Versions Compared

Key

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

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.

Image Pull Secret

If Finally use the pull secret within the IBM DPOD Cloud Agent images are to be pulled from the IBM Entitled Registry, an Entitlement Key must be used as an Image Pull Secret. 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.

    Code Block
    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.

...

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. Click Create to create the secret.

images are available on the following container registries:

...

Operator images (Catalog, bundle and Operator) : icr.io/dpod

...

  1. .

...

On the current version a mirroring from icr.io/cpopenicr.io/dpod is required.

Without a proper mirroring, the pods will fail on ImagePullBackOff error when trying to pull the images.

See Cloud Agent Overview for a list of available versions.

...

Image Name and Tag

...

dpod-cloud-agent-operator-catalog:<OPERATOR-VERSION>-amd64

...

dpod-cloud-agent-operator-bundle:<OPERATOR-VERSION>-amd64

...

dpod-cloud-agent-operator:<OPERATOR-VERSION>-amd64

...

dpod-cloud-agent-api-proxy:<DPOD-VERSION>-amd64

...

dpod-cloud-agent-http-ingester:<DPOD-VERSION>-amd64

...

dpod-cloud-agent-manager:<DPOD-VERSION>-amd64

...

dpod-cloud-agent-messaging-broker:<DPOD-VERSION>-amd64

...

dpod-cloud-agent-syslog-ingester:<DPOD-VERSION>-amd64

Choose the Appropriate Procedure

The procedure for mirroring the Cloud Agent images varies, depending on the flavor of Kubernetes in you environment:

...

A private container registry

...

RedHat OpenShift Container Platform
(OCP)

...

Follow OCP

...

Other Kuberenetes flavors
(e.g.: AWS EKS, Azure AKS)

...