11 Commits

Author SHA1 Message Date
7b23df70db updated to jdk v11.0.11 2021-06-01 13:30:57 -04:00
8ae643f2e2 set execute permission on entrypoint 2021-04-22 22:31:30 -04:00
2f382d09c8 put HotSwap/JDWP back into JAVA_OPTS 2021-04-22 21:57:45 -04:00
f25e3e374a fixed java download 2021-04-22 21:48:16 -04:00
afe871cc05 made hotswap/jdwp disablable 2021-04-22 21:29:28 -04:00
2a1ce87bfc added multiple paths to hotswap; README 2021-03-16 21:37:51 -04:00
12942fc38e more fixes 2021-03-16 19:59:52 -04:00
8480c96ae3 fixed classpath paths 2021-03-16 14:18:50 -04:00
0ab2648e3e fixed accidental comment-out 2021-03-16 14:13:11 -04:00
1e048ff961 split setenv 2021-03-16 12:55:13 -04:00
bc6f05b1f8 added automatic classpath loading and JAVA_CLASS envvar usage 2021-03-16 11:50:31 -04:00
6 changed files with 121 additions and 17 deletions

View File

@@ -4,15 +4,23 @@ FROM ubuntu:${ubuntu.version}
# Configure standard JAVA parameters # Configure standard JAVA parameters
ENV JAVA_MEMORY_INIT=128m ENV JAVA_MEMORY_INIT=128m
ENV JAVA_MEMORY_MAX=512m ENV JAVA_MEMORY_MAX=512m
ENV JAVA_HOME=/usr/local/lib/jvm/java-openjdk-dcevm
ENV JRE_HOME=/usr/local/lib/jvm/java-openjdk-dcevm
ENV JAVA_OPTS= ENV JAVA_OPTS=
ENV ENABLE_HOTSWAP=true
ENV ENABLE_JDWP=true
# Install curl # Install curl
RUN apt update && apt -y install curl RUN apt update && \
apt -y install curl
# Download & Install DCEVM Java # Download & Install DCEVM Java
RUN mkdir -p /usr/local/lib/jvm && \ RUN mkdir -p /usr/local/lib/jvm && \
curl -L https://github.com/TravaOpenJDK/trava-jdk-${dcevm.majorVersion}-dcevm/releases/download/dcevm-${dcevm.version}/java${dcevm.majorVersion}-openjdk-dcevm-linux.tar.gz -o /usr/local/lib/jvm/java-openjdk-dcevm.tar.gz && \ curl -L https://github.com/TravaOpenJDK/trava-jdk-${dcevm.majorVersion}-dcevm/releases/download/dcevm-${dcevm.version}/${dcevm.filename} -o /usr/local/lib/jvm/java-openjdk-dcevm.tar.gz && \
cd /usr/local/lib/jvm && tar xzvf java-openjdk-dcevm.tar.gz && mv dcevm-${dcevm.version} java-openjdk-dcevm && rm java-openjdk-dcevm.tar.gz cd /usr/local/lib/jvm && \
tar xzvf java-openjdk-dcevm.tar.gz && \
mv dcevm-${dcevm.version} java-openjdk-dcevm && \
rm java-openjdk-dcevm.tar.gz
# Download Hotswap Agent # Download Hotswap Agent
RUN curl -L https://github.com/HotswapProjects/HotswapAgent/releases/download/RELEASE-${hotswap.version}/hotswap-agent-${hotswap.version}.jar -o /usr/local/lib/jvm/hotswap-agent.jar RUN curl -L https://github.com/HotswapProjects/HotswapAgent/releases/download/RELEASE-${hotswap.version}/hotswap-agent-${hotswap.version}.jar -o /usr/local/lib/jvm/hotswap-agent.jar
@@ -23,10 +31,12 @@ RUN mkdir -p /var/lib/jvm && cd /var/lib/jvm && \
mkdir classes classes-extra1 classes-extra2 classes-extra3 classes-extra4 classes-extra5 classes-extra6 classes-extra7 && \ mkdir classes classes-extra1 classes-extra2 classes-extra3 classes-extra4 classes-extra5 classes-extra6 classes-extra7 && \
mkdir lib lib-extra1 lib-extra2 lib-extra3 lib-extra4 lib-extra5 lib-extra6 lib-extra7 mkdir lib lib-extra1 lib-extra2 lib-extra3 lib-extra4 lib-extra5 lib-extra6 lib-extra7
# Add our Docker container initialization script # Add our Docker container initialization scripts
ADD setenv.sh /usr/local/bin/${project.artifactId}-setenv.sh
ADD docker-entrypoint.sh /usr/local/bin ADD docker-entrypoint.sh /usr/local/bin
RUN chmod 755 /usr/local/bin/docker-entrypoint.sh
# Add our default hotswap configuration; may be overwritten # Add our default hotswap configuration; may be overwritten in dev/classes* volumes
ADD hotswap-agent.properties /var/lib/jvm/lib ADD hotswap-agent.properties /var/lib/jvm/lib
# Listening for Java debugger traffic # Listening for Java debugger traffic
@@ -37,6 +47,3 @@ EXPOSE 8000
# Execute the Docker container initialization script # Execute the Docker container initialization script
ENTRYPOINT [ "/usr/local/bin/docker-entrypoint.sh" ] ENTRYPOINT [ "/usr/local/bin/docker-entrypoint.sh" ]
# Do nothing meaningful; made to be overridden
CMD [ "-version" ]

37
README.md Normal file
View File

@@ -0,0 +1,37 @@
# Java Application Container Image with Hot-Reloading
This project creates a Docker image that has uses both the [Trava DCEVM](http://dcevm.github.io/) and [Hotswap Agent](http://hotswapagent.org/) and the Java JDWP debugger. The combination of these utilities allows for the hot-reloading of Java resources and classes to enable rapid application development and debugging capabilties. As a Docker image, containers can be started to facilitate development without requiring complicated installations on developer workstations.
It is expected that containers are configured in Maven using the Fabric8 or Spotify Docker plugins. These configurations should expose the 8000 (debugger) port and any other port that the application may open. Most importantly, it should mount/bind the source code to the following possible paths.
| Directory | Type | Hot-Reloaded |
| --------------------------------- |:---------:|:------------:|
| `/var/lib/jvm/dev/classes` | Classpath | Yes |
| `/var/lib/jvm/dev/classes-extra1` | Classpath | Yes |
| `/var/lib/jvm/dev/classes-extra2` | Classpath | Yes |
| `/var/lib/jvm/dev/classes-extra3` | Classpath | Yes |
| `/var/lib/jvm/dev/classes-extra4` | Classpath | Yes |
| `/var/lib/jvm/dev/classes-extra5` | Classpath | Yes |
| `/var/lib/jvm/dev/classes-extra6` | Classpath | Yes |
| `/var/lib/jvm/dev/classes-extra7` | Classpath | Yes |
| `/var/lib/jvm/dev/lib` | JARs | No |
| `/var/lib/jvm/dev/lib-extra1` | JARs | No |
| `/var/lib/jvm/dev/lib-extra2` | JARs | No |
| `/var/lib/jvm/dev/lib-extra3` | JARs | No |
| `/var/lib/jvm/dev/lib-extra4` | JARs | No |
| `/var/lib/jvm/dev/lib-extra5` | JARs | No |
| `/var/lib/jvm/dev/lib-extra6` | JARs | No |
| `/var/lib/jvm/dev/lib-extra7` | JARs | No |
You may include your own `hotswap-agent.properties` in any of the `classes` folders. The one loaded by default is usually sufficient.
You can specify the following environment variables when running the container.
| Environment Variable | Default Value | Description |
| -------------------- | ------------- | ----------- |
| `JAVA_MEMORY_INIT` | `128m` | The initial and minimum JVM memory. |
| `JAVA_MEMORY_MAX` | `512m` | The maximum JVM memory allowed. |
| `ENABLE_HOTSWAP` | `true` | Set to `false` to disable the HotSwap agent. |
| `ENABLE_JDWP` | `true` | Set to `false` to disable the Java debugger. |
| `JAVA_OPTS` | | Set to extend the standard `JAVA_OPTS` environment variable. |

View File

@@ -1,4 +1,9 @@
#!/bin/bash #!/bin/sh
JAVA_OPTS="-Xms${JAVA_MEMORY_INIT} -Xmx${JAVA_MEMORY_MAX} -XX:HotswapAgent=external -javaagent:/usr/local/lib/jvm/hotswap-agent.jar -agentlib:jdwp=transport=dt_socket,address=8000,server=y,suspend=n $JAVA_OPTS" . /usr/local/bin/java-dcevm-hotswap-setenv.sh
exec "/usr/local/lib/jvm/java-openjdk-dcevm/bin/java ${JAVA_OPTS} $@" JAVA_CP="/var/lib/jvm/lib:/var/lib/jvm/lib/*"
JAVA_CP="${JAVA_CP}:/var/lib/jvm/dev/classes:/var/lib/jvm/dev/classes-extra1:/var/lib/jvm/dev/classes-extra2:/var/lib/jvm/dev/classes-extra3:/var/lib/jvm/dev/classes-extra4:/var/lib/jvm/dev/classes-extra5:/var/lib/jvm/dev/classes-extra6:/var/lib/jvm/dev/classes-extra7"
JAVA_CP="${JAVA_CP}:/var/lib/jvm/dev/lib/*:/var/lib/jvm/dev/lib-extra1/*:/var/lib/jvm/dev/lib-extra2/*:/var/lib/jvm/dev/lib-extra3/*:/var/lib/jvm/dev/lib-extra4/*:/var/lib/jvm/dev/lib-extra5/*:/var/lib/jvm/dev/lib-extra6/*:/var/lib/jvm/dev/lib-extra7/*"
EXEC_JAVA_OPTS="${JAVA_OPTS} -classpath ${JAVA_CP}"
exec ${JAVA_HOME}/bin/java ${EXEC_JAVA_OPTS} ${JAVA_CLASS}

View File

@@ -7,7 +7,14 @@
# This may be useful for example in multi module maven project to load class changes from upstream project # This may be useful for example in multi module maven project to load class changes from upstream project
# classes. Set extraClasspath to upstream project compiler output and .class file will have precedence to # classes. Set extraClasspath to upstream project compiler output and .class file will have precedence to
# classes from built JAR file. # classes from built JAR file.
extraClasspath=/tmp/java/classpath extraClasspath=/var/lib/jvm/dev/classes; \
/var/lib/jvm/dev/classes-extra1; \
/var/lib/jvm/dev/classes-extra2; \
/var/lib/jvm/dev/classes-extra3; \
/var/lib/jvm/dev/classes-extra4; \
/var/lib/jvm/dev/classes-extra5; \
/var/lib/jvm/dev/classes-extra6; \
/var/lib/jvm/dev/classes-extra7
# Watch for changes in a directory (resources only). If not set, changes of resources won't be observed. # Watch for changes in a directory (resources only). If not set, changes of resources won't be observed.
# #
@@ -19,14 +26,21 @@ extraClasspath=/tmp/java/classpath
# replacements of resources in a building step (maven filtering resource option). # replacements of resources in a building step (maven filtering resource option).
# This setting will leave i.e. src/target/classes as default source for resources, but after the resource is modified # This setting will leave i.e. src/target/classes as default source for resources, but after the resource is modified
# in src/main/resources, the new changed resource is served instead. # in src/main/resources, the new changed resource is served instead.
watchResources=/tmp/java/resources watchResources=/var/lib/jvm/dev/classes; \
/var/lib/jvm/dev/classes-extra1; \
/var/lib/jvm/dev/classes-extra2; \
/var/lib/jvm/dev/classes-extra3; \
/var/lib/jvm/dev/classes-extra4; \
/var/lib/jvm/dev/classes-extra5; \
/var/lib/jvm/dev/classes-extra6; \
/var/lib/jvm/dev/classes-extra7
# Load static web resources from different directory. # Load static web resources from different directory.
# #
# This setting is dependent on application server plugin(Jetty, Tomcat, ...). # This setting is dependent on application server plugin(Jetty, Tomcat, ...).
# Jboss and Glassfish are not yet supported. # Jboss and Glassfish are not yet supported.
# Use this setting to set to serve resources from source directory directly (e.g. src/main/webapp). # Use this setting to set to serve resources from source directory directly (e.g. src/main/webapp).
webappDir=/var/java/web webappDir=
# Comma separated list of disabled plugins # Comma separated list of disabled plugins

37
pom.xml
View File

@@ -3,7 +3,7 @@
<modelVersion>4.0.0</modelVersion> <modelVersion>4.0.0</modelVersion>
<groupId>com.inteligr8</groupId> <groupId>com.inteligr8</groupId>
<artifactId>java-dcevm-hotswap</artifactId> <artifactId>java-dcevm-hotswap</artifactId>
<version>11.0.10-1.4.1</version> <version>11.0.11-1.4.1</version>
<name>Java DCEVM for Rapid Application Development</name> <name>Java DCEVM for Rapid Application Development</name>
<packaging>pom</packaging> <packaging>pom</packaging>
@@ -15,8 +15,13 @@
<!-- The version of Java DCEVM to use for executing Apache Tomcat --> <!-- The version of Java DCEVM to use for executing Apache Tomcat -->
<!-- See: https://github.com/TravaOpenJDK/trava-jdk-11-dcevm/releases --> <!-- See: https://github.com/TravaOpenJDK/trava-jdk-11-dcevm/releases -->
<dcevm.version>11.0.10+4</dcevm.version> <dcevm.version>11.0.11+1</dcevm.version>
<dcevm.majorVersion>11</dcevm.majorVersion> <dcevm.majorVersion>11</dcevm.majorVersion>
<dcevm.os-arch>linux-x64</dcevm.os-arch>
<!-- v11.0.10
<dcevm.filename>java${dcevm.majorVersion}-openjdk-dcevm-${dcevm.os-arch}.tar.gz</dcevm.filename>
-->
<dcevm.filename>Openjdk${dcevm.majorVersion}u-dcevm-${dcevm.os-arch}.tar.gz</dcevm.filename>
<!-- The version of the Hotswap Agent to use --> <!-- The version of the Hotswap Agent to use -->
<!-- See: https://github.com/HotswapProjects/HotswapAgent/releases --> <!-- See: https://github.com/HotswapProjects/HotswapAgent/releases -->
@@ -29,7 +34,33 @@
</properties> </properties>
<build> <build>
<resources>
<resource>
<directory>.</directory>
<includes>
<include>*.sh</include>
<include>*.properties</include>
</includes>
<filtering>true</filtering>
<targetPath>${project.build.directory}</targetPath>
</resource>
</resources>
<plugins> <plugins>
<plugin>
<artifactId>maven-resources-plugin</artifactId>
<version>3.2.0</version>
<executions>
<execution>
<id>copy-resources</id>
<phase>process-resources</phase>
<goals><goal>resources</goal></goals>
<configuration>
<encoding>utf-8</encoding>
<propertiesEncoding>utf-8</propertiesEncoding>
</configuration>
</execution>
</executions>
</plugin>
<!-- This plugin build and pushes the Docker image --> <!-- This plugin build and pushes the Docker image -->
<plugin> <plugin>
<groupId>io.fabric8</groupId> <groupId>io.fabric8</groupId>
@@ -42,7 +73,7 @@
<registry>${image.registry}</registry> <registry>${image.registry}</registry>
</image> </image>
</images> </images>
<contextDir>${basedir}</contextDir> <contextDir>${project.build.directory}</contextDir>
<buildStrategy>docker</buildStrategy> <buildStrategy>docker</buildStrategy>
<verbose>true</verbose> <verbose>true</verbose>
</configuration> </configuration>

10
setenv.sh Normal file
View File

@@ -0,0 +1,10 @@
#!/bin/sh
JAVA_OPTS="${JAVA_OPTS} -Xms${JAVA_MEMORY_INIT} -Xmx${JAVA_MEMORY_MAX}"
if [ "${ENABLE_HOTSWAP}" = "true" ]; then
JAVA_OPTS="${JAVA_OPTS} -XX:HotswapAgent=external -javaagent:/usr/local/lib/jvm/hotswap-agent.jar"
fi
if [ "${ENABLE_JDWP}" = "true" ]; then
JAVA_OPTS="${JAVA_OPTS} -agentlib:jdwp=transport=dt_socket,address=8000,server=y,suspend=n"
fi