Return to Image List

compose

compose

Compose is a tool for defining and running multi-container Docker applications. With Compose, you use a Compose file to configure your application's services. Then, using a single command, you create and start all the services from your configuration. To learn more about all the features of Compose see the list of features.
Compose is great for development, testing, and staging environments, as well as CI workflows. You can learn more about each case in Common Use Cases.

See official git repo for more information

This image is built by IBM to run on the IBM Z architecture and is not affiliated with any other community that provides a version of this image.


License

View license information here

As with all Docker images, these likely also contain other software which may be under other licenses (such as Bash, etc from the base distribution, along with any direct or indirect dependencies of the primary software being contained).

As for any pre-built image usage, it is the image user's responsibility to ensure that any use of this image complies with any relevant licenses for all software contained within.


Versions

Use the pull string below for the version of this image you require.
2.9.0 docker pull icr.io/ibmz/compose@sha256:46a8a0083c2f987bdfec6c84ecfcf39db5f42c0c9868d60fe2865e99937706d4 Vulnerability Report08-16-2022
2.7.0 docker pull icr.io/ibmz/compose@sha256:baba1e11709418ad8f3d4953b911c91e51b82e957387fc8909ee71f6f1f98aae Vulnerability Report07-23-2022
2.6.0 docker pull icr.io/ibmz/compose@sha256:46e7f5ba72690940021cc28b46620a3cc83bcf35022b5ed725f1eb6112ca87ca Vulnerability Report06-06-2022
2.5.1 docker pull icr.io/ibmz/compose@sha256:150c7214f9a1b34aa105542675f04b5d244dbc195b24efffa5865e94d8d958e2 Vulnerability Report05-19-2022
2.4.1 docker pull icr.io/ibmz/compose@sha256:64fe0f2ed5be9cf79918d59715b604dfbf4579bd3573afb9d84007c5f73534c8 Vulnerability Report04-04-2022
2.3.3 docker pull icr.io/ibmz/compose@sha256:f33d5f553c7f9d2be216e848858d5bd5860081fb586fa5b59e552f4361eb4069 Vulnerability Report03-16-2022
2.2.3 docker pull icr.io/ibmz/compose@sha256:41a9041bb2ef6597e928c2a016f256cc7a44af997b20d0e21caf7f5225658e84 Vulnerability Report02-17-2022
2.0.1 docker pull icr.io/ibmz/compose@sha256:126c60bbf4d48673cf7451fcb4d5c5ed17440ccae208117480ee340cec4d1645 Vulnerability Report10-19-2021
Version Pull String Security (IBM Cloud) Created

Usage Notes

Docker-compose can be used stand-alone or as the basis for another image that is responsible for performing compose processes.


Create your docker-compose.yml file and other resources required for the containers specified in docker-compose.yml.

version: '2'
services:
  java:
    image: icr.io/ibmz/openjdk:11.0.8
    command: java --version

If you want to use docker-compose stand-alone

Add your docker-compose.yml to a docker volume.


Run the docker-compose image with your volume mounted and specifying the path to the docker-compose.yml at the mount location. Ensure that you are mounting docker.sock to the container as it is required to access the docker daemon.

docker run --rm -it -v /var/run/docker.sock:/var/run/docker.sock:ro -v myvolume:/config/ icr.io/ibmz/compose:[tag] --env-file /config/docker-compose.yml up
If you want to create an image based on docker-compose

Create a Dockerfile that builds an image that contains your docker-compose.yml file, and other resources required for the containers specified in docker-compose.yml.

FROM icr.io/ibmz/compose:[tag]
COPY docker-compose.yml /home/
ENV COMPOSE_FILE=/home/docker-compose.yml
CMD ["docker-compose", "up"]

Build the image.

docker build -t docker-compose-app .

Run a container using the image you just built. (Ensure that you are mounting docker.sock to the container). This will cause the java --version docker-compose to run the icr.io/ibmz/openjdk:11.0.8 image with the java --version command.

docker run --name app -v /var/run/docker.sock:/var/run/docker.sock:ro docker-compose-app