In this page:

The IBM Entitled Registry (cp.icr.io/cp) contains the software images of the DPOD Cloud Agent application. To allow the DPOD Cloud Agent Operator to automatically pull those software images, you must first obtain your entitlement key, create a pull secret with your entitlement key, and use the pull secret within the DPOD Cloud Agent CR.

Obtaining your Entitlement Key

1. Navigate to the Container software library.

2. Click Copy to copy the key.

3. Keep the entitlement key in a safe place, so you can use it to 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 executing the following command:

   Code Block
   docker login cp.icr.io --username cp --password <YOUR_ENTITLEMENT_KEY>

Creating the Pull Secret

You must be a namespace administrator to perform this task.

Create a pull secret in the same namespace as the DPOD Cloud Agent instance (CR):

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 registry server address.

Creating the Pull Secret using the CLI

The pull secret can be created with the following command in OCP. Replace <YOUR_ENTITLEMENT_KEY> with your entitlement key and <TARGET_NAMESPACE> with the DPOD Cloud Agent instance namespace.

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

For more information on creating secrets using the Kubernetes command line, please see the k8s documentation.

Creating the Pull Secret using the OpenShift Web Console

1. Log in to the OpenShift web console and select the Administrator perspective.

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:

6. Click Create to create the secret.

Using the Pull Secret within the DPOD Cloud Agent CR

Each image of the DPOD Cloud Agent can be configured with a pull secret with the imagePullSecrets property.

See Cloud Agent Operand Installation for more details.