Getting started with Container Registry

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

Before you startBefore you start

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

1. In the management console, select a cloud and click Create folder at the top right.

2. Enter the folder name. The naming requirements are as follows:

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

5. Click Create.

You will also need the Nebius Israel CLI and Docker.

Creating a registry and performing basic operations on Docker imagesCreating 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.il.nebius.cloud": "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.il.nebius.cloud/<registry ID>/<Docker image name>:<tag>:

   docker tag ubuntu \
   cr.il.nebius.cloud/crpc9qeoft236r8tfalm/ubuntu:hello
   

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

   docker push \
   cr.il.nebius.cloud/crpc9qeoft236r8tfalm/ubuntu:hello
   

6. Run the Docker image:

   docker run \
   cr.il.nebius.cloud/crpc9qeoft236r8tfalm/ubuntu:hello
   

See alsoSee 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.