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:
- Docker installed on your machine. Download Docker
- An active account on DowntoZero Cloud
- Enable the Container Registry Service
- Generate API Key for registry authentication - Getting an API Key
Step 1: Create an Account
If you don’t have an account yet, follow these steps:
- Visit DowntoZero Cloud
- Click on Sign Up
- 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:
- Log in to your DowntoZero Cloud
- Navigate to Identity Service
- Click on New to create a new Authentication
- Provide a name for the token (e.g., “Docker Registry Access”)
- Set the appropriate permissions for the token
- Click Create Token
- 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
• <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