자동 발행, 예약만 걸어두고 끝내지 않았나요?
시간대, 토큰, 모의 실행, 중복 방지, 이어하기, 공개 결과, 누락 감시와 비용. 웹·SNS 자동 발행 전에 확인할 8개 항목이에요.
마지막 업데이트
공식 자료 확인일:
예약 시간이 지났는데 글이 없거나, 재실행했더니 같은 글이 두 번 올라갔나요? GitHub Actions와 게시 API를 예로 자동 발행 흐름을 점검해볼게요. 공식 문서가 설명하는 기능에 이 가이드가 권하는 운영 기준을 더했어요. 플랫폼마다 지원 범위는 다르므로 사용 중인 서비스의 문서도 함께 확인해주세요. 그림은 설명용 예시이며 실제 발행 기록이 아니에요.
CHECK 01 / 8실행 시간과 게시할 시간이 같은 기준인가요?
운영 시간대를 먼저 정하고 스케줄의 시간대 설정을 대조해요. GitHub Actions는 기본 UTC를 쓰며 시간대를 지정하는 방식도 지원하므로 실제 파일을 확인해요. 기본 브랜치에 일정이 있는지와 워크플로 활성 여부도 봐요. 예약 실행은 지연되거나 누락될 수 있어요. 정각 실행만 믿기보다 오늘 몇 시까지 어떤 게시물이 있어야 하는지 정하면 빠진 작업을 찾기 쉬워요.
- 어디서 확인하나요?
- 스케줄 파일 · 시간대 · 기본 브랜치 · Actions 활성 상태
- 언제 체크하나요?
- 의도한 현지 시각과 실행 설정을 대조했고 공개 완료를 확인할 기한을 정했어요.
CHECK 02 / 8토큰이 맞는 계정과 권한에 연결되어 있나요?
게시 대상 계정, 채널, 사이트를 목록으로 적고 토큰이 그 대상의 작업을 허용하는지 확인해요. 테스트 계정으로만 연결됐거나 새로 만든 환경에 Secret이 빠진 경우도 찾아요. 가능하면 읽기 전용 계정 확인 호출부터 해보고 만료·갱신 방법을 기록하세요. Secret 이름을 확인하는 것과 실제 인증 성공은 별개예요. 토큰 값은 저장소나 실행 로그, AI 대화에 노출하지 않고 필요한 권한만 사용해요.
- 어디서 확인하나요?
- 저장소·환경의 Secrets · API 계정 확인 · 대상 채널 설정
- 언제 체크하나요?
- 값을 노출하지 않고 실제 인증·대상 계정·필요 권한과 갱신 경로를 확인했어요.
CHECK 03 / 8실제 게시 없이 전체 흐름을 시험해봤나요?
모의 실행 옵션을 만들어 자료 수집부터 초안, 이미지, 링크, 예약 정보까지 만들어봐요. 단순히 dry-run이라는 이름만 붙이지 말고 실제 게시 API와 배포 호출을 막는지 확인해요. 결과물에서 제목, 언어, 이미지 경로, 출처와 대상 계정을 읽어보세요. 수동 실행 기능은 시작 방법일 뿐 자동으로 모의 실행이 되지는 않아요. 실제 서비스로 나가는 단계가 차단됐다는 기록까지 남기는 것을 권해요.
- 어디서 확인하나요?
- 수동 실행 입력 · 모의 실행 코드 · 결과 초안과 실행 로그
- 언제 체크하나요?
- 전체 결과물을 검토했고 모의 실행 중 게시·배포 부작용이 없다는 것을 확인했어요.
CHECK 04 / 8같은 작업이 겹쳐도 중복 게시를 막나요?
두 실행이 겹치면 같은 초안을 동시에 올릴 수 있어요. 같은 게시 대상을 순서대로 처리하도록 동시 실행을 제어하고, 콘텐츠·언어·채널을 식별하는 작업 ID와 게시 기록을 남기는 설계를 권해요. 동시 실행 제어만으로 중복이 전부 막히지는 않아요. 게시 직전에 처리 여부를 다시 확인하고, 같은 작업을 두 번 넣는 모의 시험에서 외부 게시가 한 번만 준비되는지 봐요.
- 어디서 확인하나요?
- concurrency 설정 · 작업 ID · 게시 기록 저장소 · 중복 입력 시험
- 언제 체크하나요?
- 겹치는 실행과 같은 작업의 재입력을 시험했고 중복 게시를 방지하는 기록과 확인 절차가 있어요.
CHECK 05 / 8타임아웃 뒤에 무작정 다시 올리지 않나요?
전송이 시간 초과됐어도 상대 서비스에서는 게시가 끝났을 수 있어요. “결과 불명” 상태를 두고 대상의 게시 ID나 최근 결과를 먼저 조회하는 방식을 권해요. 지원하는 API라면 멱등 키를 사용하고, 확인할 방법이 없으면 재게시를 보류해 중복 위험을 남겨요. 일시 오류의 재시도는 횟수 제한과 대기 간격을 두고 서비스의 Retry-After를 따르세요. 초안·업로드·게시 단계를 저장하면 실패한 곳부터 이어갈 수 있어요.
- 어디서 확인하나요?
- API 응답·대상 게시 조회 · 작업 상태 · 재시도 횟수와 대기 설정
- 언제 체크하나요?
- 전송 결과 불명과 확정 실패를 구분했고 조회·제한 재시도·이어하기 경로를 시험했어요.
CHECK 06 / 8성공 표시가 실제 공개 결과와 맞나요?
초안 파일 생성, 배포 시작, 공개 페이지 반영, SNS 게시 성공은 서로 다른 단계예요. 각 대상의 최종 URL이나 게시 ID를 남기고 실제 공개된 제목·언어·이미지를 확인해요. 웹과 SNS 중 하나만 끝났다면 부분 완료로 기록하는 설계를 권해요. 이미 성공한 채널은 건너뛰고 실패한 채널만 이어가도록 해요. “종료 코드 0”이나 초록색 실행 표시만으로 전부 발행됐다고 적지 않아요.
- 어디서 확인하나요?
- 워크플로 단계 로그 · 배포 결과 · 공개 URL · 채널별 게시 ID
- 언제 체크하나요?
- 대상별 공개 결과를 확인하고 성공·실패·부분 완료를 실제 상태대로 기록했어요.
CHECK 07 / 8실패와 아예 실행되지 않은 날을 모두 찾나요?
실패 알림 수신자를 확인하고 일부러 만든 테스트 실패가 전달되는지 봐요. 그다음 최근 성공 시각과 오늘 기대한 게시 수를 따로 확인해요. 작업이 아예 시작되지 않으면 실패 로그도 생기지 않으므로, 마감 뒤 공개 결과를 확인하는 독립적인 감시가 도움이 돼요. 이 가이드에서는 누락 감지를 위한 별도 확인을 권해요. 중복 방지에 걸려 건너뛴 것인지, 조용히 멈춘 것인지 이유도 기록해요.
- 어디서 확인하나요?
- 실패 알림 설정 · 마지막 성공 시각 · 기대 게시 수와 실제 결과
- 언제 체크하나요?
- 테스트 실패 알림을 받았고 실행 누락도 정한 기한 뒤에 발견할 확인 절차가 있어요.
CHECK 08 / 8재시도와 생성 비용에 한도를 두었나요?
하루 게시 수, AI 생성 횟수, 실행 시간, 유료 API 사용량에 운영 한도를 정해요. GitHub 실행 비용과 외부 모델·게시 도구 비용은 따로 계산해야 해요. 자동으로 반복할수록 비용이 늘 수 있으니 작업별 시도 수와 사용량을 남기고 경고 기준을 정하는 것을 권해요. 한도에 도달하면 해당 작업을 대기 상태로 남기고 알리세요. 누락을 해결한다며 전체 자동화를 설명 없이 꺼버리지 않도록 복구 담당과 절차도 기록해요.
- 어디서 확인하나요?
- 플랫폼 사용량 · 외부 API 비용 화면 · 시도 수·일일 한도 · 복구 절차
- 언제 체크하나요?
- 실제 한도를 문서화했고 초과 시 대기·알림·복구를 하는 경로를 모의 시험했어요.
복사해서 AI에게 붙여넣어보세요
아래 대괄호를 내 주소와 도구, 현재 상황으로 바꿔주세요. 전체를 복사해 사용하는 AI에 붙여넣으면 위 8개 항목과 공개 결과, 남은 계정 작업까지 확인하도록 요청할 수 있어요.
참고 자료
- https://docs.github.com/en/actions/reference/workflows-and-actions/events-that-trigger-workflows
- https://docs.github.com/en/actions/how-tos/write-workflows/choose-what-workflows-do/use-secrets
- https://docs.github.com/en/actions/how-tos/manage-workflow-runs/manually-run-a-workflow
- https://docs.github.com/en/actions/how-tos/write-workflows/choose-when-workflows-run/control-workflow-concurrency
- https://docs.github.com/en/rest/using-the-rest-api/best-practices-for-using-the-rest-api
- https://docs.github.com/en/actions/how-tos/monitor-workflows/view-workflow-run-history
- https://docs.github.com/en/actions/concepts/workflows-and-actions/notifications-for-workflow-runs
- https://docs.github.com/en/actions/concepts/billing-and-usage