Начните не с копирования SSH-команды в GitHub Actions, а с границы релиза: workflow должен собрать один артефакт, проверить его, развернуть в production и подтвердить работоспособность. Если health check не проходит, текущая версия не удаляется — переключатель возвращается на предыдущий release.

Для production используйте GitHub environment и `concurrency`: environment отделяет правила и секреты окружения, а concurrency не даёт двум деплоям одновременно менять сервер. Долгоживущий облачный ключ по возможности замените OIDC-доверием с условием на конкретный repository, branch или environment.

Сначала зафиксируйте контракт релиза

СтадияАртефакт или сигналУсловие продолжения
BuildВерсионированный архив или image digestСборка воспроизводима и завершилась без ошибок
TestОтчёт тестов и lintВсе обязательные проверки прошли
TransferRelease directory или image в registryChecksum или digest совпадает
SwitchSymlink, deployment revision или service updateНовая версия стала активной атомарно
VerifyHTTP health и один пользовательский сценарийОтвет корректен в заданном окне
RollbackПредыдущий immutable releaseСервис снова проходит проверку

Артефакт помечайте commit SHA, а не только словом `latest`. Workflow и человек должны однозначно отвечать, какой код работает сейчас. Production не должен собирать зависимости заново: иначе протестированная сборка отличается от развернутой.

Workflow ограничивает очередь production

name: deploy

on:
  push:
    branches: [main]
  workflow_dispatch:

concurrency:
  group: production
  cancel-in-progress: false

jobs:
  deploy:
    runs-on: ubuntu-latest
    environment:
      name: production
      url: https://example.com
    permissions:
      contents: read
      id-token: write
    steps:
      - uses: actions/checkout@v4
      - run: ./ci/build-and-test.sh
      - run: ./ci/deploy-artifact.sh
      - run: ./ci/check-release.sh https://example.com/health

Это каркас, а не готовая команда для любого сервера. `cancel-in-progress: false` оставляет начавшийся production-деплой завершиться, вместо того чтобы оборвать его на середине. `id-token: write` нужен только если выбран OIDC; облачная роль должна дополнительно проверять claims и давать минимальные права.

Environment ставит границу перед секретами

Привяжите job к environment `production`, ограничьте допустимые ветки и добавьте approval там, где цена ошибки высока. GitHub указывает, что environment secrets становятся доступны job только после прохождения protection rules. Сборка pull request не должна иметь production credentials.

  • Разделите staging и production ролями, адресами и secret namespace.
  • Закрепляйте сторонние actions на доверенной версии или commit SHA согласно своей модели риска.
  • Не печатайте environment dump и команды с токеном в аргументах.
  • Защитите main branch обязательными проверками до запуска deploy.
  • Записывайте release ID, commit SHA, время и инициатора в журнал развертываний.

Health check проверяет не только открытый порт

Эндпоинт `/health` должен быстро отвечать без персональных данных, но успешного HTTP 200 мало. Добавьте короткий smoke test: открыть ключевую страницу, выполнить безопасное чтение из базы или проверить фонового consumer. Не превращайте health endpoint в дорогой запрос ко всем зависимостям.

Если миграция базы несовместима с прошлой версией, мгновенный rollback приложения не поможет. Используйте expand-and-contract: сначала добавьте совместимую схему, затем переключите код и удаляйте старое поле отдельным релизом после наблюдения.

Откат репетируется до первого production-сбоя

Сохраните минимум предыдущий готовый артефакт и команду атомарного переключения. В staging намеренно сломайте smoke test и убедитесь, что workflow не удаляет рабочую версию, возвращает указатель назад и помечает deployment как неуспешный.

Для ревью подготовьте workflow, схему ролей, список protection rules, формат артефакта и журнал тестового rollback. Закройте secret values, приватные адреса и содержимое production-конфигурации.

Проверенные источники