Getting Started

last updated: 2024-10-18

Welcome to the DowntoZero Cloud OCI-compliant container registry! This guide will help you get started with pushing and pulling container images using our registry.

Prerequisites

Before you begin, ensure you have the following:

Step 1: Create an Account

If you don’t have an account yet, follow these steps:

  1. Visit DowntoZero Cloud
  2. Click on Sign Up
  3. Fill in the required information

Step 2: Generate an API Key

To securely interact with the registry, you’ll need to generate an API key:

  1. Log in to your DowntoZero Cloud
  2. Navigate to Identity Service
  3. Click on New to create a new Authentication
  4. Provide a name for the token (e.g., “Docker Registry Access”)
  5. Set the appropriate permissions for the token
  6. Click Create Token
  7. Copy the generated token and store it securely (you won’t be able to view it again)

Step 3: Log In to the Registry

Use your API Key to log in to the registry:

echo "<your-api-key>" | docker login cr.dtz.rocks -u apikey --password-stdin

Step 4: Tag Your Image

Tag your local Docker image to match the registry format:

docker tag cr.dtz.rocks/:

•	<local-image>: The name of your local image
•	<image-name>: Desired image name in the registry
•	<tag>: Image tag (optional, defaults to latest)

Example:

docker tag my-app cr.dtz.rocks/my-app:latest

Step 5: Push the Image

Push the tagged image to the registry:

docker push cr.dtz.rocks/<image-name>:<tag>

Example:

docker push cr.dtz.rocks/my-app:latest

Step 6: Pull the Image

You or others can now pull the image from the registry:

docker pull cr.dtz.rocks/<image-name>:<tag>

Example:

docker pull cr.dtz.rocks/my-app:latest