Get started
Yandex Container Registry

Getting started with Container Registry

Written by

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 in the Home page of the management console.

  2. Enter the folder name.

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

  3. Select Create a default network. A network is created with subnets in each availability zone.

  4. Click Create.

You'll also need the Yandex 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
..done
id: crpc9qeoft236r8tfalm
folder_id: b1g0itj57rbjk9thrinv
name: my-first-registry
status: ACTIVE
created_at: "2018-12-25T12:24:56.286Z"

    You will need the received id to access the created registry.

  2. Authenticate in Container Registry using a Docker Credential helper:

    1. Configure Docker to use docker-credential-yc:

      yc container registry configure-docker
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 file must contain the following line:

      "cr.yandex": "yc"

  3. Pull a Docker image from the Docker Hub repository:

    docker pull ubuntu

  4. Assign a tag like cr.yandex/<registry ID>/<Docker image name>:<tag> to the Docker image pulled:

    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

In this article: