내용으로 건너뛰기

AMI를 만들거나 복사할 때 ‘Waiter ImageAvailable failed’ 오류를 해결하려면 어떻게 해야 합니까?

3분 분량
0

Amazon Elastic Compute Cloud(Amazon EC2)에서 Amazon Machine Image(AMI)를 만들거나 복사할 때 ‘Waiter ImageAvailable failed’ 오류 메시지가 표시됩니다.

해결 방법

'Max attempts exceeded' 오류 해결

AMI 만들기 또는 복사 프로세스가 기본 제한 시간인 10분보다 오래 걸리는 경우 다음과 같은 오류 메시지가 표시됩니다.

"Waiter ImageAvailable failed: Max attempts exceeded"

이 문제를 해결하려면 재시도 동작이 포함된 지수 백오프를 구현하거나 Amazon EventBridge를 사용하여 AMI 만들기 또는 복사 프로세스를 모니터링하십시오.

지수 백오프 구현

지수 백오프는 재시도 사이의 시간을 늘립니다. 지수 백오프를 구현하려면 각 시도 사이의 지연 시간을 늘리면서 작업을 재시도하는 스크립트나 코드를 사용하십시오.

다음 예제 스크립트는 AWS SDK for Python(Boto3)을 통해 사용자 지정 WaiterConfig 값을 설정합니다.

import boto3
from botocore.exceptions import WaiterError

client = boto3.client('ec2')
waiter = client.get_waiter('image_available')

try:
    waiter.wait(
        ImageIds=['ami-abcdefghxyz'],
        WaiterConfig={
            'Delay': 15,
            'MaxAttempts': 50
        }
    )
except WaiterError as e:
    # Handle the WaiterError exception
    print(f"Error waiting for image availability: {e}")
    # Add additional logic here to handle the error, such as retrying the operation or logging the issue

참고: ami-abcdefghxyz를 AMI ID로, 15를 시도 간 지연 시간(초)으로, 50을 최대 재시도 횟수로 바꾸십시오.

EventBridge를 사용하여 AMI 프로세스 모니터링

EventBridge를 사용하는 경우 AMI 프로세스를 적극적으로 모니터링할 필요가 없습니다. 대신 CopyImage 또는 CreateImage 이벤트가 완료되는 시기를 감지하는 EventBridge 규칙을 만드십시오. 그런 다음, 프로세스가 완료되면 알림을 받도록 작업을 구성하십시오. 예를 들어 Amazon Simple Notification Service(Amazon SNS)를 사용하여 이메일 알림을 받습니다. 자세한 내용은 EventBridge를 사용한 AMI 이벤트 모니터링을 참조하십시오.

‘An error occurred waiting for the image to become available’ 오류 해결

참고: AWS Command Line Interface(AWS CLI) 명령을 실행할 때 오류가 발생하면 AWS CLI의 오류 해결을 참조하십시오. 또한 최신 AWS CLI 버전을 사용하고 있는지 확인하십시오.

다음과 같은 오류 메시지가 표시될 수 있습니다.

"An error occurred waiting for the image to become available: Waiter ImageAvailable failed: Waiter encountered a terminal failure state"

이 오류는 다음과 같은 이유로 발생합니다.

  • 필요한 AWS Identity and Access Management(IAM) 권한이 없습니다.
  • 기본 AWS 인프라에 일시적인 문제가 있습니다.
  • 크거나 복잡한 AMI를 복사하거나 만들었습니다.
    참고: 다양한 소프트웨어 패키지 및 사용자 지정이 포함된 크거나 복잡한 AMI는 복사 또는 만들기 시 기본 10분 제한 시간을 초과할 수 있습니다. 이 문제를 해결하려면 'Max attempts exceeded' 오류 해결을 참조하십시오.

이러한 문제를 해결하려면 다음 작업을 수행하십시오.

IAM 권한 확인

AMI를 만들거나 복사한 역할 또는 사용자에게 연결한 IAM 정책에는 다음과 같은 필수 권한이 있어야 합니다.

  • ec2:DescribeImages
  • ec2:CreateImage
  • ec2:CopyImage

위 권한을 포함하도록 IAM 정책을 업데이트한 다음, 만들기 또는 복사 프로세스를 다시 시도합니다.

AWS 인프라 관련 문제 확인

AMI의 현재 상태를 확인하려면 다음 describe-images AWS CLI 명령을 실행합니다.

aws ec2 describe-images --image-ids AMI_ID

참고: AMI_ID를 AMI ID로 바꾸십시오.

출력은 AMI의 현재 상태를 보여줍니다. 상태가 보류 중인 경우 AMI 만들기 또는 복사 프로세스가 아직 진행 중인 것입니다. 그러나 상태가 실패인 경우 기본 인프라에 문제가 있을 수 있습니다.

높은 로드 또는 하드웨어 문제로 인해 AMI를 만들거나 복사할 때 일시적인 문제가 발생할 수 있습니다. 이 시나리오에서는 5~10분 정도 기다린 다음, 만들기 또는 복사 프로세스를 다시 시도합니다. AWS 리전 또는 AWS 서비스에 영향을 미치는 지속적인 문제를 확인하려면 AWS Health Dashboard에서 서비스 상태를 확인하십시오.

추가 문제 해결

여전히 문제가 발생하는 경우 AWS CloudTrail 이벤트 기록을 확인하여 CopyImage 또는 CreateImage 이벤트와 관련된 문제를 식별하십시오. 오류 메시지, 실패 이유, 서비스 할당량 초과, 액세스 문제를 확인합니다. 자세한 내용은 CloudTrail을 사용한 Amazon EC2 API 호출 로깅을 참조하십시오.

진행 중인 문제가 없고 5~10분 정도 기다린 후 다시 시도했는데도 작업이 실패하면 AWS Support 사례를 여십시오.

AWS 공식업데이트됨 일 년 전