Красный pipeline без сообщения обычно означает одно из двух: job уведомления унаследовал условие success и был пропущен либо команда отправки выполнилась, но её ответ никто не проверил. Начните с уже завершившегося run — повторять deploy для диагностики не требуется.
В GitHub Actions зависимый job по умолчанию не стартует, если нужный ему job завершился ошибкой или был пропущен. Для уведомления задают явное условие, а само уведомление не помещают последним step в deploy job: процесс мог оборваться раньше.
Один run раскладываем на четыре результата
| Уровень | Что открыть | Признак причины |
|---|---|---|
| Команда deploy | Exit code и stderr | Ошибка подавлена через || true или continue-on-error |
| Deploy job | Job conclusion | success при фактическом неуспехе релиза |
| Notify job | Condition evaluation | skipped из-за неявного success() |
| Шаг отправки | HTTP/API result | 200 у shell, но отказ внешнего сервиса не разобран |
| Канал | Message/correlation ID | Принято, но отправлено не в тот маршрут |
Workflow run URL и job ID важнее скриншота красной иконки. Они показывают фактические conclusions и вычисленное условие. Секрет webhook, полный payload и содержимое рабочих логов в задачу расследования не копируют.
Notify job не зависит от успеха deploy
jobs:
deploy:
runs-on: ubuntu-latest
steps:
- name: Deploy
run: ./deploy.sh
notify_failure:
needs: deploy
if: ${{ always() && needs.deploy.result == 'failure' }}
runs-on: ubuntu-latest
steps:
- name: Send failure event
env:
NOTIFY_URL: ${{ secrets.NOTIFY_URL }}
run: ./notify-failure.sh "${{ github.run_id }}"Пример относится к GitHub Actions и одной зависимости. needs перечисляет job, completion которого нужно дождаться, а условие проверяет его result. Репозиторий можно не checkout-ить, если notify-failure.sh доступен иначе; в реальной конфигурации скрипт и способ доставки должны быть определены заранее.
Провал должен доходить до CI как провал
Если deploy.sh ловит ошибку и завершает процесс кодом 0, платформа честно отмечает job успешным. Уберите безусловные || true, проверьте set -e только в понятном shell-контексте и явно возвращайте ненулевой код после неуспешной проверки. continue-on-error используйте лишь там, где ошибка действительно не меняет итог deploy.
- Команда публикации возвращает ненулевой код при отказе API или SSH.
- Проверка smoke test не печатает ошибку и продолжает job как success.
- Rollback имеет собственный результат, отдельный от результата исходного deploy.
- Cancellation не смешивается с failure, если для них нужны разные сообщения.
- Matrix jobs агрегируются осознанно: уведомление не ждёт несуществующий единичный result.
Доставка подтверждается ответом, а не запуском curl
Скрипт отправки должен ограничивать время соединения, проверять HTTP status или поле ok в API и завершаться ошибкой при отказе. При временной сетевой проблеме допустимы несколько повторов с backoff; при 401, 403 или неверном маршруте повтор без изменения конфигурации только создаёт шум.
Чтобы уведомление само не потерялось, запишите delivery attempt, run ID, канал-назначение и обезличенный response code. Секретный URL маскируется. Для критичных релизов полезен независимый контроль: монитор видит failed run без delivery receipt и поднимает отдельный сигнал.
Проверяем уведомление без нового релиза
- Создать тестовый workflow с job, который предсказуемо завершается exit 1.
- Направить notify job в тестовый канал или sandbox endpoint.
- Убедиться, что deploy conclusion равен failure, а notify не skipped.
- Проверить один полученный message ID и ссылку на тестовый run.
- Смоделировать отказ провайдера и увидеть failure самого notify job.
- Отдельно отменить run и подтвердить выбранную политику для cancellation.
Повтор уведомления не повторяет deploy
У отправки должен быть собственный ключ дедупликации, например repository + workflow run ID + notification type. Тогда ручной retry notify job не создаст пять одинаковых сообщений. Не используйте rerun all jobs ради одного пропущенного сигнала: он может повторить изменение инфраструктуры.
Что приложить к разбору
Достаточно workflow YAML с удалёнными secrets, URL завершённого run, conclusions связанных jobs, текст вычисленного if и код ответа канала. По ним видно, где оборвалась цепочка. Рабочий webhook и приватные логи приложения для исправления условий запуска не нужны.