{"type":"doc","content":[{"type":"paragraph","content":[{"text":"For offline/air-gapped environments, the DPOD Cloud Agent images are available via the Cloud Agent Images Tool.","type":"text"}]},{"type":"paragraph","content":[{"text":"Once the tool is obtained, it allows uploading the images to a private registry, making them available for the installation in the k8s cluster.","type":"text"}]},{"type":"paragraph","content":[{"text":"The tool is using ","type":"text"},{"text":"skopeo","type":"text","marks":[{"type":"code"}]},{"text":" internally for uploading the images while preserving their digests. See the ","type":"text"},{"text":"skopeo documentation","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/containers/skopeo/blob/main/docs/skopeo-copy.1.md"}}]},{"text":" for more details on the parameters that may be used during the upload.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Prerequisites","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Access to a Linux system command line.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"docker","type":"text","marks":[{"type":"code"}]},{"text":" or ","type":"text"},{"text":"podman","type":"text","marks":[{"type":"code"}]},{"text":" installed.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"(Optional) OpenShift command line (","type":"text"},{"text":"oc","type":"text","marks":[{"type":"code"}]},{"text":") - required to deploy the images directly to OpenShift’s internal image registry.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Obtain the Tool","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Download the tool file and its md5 checksum file from ","type":"text"},{"text":"IBM Fix Central","type":"text","marks":[{"type":"link","attrs":{"href":"https://www.ibm.com/support/fixcentral/swg/selectFixes?parent=ibm%7EWebSphere&product=ibm/WebSphere/WebSphere+DataPower+SOA+Appliances&release=All&platform=All&function=textSearch&text=datapower+operations+dashboard"}}]},{"text":" (file name is ","type":"text"},{"text":"DPOD-CA-images-tool-.tar.gz","type":"text","marks":[{"type":"code"}]},{"text":").","type":"text"},{"type":"hardBreak"},{"text":"Verify the tar file integrity by calculating its md5 checksum and comparing it to the downloaded md5 checksum file.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The tool is packaged as a Docker image (","type":"text"},{"text":"tar.gz","type":"text","marks":[{"type":"code"}]},{"text":") file.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Deploy the DPOD Cloud Agent Images","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Copy the tool file to any directory on the Linux machine you’re using.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create a directory for the tool’s log files (e.g. ","type":"text"},{"text":"/logs/dpod-cloud-agent-images-tool","type":"text","marks":[{"type":"code"}]},{"text":").","type":"text"}]},{"type":"codeBlock","content":[{"text":"mkdir -p /logs/dpod-cloud-agent-images-tool","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Obtain the private registry host, port and URI.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Obtain the credentials for authenticating to the private registry.","type":"text"},{"type":"hardBreak"},{"text":"The credentials should be provided using ","type":"text"},{"text":"skopeo","type":"text","marks":[{"type":"code"}]},{"text":" parameters, such as ","type":"text"},{"text":"--dest-creds","type":"text","marks":[{"type":"code"}]},{"text":" (for basic authentication) or ","type":"text"},{"text":"--dest-registry-token","type":"text","marks":[{"type":"code"}]},{"text":" (for bearer token).","type":"text"},{"type":"hardBreak"},{"text":"See the ","type":"text"},{"text":"skopeo documentation","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/containers/skopeo/blob/main/docs/skopeo-copy.1.md"}}]},{"text":" for more details.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Additional ","type":"text"},{"text":"skopeo","type":"text","marks":[{"type":"code"}]},{"text":" parameters may be provided, such as ","type":"text"},{"text":"--dest-tls-verify=false","type":"text","marks":[{"type":"code"}]},{"text":" for disabling certificates verification.","type":"text"},{"type":"hardBreak"},{"text":"See the ","type":"text"},{"text":"skopeo documentation","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/containers/skopeo/blob/main/docs/skopeo-copy.1.md"}}]},{"text":" for more details.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Run the tool using the following commands:","type":"text"},{"type":"hardBreak"},{"text":"Replace the ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" placeholders before running the commands.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"CA_IMAGES_TOOL_FILE_PATH=\"\"\nCA_IMAGES_TOOL_LOGS_PATH=\"\"\nCA_IMAGES_TOOL_REGISTRY_HOST=\"\"\nCA_IMAGES_TOOL_REGISTRY_PORT=\"\"\nCA_IMAGES_TOOL_REGISTRY_URI=\"\"\nCA_IMAGES_TOOL_ADDITIONAL_PARAMS=\"\"\n\nCA_IMAGES_TOOL_NAME_AND_TAG=\"$(docker load <${CA_IMAGES_TOOL_FILE_PATH} | grep -oP \"Loaded image: \\K.*\")\"\ndocker run -it -u \"$(id -u):$(id -g)\" \\\n --name \"dpod-cloud-agent-images-tool\" \\\n -v \"/etc/localtime:/etc/localtime:ro\" \\\n -v \"${CA_IMAGES_TOOL_LOGS_PATH}:/logs:rw\" \\\n -e CA_IMAGES_TOOL_REGISTRY_PATH=\"${CA_IMAGES_TOOL_REGISTRY_HOST}:${CA_IMAGES_TOOL_REGISTRY_PORT}/${CA_IMAGES_TOOL_REGISTRY_URI}\" \\\n -e CA_IMAGES_TOOL_ADDITIONAL_PARAMS=\"${CA_IMAGES_TOOL_ADDITIONAL_PARAMS}\" \\\n --add-host \"${CA_IMAGES_TOOL_REGISTRY_HOST}:$(getent hosts ${CA_IMAGES_TOOL_REGISTRY_HOST} | head -1 | awk '{print $1}')\" \\\n\t\"${CA_IMAGES_TOOL_NAME_AND_TAG}\" \\\n /bin/bash -c \"/opt/imagesTool.sh -a upload -r \\\"\\${CA_IMAGES_TOOL_REGISTRY_PATH}\\\" -p \\\"\\${CA_IMAGES_TOOL_ADDITIONAL_PARAMS}\\\"\"\ndocker rm -f dpod-cloud-agent-images-tool","type":"text"}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Examples of Parameters","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Deploying Images to a Private Registry","type":"text"}]},{"type":"paragraph","content":[{"text":"Use the following parameters to deploy the images to a private registry using bearer token authentication:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"CA_IMAGES_TOOL_FILE_PATH=\"/path/to/DPOD-CA-images-tool-1.0.23.0.tar.gz\"\nCA_IMAGES_TOOL_LOGS_PATH=\"/logs/dpod-cloud-agent-images-tool\"\nCA_IMAGES_TOOL_REGISTRY_HOST=\"my-registry.example.com\"\nCA_IMAGES_TOOL_REGISTRY_PORT=\"443\"\nCA_IMAGES_TOOL_REGISTRY_URI=\"dpod/cloud-agent\"\nCA_IMAGES_TOOL_ADDITIONAL_PARAMS=\"--dest-registry-token=a6921bf9-2cb6-4f54-949c-bfde0c491272\"","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Deploying Images to OpenShift","type":"text"}]},{"type":"paragraph","content":[{"text":"Use the following parameters to deploy the images to OpenShift’s Internal Registry using basic authentication:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"# Login to OpenShift\noc login -u=... -p=... --server=...\n\nCA_IMAGES_TOOL_FILE_PATH=\"/path/to/DPOD-CA-images-tool-1.0.23.0.tar.gz\"\nCA_IMAGES_TOOL_LOGS_PATH=\"/logs/dpod-cloud-agent-images-tool\"\nCA_IMAGES_TOOL_REGISTRY_HOST=\"api.openshift.example.com\"\nCA_IMAGES_TOOL_REGISTRY_PORT=\"6443\"\nCA_IMAGES_TOOL_REGISTRY_URI=\"dpod-cloud-agent-ns\"\nCA_IMAGES_TOOL_ADDITIONAL_PARAMS=\"--dest-creds=$(oc whoami):$(oc whoami -t)\"","type":"text"}]},{"type":"paragraph"}],"version":1}

Browser not supported