|
|
@@ -0,0 +1,90 @@
|
|
|
+# Overview
|
|
|
+
|
|
|
+This image contains IBM WebSphere Application Server for Developers Liberty
|
|
|
+Profile and the IBM Java Runtime Environment. For more information on WebSphere
|
|
|
+Application Server Liberty Profile, see the [WASdev][getting-started] site.
|
|
|
+
|
|
|
+# Usage
|
|
|
+
|
|
|
+In order to use the image, it is necessary to accept the terms of the WebSphere
|
|
|
+Application Server for Developers and IBM JRE licenses. This is achieved by
|
|
|
+specifying the environment variable `LICENSE` equal to `accept` when running the
|
|
|
+image. You can also view the license terms by setting this variable to
|
|
|
+`view`. Failure to set the variable will result in the termination of the
|
|
|
+container with a usage statement.
|
|
|
+
|
|
|
+The image is designed to support a number of different usage
|
|
|
+patterns. The following examples are based on the Liberty [application
|
|
|
+deployment sample][sample] and assume that
|
|
|
+[DefaultServletEngine.zip][zip] has been extracted to `/tmp` and the
|
|
|
+`server.xml` updated to accept HTTP connections from outside of the
|
|
|
+container by adding the following element inside the `server` stanza:
|
|
|
+
|
|
|
+ <httpEndpoint host="*" httpPort="9080" httpsPort="-1"/>
|
|
|
+
|
|
|
+1. The image contains a default server configuration that specifies the
|
|
|
+`webProfile-6.0` feature and exposes ports 9080 and 9443 for HTTP and HTTPS
|
|
|
+respectively. A WAR file can therefore be mounted in to the `dropins` directory
|
|
|
+of this server and run. The following example starts a container in the
|
|
|
+background running a WAR file from the host file system with the HTTP and HTTPS
|
|
|
+ports mapped to 80 and 443 respectively.
|
|
|
+
|
|
|
+ docker run -e LICENSE=accept -d -p 80:9080 -p 443:9443 \
|
|
|
+ -v /tmp/DefaultServletEngine/dropins/Sample1.war:/opt/ibm/wlp/usr/servers/defaultServer/dropins/Sample1.war \
|
|
|
+ websphere-liberty
|
|
|
+
|
|
|
+ Once the server has started, you can browse to
|
|
|
+ http://localhost/Sample1/SimpleServlet on the Docker host.
|
|
|
+
|
|
|
+2. For greater flexibility over configuration, it is possible to mount
|
|
|
+an entire server configuration directory from the host and then
|
|
|
+specify the server name as a parameter to the run command. Note that
|
|
|
+this particular example server configuration only provides HTTP
|
|
|
+access.
|
|
|
+
|
|
|
+ docker run -e LICENSE=accept -d -p 80:9080 \
|
|
|
+ -v /tmp/DefaultServletEngine:/opt/ibm/wlp/usr/servers/DefaultServletEngine \
|
|
|
+ websphere-liberty /opt/ibm/wlp/bin/server run DefaultServletEngine
|
|
|
+
|
|
|
+3. It is also possible to build an application layer on top of this image using
|
|
|
+either the default server configuration or a new server configuration and,
|
|
|
+optionally, accept the license as part of that build. Here we have copied the
|
|
|
+`Sample1.war` from `/tmp/DefaultServletEngine/dropins` to the same directory as
|
|
|
+the following Dockerfile.
|
|
|
+
|
|
|
+ FROM websphere-liberty
|
|
|
+ ADD Sample1.war /opt/ibm/wlp/usr/servers/defaultServer/dropins/
|
|
|
+ ENV LICENSE accept
|
|
|
+
|
|
|
+This can then be built and run as follows:
|
|
|
+
|
|
|
+ docker build -t app .
|
|
|
+ docker run -d -p 80:9080 -p 443:9443 app
|
|
|
+
|
|
|
+4. Lastly, it is possible to mount a data volume container containing the
|
|
|
+application and the server configuration on to the image. This has the benefit
|
|
|
+that it has no dependency on files from the host but still allows the
|
|
|
+application container to be easily re-mounted on a newer version of the
|
|
|
+application server image. The example assumes that you have copied the
|
|
|
+`/tmp/DefaultServletEngine` directory in to the same directory as the
|
|
|
+Dockerfile.
|
|
|
+
|
|
|
+ Build and run the data volume container:
|
|
|
+
|
|
|
+ FROM websphere-liberty
|
|
|
+ ADD DefaultServletEngine /opt/ibm/wlp/usr/servers/DefaultServletEngine
|
|
|
+
|
|
|
+ docker build -t app-image .
|
|
|
+ docker run -d -v /opt/ibm/wlp/usr/servers/DefaultServletEngine \
|
|
|
+ --name app app-image true
|
|
|
+
|
|
|
+ Run the WebSphere Liberty image with the volumes from the data
|
|
|
+ volume container mounted:
|
|
|
+
|
|
|
+ docker run -e LICENSE=accept -d -p 80:9080 \
|
|
|
+ --volumes-from app websphere-liberty \
|
|
|
+ /opt/ibm/wlp/bin/server run DefaultServletEngine
|
|
|
+
|
|
|
+[getting-started]: https://developer.ibm.com/wasdev/docs/category/getting-started/
|
|
|
+[sample]: https://developer.ibm.com/wasdev/docs/article_appdeployment/
|
|
|
+[zip]: https://www.ibm.com/developerworks/mydeveloperworks/blogs/wasdev/resource/DefaultServletEngine.zip
|
yosifkit
