EventBridge에서 cron 표현식을 설정하는 방법

Overview

Amazon EventBridge에서는 cron(...) 표현식으로 Lambda, Step Functions 같은 작업의 실행 시간을 정할 수 있다.

이 문서는 EventBridge 기준 cron 필드 순서와 자주 쓰는 예시만 간단히 정리한다.

How to

1) EventBridge cron 필드 순서

EventBridge의 cron 표현식은 아래 6개 필드를 사용한다.

cron(분 시 일 월 요일 연도)

예:

cron(1 11 3 * ? *)

• 매달 3일 11시 01분에 실행

2) 각 필드 의미

• 분(minute)
• 시(hour)
• 일(day-of-month)
• 월(month)
• 요일(day-of-week)
• 연도(year)

3) 자주 쓰는 기호

• *: 모든 값
• ,: 여러 값 나열
• -: 범위 지정
• /: 간격 지정
• ?: 일 또는 요일 필드를 비워 둘 때 사용

Example

1) 매일 18시 00분 실행

cron(0 18 * * ? *)

2) 매일 10분마다 실행

cron(0/10 * * * ? *)

3) 평일 21시 00분 실행

cron(0 21 ? * MON-FRI *)

4) 매달 10일 04시 42분 실행

cron(42 4 10 * ? *)

5) 매주 월요일 17시 00분 실행

cron(0 17 ? * MON *)

6) 여러 값을 나열해서 실행

cron(0 6,12 ? * * *)

• 매일 06시와 12시에 실행

7) 시간 간격을 지정해서 실행

cron(0 0/4 * * ? *)

• 매일 4시간 간격으로 실행

8) 범위를 지정해서 실행

cron(0 9-17 ? * MON-FRI *)

• 평일 09시부터 17시까지 매시간 정각에 실행

---

Notes

1) 일반 crontab과 EventBridge는 다르다

• 일반 crontab은 보통 5개 필드를 쓰지만, EventBridge는 6개 필드에 연도까지 포함한다.
• EventBridge에서는 일(day-of-month)과 요일(day-of-week)을 함께 쓸 때 ?를 자주 사용한다.

2) ?가 필요한 이유

• EventBridge는 일과 요일 필드를 동시에 명확하게 지정하지 않는 쪽이 안전하다.
• 예를 들어 매주 월요일만 지정하고 싶다면 일 필드는 ?로 두고 요일만 MON으로 지정한다.

3) 시간대 확인

• EventBridge 스케줄은 AWS 콘솔이나 리소스 설정에 따라 UTC 기준으로 보일 수 있다.
• 원하는 지역 시간대로 실행되는지 최종 설정 화면에서 한 번 더 확인하는 편이 좋다.

4) 참고 문서

• AWS - Amazon EventBridge에서 cron 및 rate 표현식 사용하기