Building a sample or supported IBM App Connect Enterprise image using Docker

You can build a sample or supported IBM® App Connect Enterprise Docker image. You can configure IBM App Connect Enterprise to run in a Docker container on AIX®, Linux®, and Windows systems, and in IBM z/OS® Container Extensions (zCX).

About this task

To run IBM App Connect Enterprise in a Docker container, you must first build a base image containing an installation of IBM App Connect Enterprise. Instructions are available in the IBM App Connect Enterprise GitHub repository, at https://github.com/ot4i/ace-docker. Alternatively, you can download an image of IBM App Connect Enterprise from the IBM Entitled Registry.

If you plan to use IBM z/OS Container Extensions (zCX), ensure that you have installed the Linux on zSeries package. Until APAR OA59111 is available, you can build an image on IBM z/OS Container Extensions (zCX) only by using the experimental Ubuntu Dockerfiles. A pre-built image is not currently available for download for IBM z/OS Container Extensions (zCX).

A Dockerfile is a set of instructions for building a Docker image. Images can be stored in local or remote registries, and are used to create a running Docker container. To build the image, Docker executes the instructions in the Dockerfile. Each instruction causes a new image layer to be created. Docker best practice guidelines recommend that you keep the number of Dockerfile instructions to a minimum, because the number of layers in an image might be limited. The guidelines, which are available at https://docs.docker.com/engine/userguide/eng-image/dockerfile_best-practices, suggest that you “find the balance between readability (and thus long-term maintainability) of the Dockerfile and minimizing the number of layers it uses. Be strategic and cautious about the number of layers you use.”

The following GitHub repository contains a Dockerfile and some additional files that show how you can build an IBM App Connect Enterprise Docker image: https://github.com/ot4i/ace-docker.

If you do not have access to the GitHub CLI (which is not currently available on IBM z/OS Container Extensions (zCX)), you can obtain the contents of the repository by running the following curl command:

curl -Lk https://github.com/ot4i/ace-docker/tarball/master | tar xz

Obtaining an IBM App Connect Enterprise server image

To obtain your required version of an IBM App Connect Enterprise server image, you require an IBM entitlement key for pulling the image from the IBM Cloud Container Registry. You need to obtain this key once only.

Procedure

Complete the following steps:

Obtain an IBM entitlement key from the following location: https://myibm.ibm.com/products-services/containerlibrary.
Log in to the IBM Cloud Container Registry by running this command, using cp as the username, cp.icr.io as the Docker server, and your entitlement key as the password:
```
docker login cp.icr.io -u cp -p myEntitlementKey
```
For more information about the Container Registry, see the IBM Cloud Container Registry documentation.
Use Docker to pull the required version, where imageLocation represents one of the listed image locations in the following table:
```
docker pull imageLocation
```
Version Image location

13.0.1.0-r1 cp.icr.io/cp/appc/ace:13.0.1.0-r1@sha256:8245aab89121b8368c14c8b0647840faa2948fa5f5916f00d84878f4ffa46151
Re-tag the image appropriately and then push it to your preferred registry.

You can run the image by using an example command such as:

docker run --name aceserver -p 7600:7600 -p 7800:7800 -p 7843:7843 --env LICENSE=accept --env ACE_SERVER_NAME=ACESERVER cp.icr.io/cp/appc/ace:13.0.1.0-r1@sha256:8245aab89121b8368c14c8b0647840faa2948fa5f5916f00d84878f4ffa46151