|
|
@@ -0,0 +1,132 @@
|
|
|
+# Supported tags and respective `Dockerfile` links
|
|
|
+
|
|
|
+- [`8.5.5`, `latest` (*websphere-liberty/8.5.5/Dockerfile*)](https://github.com/WASdev/ci.docker/blob/f7c3cf46801e5748b6a9227a8c8e5ad3f544fc4a/websphere-liberty/8.5.5/Dockerfile)
|
|
|
+
|
|
|
+For more information about this image and its history, please see the [relevant
|
|
|
+manifest file
|
|
|
+(`library/websphere-liberty`)](https://github.com/docker-library/official-images/blob/master/library/websphere-liberty)
|
|
|
+in the [`docker-library/official-images` GitHub
|
|
|
+repo](https://github.com/docker-library/official-images).
|
|
|
+
|
|
|
+# 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
|
|
|
+
|
|
|
+# License
|
|
|
+
|
|
|
+The Dockerfile and associated scripts are licensed under the [Apache License
|
|
|
+2.0][apache-license]. The IBM JRE and WebSphere Application Server for
|
|
|
+Developers are licensed under the IBM International License Agreement for
|
|
|
+Non-Warranted Programs. Those licenses may be viewed from the image using the
|
|
|
+`LICENSE=view` environment variable as described above or may be found online
|
|
|
+for the [IBM JRE][jre-license] and [IBM WebSphere Application Server for
|
|
|
+Developers][liberty-license]. Note that this license does not permit further
|
|
|
+distribution and that the image is for development use only.
|
|
|
+
|
|
|
+[apache-license]: http://www.apache.org/licenses/LICENSE-2.0.html
|
|
|
+[jre-license]: https://www14.software.ibm.com/cgi-bin/weblap/lap.pl?la_formnum=&li_formnum=L-EWOD-99YA4J&title=IBM%C2%AE+SDK%2C+Java+Technology+Edition%2C+Version+7+Release+1&l=en
|
|
|
+[liberty-license]: https://public.dhe.ibm.com/ibmdl/export/pub/software/websphere/wasdev/downloads/wlp/8.5.5.3/lafiles/runtime/en.html
|
|
|
+
|
|
|
+# Supported Docker versions
|
|
|
+
|
|
|
+This image is officially supported on Docker version 1.4.1.
|
|
|
+
|
|
|
+Support for older versions (down to 1.0) is provided on a best-effort basis.
|
|
|
+
|
|
|
+# User Feedback
|
|
|
+
|
|
|
+For issues relating specifically to this Docker image, please use the [GitHub
|
|
|
+issue tracker][issues]. For more general issues relating to IBM WebSphere
|
|
|
+Application Server Liberty Profile you can [get help][help] through the WASdev
|
|
|
+community. We welcome contributions following [our guidelines][contributing].
|
|
|
+
|
|
|
+[issues]: https://github.com/WASdev/ci.docker/issues
|
|
|
+[help]: https://developer.ibm.com/wasdev/help/
|
|
|
+[contributing]: https://github.com/WASdev/wasdev.github.io/blob/master/CONTRIBUTING.md
|
Tianon Gravi