tocdepth: 2

Быстрый старт

С помощью быстрого старта вы создадите реестр, пройдете аутентификацию и загрузите Docker-образ в репозиторий.

Перед началом работы

Установите локально Docker Desktop.
Зарегистрируйтесь в личном кабинете Cloud.ru.

Если вы уже зарегистрированы, войдите под своей учетной записью.
Перейдите в раздел Контейнеры и подключите сервис Artifact Registry.
Получите и сохраните персональные ключи доступа для аутентификации.

Создайте реестр

Реестр — каталог всех репозиториев проекта, в которых хранятся артефакты: Docker-образы и Helm-чарты.

В личном кабинете на стартовой странице сервиса Artifact Registry нажмите Создать реестр.
Укажите название реестра.

Название реестра станет частью URI реестра, который будет использоваться для аутентификации и работы с образами.
Выберите Приватный тип доступа к реестру.
Нажмите Создать.

Пройдите аутентификацию

В личном кабинете перейдите в раздел Реестры и скопируйте URI реестра.

URI реестра имеет вид: <registry_name>.cr.cloud.ru.
Запустите Docker CLI или любой привычный терминал на вашем компьютере.
Для аутентификации используйте команду:
```
docker login <registry_name>.cr.cloud.ru -u <key_id> -p <key_secret>
```
Где:
- <registry_name>.cr.cloud.ru — URI реестра, сгенерированный на этапе создания реестра.
- <key_id> — логин персонального ключа (Key ID).
- <key_secret> — пароль персонального ключа (Key Secret).

Загрузите Docker-образ в репозиторий

(Опционально) Если у вас нет подготовленного образа, используйте наш демонстрационный Docker-образ. Для сборки демонстрационного образа на локальном компьютере выполните команду в Docker CLI или любом удобном терминале:
```
docker build --tag <registry_name>.cr.cloud.ru/react-hello-world https://gitverse.ru/cloudru/evo-containerapp-react-sample.git#master --platform linux/amd64
```
Присвойте образу тег:
```
docker tag helloworld:v1 <registry_name>.cr.cloud.ru/helloworld:v1
```
Где:
- <registry_name>.cr.cloud.ru — URI реестра, в котором находится репозиторий.
- helloworld — название будущего репозитория, которое соответствует названию загружаемого образа.
- v1 — тег образа.
Примечание

Если вы работаете с образами для Windows-контейнеров, то перед загрузкой в репозиторий настройте Docker Daemon. В файле daemon.json укажите параметр allow-nondistributable-artifacts со значением URI реестра, например:
```
{
"allow-nondistributable-artifacts" : ["<registry_name>.cr.cloud.ru"]
}
```
Если этот параметр не указан, то при попытке загрузить образ для Windows-контейнера появится ошибка «Error response from daemon get https://… connection refused».
Для загрузки образа в репозиторий выполните команду в Docker CLI или любом удобном терминале:
```
docker push <registry_name>.cr.cloud.ru/<repository_name>:<tag>
```
Где:
- <registry_name>.cr.cloud.ru — URI реестра, в котором находится репозиторий.
- <repository_name> — название будущего репозитория (соответствует названию загружаемого образа).
- <tag> — тег образа.
Убедитесь, что образ появился в списке образов в разделе Артефакты.

Что дальше

Вы можете создать контейнер в среде сервиса Container Apps на базе загруженного Docker-образа.

Продолжайте знакомство с сервисами — выполняйте лабораторные работы и получайте практические навыки развертывания контейнерных приложений c помощью Artifact Registry и Container Apps.