Getting started with Container Registry
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.
Creating a registry and performing basic operations on Docker images
-
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:
-
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.
-
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