Начните не с копирования SSH-команды в GitHub Actions, а с границы релиза: workflow должен собрать один артефакт, проверить его, развернуть в production и подтвердить работоспособность. Если health check не проходит, текущая версия не удаляется — переключатель возвращается на предыдущий release.
Для production используйте GitHub environment и `concurrency`: environment отделяет правила и секреты окружения, а concurrency не даёт двум деплоям одновременно менять сервер. Долгоживущий облачный ключ по возможности замените OIDC-доверием с условием на конкретный repository, branch или environment.
Сначала зафиксируйте контракт релиза
| Стадия | Артефакт или сигнал | Условие продолжения |
|---|---|---|
| Build | Версионированный архив или image digest | Сборка воспроизводима и завершилась без ошибок |
| Test | Отчёт тестов и lint | Все обязательные проверки прошли |
| Transfer | Release directory или image в registry | Checksum или digest совпадает |
| Switch | Symlink, deployment revision или service update | Новая версия стала активной атомарно |
| Verify | HTTP 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-конфигурации.