Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

In this page:

Table of Contents
minLevel1
maxLevel1
outlinefalse
styledisc
typelist
printabletrue

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

Obtaining your

...

Entitlement Key

  1. Go Navigate to the Container software library.

  2. Click Copy to copy the key.

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

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

Creating the Pull Secret

If you want to create your own Entitlement Key as a Secret, you must create it You must be a namespace administrator to perform this task.

Create a pull secret in the same namespace as the IBM 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 entitlement key as the password.

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

...

  1. address.

Creating the Pull Secret using the CLI

You must be a namespace administrator to perform this task.

Create a docker registry secret named ibm-entitlement-key, using The pull secret can be created with 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:in OCP. Replace <YOUR_ENTITLEMENT_KEY> with your entitlement key and <TARGET_NAMESPACE> with the DPOD Cloud Agent instance namespace.

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

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

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

...

Creating the Pull Secret using the OpenShift Web Console

  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

Secret name

ibm-entitlement-key

Authentication type

Image registry credentials

Registry server address

cp.icr.io

Username

cp

Password

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

Email

(Optional value)

  1. 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.