Skip to main content
Container Registry: quick start
Last update:

Container Registry: quick start

To start working with images — uploading, downloading, deleting and other operations — you need:

  1. Create Registry — this can be done in the control panel (method described below) or via the Container Registry API.
  2. Get token.
  3. Authorize to Docker CLI.

Create a registry⁠

  1. In Control Panel, go to Cloud Platform → Container Registry.

  2. Press Start work.

  3. Enter the name of the registry. The name of the registry will be part of its URI:

    cr.selcloud.ru/<registry>

  4. Press Create.

Generate token⁠

To configure access to the registries, generate a token. You can select the token expiration date, access rights, and registries to which the token gives access.

  1. In Control Panel, go to Cloud Platform → Container Registry.

  2. Open the Tokens tab.

  3. Click Generate Token.

  4. Enter the name of the token.

  5. Select access rights:

    • read-only — downloading images and charts from the registry will be available;
    • write and read — adding, downloading and deleting images and charts from the registry will be available.

  6. Select the registry to which you want to grant access. If you grant access to all registries, the token will also be valid for new registries you create.

  7. Select the validity period of the token:

    • 30 days;
    • 60 days;
    • 90 days;
    • 1 year;
    • indefinite.

  8. Click Generate Token.

  9. When the login and password are created, click Download json token.

Authorize in the Docker CLI⁠

To work with the Docker CLI, you need the token and authorization data you received in the previous step.

  1. Open a terminal and type the command:

    docker login cr.selcloud.ru

  2. Enter the username and password for the registry.

Download image⁠

  1. Assign a tag to the image:

    docker tag <image> cr.selcloud.ru/<registry>/<image>:<tag>

    Specify:

    • <image> — image name, can be viewed with docker image list
    • <registry> is the name of the registry where you want to load the image;
    • <tag> — Tag.

  2. Load the image into the registry:

    docker push cr.selcloud.ru/<registry>/<image>:<tag>

Download image⁠

Download an image from the registry:

docker pull cr.selcloud.ru/<registry>/<image>:<tag>

Specify:

  • <registry> is the name of the registry from which to download the image;
  • <image> — image name, can be viewed with docker image list
  • <tag> — Tag.