Installing Zowe runtime Docker Image (Technical Preview)
Installing Zowe runtime Docker Image (Technical Preview)
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.
#
Installing via Docker HubZowe'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,
ompzowe/server-bundle:latest
- The latest version for the platform you are running on, such as
ompzowe/server-bundle:amd64
for Linux - A specific version by referencing the version's digest, such as
ompzowe/server-bundle@sha256:bdbc0617b02e16a452f6d4de50b8b13e56592e309b4c68f9ea52c82303ad57ec
The latest digests can be seen on the image's tags page.
#
Installing via direct downloadYou can install a Docker Image that has been downloaded as a .tar
archive from anywhere, such as Zowe.org.
#
Loading an image from .tar fileTo 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
#
Confirming the installationThe 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
#
UpgradingOnce 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 <none>
.
# 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 images
command.