Get started
Yandex Container Registry

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 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: