이미지 파이프라인에 대한 파이프라인 실행 설정 구성 - EC2 Image Builder
장애가 발생한 파이프라인 자동 비활성화파이프라인 로깅 구성

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

이미지 파이프라인에 대한 파이프라인 실행 설정 구성

다음 옵션 중에서 선택하여 파이프라인 실행을 예약할 수 있습니다.

스케줄 빌더

Schedule Builder를 사용하여 반복되는 자동 파이프라인 실행을 구성합니다. 파이프라인이 실행되어야 하는 시기와 빈도(일, 시간 및 빈도)를 정의합니다. 기본 일정은 일정이 생성된 날짜 및 시간(UTC)을 기준으로 매주입니다.

Cron 표현식

일정을 지정하는 cron 표현식을 사용하여 파이프라인을 자동으로 실행합니다. Image Builder에서 사용하는 cron 구문에 대한 자세한 내용은 섹션을 참조하세요Image Builder에서 cron 표현식 사용.

수동

파이프라인이 일정에 따라 실행되지 않습니다. 콘솔의 작업 메뉴에서 파이프라인 실행을 선택하여 파이프라인을 실행합니다. 에서를 실행할 AWS CLI수 있습니다start-image-pipeline-execution.

종속성 설정

예약된 빌드의 경우 기본 이미지 또는 레시피에 사용되는 구성 요소 변경과 같은 종속성 업데이트가 없는 한 항상 일정에 따라 실행할지 아니면 파이프라인 실행을 건너뛸지 선택할 수 있습니다.

장애가 발생한 파이프라인 자동 비활성화

일정에 따라 실행되는 이미지 파이프라인의 경우 Image Builder가 파이프라인을 자동으로 비활성화하기 전에 허용(최대10)하도록 최대 연속 실패 수를 구성할 수 있습니다.

설정 자동 비활성화

Image Builder는 예약된 파이프라인 실행에 대한 연속 실패 수를 추적하고 일정에 따라 실행될 때마다 다음 작업 중 하나를 수행합니다.

  • 파이프라인 실행이 성공하면 연속 실패 수가 0으로 재설정됩니다.

  • 파이프라인 실행이 실패하면 Image Builder는 연속 실패 횟수를 증가시킵니다. 실패 수가에 정의된 한도를 초과하면 AutoDisablePolicyImage Builder는 파이프라인을 비활성화합니다.

다음 조건에서는 연속 실패 횟수도 0으로 재설정됩니다.

  • 파이프라인은 수동으로 실행되고 성공합니다.

  • 파이프라인 구성이 업데이트됩니다.

파이프라인이 수동으로 실행되고 실패하면 개수는 동일하게 유지됩니다. 예약된 다음 실행은 이전에 중단된 위치에서 계속 증가합니다.

파이프라인 로깅 구성

이미지 파이프라인을 생성하거나 업데이트할 때 이미지 빌드 및 파이프라인 로그에 대한 사용자 지정 CloudWatch Logs 그룹을 구성할 수 있습니다. 사용자 지정 파이프라인 실행 역할에 로그 그룹 리소스를 생성하고 액세스할 수 있는 다음과 같은 권한이 있는지 확인합니다.

  • logs:CreateLogGroup

  • logs:CreateLogStream

  • logs:PutLogEvents

사용자 지정 로그 그룹

이미지 빌드 또는 파이프라인 실행에 사용자 지정 로그 그룹을 사용하려면 먼저 CloudWatch Logs에서 로그 그룹을 생성합니다. 자세한 내용은 Amazon CloudWatch Logs 사용 설명서의 로그 그룹 생성을 참조하세요. Amazon CloudWatch 로그 그룹 이름 지정 요구 사항에 대한 추가 지침은 Amazon CloudWatch Logs API 참조의 CreateLogGroup을 참조하세요. Amazon CloudWatch

Console

고급 설정의 로깅 구성 섹션에서 파이프라인의 이미지 로그 그룹 또는 파이프라인 로그 그룹을 지정합니다.

CLI

구성에 JSON logging-configuration 객체를 사용하는 경우 객체 내에 다음 필드를 지정합니다.

  • imageLogGroupName

  • pipelineLogGroupName

명령줄에서 직접 모든 파라미터를 지정하려면 명령 참조의 create-image-pipeline을 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 형식의 파이프라인 실행 날짜)

각 파이프라인 로그는 해당 날짜의 스트림에 추가됩니다.