GitHub Actions 실패를 놓치지 마세요: Echobell로 받는 즉시 알림

목차

• 설정
• 1. Echobell 채널 만들기
• 2. 워크플로에 추가하기
• 팁
• 관련 문서

CI 실패를 알리는 이메일이나 Slack 알림은 놓치기 쉽습니다. Echobell Notification Action은 웹훅 알림을 휴대폰으로 바로 보냅니다. 일반 빌드에는 푸시 알림을, 프로덕션 실패에는 전화 알림을 사용하므로 망가진 파이프라인이 그대로 방치되지 않습니다.

설정

1. Echobell 채널 만들기

1. Echobell 다운로드 / Google Play 후 로그인합니다
2. "GitHub CI/CD Alerts" 같은 이름으로 채널을 만듭니다
3. 채널 설정에서 웹훅 URL을 복사합니다
4. GitHub 저장소에서: Settings → Secrets and variables → Actions → New repository secret
5. 이름을 ECHOBELL_WEBHOOK_URL로 지정하고 URL을 붙여넣습니다

2. 워크플로에 추가하기

기본 설정 (단일 잡 워크플로):

name: Build and Test

on:
  push:
    branches: [main]
  pull_request:
    branches: [main]

jobs:
  build:
    runs-on: ubuntu-latest

    steps:
      - uses: actions/checkout@v4

      - name: Build
        run: npm run build

      - name: Test
        run: npm test

      - name: Notify on Failure
        if: failure()
        uses: weelone/echobell-action@v1
        with:
          webhook-url: ${{ secrets.ECHOBELL_WEBHOOK_URL }}

다중 잡 파이프라인 — 중요한 잡 전체에 의존하는 전용 알림 잡을 사용합니다:

name: Deploy Pipeline

on:
  push:
    branches: [main]

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Run Tests
        run: npm test

  build:
    needs: test
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Build
        run: npm run build

  deploy:
    needs: build
    runs-on: ubuntu-latest
    steps:
      - name: Deploy
        run: npm run deploy

  notify_on_failure:
    runs-on: ubuntu-latest
    needs: [test, build, deploy]
    if: failure()
    steps:
      - name: Send Failure Notification
        uses: weelone/echobell-action@v1
        with:
          webhook-url: ${{ secrets.ECHOBELL_WEBHOOK_URL }}

전용 알림 잡을 두면 연쇄적으로 발생하는 실패에 대해 여러 개의 개별 알림 대신 하나로 통합된 알림을 받습니다.

팁

알림 제목은 무엇이, 어디에서, 언제 실패했는지를 알려 주어야 합니다. ❌ Main Branch CI Failed이나 🚨 Deploy Pipeline Down - Production 같은 형식을 사용하세요.

심각도에 따라 채널을 분리하세요. 일반적인 CI 알림은 표준 채널로 받고, 프로덕션 실패에는 전화로 설정한 두 번째 채널을 사용합니다. 워크플로마다 서로 다른 웹훅 URL을 지정하면 됩니다. 자세한 내용은 전화 알림을 참고하세요.

팀과 채널을 공유하세요. 팀 전체가 확인해야 하는 CI/CD 실패용 채널과 인프라 담당자만 보는 문제용 채널을 따로 만드세요. Echobell의 공유 채널을 사용하면 팀원이 각자의 알림 설정으로 구독할 수 있어, 모든 사람이 웹훅을 개별적으로 구성할 필요가 없습니다.

관련 문서

• Webhook 문서 — 전체 Webhook API 레퍼런스
• 템플릿과 조건 — 알림 내용과 필터링 사용자 지정
• Grafana 전화 알림 — 모니터링 시스템을 위한 전화 알림
• WebhookMCP 알림 — AI 작업 완료 알림
• 기능 문서: 채널, Webhook, 이메일 트리거, 전화 알림