From 083658fb1364d442a913016d639bbd1c2a4ed551 Mon Sep 17 00:00:00 2001 From: Brian Long Date: Tue, 16 Mar 2021 21:48:12 -0400 Subject: [PATCH] added more paths to hotswap; added README --- README.md | 35 +++++++++++++++++++++++++++++++++++ hotswap-agent.properties | 27 ++++++++++++++++++++++++--- 2 files changed, 59 insertions(+), 3 deletions(-) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..4f723ec --- /dev/null +++ b/README.md @@ -0,0 +1,35 @@ + +# Apache Tomcat Application Container Image with Hot-Reloading + +This project creates a Docker image that has uses the [Java DCEVM Hotswap Docker Image](/inteligr8/java-dcevm-hotswap-docker) to support hot-reloading for the enablement of rapid application development. 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 8080 (HTTP) and 8000 (debugger) ports 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/tomcat/dev/classes` | Classpath | Yes | +| `/var/lib/tomcat/dev/classes-extra1` | Classpath | Yes | +| `/var/lib/tomcat/dev/classes-extra2` | Classpath | Yes | +| `/var/lib/tomcat/dev/classes-extra3` | Classpath | Yes | +| `/var/lib/tomcat/dev/classes-extra4` | Classpath | Yes | +| `/var/lib/tomcat/dev/classes-extra5` | Classpath | Yes | +| `/var/lib/tomcat/dev/classes-extra6` | Classpath | Yes | +| `/var/lib/tomcat/dev/classes-extra7` | Classpath | Yes | +| `/var/lib/tomcat/dev/lib` | JARs | No | +| `/var/lib/tomcat/dev/lib-extra1` | JARs | No | +| `/var/lib/tomcat/dev/lib-extra2` | JARs | No | +| `/var/lib/tomcat/dev/lib-extra3` | JARs | No | +| `/var/lib/tomcat/dev/lib-extra4` | JARs | No | +| `/var/lib/tomcat/dev/lib-extra5` | JARs | No | +| `/var/lib/tomcat/dev/lib-extra6` | JARs | No | +| `/var/lib/tomcat/dev/lib-extra7` | JARs | No | +| `/var/lib/tomcat/dev/web` | Web | Yes | +| `/var/lib/tomcat/dev/web-extra1` | Web | Yes | +| `/var/lib/tomcat/dev/web-extra2` | Web | Yes | +| `/var/lib/tomcat/dev/web-extra3` | Web | Yes | +| `/var/lib/tomcat/dev/web-extra4` | Web | Yes | +| `/var/lib/tomcat/dev/web-extra5` | Web | Yes | +| `/var/lib/tomcat/dev/web-extra6` | Web | Yes | +| `/var/lib/tomcat/dev/web-extra7` | Web | Yes | + +You may include your own `hotswap-agent.properties` in any of the `classes` folders. The one loaded by default is usually sufficient. It most notably disables the Hotswap Agent Hibernate plugin. diff --git a/hotswap-agent.properties b/hotswap-agent.properties index b87a98b..db38a6b 100644 --- a/hotswap-agent.properties +++ b/hotswap-agent.properties @@ -7,7 +7,14 @@ # 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 from built JAR file. -extraClasspath=/var/lib/tomcat/dev/classes +extraClasspath=/var/lib/tomcat/dev/classes; \ +/var/lib/tomcat/dev/classes-extra1; \ +/var/lib/tomcat/dev/classes-extra2; \ +/var/lib/tomcat/dev/classes-extra3; \ +/var/lib/tomcat/dev/classes-extra4; \ +/var/lib/tomcat/dev/classes-extra5; \ +/var/lib/tomcat/dev/classes-extra6; \ +/var/lib/tomcat/dev/classes-extra7 # Watch for changes in a directory (resources only). If not set, changes of resources won't be observed. # @@ -19,14 +26,28 @@ extraClasspath=/var/lib/tomcat/dev/classes # 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 # in src/main/resources, the new changed resource is served instead. -watchResources=/var/lib/tomcat/dev/classes +watchResources=/var/lib/tomcat/dev/classes; \ +/var/lib/tomcat/dev/classes-extra1; \ +/var/lib/tomcat/dev/classes-extra2; \ +/var/lib/tomcat/dev/classes-extra3; \ +/var/lib/tomcat/dev/classes-extra4; \ +/var/lib/tomcat/dev/classes-extra5; \ +/var/lib/tomcat/dev/classes-extra6; \ +/var/lib/tomcat/dev/classes-extra7 # Load static web resources from different directory. # # This setting is dependent on application server plugin(Jetty, Tomcat, ...). # Jboss and Glassfish are not yet supported. # Use this setting to set to serve resources from source directory directly (e.g. src/main/webapp). -webappDir=/var/lib/tomcat/dev/web +webappDir=/var/lib/tomcat/dev/web; \ +/var/lib/tomcat/dev/web-extra1; \ +/var/lib/tomcat/dev/web-extra2; \ +/var/lib/tomcat/dev/web-extra3; \ +/var/lib/tomcat/dev/web-extra4; \ +/var/lib/tomcat/dev/web-extra5; \ +/var/lib/tomcat/dev/web-extra6; \ +/var/lib/tomcat/dev/web-extra7 # Comma separated list of disabled plugins