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 will need a folder in Yandex.Cloud. If you don't have any folders yet, create a new folder before creating a registry:

  1. Click Create folder in the Home page of the management console.

  2. Enter the folder name.

    The name must be unique within the folder. 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. The maximum length of the name is 63 characters.

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

  4. Click Create folder.

You will 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. Log in to Container Registry by running the docker login command with an OAuth token. You can get a token at this link.

    $ docker login \
    --username oauth \ # type of token used
    --password <OAuth token> \
    cr.yandex
    
  3. Pull a Docker image from the Docker Hub repository:

    $ docker pull ubuntu
    
  4. Assign a tag to the Docker image:

    $ docker tag <image ID> \
    cr.yandex/crpc9qeoft236r8tfalm/ubuntu:hello
    
  5. Push the Docker image to the repository:

    $ docker push \
    cr.yandex/crpc9qeoft236r8tfalm/ubuntu:hello
    
  6. Run the Docker image:

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

See also