View a markdown version of this page

향상된 AMI 배포 기능 사용 - EC2 Image Builder
분리된 배포배포 재시도배포 워크플로

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

향상된 AMI 배포 기능 사용

Image Builder는 AMIs가 리전 및 계정에 분산되는 방식을 유연하고 제어할 수 있는 고급 배포 기능을 제공합니다. 이러한 기능은 배포를 빌드 프로세스와 분리하므로 기존 이미지를 온디맨드로 배포하고, 배포 실패로부터 효율적으로 복구하고, 사용자 지정 가능한 워크플로를 통해 제어된 다단계 배포 전략을 구현할 수 있습니다.

Image Builder에서 향상된 AMI 배포 기능을 사용하면 전체 이미지 빌드를 다시 실행할 필요 없이 배포 활동을 직접 수행할 수 있습니다.

분리된 배포

DistributeImage API는 세 가지 유형의 소스 이미지 참조를 허용합니다.

  • AMI ID - 표준 AMI 식별자(예: ami-0abcdef1234567890)

  • SSM 파라미터 - AMI ID를 저장하는 SSM 파라미터(예: ssm:/my/ami/parameter)

  • Image Builder 버전 ARN - Image Builder 이미지 버전 ARN

배포 재시도

이미지 배포에 실패하면 RetryImage API를 사용하여 배포를 다시 시도합니다. 이렇게 하면 전체 이미지 재구축을 방지하여 실패 원인을 해결하는 데 걸리는 시간이 단축됩니다. 배포 실패의 근본 원인을 해결한 RetryImage 후를 사용합니다.

RetryImage API는 이미지 빌드 버전 ARN(예: arn:aws:imagebuilder:us-west-2:123456789012:image/my-image/1.0.0/1)을 허용합니다. API를 호출하면 Image Builder는 원래 배포 구성 및 설정을 사용하여 장애 발생 시점부터 배포 프로세스를 자동으로 재개합니다. RetryImage API는 배포 단계, 테스트 단계 또는 통합 단계에서 실패한 배포를 재시도할 수 있습니다. 보류 중, 실패, 삭제됨 또는 사용 가능 상태의 AMIs에서 작동합니다.

사전 조건

배포를 다시 시도하기 전에 다음을 확인합니다.

  • 장애의 근본 원인을 식별하고 해결했습니다. 오류 세부 정보는 CloudWatch Logs의 배포 로그를 검토합니다.

  • 이미지 빌드를 재시도하는 데 필요한 IAM 권한이 있습니다.

  • 교차 계정 배포 실패의 경우 대상 계정의 EC2ImageBuilderDistributionCrossAccountRole에 Ec2ImageBuilderCrossAccountDistributionAccess 정책이 연결되어 있는지 확인합니다.

중요: 기본 문제를 수정하지 않고 재시도하면 반복적으로 실패합니다.

배포 워크플로

배포 워크플로는 빌드 및 테스트 워크플로를 보완하는 새로운 워크플로 유형으로, 순차적으로 배포 프로세스를 정의하고 제어할 수 있습니다. 배포 워크플로를 사용하면 AMI 복사 작업, wait-for-action 체크포인트, 이미지 속성 수정 및 기타 배포 관련 단계를 포함하는 사용자 지정 배포 프로세스를 생성할 수 있습니다. 이를 통해 단계별 가시성, 병렬 배포 기능 및 세분화된 오류 보고를 통해 AMIs가 배포되는 방식을 구조적으로 제어할 수 있습니다.

워크플로 생성 및 사용자 지정에 대한 자세한 내용은 이미지 워크플로 관리를 참조하세요.