---
title: 'Container Registry: быстрый старт'
sidebar_label: 'Быстрый старт'
description: 'Как начать работу с Container Registry: создать реестр, получить токен, авторизоваться в Docker CLI, загрузить и скачать образ'
sidebar_position: 2
---

import Formbricks from '@theme/MDXComponents/Formbricks'

# Container Registry: быстрый старт

1. [Создайте реестр](#create-registry).
2. [Сгенерируйте токен](#generate-token).
3. [Авторизуйтесь в Docker CLI](#log-in-to-docker-cli).
4. [Загрузите образ](#upload-image).
5. [Скачайте образ](#download-image).

## 1. Создать реестр \{#create-registry}

1. В [панели управления](https://my.selectel.ru/vpc/default/craas/) в верхнем меню нажмите **Продукты** и выберите **Container Registry**.

2. Откройте вкладку **Реестры**.

3. Нажмите **Создать реестр**.

4. Введите имя реестра. Имя реестра будет частью его URI:

   ```bash
   cr.selcloud.ru/<registry>
   ```

   Укажите `<registry>` — имя реестра.

5. Нажмите **Создать**.

## 2. Сгенерировать токен \{#generate-token}

Чтобы настроить доступ к реестрам, сгенерируйте токен. Вы можете выбрать срок действия токена, права доступа и реестры, к которым дает доступ токен.

1. В [панели управления](https://my.selectel.ru/vpc/default/craas/) в верхнем меню нажмите **Продукты** и выберите **Container Registry**.

2. Откройте вкладку **Токены**.

3. Нажмите **Сгенерировать токен**.

4. Введите имя токена.

5. Выберите права доступа:

   * только на чтение — будет доступно скачивание образов и чартов из реестра;
   * на запись и чтение — будет доступно добавление, скачивание и удаление образов и чартов из реестра.

6. Выберите реестр, к которому хотите предоставить доступ. Если вы предоставляете доступ ко всем реестрам, то токен будет действителен и для новых реестров, которые вы будете создавать в этом проекте.

7. Выберите срок действия токена:

   * 30 дней;
   * 60 дней;
   * 90 дней;
   * 1 год;
   * бессрочный.

8. Нажмите **Сгенерировать токен**.

9. Сохраните данные для авторизации с помощью токена — скопируйте имя пользователя (username) и пароль (password) или скачайте токен в формате `.json`.

## 3. Авторизоваться в Docker CLI \{#log-in-to-docker-cli}

Для работы с Docker CLI нужен токен и данные для авторизации, которые вы получили на предыдущем шаге.

1. Откройте CLI.

2. Авторизуйтесь в Docker:

   ```bash
   docker login cr.selcloud.ru
   ```

3. Введите имя пользователя (username) и пароль (password) токена, который вы [сгенерировали](#generate-token).

## 4. Загрузить образ \{#upload-image}

1. Присвойте образу тег:

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

   Укажите:

   * `<image>` — имя образа, можно посмотреть с помощью `docker image list`;
   * `<registry>` — имя реестра, в который нужно загрузить образ;
   * `<tag>` — тег.

2. Загрузите образ в реестр:

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

## 5. Скачать образ \{#download-image}

Скачайте образ из реестра:

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

Укажите:

* `<registry>` — имя реестра, из которого нужно скачать образ;
* `<image>` — имя образа, можно посмотреть с помощью `docker image list`;
* `<tag>` — тег.

<Formbricks />