기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 이미지 파이프라인에 대한 파이프라인 실행 설정 구성
다음 옵션 중에서 선택하여 파이프라인 실행을 예약할 수 있습니다.
스케줄 빌더
Schedule Builder를 사용하여 반복되는 자동 파이프라인 실행을 구성합니다. 파이프라인이 실행되어야 하는 시기와 빈도(일, 시간 및 빈도)를 정의합니다. 기본 일정은 일정이 생성된 날짜 및 시간(UTC)을 기준으로 매주입니다.
Cron 표현식
일정을 지정하는 cron 표현식을 사용하여 파이프라인을 자동으로 실행합니다. Image Builder에서 사용하는 cron 구문에 대한 자세한 내용은 섹션을 참조하세요[Image Builder에서 cron 표현식 사용](cron-expressions.md).
수동
파이프라인이 일정에 따라 실행되지 않습니다. 콘솔의 **작업** 메뉴에서 **파이프라인 실행**을 선택하여 파이프라인을 실행합니다. 에서를 실행할 AWS CLI수 있습니다`start-image-pipeline-execution`.
**종속성 설정**
예약된 빌드의 경우 기본 이미지 또는 레시피에 사용되는 구성 요소 변경과 같은 종속성 업데이트가 없는 한 항상 일정에 따라 실행할지 아니면 파이프라인 실행을 건너뛸지 선택할 수 있습니다.
## 장애가 발생한 파이프라인 자동 비활성화
일정에 따라 실행되는 이미지 파이프라인의 경우 Image Builder가 파이프라인을 자동으로 비활성화하기 전에 허용(최대`10`)하도록 최대 연속 실패 수를 구성할 수 있습니다.
**설정 자동 비활성화**
Image Builder는 예약된 파이프라인 실행에 대한 연속 실패 수를 추적하고 일정에 따라 실행될 때마다 다음 작업 중 하나를 수행합니다.
+ 파이프라인 실행이 성공하면 연속 실패 수가 0으로 재설정됩니다.
+ 파이프라인 실행이 실패하면 Image Builder는 연속 실패 횟수를 증가시킵니다. 실패 수가에 정의된 한도를 초과하면 `AutoDisablePolicy`Image Builder는 파이프라인을 비활성화합니다.
다음 조건에서는 연속 실패 횟수도 0으로 재설정됩니다.
+ 파이프라인은 수동으로 실행되고 성공합니다.
+ 파이프라인 구성이 업데이트됩니다.
파이프라인이 수동으로 실행되고 실패하면 개수는 동일하게 유지됩니다. 예약된 다음 실행은 이전에 중단된 위치에서 계속 증가합니다.
## 파이프라인 로깅 구성
이미지 파이프라인을 생성하거나 업데이트할 때 이미지 빌드 및 파이프라인 로그에 대한 사용자 지정 CloudWatch Logs 그룹을 구성할 수 있습니다. 사용자 지정 파이프라인 실행 역할에 로그 그룹 리소스를 생성하고 액세스할 수 있는 다음과 같은 권한이 있는지 확인합니다.
+ logs:CreateLogGroup
+ logs:CreateLogStream
+ logs:PutLogEvents
**사용자 지정 로그 그룹**
이미지 빌드 또는 파이프라인 실행에 사용자 지정 로그 그룹을 사용하려면 먼저 CloudWatch Logs에서 로그 그룹을 생성합니다. 자세한 내용은 Amazon CloudWatch Logs 사용 설명서의 로그 [그룹 생성을](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html#Create-Log-Group) 참조하세요. *Amazon CloudWatch * 로그 그룹 이름 지정 요구 사항에 대한 추가 지침은 Amazon CloudWatch Logs API 참조의 [CreateLogGroup](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_CreateLogGroup.html)을 참조하세요. *Amazon CloudWatch *
------
#### [ Console ]
**고급 설정**의 **로깅 구성** 섹션에서 파이프라인의 **이미지 로그 그룹** 또는 파이프라인 **로그 그룹을** 지정합니다.
------
#### [ CLI ]
구성에 JSON `logging-configuration` 객체를 사용하는 경우 객체 내에 다음 필드를 지정합니다.
+ `imageLogGroupName`
+ `pipelineLogGroupName`
명령줄에서 직접 모든 파라미터를 지정하려면 명령 참조의 [create-image-pipeline](https://docs.aws.amazon.com/cli/latest/reference/imagebuilder/create-image-pipeline.html)을 *AWS CLI 참조*하세요.
------
사용자 지정 로그 그룹을 지정하지 않으면 Image Builder는 다음과 같은 기본 로그 그룹을 사용합니다.
이미지 빌드 로그
Image Builder는 다음 Image Builder CloudWatch Logs 그룹 및 스트림에 빌드 로그를 씁니다.
**LogGroup:** `/aws/imagebuilder/{{ImageName}}`
**LogStream(x.x.x/x):** `{{ImageVersion/ImageBuildVersion}}`
파이프라인 실행 로그
Image Builder는 파이프라인 실행 로그를 다음 Image Builder CloudWatch Logs 그룹 및 스트림에 기록합니다.
**LogGroup:** `/aws/imagebuilder/pipeline/{{pipeline-name}}`
**LogStream:** `{{2025/09/01}}` (YYYY/MM/DD 형식의 파이프라인 실행 날짜)
각 파이프라인 로그는 해당 날짜의 스트림에 추가됩니다.