tocdepth: 2

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

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

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

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

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

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

Реестр — каталог всех репозиториев проекта, в которых хранятся артефакты: 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 — тег образа.
Для загрузки образа в репозиторий выполните команду в Docker CLI или любом удобном терминале:
```
docker push <registry_name>.cr.cloud.ru/<repository_name>:<tag>
```
Где:
- <registry_name>.cr.cloud.ru — URI реестра, в котором находится репозиторий.
- <repository_name> — название будущего репозитория (соответствует названию загружаемого образа).
- <tag> — тег образа.
Убедитесь, что образ появился в списке образов в разделе Артефакты.

Разверните приложение в контейнере

В личном кабинете перейдите в раздел Artifact Registry → Репозитории → Артефакты.
В строке с нужным образом откройте меню .
Нажмите Создать Container App.
Заполните поля и активируйте опции:
- Название контейнера — произвольное название контейнера, может совпадать с именем образа.
- Порт контейнера — порт, на котором будет работать контейнер.
  
  Порт должен соответствовать порту, на котором работает ваше приложение. Принимаются значения от 1024 до 65535 включительно. Если вы используете наш демонстрационный образ, укажите порт 8080.
- vCPU/RAM — количество vCPU и RAM, которые выделяются для каждого экземпляра контейнера при обработке вызова. Выберите минимальную конфигурацию: 0.1 vCPU – 256 MB.
- Минимальное количество экземпляров — 0.
- Максимальное количество экземпляров — 1.
- Публичный адрес — активируйте опцию, чтобы получить URL-адрес для вызова приложения.
Нажмите Создать.

Вы будете перенаправлены на страницу сервиса Container Apps. Контейнер будет создан и запущен в течение нескольких минут.
Дождитесь, когда контейнер и ревизия перейдут в статус «Выполняется» и появится публичный URL-адрес.
Cкопируйте и вставьте URL-адрес в адресную строку браузера. Откроется страница приложения.

Что дальше

Вы загрузили образ в репозиторий и развернули контейнер, используя упрощенную форму в интерфейсе Artifact Registry. Это быстрый способ развертывания контейнера, без поддержки дополнительных настроек — например, без параметров масштабирования контейнера, переменных и health-проб.

Для более тонкой настройки при развертывании контейнера используйте форму создания в интерфейсе Container Apps. Подробнее — в разделе Создание контейнера в Container Apps.

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