Деплой в сloud.ru

Container Apps — это сервис от сloud.ru для запуска контейнерных приложений в облаке.

Подробнее см. в сloud.ru.

В рамках GitVerse CI/CD деплой в Container Apps позволяет автоматизировать процесс развертывания приложений, используя GitVerse-специфичные инструменты и практики.

Пример workflow

Требования

1. Собранный Docker-образ:

   • ожидается, что образ уже опубликован в реестре;
   • пример: gitverse.ru/actions/gitverse_hello:container_app;
   • можно собрать через: .gitverse/workflows/docker/cloud-hosted-runner/push-registries.yaml.

2. Доступ к Container App:

   • требуется доступ к реестру cloud.ru;
   • необходимо настроить секреты: CLOUD_RU_REGISTRY, CLOUD_RU_USERNAME, CLOUD_RU_PASSWORD, CLOUD_RU_PROJECT_ID.

3. Зависимости:

   • используется кастомное действие: actions/evo-container-app-action@v5;
   • требует Go >=1.23 для работы (устанавливается через setup-go).

4. Dockerfile:

   • используется: ./distribution/container_app.Dockerfile;
   • приложение должно слушать на одном из разрешенных платформой портов;
   • поддерживаемые порты: 8080, 8443 и т.д. (точный список — в документации cloud.ru);
   • пример:

     EXPOSE 8080
     CMD ["your-app", "--port=8080"]
   • если приложение слушает на порту, не входящем в разрешенный список — оно не будет доступно.

5. Container App:

   • проект должен существовать, ID указан в секрете: CLOUD_RU_PROJECT_ID;
   • action автоматически создает или обновляет приложение;
   • название приложения: container-app-gitverse-hello;
   • порт в конфигурации: 8080 (соответствует требованиям платформы).

6. Как проверить:

   • после успешного деплоя откройте в браузере: https://container-app-gitverse-hello.containerapps.ru;
   • вы увидите ответ от запущенного приложения.

Workflow

on:
  workflow_dispatch:
 
jobs:
  # Сборка и публикация образа для container-app
  build-push-image:
    name: Сборка и публикация Docker-образа
    runs-on: ubuntu-latest
 
    steps:
      - name: Клонировать репозиторий
        uses: actions/checkout@v4
 
      - name: Prepare Kaniko credentials
        run: |
          mkdir -p "${{ gitverse.workspace }}/.docker"
          
          # Кодируем username:password в base64
          AUTH=$(echo -n "${{ secrets.CLOUD_RU_USERNAME }}:${{ secrets.CLOUD_RU_PASSWORD }}" | base64 -w0)
          
          # Создаем config.json с credentials
          cat > "${{ gitverse.workspace }}/.docker/config.json" <<EOF
          {
            "auths": {
              "${{ secrets.CLOUD_RU_REGISTRY }}": {
                "auth": "${AUTH}"
              }
            }
          }
          EOF
          
          chmod 600 "${{ gitverse.workspace }}/.docker/config.json"
          echo "✅ Created config at ${{ gitverse.workspace }}/.docker/config.json"
        shell: bash
 
      - name: Собрать и опубликовать образ через Kaniko
        uses: docker://gcr.io/kaniko-project/executor:v1.24.0
        env:
          DOCKER_CONFIG: ${{ gitverse.workspace }}/.docker
        with:
          args: >-
            --context=dir://${{ gitverse.workspace }}/distribution
            --dockerfile=container-app.Dockerfile
            --destination=${{ secrets.CLOUD_RU_REGISTRY }}/gitverse_hello:container_app
            --verbosity=info
 
  # Деплой в Container App
  up-container-app:
    name: Деплой в Container App
    needs: build-push-image
    runs-on: ubuntu-latest
 
    steps:
      - name: Создать или обновить приложение в Container App
        uses: actions/evo-container-app-action@v1
        with:
          client_id: ${{ secrets.CLOUD_RU_USERNAME }}
          client_secret: ${{ secrets.CLOUD_RU_PASSWORD }}
          registry_uri: ${{ secrets.CLOUD_RU_REGISTRY }}
          image_name: gitverse_hello
          tag_name: container_app
          project_id: ${{ secrets.CLOUD_RU_PROJECT_ID }}
          name: container-app-gitverse-hello
          port: 8080

Описание шагов workflow

1. Клонирование репозитория.

• используется стандартный action actions/checkout@v4 для получения исходного кода проекта.

2. Подготовка учетных данных для Docker реестра.

• создается конфигурационный файл .docker/config.json с учетными данными для авторизации в реестре cloud.ru;
• используются секреты CLOUD_RU_REGISTRY, CLOUD_RU_USERNAME, CLOUD_RU_PASSWORD.

3. Сборка и публикация образа через Kaniko.

• выполняется сборка Docker-образа с помощью Kaniko;
• образ публикуется в реестре cloud.ru с тегом container_app;
• используется контекст из директории distribution и Dockerfile distribution/container-app.Dockerfile.

4. Создание или обновление приложения в Container App.

• используется кастомное действие actions/evo-container-app-action@v1;
• устанавливается Go версии >=1.23;
• настраивается подключение к Container App с использованием секретов;
• создается или обновляется приложение с именем container-app-gitverse-hello на порту 8080;
• action автоматически обрабатывает создание или обновление ресурса в Container Apps.