Docker is a way to create a pre-packaged set of software and configuration called an "Image". Images are used to create Docker "Containers", which run the Image contents in isolation from the other software running on the same system. Docker containers are the runtime environment, and Images are what they are crated from.
The majority of the Zowe server runtime is available in the form of a Docker Image, among other options. To use this image, you must have set up the Zowe server runtime on z/OS, z/OSMF, or both depending on which Zowe components you will use.
If you have not set up the Zowe server runtime on z/OS, please follow the steps found in Docker Installation Roadmap.
This guide assumes you are using Linux or zLinux and have already downloaded Docker itself. If you have not yet done so, please review System Requirements.
Zowe's Docker Image is hosted on Docker Hub, which is the default location from which you can use the Docker command line utility to download and update Docker Images. On Docker Hub, the Zowe server runtime image is named ompzowe/server-bundle.
You can download a Docker Image by using the Docker command line utility
docker pull imagename where imagename is one of the following:
- The latest version of zowe,
- The latest version for the platform you are running on, such as
- A specific version by referencing the version's digest, such as
The latest digests can be seen on the image's tags page.
You can install a Docker Image that has been downloaded as a
.tar archive from anywhere, such as Zowe.org.
To install a Docker Image that you have downloaded as a tar file from somewhere, transfer the file to the destination host and then run the following command:
docker image load -i path_to_tar
docker images command lists the images a system currently has, which make them available for creating containers from.
# docker imagesREPOSITORY TAG IMAGE ID CREATED SIZEompzowe/server-bundle amd64 ceb8c50d2381 2 hours ago 1.27GB
Once installed, it is possible to upgrade an image by using
docker pull with the same imagename as before, or by using
docker image load to load another image of the same type.
Newer containers can be created from newer images. In Zowe, configuration can be persisted between containers. More information on this subject can be found in Configuring Docker Container documentation.
When upgrading, it is possible that the previous image may persist.
You may see the old image tagged as
# docker imagesREPOSITORY TAG IMAGE ID CREATED SIZEompzowe/server-bundle amd64 ceb8c50d2381 2 hours ago 1.27GB<none> <none> 1e52fadc2918 2 weeks ago 3.03GB
If you see this and want to clean up the older images to preserve storage space, you can run the command
docker rmi IMAGE_ID to remove an image, where IMAGE_ID is the code seen from the
Dockerhub is equiped with an option authenticity verification feature that you can use to ensure that the Zowe release you are pulling from Dockerhub is legitimate.
Note: With this verification turned on, you will not be able to download images that are not signed.
To turn use this feature, you must set the environment variable
DOCKER_CONTENT_TRUST=1, then use the "docker pull" command on images that you want to download. This feature can be set to be either temporary or permanent.
DOCKER_CONTENT_TRUST=1 docker pull ompzowe/server-bundle:amd64
export DOCKER_CONTENT_TRUST=1to your shell profile, such as echo
export DOCKER_CONTENT_TRUST=1>> .profile
Login again so that the export can take effect.
Use docker commands, such as
docker pull ompzowe/server-bundle:amd64