IBM App Connect Enterprise, Version 11.0.0.2 Operating Systems: Windows, Linux


Building a sample IBM App Connect Enterprise image using Docker

You can build a sample IBM® App Connect Enterprise Docker image.

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, by following the steps described in this topic. You can, alternatively, download an image of the IBM App Connect Enterprise for Developers edition from https://hub.docker.com/r/ibmcom/ace/ and use this to run a Docker container.

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.

Procedure

The following steps show how to build a sample base image and an extended image with a running application, by using scripts that are hosted on GitHub:

  1. Build the image by running the following commands (ensure that you include the period at the end of the docker build command):
    cd 11.0.0.0/ace/ubuntu-1604/base
    docker build -t ace:11.0.0.0 .
    This command creates an image called ace, which occupies approximately 1.07GB of space (including the size of the underlying Ubuntu base image) in your local Docker registry, as shown in the following example:
    REPOSITORY     TAG       IMAGE ID        CREATED          SIZE
    ace            11.0.0.0  e2b6a1ec3089    2 seconds ago    1.07GB
    ubuntu         16.04     dd6f76d9cc90    5 months ago     122MB

    The built image contains a full installation of IBM App Connect Enterprise for Developers at the latest fix pack level.

  2. After building a base image from the supplied files, you can run a container that will create and start an integration server, to which you can deploy integration solutions. Alternatively, you can build the extended image, which takes the base image, adds a BAR file, and edits the server.conf.yaml configuration file. This gives you an image with an application that is already set up and running. To run a container from the image, complete the following steps:
    1. Accept the terms of the IBM App Connect Enterprise for Developers license, 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. You can view the license in a different language by setting the LANG environment variable.
    2. Configure the ports for integration server administration and HTTP traffic. By default, the Dockerfile exposes port 7600 for integration server administration, and port 7800 for integration server HTTP traffic. This means that you can run with the -P flag to auto-map these ports to ports on your host. Alternatively, you can use -p to expose and map any ports of your choice.
      For example, the following command runs a container that creates and starts an integration server, and exposes ports 7600 and 7800 on random ports on the host machine:
      docker run --name myAce -e LICENSE=accept -P ace:11.0.0.0
      You can now use the following command to see which ports have been mapped, and then connect to the web user interface for the integration server in the usual way:
      docker port <container name>
  3. Verify that your container is running correctly, by completing the following steps:
    1. Run the container, ensuring that you expose port 7600 to the host. Check that the container started with no errors.
    2. Connect a browser to your host on the port that you exposed in step 1. The IBM App Connect Enterprise web user interface is displayed.

bz91340_.htm | Last updated 2018-11-02 14:46:39