|
|
@@ -1,11 +1,11 @@
|
|
|
# Supported tags and respective `Dockerfile` links
|
|
|
|
|
|
-- [`kernel`, `8.5.5.7-kernel` (*websphere-liberty/8.5.5/developer/kernel/Dockerfile*)](https://github.com/WASdev/ci.docker/blob/975e98caeaf81eb0648832d54778e0d6b079e4b4/websphere-liberty/8.5.5/developer/kernel/Dockerfile)
|
|
|
-- [`common`, `8.5.5.7-common` (*websphere-liberty/8.5.5/developer/common/Dockerfile*)](https://github.com/WASdev/ci.docker/blob/975e98caeaf81eb0648832d54778e0d6b079e4b4/websphere-liberty/8.5.5/developer/common/Dockerfile)
|
|
|
-- [`webProfile6`, `8.5.5.7-webProfile6` (*websphere-liberty/8.5.5/developer/webProfile6/Dockerfile*)](https://github.com/WASdev/ci.docker/blob/975e98caeaf81eb0648832d54778e0d6b079e4b4/websphere-liberty/8.5.5/developer/webProfile6/Dockerfile)
|
|
|
-- [`webProfile7`, `8.5.5.7-webProfile7` (*websphere-liberty/8.5.5/developer/webProfile7/Dockerfile*)](https://github.com/WASdev/ci.docker/blob/975e98caeaf81eb0648832d54778e0d6b079e4b4/websphere-liberty/8.5.5/developer/webProfile7/Dockerfile)
|
|
|
-- [`javaee7`, `8.5.5.7-javaee7`, `8.5.5.7`, `8.5.5`, `latest` (*websphere-liberty/8.5.5/developer/javaee7/Dockerfile*)](https://github.com/WASdev/ci.docker/blob/975e98caeaf81eb0648832d54778e0d6b079e4b4/websphere-liberty/8.5.5/developer/javaee7/Dockerfile)
|
|
|
-- [`beta` (*websphere-liberty/beta/Dockerfile*)](https://github.com/WASdev/ci.docker/blob/a985ec807ce260337a36875a76a57d9a8eed9d40/websphere-liberty/beta/Dockerfile)
|
|
|
+- [`kernel`, `8.5.5.7-kernel` (*websphere-liberty/8.5.5/developer/kernel/Dockerfile*)](https://github.com/WASdev/ci.docker/blob/086dcba5e235a1c87b11742c833aeb41c6ac11a8/websphere-liberty/8.5.5/developer/kernel/Dockerfile)
|
|
|
+- [`common`, `8.5.5.7-common` (*websphere-liberty/8.5.5/developer/common/Dockerfile*)](https://github.com/WASdev/ci.docker/blob/086dcba5e235a1c87b11742c833aeb41c6ac11a8/websphere-liberty/8.5.5/developer/common/Dockerfile)
|
|
|
+- [`webProfile6`, `8.5.5.7-webProfile6` (*websphere-liberty/8.5.5/developer/webProfile6/Dockerfile*)](https://github.com/WASdev/ci.docker/blob/086dcba5e235a1c87b11742c833aeb41c6ac11a8/websphere-liberty/8.5.5/developer/webProfile6/Dockerfile)
|
|
|
+- [`webProfile7`, `8.5.5.7-webProfile7` (*websphere-liberty/8.5.5/developer/webProfile7/Dockerfile*)](https://github.com/WASdev/ci.docker/blob/086dcba5e235a1c87b11742c833aeb41c6ac11a8/websphere-liberty/8.5.5/developer/webProfile7/Dockerfile)
|
|
|
+- [`javaee7`, `8.5.5.7-javaee7`, `8.5.5.7`, `8.5.5`, `latest` (*websphere-liberty/8.5.5/developer/javaee7/Dockerfile*)](https://github.com/WASdev/ci.docker/blob/086dcba5e235a1c87b11742c833aeb41c6ac11a8/websphere-liberty/8.5.5/developer/javaee7/Dockerfile)
|
|
|
+- [`beta` (*websphere-liberty/beta/Dockerfile*)](https://github.com/WASdev/ci.docker/blob/086dcba5e235a1c87b11742c833aeb41c6ac11a8/websphere-liberty/beta/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). This image is updated via pull requests to [the `docker-library/official-images` GitHub repo](https://github.com/docker-library/official-images).
|
|
|
|
|
|
@@ -13,7 +13,7 @@ For detailed information about the virtual/transfer sizes and individual layers
|
|
|
|
|
|
# Overview
|
|
|
|
|
|
-The images in this repository contain IBM WebSphere Application Server for Developers Liberty Profile and the IBM Java Runtime Environment. For more information on WebSphere Application Server Liberty, see the [WASdev](https://developer.ibm.com/wasdev/docs/category/getting-started/) site.
|
|
|
+The images in this repository contain IBM WebSphere Application Server for Developers Liberty Profile and the IBM Java Runtime Environment. See the license section below for restrictions relating to the usage of this image. For more information on WebSphere Application Server Liberty, see the [WASdev](https://developer.ibm.com/wasdev/docs/category/getting-started/) site.
|
|
|
|
|
|
# Images
|
|
|
|
|
|
@@ -23,7 +23,7 @@ The `kernel` image contains just the Liberty kernel and no additional runtime fe
|
|
|
|
|
|
```dockerfile
|
|
|
FROM websphere-liberty:kernel
|
|
|
-COPY server.xml /opt/ibm/wlp/usr/servers/defaultServer/
|
|
|
+COPY server.xml /config/
|
|
|
RUN installUtility install --acceptLicense defaultServer
|
|
|
```
|
|
|
|
|
|
@@ -37,8 +37,6 @@ There are also corresponding image tags that contain the version number of the L
|
|
|
|
|
|
# Usage
|
|
|
|
|
|
-In order to use any of the images, 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 an 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 images are designed to support a number of different usage patterns. The following examples are based on the Java EE6 Liberty [application deployment sample](https://developer.ibm.com/wasdev/docs/article_appdeployment/) and assume that [DefaultServletEngine.zip](https://www.ibm.com/developerworks/mydeveloperworks/blogs/wasdev/resource/DefaultServletEngine.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:
|
|
|
|
|
|
```xml
|
|
|
@@ -48,8 +46,8 @@ The images are designed to support a number of different usage patterns. The fol
|
|
|
1. Each image contains a default server configuration that specifies the corresponding features 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.
|
|
|
|
|
|
```console
|
|
|
- $ 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 \
|
|
|
+ $ docker run -d -p 80:9080 -p 443:9443 \
|
|
|
+ -v /tmp/DefaultServletEngine/dropins/Sample1.war:/config/dropins/Sample1.war \
|
|
|
websphere-liberty:webProfile6
|
|
|
```
|
|
|
|
|
|
@@ -60,17 +58,16 @@ The images are designed to support a number of different usage patterns. The fol
|
|
|
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.
|
|
|
|
|
|
```console
|
|
|
- $ docker run -e LICENSE=accept -d -p 80:9080 \
|
|
|
- -v /tmp/DefaultServletEngine:/opt/ibm/wlp/usr/servers/DefaultServletEngine \
|
|
|
- websphere-liberty:webProfile6 /opt/ibm/wlp/bin/server run DefaultServletEngine
|
|
|
+ $ docker run -d -p 80:9080 \
|
|
|
+ -v /tmp/DefaultServletEngine:/config \
|
|
|
+ websphere-liberty:webProfile6
|
|
|
```
|
|
|
|
|
|
-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.
|
|
|
+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. Here we have copied the `Sample1.war` from `/tmp/DefaultServletEngine/dropins` to the same directory as the following Dockerfile.
|
|
|
|
|
|
```dockerfile
|
|
|
FROM websphere-liberty:webProfile6
|
|
|
- ADD Sample1.war /opt/ibm/wlp/usr/servers/defaultServer/dropins/
|
|
|
- ENV LICENSE accept
|
|
|
+ ADD Sample1.war /config/dropins/
|
|
|
```
|
|
|
|
|
|
This can then be built and run as follows:
|
|
|
@@ -86,21 +83,20 @@ The images are designed to support a number of different usage patterns. The fol
|
|
|
|
|
|
```dockerfile
|
|
|
FROM websphere-liberty:webProfile6
|
|
|
- ADD DefaultServletEngine /opt/ibm/wlp/usr/servers/DefaultServletEngine
|
|
|
+ ADD DefaultServletEngine /config
|
|
|
```
|
|
|
|
|
|
```console
|
|
|
$ docker build -t app-image .
|
|
|
- $ docker run -d -v /opt/ibm/wlp/usr/servers/DefaultServletEngine \
|
|
|
+ $ docker run -d -v /config \
|
|
|
--name app app-image true
|
|
|
```
|
|
|
|
|
|
Run the WebSphere Liberty image with the volumes from the data volume container mounted:
|
|
|
|
|
|
```console
|
|
|
- $ docker run -e LICENSE=accept -d -p 80:9080 \
|
|
|
- --volumes-from app websphere-liberty:webProfile6 \
|
|
|
- /opt/ibm/wlp/bin/server run DefaultServletEngine
|
|
|
+ $ docker run -d -p 80:9080 \
|
|
|
+ --volumes-from app websphere-liberty:webProfile6
|
|
|
```
|
|
|
|
|
|
# License
|
|
|
@@ -113,7 +109,7 @@ Licenses for the products installed within the images are as follows:
|
|
|
- [IBM WebSphere Application Server](https://public.dhe.ibm.com/ibmdl/export/pub/software/websphere/wasdev/downloads/wlp/8.5.5.5/lafiles/runtime/en.html) in the `latest`/`8.5.5` image (International License Agreement for Non-Warranted Programs)
|
|
|
- [IBM WebSphere Application Server Liberty v9 Beta with Java EE 7](https://public.dhe.ibm.com/ibmdl/export/pub/software/websphere/wasdev/downloads/wlp/beta/lafiles/en.html) in the `beta` image (International License Agreement for Early Release of Programs)
|
|
|
|
|
|
-The product licenses associated with an image can be displayed by specifying the `LICENSE=view` environment variable as described above. Note that these licenses do not permit further distribution and that the terms for WebSphere Application Server in the `latest`/`8.5.5` image restrict usage to a developer machine or build server only, or subject to a maximum 2 gigabyte heap usage across all instances. Instructions are available to enable entitled customers to [upgrade](https://github.com/WASdev/ci.docker/tree/master/websphere-liberty/8.5.5/production-upgrade) the Docker Hub image for production use or [build](https://github.com/WASdev/ci.docker/tree/master/websphere-liberty/8.5.5/production-install) their own production licensed image.
|
|
|
+Note that these licenses do not permit further distribution and that the terms for WebSphere Application Server in the `latest`/`8.5.5` image restrict usage to a developer machine or build server only, or subject to a maximum 2 gigabyte heap usage across all instances. Instructions are available to enable entitled customers to [upgrade](https://github.com/WASdev/ci.docker/tree/master/websphere-liberty/8.5.5/production-upgrade) the Docker Hub image for production use or [build](https://github.com/WASdev/ci.docker/tree/master/websphere-liberty/8.5.5/production-install) their own production licensed image.
|
|
|
|
|
|
# Supported Docker versions
|
|
|
|
Docker Library Bot