Obtaining the IBM App Connect Enterprise server image from the IBM Cloud Container Registry

You can obtain the IBM® App Connect server Docker image from the IBM Cloud Container Registry to extend it and add extra capability. These images are designed to be used only with the IBM App Connect Operator. Separate images are available for IBM App Connect Enterprise and IBM App Connect Enterprise for Developers.

If you are looking to deploy IBM App Connect Enterprise in your own containerized deployment, see Building a sample IBM App Connect Enterprise image using Docker in the IBM App Connect Enterprise documentation.


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:

  1. Obtain an IBM entitlement key from the following location: https://myibm.ibm.com/products-services/containerlibrary.
  2. 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.

  3. 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
    12.0.4.0-r2 cp.icr.io/cp/appc/ace-server-prod@sha256:7eb8483de45c1634d09e24521b9d2f89a9e4d0c9b89a1a5d52cc4fd37a091234
    12.0.4.0-r1 cp.icr.io/cp/appc/ace-server-prod@sha256:2b8be27ffa0106c66d7bab819a8043bb7e01a7d049ede0df8439f9d42d799685
    12.0.3.0-r2 cp.icr.io/cp/appc/ace-server-prod@sha256:dd92acece159fa682256b41d009f2bc05c25090ddf18be0e9ac63a09b3b0b666
    12.0.3.0-r1 cp.icr.io/cp/appc/ace-server-prod@sha256:f9b2b5e385f462d60a3fedf2aa7366b3bc304e971c89fafe6425cf2949a472c6
    12.0.2.0-r2 cp.icr.io/cp/appc/ace-server-prod@sha256:f31b9adcfd4a77ba8c62b92c6f34985ef1f2d53e8082f628f170013eaf4c9003
    12.0.2.0-r1 cp.icr.io/cp/appc/ace-server-prod@sha256:8c7a80be06567e1e535913ba4ea160000b586b1d3ff632cdad92d7aa1ee23bf6
    12.0.1.0-r4 cp.icr.io/cp/appc/ace-server-prod@sha256:f7a74de7e5cd3d1d56cabde1c11b174b1be643f48c3bce63ab5f344495877052
    12.0.1.0-r3 cp.icr.io/cp/appc/ace-server-prod@sha256:eed0750a788047982b3f7ddcf6f6762d46e6c54aca3098dff8ddd25197bcebbc
    12.0.1.0-r2 cp.icr.io/cp/appc/ace-server-prod@sha256:dd1f5112da3b86250efdf66400b29e2fa66a5499bf22068efb2721282513c12d
    12.0.1.0-r1 cp.icr.io/cp/appc/ace-server-prod@sha256:0214e90f08f57574f02b39d847180f7502cc1c17fe93a31829f11f9b8a7794d1
    11.0.0.12-r1 [EOS] cp.icr.io/cp/appc/ace-server-prod@sha256:9ed5edfd8e6d0a9259e5387332b96685ae353bc2f50f13a37787846d5ef7913a
    11.0.0.11-r2 [EOS] cp.icr.io/cp/appc/ace-server-prod@sha256:d04fa579290896a8a9474382be3d2729580e16810beacfad8714e8df88794391
    11.0.0.11-r1 [EOS] cp.icr.io/cp/appc/ace-server-prod@sha256:8598eef24c097e467bfa33499e62fe0dcfbfd817d877bd2347c857870b47b8fa
    11.0.0.17-r2-eus cp.icr.io/cp/appc/ace-server-prod@sha256:0fb5e38fa724c8944ee24b00b792985b72238a25b29ef980cf8c94af72ceb8cc
    11.0.0.17-r1-eus cp.icr.io/cp/appc/ace-server-prod@sha256:bc6243287af7274883e50690bb02eecc9ebc0bbe6338a1213ff2fa39e03f5c23
    11.0.0.16-r1-eus cp.icr.io/cp/appc/ace-server-prod@sha256:9d0a32db3c371753af087f8c715eae9b54516251616b99444c67c3814f4ce9dc
    11.0.0.15-r2-eus cp.icr.io/cp/appc/ace-server-prod@sha256:12c18f534fb755add1c20d6ae71398858022a373376054f434419d4ce9403cba
    11.0.0.15-r1-eus cp.icr.io/cp/appc/ace-server-prod@sha256:c18dfecd10dc7cddfb8eebdfdc4a2d5f97aad5e9344a7176bd758a8027995031
    11.0.0.14-r1-eus cp.icr.io/cp/appc/ace-server-prod@sha256:891841a6a7e6996bd23fb8910972cd73005d2ffb507a1e8adea4319b322536fa
    11.0.0.13-r1-eus cp.icr.io/cp/appc/ace-server-prod@sha256:a51fa639c8235ca1f1af696d7f7616ce31c15f9a4a0991f526c80edff4b0772b
    11.0.0.12-r1-eus cp.icr.io/cp/appc/ace-server-prod@sha256:8372beb29cd95d0d3de1b6587248e9997e69ef13bc77caffd6ca3f7068d7779a
    11.0.0.10-r3-eus cp.icr.io/cp/appc/ace-server-prod@sha256:b218a2daec93b8e4555f58a3fd658c3d7b30893b6bff69ec92f81d946c4d1ab3
    11.0.0.10-r2 [EOS] cp.icr.io/cp/appc/ace-server-prod@sha256:bdeb8b839be9e095bf3c74be8b9f02f54cf6c0a740b8f45f93d01265549d9e83
    11.0.0.10-r1 [EOS] cp.icr.io/cp/appc/ace-server-prod@sha256:dd3c1e8d204b37775b792fc25a0bad4daba4fa35cd5aad996b29b1db63959baf
    11.0.0.9-r3 [EOS] cp.icr.io/cp/appc/ace-server-prod@sha256:8df2fc5e76aa715e2b60a57920202cd000748476558598141a736c1b0eb1f1a3
    11.0.0.9-r2 [EOS] cp.icr.io/cp/appc/ace-server-prod@sha256:04bc376391a00ff1923d9122f93911b0f8e9700c7dda132f24676e383c0283cc
    11.0.0.9-r1 [EOS] cp.icr.io/cp/appc/ace-server-prod@sha256:2771ba69f5871c37979576389f5a2040213b913f4d46bfbcafdabdea808f5bad

          [EOS]  "End of service" or "end of support" (EOS) marks the official withdrawal of technical support for these versions.

  4. 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-server-prod@sha256:2771ba69f5871c37979576389f5a2040213b913f4d46bfbcafdabdea808f5bad

    For additional configuration options, see http://ibm.biz/ot4iaceserver.

Obtaining an IBM App Connect Enterprise for Developers server image

The IBM App Connect Enterprise for Developers server images are freely available, so no login credentials are required for pulling an image.

Procedure

Complete the following steps:

  1. 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
    12.0.4.0-r2 icr.io/appc-dev/ace-server@sha256:a41f7501fe4025d2705bcabf1ad2ff523bcaf9ec263b98054501de1fc0cf5f62
    12.0.4.0-r1 icr.io/appc-dev/ace-server@sha256:6ddc1cbb3437b4a0d75a5a2c6f7210656d2195d28faa0ab6f6ca4ef4f59d973c
    12.0.3.0-r2 icr.io/appc-dev/ace-server@sha256:9825171d021913063cf4f505acc093c83c616e3fea9b2b23ea97d27ebf59ad43
    12.0.3.0-r1 icr.io/appc-dev/ace-server@sha256:9c0ab33cf01233b52e1273e559c1b1daa2f23282430ecd2c48001fc0469132f3
    12.0.2.0-r2 icr.io/appc-dev/ace-server@sha256:9a6e98dba1443e7176c7eb47ed301f6a83ec105124357cd04b37c0c9dcb9d135
    12.0.2.0-r1 icr.io/appc-dev/ace-server@sha256:c58fc5a0975314e6a8e72f2780163af38465e6123e3902c118d8e24e798b7b01
    12.0.1.0-r4 icr.io/appc-dev/ace-server@sha256:3714e2236265a557a78bc743fadd0923e4b78ee6a9f6dc321b6856bf0cd4d5fc
    12.0.1.0-r3 icr.io/appc-dev/ace-server@sha256:0a343dc13136a2ea02fbfdf183eada88c60df254acff9bcf8373484038c93ce9
    12.0.1.0-r2 icr.io/appc-dev/ace-server@sha256:6a008790d40e1c5ef1a2d2e7c4d0db2a1afaa2fc302549e38eb5336e49007e5e
    12.0.1.0-r1 icr.io/appc-dev/ace-server@sha256:59d4e4821ce2483423eba7fbe3b0c291ec25e72581d33498ec4928b0930b8b78
    11.0.0.17-r2-eus icr.io/appc-dev/ace-server@sha256:5c5765a667e514f41f85c7533308ecc79930c71f5a56430f9a5b450635553da0
    11.0.0.17-r1-eus icr.io/appc-dev/ace-server@sha256:9a801836461e25823390fb4ba6b935895f6beb3a6a17d980797dce43e587e8f9
    11.0.0.16-r1-eus icr.io/appc-dev/ace-server@sha256:167b13d9a2817755ef6229c3f604f2bcc9f67aa3652490e116d855cc24e9fc33
    11.0.0.15-r2-eus icr.io/appc-dev/ace-server@sha256:f16c062ce3cf3e48d74387273797dd09885c6abb6789ccf827770e8473e5c391
    11.0.0.15-r1-eus icr.io/appc-dev/ace-server@sha256:dc4dc73cde456f1a95ab09a0dcea19d325613f69d4b296760e0547f37ac36334
    11.0.0.14-r1-eus icr.io/appc-dev/ace-server@sha256:6f35b1193d9ffff705f1f311a957def702096d8c6d6628091bef8cfafd7ad30d
    11.0.0.13-r1-eus icr.io/appc-dev/ace-server@sha256:980a561ba72fcc53f46e909f9f94c521aa66bf11a3e286480c8074d4e8bb40fe
    Tip: If you observe errors when pulling the image, ensure that you are logged out from the Container Registry by running the following command, which should eliminate issues pertaining to stale tokens:
    docker logout icr.io
  2. 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 icr.io/appc-dev/ace-server@sha256:59d4e4821ce2483423eba7fbe3b0c291ec25e72581d33498ec4928b0930b8b78

    For additional configuration options, see http://ibm.biz/ot4iaceserver.