GitHub Actions

끝난 워크플로 결과로 휴대폰을 울리세요.

Pocket Alert는 GitHub Actions 결과를 푸시 알림으로 휴대폰에 보내 드려요. 워크플로에 curl 단계를 하나 추가하면, 빌드, 배포, 릴리스가 끝나는 즉시 결과가 1초 안에 iPhone이나 Android에 도착해요. Actions 탭을 계속 볼 필요가 없어요.

<1초 안에 푸시API 키를 시크릿으로 보관curl 단계 하나면 충분 업데이트
기능

워크플로 실행에서 잠금 화면까지

워크플로는 이미 작업이 끝난 시점을 알고 있어요. Pocket Alert는 그 순간을 놓칠 수 없는 푸시 알림으로 바꿔 드려요.

워크플로의 단계 하나로 충분해요

메시지 API에 curl 호출 한 번이면 어떤 워크플로 단계든 푸시 알림이 돼요. 러너를 따로 설정할 필요도, 추가 서비스도 필요 없어요.

저장소 시크릿으로 보관하는 키

${{ secrets.POCKETALERT_API_KEY }}에서 API 키를 읽으면 로그에 노출되지 않고, 대시보드에서 교체할 수 있어요.

원하는 결과만 골라서 알림

if: failure()와 if: success()를 함께 쓰면 빌드 실패와 배포 성공을 각각 구분된 메시지로 보낼 수 있어요.

저장소마다 채널 하나씩

애플리케이션마다 고유 ID가 있어서 저장소별, 환경별 실행 결과를 따로 나눠 받을 수 있어요.

1초 이내 전달

작업이 끝나는 순간 단계가 실행되어 결과가 1초 안에 휴대폰에 도착해요.

실행 정보 전체 포함

github.repository, github.sha, github.workflow 값을 메시지에 넣으면 어떤 실행인지 정확히 알 수 있어요.

시작하기

휴대폰으로 GitHub Actions 알림을 받는 3단계

1

애플리케이션 만들기

Pocket Alert에서 애플리케이션을 추가하고 API 키를 POCKETALERT_API_KEY 저장소 시크릿으로 저장하세요.

2

알림 단계 연결하기

메시지 API를 curl로 호출하는 알림 단계를 추가하고, if: failure()와 if: success()로 결과를 골라 주세요.

3

정보 매핑 후 배포

저장소, sha, 워크플로 정보를 메시지에 넣으세요. 다음 실행부터 휴대폰이 울려요.

GitHub Actions 알림을 휴대폰으로 받기

1. 애플리케이션을 만들고 API 키를 저장하세요

Pocket Alert에서 애플리케이션을 추가하고 API 키를 복사하세요. 설정 → Secrets and variables → Actions에서 POCKETALERT_API_KEY라는 이름의 저장소 시크릿으로 저장하세요.

2. 메시지 API를 호출하는 알림 단계를 추가하세요

- name: Notify on failure
  if: failure()
  run: |
    curl -X POST "https://api.pocketalert.app/v1/messages" \
      -H "Token: ${{ secrets.POCKETALERT_API_KEY }}" \
      -H "Content-Type: application/json" \
      -d '{"title":"Build failed","message":"${{ github.workflow }} on ${{ github.ref_name }} (${{ github.sha }})","level":"high"}'

- name: Notify on success
  if: success()
  run: |
    curl -X POST "https://api.pocketalert.app/v1/messages" \
      -H "Token: ${{ secrets.POCKETALERT_API_KEY }}" \
      -H "Content-Type: application/json" \
      -d '{"title":"Deploy succeeded","message":"${{ github.repository }}@${{ github.sha }}"}'

3. 특정 애플리케이션으로 보내기

본문에 application_id를 추가하면 해당 앱으로만 푸시가 가요. TID는 대시보드에서 확인하세요:

-d '{"title":"Release shipped","message":"${{ github.repository }} ${{ github.ref_name }}","application_id":"qm47b9pzxzxg"}'

메시지 API가 받는 모든 필드는 시작하기 문서에서 확인할 수 있어요.

FAQ

궁금한 점을 답해드려요

Token 헤더에 API 키를 넣고 https://api.pocketalert.app/v1/messages 로 curl을 호출하는 단계를 추가하세요. 작업 맨 끝에 두면 배포가 끝나거나 빌드가 실패할 때 휴대폰으로 바로 알림이 와요.

API 키를 저장소 시크릿으로 저장하고 ${{ secrets.POCKETALERT_API_KEY }}로 읽어서 Token 헤더에 넣으세요. 키는 로그에 나타나지 않으며, Pocket Alert 대시보드에서 교체할 수 있어요.

단계 두 개에 각각 if: failure()와 if: success()를 설정하세요. 빌드가 실패하면 한 메시지가, 배포가 성공하면 다른 메시지가 발송되어 필요한 결과만 골라 알림을 받을 수 있어요.

저장소나 환경마다 애플리케이션을 따로 만드세요. 프론트엔드, 백엔드, 릴리스 워크플로가 각각 별도 채널로 전달되어 개별적으로 알림을 끌 수 있어요.

메시지 본문에 ${{ github.repository }}, ${{ github.sha }}, ${{ github.workflow }} 같은 실행 정보를 넣으세요. 푸시 알림만 봐도 어떤 실행이 끝났는지 정확히 알 수 있어요.

이 단계는 Token 헤더와 title, message 값을 담은 JSON 본문으로 https://api.pocketalert.app/v1/messages 를 호출해요. 특정 앱으로 보내려면 application_id를 추가하세요.

실패 단계의 본문에 "level":"high"를 추가하면 iPhone에서는 집중 모드를 뚫고, Android에서는 눈에 띄게 울려요. "level":"critical"을 쓰면 방해 금지 모드도 무시해요. 배포 성공 알림은 "level":"silent"로 보내면 진동 없이 기록에만 남아요.

실행을 지켜보지 않아도 배포가 성공했는지 알 수 있어요.

애플리케이션을 만들고 API 키를 복사한 뒤, Pocket Alert 단계를 워크플로에 추가하세요.