Add WebSphere Liberty docs
This commit is contained in:
David Currie
parent
b6f9804a9a
commit
1f98d6a99a
|
|
@ -51,6 +51,7 @@ declare -A otherRepos=(
|
|||
[ubuntu-debootstrap]='https://github.com/tianon/docker-brew-ubuntu-debootstrap'
|
||||
[ubuntu-upstart]='https://github.com/tianon/dockerfiles'
|
||||
[ubuntu]='https://github.com/tianon/docker-brew-ubuntu-core'
|
||||
[websphere-liberty]='https://github.com/WASdev/ci.docker'
|
||||
)
|
||||
|
||||
dockerLatest="$(curl -sSL 'https://get.docker.com/latest')"
|
||||
|
|
|
|||
|
|
@ -0,0 +1 @@
|
|||
Official IBM WebSphere Application Server for Developers V8.5.5 Liberty Profile image.
|
||||
|
|
@ -0,0 +1,92 @@
|
|||
# Overview
|
||||
|
||||
This image contains IBM WebSphere Application Server for Developers V8.5.5
|
||||
Liberty Profile and the IBM Java Runtime Environment 7.1 SR1. 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 connections from outside of the container by adding the following element inside the `server` stanza:
|
||||
|
||||
```
|
||||
<httpEndpoint host="*" httpPort="9080" httpsPort="9443"/>
|
||||
```
|
||||
|
||||
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.
|
||||
|
||||
```
|
||||
docker run -e LICENSE=accept -d -p 80:9080 -p 443:9443 \
|
||||
-v /tmp/DefaultServletEngine:/opt/ibm/wlp/usr/servers/DefaultServletEngine \
|
||||
websphere-liberty 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
|
||||
```
|
||||
|
||||
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 ubuntu:14.04
|
||||
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 -p 443:9443 \
|
||||
--volumes-from app websphere-liberty 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
|
||||
|
|
@ -0,0 +1,12 @@
|
|||
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
|
||||
Binary file not shown.
|
After Width: | Height: | Size: 39 KiB |
|
|
@ -0,0 +1,8 @@
|
|||
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
|
||||
Loading…
Reference in New Issue