Красный pipeline без сообщения обычно означает одно из двух: job уведомления унаследовал условие success и был пропущен либо команда отправки выполнилась, но её ответ никто не проверил. Начните с уже завершившегося run — повторять deploy для диагностики не требуется.

В GitHub Actions зависимый job по умолчанию не стартует, если нужный ему job завершился ошибкой или был пропущен. Для уведомления задают явное условие, а само уведомление не помещают последним step в deploy job: процесс мог оборваться раньше.

Один run раскладываем на четыре результата

УровеньЧто открытьПризнак причины
Команда deployExit code и stderrОшибка подавлена через || true или continue-on-error
Deploy jobJob conclusionsuccess при фактическом неуспехе релиза
Notify jobCondition evaluationskipped из-за неявного success()
Шаг отправкиHTTP/API result200 у 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 и поднимает отдельный сигнал.

Проверяем уведомление без нового релиза

  1. Создать тестовый workflow с job, который предсказуемо завершается exit 1.
  2. Направить notify job в тестовый канал или sandbox endpoint.
  3. Убедиться, что deploy conclusion равен failure, а notify не skipped.
  4. Проверить один полученный message ID и ссылку на тестовый run.
  5. Смоделировать отказ провайдера и увидеть failure самого notify job.
  6. Отдельно отменить run и подтвердить выбранную политику для cancellation.

Повтор уведомления не повторяет deploy

У отправки должен быть собственный ключ дедупликации, например repository + workflow run ID + notification type. Тогда ручной retry notify job не создаст пять одинаковых сообщений. Не используйте rerun all jobs ради одного пропущенного сигнала: он может повторить изменение инфраструктуры.

Что приложить к разбору

Достаточно workflow YAML с удалёнными secrets, URL завершённого run, conclusions связанных jobs, текст вычисленного if и код ответа канала. По ним видно, где оборвалась цепочка. Рабочий webhook и приватные логи приложения для исправления условий запуска не нужны.

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