Getting started with Container Registry

Written by

Updated at September 23, 2024

Use this guide to create your first registry and try managing Docker images.

Getting started

To create a registry, you will need a folder in Yandex Cloud. If you do not have any folders yet, create one before creating a registry:

In the management console, select the appropriate cloud in the list on the left.
At the top right, click Create folder.
Enter the folder name. The naming requirements are as follows:
- The name must be from 3 to 63 characters long.
- It may contain lowercase Latin letters, numbers, and hyphens.
- The first character must be a letter and the last character cannot be a hyphen.
(Optional) Enter a description of the folder.
Select Create a default network. This will create a network with subnets in each availability zone. Within this network, a default security group will be created, inside which all network traffic is allowed.
Click Create.

To work with Container Registry and Docker images, install the Yandex Cloud CLI and configure Docker.

Create a registry in Container Registry:

yc container registry create --name my-first-registry

Result:

..done
id: crpc9qeoft23********
folder_id: b1g0itj57rbj********
name: my-first-registry
status: ACTIVE
created_at: "2018-12-25T12:24:56.286Z"

You will use the received ID to access the created registry later.

Authenticate in Container Registry using Docker Credential helper:
1. Configure Docker to use docker-credential-yc:
```
yc container registry configure-docker
```
  Result:
```
Credential helper is configured in '/home/<user>/.docker/config.json'
```
  During setup, information about the current user profile is saved.
2. Make sure that Docker is configured.
  
  In the /home/<user>/.docker/config.json configuration file, you should see the following line:
```
"cr.yandex": "yc"
```
Pull a Docker image from Docker Hub:
```
docker pull ubuntu
```
Assign the pulled Docker image a tag in this format: cr.yandex/<registry_ID>/<Docker_image_name>:<tag>:
```
docker tag ubuntu \
cr.yandex/<registry_ID>/ubuntu:hello
```
Push the Docker image to the repository Container Registry:
```
docker push \
cr.yandex/<registry_ID>/ubuntu:hello
```

Run the Docker image:

docker run \
cr.yandex/<registry_ID>/ubuntu:hello