Push and pull container images
Publish a local image and retrieve it by tag or digest.
Before you begin
Install Docker, prepare a local image, and authenticate to the registry. Select the correct RDC Cloud project and copy the registry address displayed on Artifact Registry.
In the examples below, REGISTRY_ADDRESS includes the project path, while REGISTRY_HOST used for login does not. Replace placeholders before running commands.
Push an image
- Tag a local image with the destination repository and version:
docker tag my-image:latest REGISTRY_ADDRESS/my-image:v1- Push the tagged image:
docker push REGISTRY_ADDRESS/my-image:v1- Return to Artifact Registry, select Refresh, and open the repository. Verify the tag, digest, size, and push time.
Use the repository pagination controls if you do not see the expected repository or version. A push can fail even after login if you lack write access to the project path.
Pull an image
Pull a tagged image with:
docker pull REGISTRY_ADDRESS/my-image:v1For a specific immutable image version, copy its digest-qualified reference from the Console and use that complete reference as the argument to docker pull. Do not construct a digest from the tag name.
Next steps
Deploy the image through Container Engine.