IBM Entitled Registry entitlement keys

To pull IBM® App Connect images from the IBM Entitled Registry, you must supply your entitlement key as a Kubernetes pull secret. If you use the secret name ibm-entitlement-key, this secret will automatically be used to pull images from the IBM Entitled Registry.

Obtaining an entitlement key

Procedure

To obtain an entitlement key, complete the following steps:

Log in the IBM Container software library with the IBMid and password that are associated with the entitled software.
Click Get entitlement key.
Copy the generated entitlement key to a safe place for later use.
Optional: Verify the validity of the key by using a container tool such as docker. From a command prompt, log in to the IBM Entitled Registry by running the following command, using cp as the user name, cp.icr.io as the Docker server, and your entitlement key as the password:
```
docker login cp.icr.io --username cp --password myEntitlementKey
```

Adding an entitlement key to a namespace

You can use standard Kubernetes tools to create a pull secret (which contains your entitlement key) in the installation namespace of your IBM App Connect components. You must create the secret in every namespace where you want to install IBM App Connect components.

Procedure

To add an entitlement key to a namespace, complete the following step:

Create a Docker registry secret by running the following command, with ibm-entitlement-key as the secret name, cp as the user name, your entitlement key as the password, and your required target namespace:

oc create secret docker-registry ibm-entitlement-key \
    --docker-username=cp \
    --docker-password=myEntitlementKey \
    --docker-server=cp.icr.io \
    --namespace=myNamespace

You can also use the kubectl tool instead of the oc tool to create the secret.