기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Image Builder에서 cron 표현식 사용
EC2 Image Builder용 cron 표현식을 사용하여 파이프라인의 기본 이미지 및 구성 요소에 적용되는 업데이트로 이미지를 새로 고치는 기간을 설정합니다. 파이프라인 새로 고침 기간은 cron 표현식에서 설정한 시간부터 시작됩니다. cron 표현식의 시간을 분 단위까지 설정할 수 있습니다. 파이프라인 빌드는 시작 시간에 또는 그 이후에 실행될 수 있습니다.
빌드가 실행되기 시작하는 데 몇 초 또는 최대 1분이 소요될 수 있습니다.
**참고**
Cron 표현식은 기본적으로 UTC(Universal Coordinated Time) 시간대를 사용하지만 시간대를 지정할 수도 있습니다. 협정 세계시(UTC)에 대한 자세한 내용과 시간대에 대한 오프셋을 찾으려면 [전 세계 시간대 약어 목록](https://www.timeanddate.com/time/zones/)을 참조하십시오.
## Image Builder에서 Cron 표현식에 대해 지원되는 값
EC2 Image Builder는 6개의 필수 필드로 구성된 cron 형식을 사용합니다. 각 필드는 선행 공백 또는 후행 공백 없이 사이에 공백을 두고 다른 필드와 구분합니다.
`{{}} {{}} {{}} {{}} {{}} {{}}`
다음 표에는 필수적인 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일까지 포함한다는 의미입니다. |
| \* | \*(별표) 와일드카드는 필드의 모든 유효한 값을 포함합니다. |
| ? | ?(물음표) 와일드카드는 필드 값이 다른 설정에 종속되도록 지정합니다. ‘일’ 및 ‘요일’ 필드의 경우 하나를 지정하거나 가능한 모든 값(\*)을 포함하는 경우 다른 필드는 ?(이)여야 합니다. 둘 다 지정할 수는 없습니다. 예를 들어, ‘일’ 필드에 7을 입력하면(매월 7일에 빌드 실행) ‘요일’ 위치에는 ?가 포함되어야 합니다. |
| / | /(슬래시) 와일드카드로 증분을 지정합니다. 예를 들어, 이틀에 한 번씩 빌드를 실행하려면 ‘일’ 필드에 \*/2(을)를 입력합니다. |
| L | 날짜 필드 중 하나에 있는 L 와일드카드는 마지막 날을 지정합니다. 즉, 월에 따라 일의 경우 28\~31일로, 요일의 경우 일요일을 지정합니다. |
| W | '일' 필드에서는 W 와일드카드로 어떤 한 평일을 지정할 수 있습니다. ‘일’ 필드에서 W 앞에 숫자를 입력하면 해당 날짜와 가장 가까운 평일을 대상으로 지정하려는 것입니다. 예를 들어, 3W를 지정하는 경우 해당 월의 3일과 가장 가까운 평일에 빌드가 실행되도록 할 수 있습니다. |
| \# | \#(해시)는 요일 필드에만 허용되며 그 뒤에 1에서 5 사이의 숫자가 와야 합니다. 숫자는 지정된 월에서 빌드 실행을 적용할 주를 지정합니다. 예를 들어, 매월 두 번째 금요일에 빌드를 실행하려면 요일 필드에 fri\#2(을)를 사용합니다. |
**제한 사항**
+ 같은 cron 표현식에서 '날짜' 및 '요일' 필드를 지정할 수 없습니다. 이들 필드 중 하나에 값 또는 `*`(을)를 지정하는 경우에는 다른 필드에서 반드시 `?`(을)를 사용해야 합니다.
+ 1분보다 빠른 속도로 이어지는 cron 표현식은 지원되지 않습니다.
## 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 *)`
**작은 정보**
파이프라인 작업이 실행되는 동안 다음 날까지 연장되지 않도록 하려면, 시작 시간을 지정할 때 빌드 시간을 고려해야 합니다.
------
## 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)`은(는) 유효한 식입니다.