|
|
@@ -16,7 +16,7 @@ Jetty is a pure Java-based HTTP (Web) server and Java Servlet container. While W
|
|
|
|
|
|
# How to use this image.
|
|
|
|
|
|
-Run the default Jetty server (`CMD ["jetty.sh", "run"]`):
|
|
|
+Run the default Jetty server:
|
|
|
|
|
|
```console
|
|
|
$ docker run -d jetty:9
|
|
|
@@ -34,10 +34,6 @@ The default Jetty environment in the image is:
|
|
|
|
|
|
JETTY_HOME = /usr/local/jetty
|
|
|
JETTY_BASE = /var/lib/jetty
|
|
|
- JETTY_CONF = /usr/local/jetty/etc/jetty.conf
|
|
|
- JETTY_STATE = /run/jetty/jetty.state
|
|
|
- JETTY_ARGS =
|
|
|
- JAVA_OPTIONS =
|
|
|
TMPDIR = /tmp/jetty
|
|
|
|
|
|
## Deployment
|
|
|
@@ -46,6 +42,30 @@ Webapps can be [deployed](https://www.eclipse.org/jetty/documentation/current/qu
|
|
|
|
|
|
For older EOL'd images based on Jetty 7 or Jetty 8, please follow the [legacy instructions](https://wiki.eclipse.org/Jetty/Howto/Deploy_Web_Applications) on the Eclipse Wiki and deploy under `/usr/local/jetty/webapps` instead of `/var/lib/jetty/webapps`.
|
|
|
|
|
|
+## Configuration
|
|
|
+
|
|
|
+The configuration of the Jetty server can be reported by running with the `--list-config` option:
|
|
|
+
|
|
|
+```console
|
|
|
+$ docker run -d jetty:9 --list-config
|
|
|
+```
|
|
|
+
|
|
|
+Configuration such as parameters and additional modules may also be passed in via the command line. For example:
|
|
|
+
|
|
|
+```console
|
|
|
+$ docker run -d jetty:9 --modules=jmx jetty.threadPool.maxThreads=500
|
|
|
+```
|
|
|
+
|
|
|
+To update the server configuration in a derived Docker image, the `Dockerfile` may enable additional modules with `RUN` commands like:
|
|
|
+
|
|
|
+```Dockerfile
|
|
|
+FROM jetty:9
|
|
|
+
|
|
|
+RUN java -jar "$JETTY_HOME/start.jar" --add-to-startd=jmx,stats
|
|
|
+```
|
|
|
+
|
|
|
+Modules may be configured in a `Dockerfile` by editing the properties in the corresponding `/var/lib/jetty/start.d/*.mod` file or the module can be deactivated by removing that file.
|
|
|
+
|
|
|
## Read-only container
|
|
|
|
|
|
To run `jetty` as a read-only container, have Docker create the `/tmp/jetty` and `/run/jetty` directories as volumes:
|