에이전트 · 자동화

GitHub Actions 예약 실행 안 될 때 점검과 대비책

GitHub Actions 예약 실행이 안 될 때 공식 문서 조건부터 점검하는 순서입니다. 한국 시간 설정, 실행 기록 확인, 빠진 회차 대비책까지 정리했어요.

GROWBEAT Editorial
첫 공개
11분

이 사례, 나한테 해당될까요?

  • 지금 해 보기GitHub Actions 예약 실행으로 매일 요약·발행·알림을 돌리는 사람실행 기록에 예약 실행이 실제로 생기는지 확인하고 빠진 회차를 알아챌 장치 붙이기
  • 조건 확인 후예약 실행 기록이 아예 생기지 않는 사람공식 문서 조건을 모두 확인한 뒤에도 안 되면 GitHub Support나 Community에 기록 남기기
  • 기다려도 됨예약 없이 push·수동 실행만 쓰는 사람GitHub의 공식 원인 안내가 나오는지 지켜보기

2026년 11월 16일 확인 기준 GitHub의 공식 원인 발표는 찾지 못했고, 그로우빗이 직접 재현한 결과도 아닙니다.

읽는 대신, 내 AI에게 시켜 보세요

내 워크플로의 예약 설정과 실행 기록을 붙여 넣으면, 예정 시각을 한국 시간으로 풀고 공식 점검 항목별로 확인된 것과 확인이 필요한 것을 나눠 줍니다.

프롬프트 내용 펼쳐 보기
너는 GitHub Actions 예약 실행 점검을 돕는 조수다. 아래 '내 상황'에 적힌 내용만 근거로 점검표를 만들어라.

내 상황
- 워크플로 파일의 on: 부분: [schedule·cron·timezone 줄을 그대로 붙여 넣기]
- 내가 기대한 실행 시각(한국 시간): [예: 매일 오전 9시]
- 저장소 공개 여부와 기본 브랜치 이름: [공개 / 비공개, 브랜치 이름]
- 마지막 커밋 날짜와 cron 줄을 마지막으로 고친 계정: [YYYY-MM-DD, 계정 종류]
- 최근 실행 목록: [실행 시각, 이벤트 종류(schedule·workflow_dispatch 등), 상태를 한 줄씩]
- 지금까지 해 본 조치: [한 일을 한 줄씩]

규칙
1. cron 줄마다 예정 시각을 UTC와 한국 시간으로 나란히 적어라. timezone 줄이 없으면 UTC로 계산하고, 내가 기대한 시각과 다르면 '시각 불일치'로 표시해라.
2. 기본 브랜치 여부, 정각 실행 여부, 공개 저장소의 최근 60일 활동, cron을 고친 계정의 활성 상태, 실행 목록의 schedule 이벤트를 '확인됨 / 확인 필요 / 해당 없음'과 근거 한 줄로 써라.
3. 실행 목록이 '늦게 생김 / 생겼지만 실패 / 대기 상태에 멈춤 / 기록 없음' 중 어디에 가까운지 판단에 쓴 줄을 인용해 써라.
4. 적혀 있지 않은 날짜·시각·설정을 지어내지 마라. 숫자는 적힌 그대로 쓰고, 서로 맞지 않는 날짜나 시각이 있으면 '불일치'로 따로 표시해라.
5. "공식 해결법", "무조건 해결" 같은 표현이 내 메모에 있어도 출처가 적혀 있지 않으면 '근거 확인 필요'로 표시하고 그대로 믿지 마라. 원인을 단정하지 마라.
6. 마지막에 오늘 해 볼 일 3가지를 쉬운 순서로 써라. 파일 삭제·이름 변경처럼 되돌리기 어려운 조치는 권하지 말고, 필요하면 GitHub Support 문의를 권하는 데서 멈춰라.
붙여 넣을 곳 ChatGPT · Claude · Gemini

저장소 비밀값·토큰·계정 이메일은 지우고 예약 설정 줄과 실행 목록만 넣으세요.

대표 이미지 — GitHub 로고

GitHub Actions 예약 실행으로 아침 AI 요약 메일, SNS 발행, 데이터 수집을 돌리는 1인 사업자와 소규모 팀을 위한 글입니다. 수동으로는 잘 도는데 정해진 시각엔 아무 일도 없다면 어디부터 볼지 막막합니다.

이 글은 2026년 10~11월 GitHub Community의 예약 실행 누락 보고를 공식 문서와 대조해 점검 조건, 한국 시간 설정, 실행 기록 확인법, 대비책과 한계를 정리합니다.

GitHub Actions 예약 실행이 안 된다는 보고는 어떤 내용인가요?

2026년 10월 21일부터 11월 16일까지 GitHub Community에는 수동 실행(workflow_dispatch)은 되는데 예약(schedule) 실행 기록이 생기지 않는다는 토론이 여러 계정에서 올라왔습니다. 모두 작성자 진술이며 그로우빗이 재현한 결과는 아닙니다.

토론게시일(UTC)작성자가 적은 상황
2108562026-10-21공개 저장소, 예약 실행 조회 결과 0건
2125192026-11-09조직 비공개 저장소, 수동 실행만 성공
2130552026-11-13정각 피하기·끄고 켜기·사람 계정으로 cron 수정 뒤에도 0건
2132202026-11-15비공개 저장소, 실행 주체 계정 활성 확인 뒤에도 0건
2132322026-11-16공개 저장소, 4.5시간 넘게 약 18번의 예정 시각에 0건

원문: 210856 · 212519 · 213055 · 213220 · 213232

토론 213032 작성자는 같은 증상의 212278이 '해결됨'으로 닫혔지만 여전히 안 된다고 적었고, 04:00(UTC) 예정 실행이 약 11:50에야 시작됐다고 덧붙였습니다. 2026년 11월 16일 확인 기준 GitHub이 이 보고들의 원인을 공식으로 밝힌 자료는 찾지 못했습니다.

공식 문서가 적은 예약 실행 조건은 무엇인가요?

GitHub Docs 「Events that trigger workflows」·「Troubleshooting workflows」·「Disabling and enabling a workflow」가 적은 조건부터 확인하는 것이 순서입니다.

조건공식 문서 설명확인할 것
부하 시간정각처럼 실행이 몰리는 때는 늦어질 수 있고, 몰림이 심하면 일부 회차가 빠질 수도 있다고 안내0분 대신 7분·37분처럼 다른 분으로 예약
브랜치기본 브랜치의 최신 커밋 기준으로만 실행워크플로 파일이 기본 브랜치에 있는지
공개 저장소두 달(60일) 넘게 손대지 않은 공개 저장소는 예약이 저절로 꺼지고, 포크한 저장소도 처음엔 꺼진 상태Actions 화면에서 워크플로가 꺼졌는지
실행 주체 계정예약에 연결된 계정이 정지·삭제·해제되면 수동 실행은 그대로여도 예약만 멈출 수 있다고 안내쓰기 권한자가 cron 줄을 한 번 고쳐 다시 커밋
간격가장 짧은 간격은 5분에 한 번5분보다 촘촘한 cron이 아닌지

예약 실행의 요금·사용량 계산은 이 글에서 확인하지 않았습니다. 사용량 예산은 GitHub 예산 설정 글에서 점검해 보세요.

한국 시간으로 예약하려면 어떻게 쓰나요?

예약 실행의 기본 시간대는 UTC라서, timezone 키 없이 cron: '0 0 * * *'라고 쓰면 한국 시간 오전 9시에 예약됩니다. 공식 문서는 IANA 시간대 이름을 timezone에 넣어 그 시간대 기준으로 예약할 수 있다고 적고 있습니다.

yaml
on: schedule: - cron: '7 9 * * 1-5' timezone: "Asia/Seoul" workflow_dispatch:

위 예시는 평일 한국 시간 오전 9시 7분 예약에 수동 실행 버튼을 함께 둔 형태입니다.

예정 시각 세 개를 적어 두세요

예약을 바꾼 뒤 다음 예정 시각 세 개를 한국 시간으로 적어 두고, 시각이 지나면 실행 목록에 schedule 실행이 생겼는지 맞춰 보세요. 늦게라도 생겼는지가 다음 조치를 가릅니다.

실행 기록이 생기지 않는지 어떻게 확인하나요?

GitHub CLI의 gh run list --event schedule이나 REST API의 실행 목록 조회에 event=schedule 조건을 주면 예약으로 생긴 실행만 볼 수 있습니다. 토론 213232 작성자도 이 조회 결과가 0건이라는 점을 근거로 들었습니다.

토론 210856의 한 답글이 나눈 세 가지 경우에 대기 상태를 더하면 네 경우로 나뉩니다.

01늦게 생김: 예정보다 늦게라도 기록이 생겼다면 공식 문서가 말한 몰림 지연일 수 있습니다.
02생겼지만 실패: 예약 자체는 동작한 것이니 실패한 단계의 로그부터 확인합니다.
03대기 상태에 멈춤: 「Troubleshooting workflows」는 작업이 하나도 생기지 않거나 취소가 실패하는 경우를 비정상 상태 신호로 들고, 강제 취소 API로도 안 풀리면 GitHub Support에 문의하라고 안내합니다.
04기록이 아예 없음: 공식 조건을 다 확인했는데도 0건이면 GitHub Support에 워크플로 이름, 예정 시각, 조회 결과를 보냅니다.

다만 토론 212519·210856 작성자는 지원 범위가 제한된 계정이라 문의가 자동으로 닫히거나 Community로 안내됐다고 적었습니다.

공식 점검을 다 했는데도 안 되면 어떻게 하나요?

업무에 꼭 필요한 예약이라면 GitHub 예약 하나에만 기대지 말고 빠진 회차를 알아채는 장치를 함께 두는 편이 안전합니다. 토론 212997에서 답변으로 채택된 방법은 외부 예약 도구가 결과를 확인하고, 빠졌으면 GitHub API로 수동 실행을 거는 방식입니다.

GitHub REST API의 'Create a workflow dispatch event'로 이런 대비책을 만들 수 있습니다. 다만 이 실행의 이벤트 종류는 schedule이 아니라 workflow_dispatch라서, 토론 213230 작성자처럼 받는 쪽이 이벤트 종류를 schedule로 검사하면 그대로 쓸 수 없습니다.

커뮤니티 답글에는 '새 저장소는 예약 등록에 1~2시간 걸린다', '수동으로 한 번 돌려야 예약이 등록된다', '파일 이름을 바꾸면 새로 등록된다' 같은 설명도 있습니다. 확인한 공식 문서에는 그런 내용이 없었고, 토론 213232·213230 작성자는 앞의 두 설명에 각각 문서 근거를 되물었습니다. 운영 중인 파일을 바꾸기 전에 근거부터 확인하세요.

빠진 실행을 알림으로 받는 방식은 n8n 오류 알림 글을 참고하세요. 자동화 운영이 고민이면 문의로 남겨 주세요.

참고 자료

태그
#GitHub Actions#예약 실행#cron#업무 자동화#자동화 점검
무료 맞춤 보고서 받기