Getting started with Container Registry

Using these instructions, you will create your first registry and try managing Docker images.

Before you start

To create a registry, you'll need a folder in Yandex Cloud. If you don't have any folders yet,
create a new folder:

1. Click Create folder on the cloud page.

2. Enter the folder name. Naming requirements:

   • The length can be from 3 to 63 characters.
   • It may contain lowercase Latin letters, numbers, and hyphens.
   • The first character must be a letter. The last character can't be a hyphen.

3. (Optional) Enter a description of the folder.

4. Select the Create a default network option. A network is created with subnets in each availability zone. A default security group, where all network traffic is allowed inside, will also be created in this network.

5. Click Create.

You will also need the Yandex Cloud CLI and Docker.

Creating a registry and performing basic operations on Docker images

1. Create a registry in Container Registry:

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

   Result:

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

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

2. 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.

      The /home/<user>/.docker/config.json configuration file must include the following line:

      "cr.yandex": "yc"
      

3. Pull a Docker image from Docker Hub:

   docker pull ubuntu
   

4. Assign the pulled Docker image a tag in the following format: cr.yandex/<registry ID>/<Docker image name>:<tag>:

   docker tag ubuntu \
   cr.yandex/crpc9qeoft236r8tfalm/ubuntu:hello
   

5. Push the Docker image to the repository Container Registry:

   docker push \
   cr.yandex/crpc9qeoft236r8tfalm/ubuntu:hello
   

6. Run the Docker image:

   docker run \
   cr.yandex/crpc9qeoft236r8tfalm/ubuntu:hello
   

See also

• Creating a registry.
• Authentication in Container Registry.
• Creating a Docker image.
• Pushing a Docker image.
• Pulling a Docker image.
• Running a Docker image on a VM.