GitHub Actions 예약이 9시간 어긋났다면

예약 시간대 확인을 설명하는 AI 생성 이미지.

아침에 받아야 할 AI 요약이 저녁에 도착한다면, 예약식의 시간대부터 보세요. GitHub Actions는 시간대를 따로 적지 않으면 UTC를 쓰고, 한국은 그보다 9시간 빠릅니다.

GitHub.com에서 예약 작업을 쓰는 분을 위한 확인 순서입니다. 아래 코드는 기존 워크플로의 예약 부분 예시이며, AI를 호출하는 작업 전체가 아닙니다.

1. cron 옆의 시간대를 확인하세요

다음 설정은 평일 오전 9시 30분처럼 보이지만, 한국에서는 오후 6시 30분을 뜻합니다.

on:
  schedule:
    - cron: '30 9 * * 1-5'

timezone이 없으니 UTC 9시 30분으로 읽기 때문입니다. cron의 앞 두 칸은 분과 시, 마지막 1-5는 월요일부터 금요일까지입니다.

2026년 10월 9일 확인한 GitHub 공식 문서는 시간대 직접 지정을 지원합니다. 한국시간을 그대로 쓰려면 이렇게 적습니다.

on:
  schedule:
    - cron: '30 9 * * 1-5'
      timezone: 'Asia/Seoul'

이 설정은 한국시간 평일 오전 9시 30분을 뜻합니다. timezone은 위 cron과 같은 예약 항목에 들어갑니다.

2. 기존 UTC 숫자에 시간대만 덧붙이지 마세요

이미 '30 0 * * 1-5'로 한국시간 오전 9시 30분에 맞춰 둔 경우도 있습니다. 이 상태에 Asia/Seoul만 붙이면 한국시간 밤 12시 30분으로 바뀝니다.

cron의 시각과 timezone을 한 쌍으로 확인하세요. 기존 UTC 설정을 유지하거나, 숫자도 9시 30분으로 바꾸면서 시간대를 지정하면 됩니다. 같은 작업에 두 예약을 모두 남기지 않도록 살펴보세요.

3. 조금 늦는다면 실행 기록을 보세요

몇 분 늦는 것과 늘 9시간 어긋나는 것은 다릅니다. GitHub는 특히 매시 정각에 부하가 몰리면 예약 실행이 지연되거나 일부 대기 작업이 빠질 수 있다고 안내합니다. 시간을 바꿨다고 정시 실행이 보장되지는 않습니다.

또 예약 파일은 저장소의 기본 브랜치에 있어야 합니다. 수정 브랜치에만 저장했는지도 확인하세요.

마지막으로 Actions 실행 기록에서 시작 시각과 요약 파일의 저장 결과를 따로 봅니다. 예약이 시작돼도 AI 호출이나 결과 저장은 실패할 수 있습니다.

아래 공식 문서로 문법과 제한을 확인했습니다. 예시를 실제 GitHub 저장소에 배포해 예약 실행까지 시험한 것은 아닙니다. 확인일은 2026년 10월 9일이며 문법·운영 조건은 바뀔 수 있습니다.

GitHub 공식 예약 실행 문서

지금 쓰는 예약의 cron과 timezone 두 줄부터 나란히 확인해보세요.

Events that trigger workflows - GitHub Docs