워크플로 실행에서 잠금 화면까지
워크플로는 이미 작업이 끝난 시점을 알고 있어요. 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단계
애플리케이션 만들기
Pocket Alert에서 애플리케이션을 추가하고 API 키를 POCKETALERT_API_KEY 저장소 시크릿으로 저장하세요.
알림 단계 연결하기
메시지 API를 curl로 호출하는 알림 단계를 추가하고, if: failure()와 if: success()로 결과를 골라 주세요.
정보 매핑 후 배포
저장소, 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가 받는 모든 필드는 시작하기 문서에서 확인할 수 있어요.
궁금한 점을 답해드려요
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 단계를 워크플로에 추가하세요.