EC2 Image Builder에서 cron 표현식 사용

EC2 Image Builder용 cron 표현식을 사용하여 파이프라인의 기본 이미지 및 구성 요소에 적용되는 업데이트로 이미지를 새로 고치는 기간을 설정합니다. 파이프라인 새로 고침 기간은 cron 표현식에서 설정한 시간부터 시작됩니다. cron 표현식의 시간을 분 단위까지 설정할 수 있습니다. 파이프라인 빌드는 시작 시간에 또는 그 이후에 실행될 수 있습니다.

빌드가 실행되기 시작하는 데 몇 초 또는 최대 1분이 소요될 수 있습니다.

참고

크론 표현식은 기본적으로 협정 세계시 (UTC) 시간대를 사용하거나 사용자가 시간대를 지정할 수 있습니다. 협정 세계시(UTC)에 대한 자세한 내용과 시간대에 대한 오프셋을 찾으려면 전 세계 시간대 약어 목록을 참조하십시오.

Image Builder에서 Cron 표현식에 대해 지원되는 값

EC2 Image Builder는 6개의 필수 필드로 구성된 cron 형식을 사용합니다. 각 필드는 선행 공백 또는 후행 공백 없이 사이에 공백을 두고 다른 필드와 구분합니다.

<Minute> <Hour> <Day> <Month> <Day of the week> <Year>

다음 표에는 필수적인 cron 항목에 대해 지원되는 값이 나와 있습니다.

Cron 표현식에 대해 지원되는 값
필드	값	와일드카드
분	0-59	, - * /
시간	0-23	, - * /
일	1-31	, - * ? / L W
월	1-12 또는 jan-dec	, - * /
요일	1-7 또는 sun-sat	, - * ? L #
연도	1970-2199	, - * /

와일드카드

다음 표에서는 Image Builder가 cron 표현식에 와일드카드를 사용하는 방법을 설명합니다. 빌드를 시작하는 데 지정한 시간이 지난 후 최대 1분이 소요될 수 있음을 유의하세요.

Cron 표현식에 대해 지원되는 와일드카드
와일드카드	설명
,	,(쉼표) 와일드카드는 추가 값을 포함합니다. 예컨대, ‘월’ 필드에서 jan,feb,mar는 1월, 2월, 3월을 포함한다는 의미입니다.
-	-(대시) 와일드카드는 범위를 지정합니다. 예컨대, ‘일’ 필드에서 1-15는 지정된 달의 1일에서 15일까지 포함한다는 의미입니다.
*	*(별표) 와일드카드는 필드의 모든 유효한 값을 포함합니다.
?	?(물음표) 와일드카드는 필드 값이 다른 설정에 종속되도록 지정합니다. Day 및 D ay-of-week 필드의 경우 하나를 지정하거나 가능한 모든 값 (*) 을 포함하는 경우 다른 하나는 a여야 합니다. ? 둘 다 지정할 수는 없습니다. 예를 들어, Day 필드에 7 a를 입력하면 (매월 7일에 빌드 실행) D ay-of-week 위치에는 ? a가 포함되어야 합니다.
/	/(슬래시) 와일드카드로 증분을 지정합니다. 예를 들어, 이틀에 한 번씩 빌드를 실행하려면 ‘일’ 필드에 */2(을)를 입력합니다.
L	날짜 필드 중 하나에 있는 L 와일드카드는 마지막 날을 지정합니다. 즉, 월에 따라 일의 경우 28~31일로, 요일의 경우 일요일을 지정합니다.
W	D ay-of-month 필드의 W 와일드카드는 요일을 지정합니다. D ay-of-month 필드에 앞에 숫자를 입력하면 해당 날짜와 가장 가까운 요일을 대상으로 지정하려는 것입니다. W 예를 들어, 3W를 지정하는 경우 해당 월의 3일과 가장 가까운 평일에 빌드가 실행되도록 할 수 있습니다.
#	#(해시)는 요일 필드에만 허용되며 그 뒤에 1에서 5 사이의 숫자가 와야 합니다. 숫자는 지정된 월에서 빌드 실행을 적용할 주를 지정합니다. 예를 들어, 매월 두 번째 금요일에 빌드를 실행하려면 요일 필드에 fri#2(을)를 사용합니다.

제한 사항

• 동일한 cron 표현식에 D ay-of-month 필드와 D ay-of-week 필드를 지정할 수 없습니다. 이들 필드 중 하나에 값 또는 *(을)를 지정하는 경우에는 다른 필드에서 반드시 ?(을)를 사용해야 합니다.

• 1분보다 빠른 속도로 이어지는 cron 표현식은 지원되지 않습니다.

EC2 Image Builder의 cron 표현식 예제

Image Builder 콘솔에서는 cron 표현식이 API 또는 CLI와 다르게 입력됩니다. 예제를 보려면 해당하는 탭을 선택하세요.

Image Builder console

다음 예제는 빌드 일정에 맞게 콘솔에 입력할 수 있는 cron 표현식을 보여줍니다. 협정 세계시(UTC)는 24시간제를 사용하여 지정합니다.

매일 오전 10시(UTC)에 실행

0 10 * * ? *

매일 오후 12시 15분(UTC)에 실행

15 12 * * ? *

매일 자정(UTC)에 실행

0 0 * * ? *

매주 평일 오전 10시(UTC)에 실행

0 10 ? * 2-6 *

매주 평일 오후 6시(UTC)에 실행

0 18 ? * mon-fri *

매월 1일 오전 8시(UTC)에 실행

0 8 1 * ? *

매월 두 번째 화요일 오후 10시 30분(UTC)에 실행

30 22 ? * tue#2 *

작은 정보

파이프라인 작업이 실행되는 동안 다음 날까지 연장되지 않도록 하려면, 시작 시간을 지정할 때 빌드 시간을 고려해야 합니다.

API/CLI

다음 예제는 CLI 명령 또는 API 요청을 사용하여 빌드 일정에 입력할 수 있는 cron 표현식을 보여줍니다. cron 표현식만 표시됩니다.

매일 오전 10시(UTC)에 실행

cron(0 10 * * ? *)

매일 오후 12시 15분(UTC)에 실행

cron(15 12 * * ? *)

매일 자정(UTC)에 실행

cron(0 0 * * ? *)

매주 평일 오전 10시(UTC)에 실행

cron(0 10 ? * 2-6 *)

매주 평일 오후 6시(UTC)에 실행

cron(0 18 ? * mon-fri *)

매월 1일 오전 8시(UTC)에 실행

cron(0 8 1 * ? *)

매월 두 번째 화요일 오후 10시 30분(UTC)에 실행

cron(30 22 ? * tue#2 *)

작은 정보

파이프라인 작업이 실행되는 동안 다음 날까지 연장되지 않도록 하려면, 시작 시간을 지정할 때 빌드 시간을 고려해야 합니다.

EC2 Image Builder의 rate 표현식

rate 표현식은 예약된 이벤트 규칙을 생성할 때 시작되며, 정의된 예약 일정에 따라 실행됩니다.

rate 표현식에는 필수 필드가 2개 있습니다. 각 필드는 공백으로 구분됩니다.

구문

rate(value unit)

값

양수.

unit

시간 단위. 1의 값(예: minute)과 1을 초과하는 값(예: minutes)은 서로 다른 단위가 필요합니다.

유효값: 분 | 분 | 시간 | 시간 | 일 | 일

제한 사항

값이 1(와)과 같을 경우에는 단위가 단수여야 합니다. 마찬가지로, 1보다 큰 값에 대해서는 단위가 복수여야 합니다. 예를 들어 rate(1 hours)(와)과 rate(5 hour)은(는) 잘못된 식이며 rate(1 hour)(와)과 rate(5 hours)은(는) 유효한 식입니다.