Versions Compared

Version Old Version 5 New Version 6
Changes made by

Shachar Greenberg

Amit Munwes

Saved on

Key

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

...

The DataPower Operations Dashboard Cloud Agent Operator currently supports installation via OLM in OCP clusters, see Prerequisites for supported versions.

...

  • All namespaces on the cluster: AllNamespaces (aka cluster scope)

  • A specific namespace on the cluster: OwnNamespace (aka namespace scope)

In AllNamespaces mode, the Operator will use a ClusterRole and ClusterRoleBinding and using that will have cluster-wide scope to manage DataPower Operations Dashboard Cloud Agent resources across all namespaces. In OwnNamespace mode, the operator will use a Role and RoleBinding as its primary access (limited to the namespace it's installed in), with a limited set of ClusterRole permissions (see Cluster-scope permissions).

Note

Do not install the Operator in more than one mode. If AllNamespaces is chosen, do not subsequently install a second instance in OwnNamespace mode.

Available Versions

DPOD Version

Cloud Agent Operator Version

1.0.19.0

0.1.0

Loading Images to a Container Registry

DataPower Operations Dashboard Cloud Agent images are currently available for download from PPA (Passport Advantage) and need to be loaded to a container registry.

The container registry can be any external registry accessible to the cluster or the cluster internal registry.

This is a list of the images file name names (as available on PPA) and the images name names:

Image file File Name

Image Name and Tag

dpod-ca-operator-catalog-1.0.19.0<VERSION>.tgz

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

dpod-ca-operator-bundle-1.0.19.0.<VERSION>.tgz

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

dpod-ca-operator-1.0.19.0<VERSION>.tgz

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

dpod-ca-api-proxy-1.0.19.0<VERSION>.tgz

dpod-cloud-agent-api-proxy:1.0.19.0<OPERAND-VERSION>-amd64

dpod-ca-http-ingester-1.0.19.0<VERSION>.tgz

dpod-cloud-agent-http-ingester:1.0.19.0<OPERAND-VERSION>-amd64

dpod-ca-manager-1.0.19.0<VERSION>.tgz

dpod-cloud-agent-manager:1.0.19.0<OPERAND-VERSION>-amd64

dpod-ca-messaging-broker-1.0.19.0<VERSION>.tgz

dpod-cloud-agent-messaging-broker:1.0.19.0:<OPERAND-VERSION>-amd64

dpod-ca-syslog-ingester-1.0.19.0<VERSION>.tgz

dpod-cloud-agent-syslog-ingester:1.0.19.0<OPERAND-VERSION>-amd64

In order to preserve the images digest we recommend using skopeo utility (available as a package for most distributions: installing Installing Skopeo).

The skopeo syntax is as follows:

Code Block
skopeo copy --all --dest-creds=<destination container registry credentials if needed> docker-archive:<image file full path> \
    docker://<destination container registry path>/<image name>:<image tag>

Example Consider the following example for loading the images to the OCP internal container registry:

  1. Set variables with the source, destination, versions, etc.:

    Code Block
    DPOD_CLOUD_AGENT_NAMESPACE="integration"
CONTAINER_REGISTRY_EXTERNAL_URL="default-route-openshift-image-registry.apps.ocp10.mycluster.com"
CONTAINER_REGISTRY_INTERNAL_URL="image-registry.openshift-image-registry.apps.ocp10.mycluster.com"
DPOD_CLOUD_AGENT_IMAGE_TAG="1.0.19.0-amd64"
DPOD_CLOUD_AGENT_OPERATOR_IMAGE_TAG="0.1.0-amd64"
IMAGES_DIR="/tmp"

  2. Load the operator catalog and bundle images to openshift-marketplace namespace:

    Code Block
    skopeo copy --all --dest-creds=admin:$(oc whoami -t) docker-archive:${IMAGES_DIR}/dpod-ca-operator-catalog-1.0.19.0.tgz \
    docker://${CONTAINER_REGISTRY_EXTERNAL_URL}/openshift-marketplace/dpod-cloud-agent-operator-catalog:${DPOD_CLOUD_AGENT_OPERATOR_IMAGE_TAG}
	
skopeo copy --all --dest-creds=admin:$(oc whoami -t) docker-archive:${IMAGES_DIR}/dpod-ca-operator-bundle-1.0.19.0.tgz \
    docker://${CONTAINER_REGISTRY_EXTERNAL_URL}/openshift-marketplace/dpod-cloud-agent-operator-bundle:${DPOD_CLOUD_AGENT_OPERATOR_IMAGE_TAG}

  3. Load operator image to DataPower Operations Dashboard Cloud Agent namespace (for namespace scope deployment) or to openshift-operators namespace (for cluster scope deployment):

    Code Block
    # if Installation Mode is "AllNamespaces" (cluster scope) use : openshift-operators
# if Installation Mode is "OwnNamespace" (Namespace scope) use : ${DPOD_CLOUD_AGENT_NAMESPACE}
DPOD_CLOUD_AGENT_OPERATOR_NAMESPACE=${DPOD_CLOUD_AGENT_NAMESPACE}

skopeo copy --all --dest-creds=admin:$(oc whoami -t) docker-archive:${IMAGES_DIR}/dpod-ca-operator-1.0.19.0.tgz \
    docker://${CONTAINER_REGISTRY_EXTERNAL_URL}/${DPOD_CLOUD_AGENT_OPERATOR_NAMESPACE}/dpod-cloud-agent-operator:${DPOD_CLOUD_AGENT_OPERATOR_IMAGE_TAG}

  4. Load application images to DataPower Operations Dashboard Cloud Agent namespace:

    Code Block
    skopeo copy --all --dest-creds=admin:$(oc whoami -t) docker-archive:${IMAGES_DIR}/dpod-ca-api-proxy-1.0.19.0.tgz \
    docker://${CONTAINER_REGISTRY_EXTERNAL_URL}/${DPOD_CLOUD_AGENT_NAMESPACE}/dpod-cloud-agent-api-proxy:${DPOD_CLOUD_AGENT_IMAGE_TAG}

skopeo copy --all --dest-creds=admin:$(oc whoami -t) docker-archive:${IMAGES_DIR}/dpod-ca-http-ingester-1.0.19.0.tgz \
    docker://${CONTAINER_REGISTRY_EXTERNAL_URL}/${DPOD_CLOUD_AGENT_NAMESPACE}/dpod-cloud-agent-http-ingester:${DPOD_CLOUD_AGENT_IMAGE_TAG}

skopeo copy --all --dest-creds=admin:$(oc whoami -t) docker-archive:${IMAGES_DIR}/dpod-ca-manager-1.0.19.0.tgz \
    docker://${CONTAINER_REGISTRY_EXTERNAL_URL}/${DPOD_CLOUD_AGENT_NAMESPACE}/dpod-cloud-agent-manager:${DPOD_CLOUD_AGENT_IMAGE_TAG}

skopeo copy --all --dest-creds=admin:$(oc whoami -t) docker-archive:${IMAGES_DIR}/dpod-ca-messaging-broker-1.0.19.0.tgz \
    docker://${CONTAINER_REGISTRY_EXTERNAL_URL}/${DPOD_CLOUD_AGENT_NAMESPACE}/dpod-cloud-agent-messaging-broker:${DPOD_CLOUD_AGENT_IMAGE_TAG}

skopeo copy --all --dest-creds=admin:$(oc whoami -t) docker-archive:${IMAGES_DIR}/dpod-ca-syslog-ingester-1.0.19.0.tgz \
    docker://${CONTAINER_REGISTRY_EXTERNAL_URL}/${DPOD_CLOUD_AGENT_NAMESPACE}/dpod-cloud-agent-syslog-ingester:${DPOD_CLOUD_AGENT_IMAGE_TAG}

Creating / Updating ImageContentSourcePolicy

...