Pulling and pushing the Universal Connector container image

(BMC.DB2.SPE2404)

This topic describes how to pull and push the Universal Connector container image.

Image pulling is the process of downloading a container image from a container registry to a local system or environment. Image pushing is the process of uploading a container image from a local system or environment to a container registry.

Before you begin

Perform the procedures described in the following topics:

Downloading the BMC AMI SQL Assurance installation files
If you use a private container registry to maintain your images, then see the applicable topic:

For more information, view the Quick Course BMC AMI SQL Assurance for Db2 - Pull and push process for the Universal Connector container image.

To pull the container image

Edit existing file or create a file, container-token.bmc, in your Linux virtual machine, and paste the container token you generated in distribution.bmc.com into the file.
After you have extracted the zip file, BMC-AMI-SQL-Assurance-V13.1-for-Db2-UC, expand the BMC AMI SQL Assurance Version 13.1.00 for Db2 - UC folder.
Copy the download-sa-image.sh file into the same directory where your container-token.bmc file resides on your Linux virtual machine.
Make the bash script file executable by using this command:
chmod +x download-sa-image.sh
The bash script, download-sa-image.sh, is used to pull the Universal Connector container image from distribution.bmc.com.
Run the bash script by providing your registered email ID as an input argument, for example:
./download-sa-image.sh yourRegisteredEmailID
Warning
Important
You may access the containers for your licensed products by using your registered email ID associated with your BMC Support account.

To push the container image to a container registry

After manually pulling the image using the script, tag the image with the container registry host name by using the following command:
docker tag bmcImageTag newTag
Replace the variables in the command as they apply to your environment:

Variable	Description
bmcImageTag	BMC image tag in the download image script and pulled from the distribution.bmc.com container registry.
newTag	Container registry hostname to which to push the image. Confirm the new image name with your container registry administrator.

Run the following command, with variable replaced for your environment, to push the newly tagged image to your container registry:
docker push newTag
Warning
Important
If the container registry is private, you must push the docker login to the container registry before pushing the image. In this case, you must run the docker login command by using the user ID, password, or token of a registered user in the container registry and the host name of the container registry server. Consult with your container registry administrator regarding docker login.

Where to go from here

Based on your CI/CD tool, see: