/
Getting access to images from the public IBM Entitled Registry

IBM DataPower Operations Dashboard v1.0.21.x

A newer version of this product documentation is available.

You are viewing an older version. View latest at IBM DPOD Documentation.

Getting access to images from the public IBM Entitled Registry

Owned by Shachar Greenberg
Last updated: Jul 23, 2024
2 min read

The IBM Entitled Registry contains software images for the IBM DPOD Cloud Agent instance. To allow the IBM DPOD Cloud Agent Operator to automatically pull those software images, you must first obtain your entitlement key, then add your entitlement key in a pull secret.

Finally use the pull secret within the IBM DPOC Cloud Agent CR

Obtaining your entitlement key

  1. Go to the Container software library.

  2. Click Copy key.

  3. Copy the entitlement key to a safe place so you can use it when you add the pull secret in the next section.

  4. (Optional) Verify the validity of the key by logging in to the IBM Entitled Registry by using a container tool.

    docker login cp.icr.io --username cp --password entitlement_key

Creating the Secret

If you want to create your own Entitlement Key as a Secret, you must create it in the same namespace as the IBM DPOD Cloud Agent instance.

  1. We recommend that you use the name ibm-entitlement-key

  2. Use cp as the username

  3. Use your Entitlement Key as the password

  4. Use cp.icr.io as the Docker server

Adding a pull secret to a namespace using the CLI

You must be a namespace administrator to perform this task.

Create a docker registry secret named ibm-entitlement-key, using the following command. In the third line, replace entitlement_key with the value of your entitlement key from the previous section. In the last line, replace target_namespace with the name of your target namespace:

oc create secret docker-registry \ ibm-entitlement-key \ --docker-username=cp \ --docker-password=<entitlement-key> \ --docker-server=cp.icr.io \ --namespace=target_namespace

For more information on creating Secrets using the Kubernetes command line, please see their documentation.

Adding the pull secret to a namespace by using the OpenShift web console

You must be a namespace administrator to perform this task. For more information, see OpenShift Roles and permissions.

  1. Log in to the OpenShift web console and select the Administrator perspective (if not selected by default).

  2. In the left navigation, click Workloads > Secrets.

  3. Ensure that the Project is set to the namespace where you intend to install instances.

  4. Click Create and select Image pull secret.

  5. Set the following parameters for the secret:

Parameter

Value

Parameter

Value

Secret name

ibm-entitlement-key

Authentication type

Image registry credentials

Registry server address

cp.icr.io

Username

cp

Password

Value of the entitlement key you copied when you got your entitlement key.

Email

(Optional value)

  1. Click Create to create the secret.

 

Copyright © 2015 MonTier Software (2015) Ltd.