// 정기 자동화 — 저장소로 받기
수집 후 Slack 알림
수집 성공/실패가 운영 채널에 한 줄로 도착. GitHub Actions UI 를 매번 열지 않아도 됨.
이런 분께 — 운영 채널이 진실 원천인 팀.
headless 수집 완료 bank.transactions.cb.v1 · IBK · 132건 (2026-04) Job: dj_3kF92...
01사전 점검
아래 명령을 그대로 붙여넣어 지금 내 환경이 준비됐는지 확인한다.
repo secret H6S_API_KEY 가 등록돼 있다
gh secret list목록에 H6S_API_KEY 가 보인다
아니면 —
gh secret set H6S_API_KEY # 또는 repo Settings → Secrets워크스페이스에 대상 자격증명이 있다
h6s credentials list그 기관에 매칭되는 자격증명이 1건 이상 보인다
아니면 —
h6s credentials create --interactive --certSlack 봇 토큰·채널이 준비돼 있다
repo Settings → Secrets(SLACK_BOT_TOKEN) · Variables(SLACK_CHANNEL_ID)secret SLACK_BOT_TOKEN + variable SLACK_CHANNEL_ID 등록됨
아니면 —
Slack 앱에서 봇 토큰 발급 후 secret/variable 등록 (chat:write 권한).
02실행
아래 파일을 .github/workflows/ 에 저장하고 기본 브랜치에 commit. 첫 검증은 Actions 탭 → Run workflow 로 수동 트리거.
# 입출금내역 수집 후 Slack 채널로 한 줄 요약을 보낸다.
# Discord 등 다른 채널도 outputs.summary / outputs.count 를 그대로 끼우면 동일하게 동작한다.
name: 수집 후 Slack 알림
on:
schedule:
- cron: '0 0 * * 1' # 매주 월요일
workflow_dispatch: {}
jobs:
fetch-and-notify:
runs-on: ubuntu-latest
steps:
- id: fetch
uses: bolta-io/h6s-action@v0
with:
api-key: ${{ secrets.H6S_API_KEY }}
schema: bank.transactions.cb.v1
provider: CB_IBK
from: ${{ vars.FETCH_FROM }}
to: ${{ vars.FETCH_TO }}
- name: Slack 알림 (성공)
if: success()
uses: slackapi/slack-github-action@v1
with:
channel-id: ${{ vars.SLACK_CHANNEL_ID }}
slack-message: |
✅ headless 수집 완료
${{ steps.fetch.outputs.summary }}
Job: `${{ steps.fetch.outputs.job-id }}`
env:
SLACK_BOT_TOKEN: ${{ secrets.SLACK_BOT_TOKEN }}
- name: Slack 알림 (실패)
if: failure()
uses: slackapi/slack-github-action@v1
with:
channel-id: ${{ vars.SLACK_CHANNEL_ID }}
slack-message: |
❌ headless 수집 실패 — workflow run ${{ github.run_id }}
${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}
env:
SLACK_BOT_TOKEN: ${{ secrets.SLACK_BOT_TOKEN }}이 Slack step 2개를 기존 PR 워크플로우 마지막에 그대로 붙이면 PR + 알림 동시.
03검증
- Actions 가 초록이면 성공 메시지, 빨강이면 실패 메시지가 채널에 도착한다.
- 성공 메시지에 fetch summary(건수·기간)와 Job ID 가 들어간다.
04흔한 에러
fetch step 에서 NO_API_KEY 로 실패secret 이름이 yml 의 secrets.H6S_API_KEY 와 다르다.
해결 secret 을 정확히 H6S_API_KEY 로 등록.
CREDENTIAL_INSUFFICIENT_FOR_PROVIDER그 provider 에 매칭되는 자격증명이 워크스페이스에 없다.
해결 h6s credentials create --interactive --cert (공동인증서 1개로 전 기관 공용).
cron 시간이 지나도 안 돈다yml 이 기본 브랜치에 없거나, repo 가 60일 비활성이라 scheduled workflow 가 멈췄다.
해결 기본 브랜치에 머지하고, 가끔 수동 트리거해 활성 유지.
Actions 는 초록인데 Slack 에 아무것도 안 옴SLACK_BOT_TOKEN 미등록 또는 봇이 채널에 미초대.
해결 secret 등록 + 대상 채널에 봇 invite, SLACK_CHANNEL_ID 확인.
05변형
같은 사례에서 자주 바꾸는 옵션. 다른 사례는 아래 이전/다음에서.
고정 기간 대신 전주 자동 계산
- id: prev-week
run: |
echo "from=$(date -u -d '7 days ago' +%Y-%m-%d)" >> "$GITHUB_OUTPUT"
echo "to=$(date -u -d 'yesterday' +%Y-%m-%d)" >> "$GITHUB_OUTPUT"
# 이후 from/to 를 ${{ steps.prev-week.outputs.* }} 로 교체