Канареечные выпуски с Actions

Представьте, что вы запускаете новую функцию или обновление. Что, если в нём окажется ошибка, затрагивающая всех пользователей? Страшно, правда?

Канареечные выпуски помогают снизить этот риск: изменения постепенно предоставляются сначала небольшой группе пользователей. Это похоже на отправку «канарейки в угольную шахту», чтобы проверить воздух до того, как войдут остальные.

Канареечные выпуски дают несколько важных преимуществ:

• Снижение рисков: Воздействие проблем ограничивается небольшой группой пользователей.
• Обратная связь в реальных условиях: Вы получаете производственные данные о производительности и стабильности.
• Быстрый откат: При возникновении проблем можно быстро вернуть только небольшую канареечную группу или весь сервис.
• Контролируемое расширение: По мере роста уверенности постепенно увеличивается число пользователей, получающих новую версию.

Возможно, вы помните развёртывания Blue/Green, при которых трафик мгновенно переключается между двумя одинаковыми окружениями.

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

Основной процесс канареечного выпуска выглядит так:

1. Развёртывание новой версии: Новая версия приложения развёртывается на небольшом наборе серверов или экземпляров параллельно с существующей стабильной версией.
2. Направление небольшой доли трафика: Балансировщик нагрузки или сервисная сеть настраивается на отправку небольшой доли (например, 5–10%) пользовательского трафика на новую версию.
3. Мониторинг: Для канареечной группы внимательно отслеживаются производительность, частота ошибок и отзывы пользователей.
4. Продвижение или откат: Если всё работает хорошо, доля трафика постепенно увеличивается или новая версия продвигается до 100%. При возникновении проблем канареечная версия откатывается, а трафик возвращается к стабильной версии.

GitHub Actions может оркестрировать весь процесс канареечного выпуска. Он не управляет трафиком напрямую — это задача вашей инфраструктуры, — но запускает следующие шаги:

• Сборка и тестирование приложения.
• Развертывание новой версии в канареечной среде.
• Инициация переключения трафика с помощью вызовов API балансировщика нагрузки или сервисной сетки.
• Ожидание результатов мониторинга или ручного подтверждения.
• Продвижение канареечной версии или запуск отката.

Типичный рабочий процесс GitHub Actions для канареечного выпуска может выглядеть так:

name: Canary Deployment

on: push

jobs:
  build:
    # ... build and test steps ...

  deploy-canary:
    needs: build
    steps:
      - name: Deploy to Canary Group
        # ... call script/tool to deploy and shift 10% traffic ...

  monitor-canary:
    needs: deploy-canary
    # ... wait for monitoring/approval ...

  promote-or-rollback:
    needs: monitor-canary
    # ... conditionally promote to 100% or rollback ...

Каждый шаг взаимодействует с вашими инструментами развертывания.

GitHub Actions выполняет оркестрацию, а фактическое принятие решений и команды развертывания часто реализуются в скриптах. Вот пример на Python, моделирующий логику канареечного развертывания. Представьте, что действие запускает этот скрипт:

Эффективный мониторинг имеет решающее значение. Ваш рабочий процесс GitHub Actions может интегрироваться с системами мониторинга несколькими способами:

• Вызовы API: Запрос ключевых метрик в инструментах мониторинга, например Datadog и Prometheus.
• Проверки работоспособности: Опрос конечных точек работоспособности приложения.
• Ручные контрольные точки: Приостановка рабочего процесса для проверки и подтверждения человеком.
• Ожидание по времени: Ожидание заданного периода, чтобы метрики стабилизировались.

Затем рабочий процесс использует эти сигналы, чтобы решить, продвигать ли версию или выполнить откат.

После этапа мониторинга GitHub Actions использует условную логику, чтобы определить следующий шаг. В определениях задания или шага можно использовать операторы if.

  promote-or-rollback:
    needs: monitor-canary
    if: success() && needs.monitor-canary.outputs.canary_ok == 'true'
    steps:
      - name: Promote Full Rollout
        # ... command to shift 100% traffic to new version ...

  rollback:
    needs: monitor-canary
    if: failure() || needs.monitor-canary.outputs.canary_ok == 'false'
    steps:
      - name: Rollback to Stable
        # ... command to shift 100% traffic to old version ...

Это обеспечивает автоматическую реакцию на показатели канареечной версии.

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

• Канареечные выпуски снижают риск и обеспечивают обратную связь в реальных условиях.
• GitHub Actions оркестрирует сборку, развертывание в канареечной среде, мониторинг и условные шаги продвижения или отката.
• Эффективный мониторинг и условная логика — ключевые составляющие успешных канареечных рабочих процессов.

Используя канареечные выпуски, Вы сможете развертывать приложения с большей уверенностью и контролем!