Push & Pull Images

This guide explains how to build, tag, push, and pull container images using CloudRaya Container Registry with standard Docker workflows.

CloudRaya Container Registry is fully compatible with the Docker Registry New panel API, allowing you to use familiar Docker commands without modification.

Prerequisites

Before you begin, ensure that:

• A Container Registry has been created in CloudRaya
• You have:
  • Registry endpoint
  • Registry username
  • Registry password
• Docker is installed on your machine

Verify Docker installation:

docker version

Registry Naming Convention

Images stored in CloudRaya Container Registry follow this format:

<registry-endpoint>/<repository>:<tag>

Example:

registry.cloudraya.com/my-app:v1.0.0

Step 1: Authenticate to the Registry

Log in to your registry using Docker:

docker login <registry-endpoint>

Example:

docker login registry.cloudraya.com

You will be prompted for:

• Username (registry name)
• Password

Successful login confirms access to the registry.

Step 2: Build a Docker Image

Build your application image locally.

docker build -t my-app .

This creates a local image named my-app.

Step 3: Tag the Image for CloudRaya Registry

Tag the image using your registry endpoint.

docker tag my-app:latest \
  <registry-endpoint>/my-app:latest

Example:

docker tag my-app:latest \
  registry.cloudraya.com/my-app:latest

Tagging prepares the image for upload.

Step 4: Push Image to CloudRaya Registry

Push the tagged image to the registry.

docker push <registry-endpoint>/my-app:latest

Example:

docker push registry.cloudraya.com/my-app:latest

Docker will upload all image layers and metadata.

Step 5: Verify Image Availability

Once pushed, the image becomes available for:

• Kubernetes deployments
• VM-based Docker workloads
• CI/CD pipelines
• External systems with registry access

Pulling Images from the Registry

To pull an image from CloudRaya Container Registry:

docker pull <registry-endpoint>/my-app:latest

Example:

docker pull registry.cloudraya.com/my-app:latest

This requires valid registry authentication.

Working with Image Tags

Tags help manage versions and deployments.

Recommended tagging strategies:

• v1.0.0, v1.1.0 — semantic versions
• staging, production
• Git commit SHA (for CI/CD)

Example:

docker tag my-app:latest \
  registry.cloudraya.com/my-app:v1.2.0

Deleting Images

Image deletion is handled at the registry management level.

Deleting a registry will remove all images stored inside it.

Common Errors & Troubleshooting

Unauthorized / Access Denied

• Ensure you are logged in
• Verify registry endpoint
• Check credentials

docker logout <registry-endpoint>
docker login <registry-endpoint>

Image Not Found

• Confirm repository name
• Confirm tag exists
• Check spelling and casing

Push Fails Midway

• Check available registry storage
• Verify network connectivity
• Retry the push

Best Practices

• Use private registries for production images
• Tag images explicitly (avoid latest in production)
• Rotate registry credentials periodically
• Use CI/CD pipelines for automated builds
• Clean up unused images to manage storage usage

Typical Workflows

Local Development

Build → Tag → Push → Deploy

CI/CD Pipeline

Build → Tag → Push → Deploy to Kubernetes

Kubernetes Deployment

Registry → imagePullSecret → Pod

Related Guides

📄 Access & Authentication

📄 Integrate with Kubernetes (KubeRaya)

📄 Manage Registry

📄 Container Registry Best Practices