tocdepth

2

Lab 2: Развертывание backend-приложения

В этой лабораторной работе вы будете использовать репозиторий GitVerse с исходным кодом готовых backend-приложений на языках Python, Go, JavaScript, C#. Каждое приложение является простым примером реализации REST API, которое возвращает список значений с демонстрационными данными.

На примере развертывания backend-приложения вы познакомитесь с дополнительными настройками сервиса Container Apps.

1. Подготовьте среду

Подготовьте среду, если не сделали этого ранее.

2. Клонируйте или скачайте репозиторий кода c GitVerse

Опциональный шаг.

Вы можете зарегистрироваться в GitVerse, если у вас еще нет аккаунта, и познакомиться с новой системой контроля версий. Этот шаг необязательный и не влияет на дальнейшее прохождение лабораторной работы.

В этом репозитории находится исходный код простого REST API приложения, написанного на разных языках: JavaScript, Python, Go, C#.

git clone https://gitverse.ru/cloudru/evo-containerapp-restapi-js-go-python-dotnet-sample

3. Соберите образ и присвойте тег

Используйте реестр, созданный в первой лабораторной работе, выполнив следующую команду:

docker build --tag <registry_name>.cr.cloud.ru/restapi-python https://gitverse.ru/cloudru/evo-containerapp-restapi-js-go-python-dotnet-sample.git#master:restapi-python/src --platform linux/amd64

4. Загрузите Docker-образ в реестр

Загрузите образ в реестр Artifact Registry, выполнив команду:

docker push <registry_name>.cr.cloud.ru/restapi-python

Где:

  • <registry_name> — название реестра, которое вы указывали при его создании в Artifact Registry;

  • restapi-python — название будущего репозитория в Artifact Registry. Название репозитория соответствует имени Docker-образа.

5. Создайте и запустите контейнер

  1. Откройте меню загруженного образа и нажмите Создать Container App.

    ../_images/ar-create-container-restapi.png

  2. Заполните поля и активируйте опции:

    ../_images/ar-create-container-advanced-settings-restapi.png

    • Название контейнера — глобально уникальное имя, на базе которого формируется адрес вашего приложения в домене *.containers.cloud.ru.

    • Порт контейнера — порт контейнера, который должен совпадать с портом вашего приложения. В этой лабораторной работе используем порт 8080.

      server {
    listen 8080;
    root /usr/share/nginx/html;
    index index.html;

    location / {
        try_files $uri $uri/ /index.html;
    }
}

    • vCPU/RAM — количество vCPU и RAM, которые выделяются для каждого экземпляра контейнера при обработке вызова. Выберите минимальную конфигурацию.

    • Минимальное и максимальное количество экземпляров при масштабировании сервиса. По умолчанию происходит масштабирование с 0, что может вызывать небольшую задержку при старте вашего приложения. Установите минимальное количество экземпляров в значение 0, а максимальное — 1.

    • Публичный адрес — активируйте опцию, чтобы получить URL-адрес для вызова приложения из интернета.

    • Автоматическое развертывание — активируйте опцию, чтобы каждый раз после загрузки в Artifact Registry новой версии образа на стороне Container Apps автоматически создавалась новая ревизия контейнера.

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

Откроется страница сервиса Container Apps. Контейнер будет запущен в течение нескольких секунд.

Дождитесь, когда контейнер и ревизия перейдут в статус «Выполняется».

../_images/ca-container-run-restapi.png

6. Проверьте рабостоспособность развернутного приложения

Дождитесь появления публичного URL, скопируйте его и вставьте в адресную строку браузера.

../_images/ca-public-url-restapi.png

Что делать, если приложение не отвечает

Если приложение не отвечает, перейдите в список ревизий и убедитесь, что последняя созданная ревизия находится в статус «Выполняется».

Если ревизия находится в статусе «Публикуется» или «Ошибка», попробуйте создать новую ревизию, нажав кнопку Создать ревизию на основе выбранной.

Что дальше

В этой лабораторной работе вы научились:

  • создавать репозитории в существующих реестрах Artifact Registry;

  • создавать и запускать контейнер через быстрое меню в Artifact Registry;

  • управлять настройками масштабирования контейнера.

В третьей лабораторной работе вы научитесь разворачивать Jupyter Server, создав контейнер в интерфейсе Container Apps.

Запустили Evolution free tier
для Dev & Test
Получить