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 a registry — this can be done in the control panel (see below) or via the API Container Registry.
  2. Get a token.
  3. Authorize in the Docker CLI.

Create a registry⁠

  1. In control panel go to Cloud platform → Container Registry.

  2. Click Get started.

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

    cr.selcloud.ru/<registry>

  4. Click Create.

Generate token⁠

To customize access to registries, generate a token. You can select the token validity period, access rights, and registries to which the token gives access.

  1. In control panel go to Cloud platform → Container Registry.

  2. Open the tab Tokens.

  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 have been 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> — 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> — name of the registry from which you want to download the image;
  • <image> — image name, can be viewed with docker image list
  • <tag> — Tag.