GitHub Actions 예약 실행: 무료 2,000분과 한국시간
GitHub Actions 예약 실행은 cron 한 줄과 월 2,000분 계산으로 끝난다
GitHub Actions로 매일 한국시간 09:00에 스크립트를 돌리려면 cron: '0 9 * * *'에 timezone: "Asia/Seoul"을 같이 쓰면 된다. timezone 키를 빼면 GitHub은 UTC 기준으로 실행하므로 같은 시각을 '0 0 * * *'로 써야 한다(GitHub Docs, 2026). 무료 계정에서 비공개 저장소는 월 2,000분이 포함되고, 공개 저장소는 표준 러너를 무료로 쓴다(GitHub Docs, 2026).
예약 실행은 워크플로 파일의 on.schedule에 cron 식을 적어 정해진 시각에 작업을 자동으로 시작하는 기능이다. 예약 실행에서 사용량 계산의 기본 단위는 작업(job)이다. GitHub은 작업마다 쓴 시간을 분 단위로 올려 계산하므로, 20초 걸린 작업도 1분으로 친다(GitHub Docs, 2026).
아래 예시는 매일 한국시간 09:10에 파이썬 스크립트 하나를 실행하는 최소 구성이다.
name: daily-report
on:
schedule:
- cron: '10 9 * * *'
timezone: "Asia/Seoul"
jobs:
run:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- run: python report.py
cron 다섯 칸은 분·시·일·월·요일 순서다
cron 식은 공백으로 구분한 5개 필드로 이루어진다. 순서는 분(0-59), 시(0-23), 일(1-31), 월(1-12 또는 JAN-DEC), 요일(0-6 또는 SUN-SAT)이다(GitHub Docs, Workflow syntax, 2026). 요일 0은 일요일이므로 월~금은 1-5로 쓴다.
각 필드에는 연산자 네 가지를 쓸 수 있다. *는 모든 값, ,는 값 목록, -는 범위, /는 간격이다. 공식 문서의 예시로 20/15 * * * *는 매시 20분·35분·50분에 실행된다(GitHub Docs, 2026).
| 원하는 주기 | cron 식 | 하루 실행 횟수(회) |
|---|---|---|
| 매일 1회(09:00) | 0 9 * * * |
1 |
| 평일 1회(09:00) | 0 9 * * 1-5 |
1(주말 0) |
| 매시 15분 | 15 * * * * |
24 |
| 30분마다 | */30 * * * * |
48 |
| 15분마다 | */15 * * * * |
96 |
| 5분마다(최소 간격) | */5 * * * * |
288 |
예약 워크플로의 최소 실행 간격은 5분에 1회다(GitHub Docs, Events that trigger workflows, 2026). * * * * *처럼 1분 간격으로 적어도 5분보다 자주 실행되지 않는다.
한국시간은 timezone 키로 쓰거나 9시간을 빼서 쓴다
예약 워크플로는 기본적으로 UTC로 실행되고, IANA 시간대 문자열을 지정하면 그 시간대로 실행된다(GitHub Docs, 2026). 한국 표준시(KST)는 UTC보다 9시간 빠르고 서머타임이 없다. 그래서 Asia/Seoul을 지정하면 한국시간을 그대로 적으면 된다.
timezone 키 없이 UTC로 쓸 때는 날짜가 바뀌는 시간대를 조심해야 한다. 한국시간 오전 9시 이전은 UTC로 전날이다. 그래서 요일 필드도 하루 앞으로 옮겨야 한다. 아래 표는 같은 한국시간을 두 방식으로 적은 결과다.
| 한국시간(KST) 실행 시각 | timezone: "Asia/Seoul"일 때 | UTC로 쓸 때 | 요일 보정 |
|---|---|---|---|
| 매일 09:00 | 0 9 * * * |
0 0 * * * |
없음 |
| 매일 07:30 | 30 7 * * * |
30 22 * * * |
전날 22:30 UTC |
| 매일 18:00 | 0 18 * * * |
0 9 * * * |
없음 |
| 평일 09:00 | 0 9 * * 1-5 |
0 0 * * 1-5 |
없음 |
| 평일 08:00 | 0 8 * * 1-5 |
0 23 * * 0-4 |
일~목으로 이동 |
| 매월 1일 06:00 | 0 6 1 * * |
0 21 L * * 불가 → timezone 키 권장 |
전달 말일이 됨 |
"매월 1일 한국시간 06:00"을 UTC로 옮기면 전달 말일 21:00이 된다. 말일은 28·30·31일로 바뀌어 cron 한 줄로 표현하기 어렵다. 이런 경우는 timezone 키를 쓰는 편이 정확하다.
서머타임이 있는 시간대를 지정하면 건너뛰는 시각의 예약은 다음 유효 시각으로 넘어간다. 공식 문서 예시로 2:30 AM 예약은 3:00 AM에 실행된다(GitHub Docs, 2026). Asia/Seoul은 서머타임이 없어 이 문제가 생기지 않는다.
월 2,000분 안에서 돌릴 수 있는 횟수 계산하기
무료 계정의 한도는 시간이 아니라 "작업별로 올림한 분의 합"으로 판단한다. 분은 러너 유형별로 그 달의 총 사용 시간을 기준으로 계산하고, 워크플로를 실행한 사람이 아니라 저장소 소유자에게 청구된다(GitHub Docs, 2026). 사용한 분은 결제 주기가 시작될 때마다 초기화된다.
자기 워크플로에 대입하는 계산 순서
- 워크플로 1회에 들어 있는 작업마다 실행 시간을 분 단위로 올린다. 3분 10초는 4분이다.
- 작업별 올림 값을 더해 1회 사용 분을 구한다. 20초짜리 작업 2개면 1분+1분=2분이다.
- 하루 실행 횟수를 구한다. 간격 실행은 1,440 ÷ 간격(분)이다.
- 1회 사용 분 × 하루 횟수 × 31일로 월 사용 분을 구한다.
- 결과를 포함 분과 비교한다. Free 2,000분, Pro 3,000분이다(GitHub Docs, 2026).
- 초과분에 분당 단가를 곱해 예상 요금을 낸다. Linux 2코어는 분당 $0.006이다.
주기별 월 사용 분 계산표
아래 표는 비공개 저장소에서 Linux 2코어 표준 러너로 31일 동안 돌렸을 때의 월 사용 분과 Free 한도 초과 요금이다.
| 주기 · 1회 작업 시간 | 1회 사용(분) | 월 실행(회) | 월 사용(분) | Free 2,000분 대비 | 초과 요금(USD) |
|---|---|---|---|---|---|
| 매일 1회 · 3분 10초 | 4 | 31 | 124 | 여유 | 0 |
| 매일 1회 · 10분 | 10 | 31 | 310 | 여유 | 0 |
| 1시간마다 · 40초 | 1 | 744 | 744 | 여유 | 0 |
| 30분마다 · 50초 | 1 | 1,488 | 1,488 | 여유 | 0 |
| 30분마다 · 1분 10초 | 2 | 1,488 | 2,976 | 976분 초과 | 5.856 |
| 15분마다 · 1분 | 1 | 2,976 | 2,976 | 976분 초과 | 5.856 |
| 5분마다 · 1분 | 1 | 8,928 | 8,928 | 6,928분 초과 | 41.568 |
초과 요금은 초과 분 × $0.006으로 계산했다. 976 × 0.006 = 5.856, 6,928 × 0.006 = 41.568이다. 결제수단을 등록하지 않았다면 요금이 나오는 대신 한도를 다 쓴 뒤 사용이 차단된다(GitHub Docs, 2026).
1분 안에 끝나는 작업이라면 Free 한도 안에서 하루 64회까지 돌릴 수 있다. 2,000 ÷ 31 = 64.5이기 때문이다. 간격으로 바꾸면 약 22.3분(1,440 ÷ 64.5)이다. 깔끔한 cron 간격 중에서는 30분이 상한이고, 20분 간격(월 2,232분)부터 한도를 넘는다.
러너별 분당 단가
러너 운영체제에 따라 분당 단가가 다르다. 아래 표는 표준 GitHub 호스팅 러너의 분당 단가다(GitHub Docs, Actions runner pricing, 2026).
| 러너 | 분당 단가(USD) | 1,000분 초과 시(USD) |
|---|---|---|
| Linux 1코어(x64) | 0.002 | 2 |
| Linux 2코어(x64) | 0.006 | 6 |
| Linux 2코어(arm64) | 0.005 | 5 |
| Windows 2코어(x64·arm64) | 0.010 | 10 |
| macOS 3코어 또는 4코어 | 0.062 | 62 |
Windows·macOS 러너가 포함 분을 Linux와 같은 비율로 차감하는지는 공식 과금 문서에서 명시적으로 확인되지 않았다. 예약 작업이 운영체제를 가리지 않는다면 Linux 러너가 가장 싸다. 포함 분은 라지 러너에 쓸 수 없고, 라지 러너는 공개 저장소에서도 항상 과금된다(GitHub Docs, 2026).
요금제별 포함량과 공개·비공개 저장소 선택 기준
요금제마다 월 포함 분과 아티팩트 저장공간이 다르다. 아래 표는 GitHub 공식 과금 문서의 월 포함량이다(GitHub Docs, 2026).
| 요금제 | 포함 분(분/월) | 아티팩트 저장공간 | Actions 캐시 |
|---|---|---|---|
| GitHub Free | 2,000 | 500MB | 저장소마다 10GB |
| GitHub Pro | 3,000 | 1GB | 저장소마다 10GB |
| GitHub Free for organizations | 2,000 | 500MB | 저장소마다 10GB |
| GitHub Team | 3,000 | 2GB | 저장소마다 10GB |
| GitHub Enterprise Cloud | 50,000 | 50GB | 저장소마다 10GB |
저장공간을 넘기면 아티팩트·Packages 공유 저장공간은 월 GB당 $0.25, Actions 캐시는 월 GB당 $0.07이 붙는다(GitHub Docs, 2026). 예약 작업이 매번 아티팩트를 올린다면 보관 기간을 짧게 잡아야 500MB를 넘기지 않는다.
공개 저장소의 표준 러너는 분 제한 없이 무료다. 셀프 호스티드 러너도 GitHub Actions 사용료가 없다(GitHub Docs, 2026). 아래 판정 표로 저장소 공개 여부를 정하면 된다.
| 상황 | 권장 | 이유 |
|---|---|---|
| 코드·설정에 비밀이 없고 30분보다 자주 돌린다 | 공개 저장소 | 표준 러너 무료 |
| 코드가 비공개여야 하고 월 사용이 2,000분 이하 | 비공개 저장소(Free) | 포함 분 안에서 해결 |
| 비공개이고 월 2,000~3,000분 | Pro 또는 결제수단 등록 | Pro 포함 3,000분 |
| 비공개이고 5분 간격처럼 월 수천 분 | 셀프 호스티드 러너 검토 | Actions 사용료 무료 |
| 공개 저장소인데 커밋이 드물다 | 60일 무활동 대비 필요 | 예약이 자동 비활성화됨 |
API 키 같은 비밀값은 공개 저장소라도 코드에 넣지 말고 저장소 시크릿에 둔다. 비공개 저장소로 정적 사이트를 무료 배포하는 방법은 비공개 저장소 무료 정적 배포 가이드에 정리했다.
예약 실행이 안 돌 때 점검 체크리스트
예약 실행이 시작되지 않는 원인은 대부분 공식 문서의 제약 조건에 있다. 아래 항목을 위에서부터 차례로 확인한다(GitHub Docs, Events that trigger workflows, 2026).
- [ ] 워크플로 파일이 기본 브랜치에 있는가. 예약 워크플로는 기본 브랜치의 최신 커밋에서만 실행된다.
- [ ] cron 간격이 5분 이상인가. 5분보다 짧은 간격은 지원하지 않는다.
- [ ] timezone 키가 없다면 시각을 UTC로 적었는가. 한국시간에서 9시간을 뺐는지 확인한다.
- [ ] 공개 저장소에서 60일 동안 활동이 없지 않았는가. 그러면 예약이 자동으로 비활성화되고 직접 다시 켜야 한다.
- [ ] 정각(매시 00분)에 몰려 있지 않은가. 부하가 높을 때 schedule 이벤트는 지연되고, 아주 높으면 대기 작업이 누락될 수 있다.
- [ ] 비공개 저장소의 포함 분을 다 쓰지 않았는가. 결제수단이 없으면 한도 소진 뒤 사용이 차단된다.
- [ ] 작업이 6시간을 넘기지 않는가. GitHub 호스팅 러너의 작업 1개는 최대 6시간이고, 넘기면 종료되어 실패 처리된다(GitHub Docs, Actions limits, 2026).
- [ ] 동시에 도는 작업이 20개를 넘지 않는가. Free 요금제 표준 러너의 동시 작업은 전체 20개, macOS 5개까지다(GitHub Docs, Actions limits, 2026).
정각 지연을 피하려면 0 9 * * * 대신 10 9 * * *처럼 분을 옮긴다. 정확한 시각이 중요한 작업이라면 GitHub의 schedule 이벤트가 시각을 보장하지 않는다는 점을 전제로 설계해야 한다. 같은 주제의 다른 도구 가이드는 AI·개발 도구 가이드 목록에서, 설정 질문은 바이브 코딩 커뮤니티에서 이어서 볼 수 있다.
자주 묻는 질문
GitHub Actions 예약 실행을 한국시간으로 맞추려면 어떻게 쓰나요?
cron 항목 아래에 timezone: "Asia/Seoul"을 추가하면 한국시간을 그대로 적을 수 있다. timezone 키가 없으면 UTC 기준이므로 한국시간에서 9시간을 빼야 한다. 한국시간 09:00은 UTC로 0 0 * * *이다.
무료 계정에서 매일 한 번 돌리면 몇 분을 쓰나요?
1회 3분 10초 걸리는 작업은 4분으로 올림되어 31일에 124분을 쓴다. 무료 계정의 비공개 저장소 포함량인 2,000분의 약 6%다. 공개 저장소에서 표준 러너로 돌리면 분을 차감하지 않는다.
5분마다 실행하면 무료 한도를 넘나요?
1분 이하 작업도 5분마다 돌리면 하루 288회, 31일에 8,928분이 되어 2,000분을 넘는다. Linux 2코어 기준 초과 6,928분 × $0.006 = 약 $41.57이다. 결제수단이 없으면 요금 대신 한도 소진 뒤 실행이 차단된다.
예약해 둔 워크플로가 제시간에 실행되지 않는 이유는 무엇인가요?
GitHub Actions 부하가 높을 때 schedule 이벤트는 지연될 수 있고, 부하가 아주 높으면 대기 작업이 누락될 수 있다. 정각을 피해 분을 옮기면 몰림을 줄일 수 있다. 워크플로 파일이 기본 브랜치에 있는지도 함께 확인한다.
공개 저장소의 예약 실행이 갑자기 멈췄어요.
공개 저장소에서 60일 동안 저장소 활동이 없으면 예약 워크플로가 자동으로 비활성화된다. 저장소의 Actions 화면에서 워크플로를 다시 활성화하면 예약이 재개된다. 멈춘 날짜와 마지막 커밋 날짜를 비교해 60일이 지났는지 확인한다.
출처
- GitHub, GitHub Actions billing (2026): https://docs.github.com/en/billing/concepts/product-billing/github-actions
- GitHub, Actions runner pricing (2026): https://docs.github.com/en/billing/reference/actions-runner-pricing
- GitHub, Events that trigger workflows — schedule (2026): https://docs.github.com/en/actions/writing-workflows/choosing-when-your-workflow-runs/events-that-trigger-workflows
- GitHub, Workflow syntax for GitHub Actions — on.schedule (2026): https://docs.github.com/en/actions/reference/workflows-and-actions/workflow-syntax
- GitHub, Actions limits (2026): https://docs.github.com/en/actions/reference/limits