Blog

🚨 도입부

AWS 환경에서 ‘InvalidAMIID: AMI not found’ 에러를 만나면 정말 좌절스럽습니다. 특히 새로운 인스턴스를 생성하거나, AMI를 기반으로 배포 작업을 진행할 때 이러한 문제가 발생하면 프로젝트 일정에 큰 차질을 빚을 수 있습니다. 예를 들어, AMI ID를 잘못 입력했을 때, AMI가 삭제되었거나 비공개로 설정되어 있을 때, 또는 잘못된 리전에 AMI를 사용하려고 할 때 이 에러가 발생합니다.

이 글에서는 이 에러를 해결하기 위한 단계별 가이드를 제공합니다. 빠르게 문제를 해결하고 싶다면 즉시 해결법을, 보다 근본적인 해결책을 원하신다면 표준 및 고급 해결법을 따라오시면 됩니다. 예상 해결 시간은 문제의 복잡도에 따라 다르지만, 일반적으로 10분에서 1시간 내에 해결할 수 있습니다.

🔍 에러 메시지 상세 분석

‘InvalidAMIID: AMI not found’ 에러 메시지는 AWS CLI나 콘솔에서 인스턴스를 시작할 때 자주 나타납니다. 변형된 메시지로는 ‘The image id ‘[ami-xxxxxx]’ does not exist’ 등이 있습니다. 이 에러는 주로 다음과 같은 상황에서 발생합니다.

• 잘못된 AMI ID 입력: 오타 또는 잘못된 포맷
• AMI 삭제: 사용하려는 AMI가 이미 삭제된 경우
• 잘못된 리전 선택: AMI가 다른 리전에 존재
• 권한 문제: AMI가 퍼블릭이 아니거나 접근 권한이 없음
• 네트워크 문제: AWS 서비스와의 연결 문제

에러 메시지에서 ‘InvalidAMIID’는 잘못된 AMI ID를 의미하며, ‘AMI not found’는 해당 ID로 AMI를 찾을 수 없음을 뜻합니다. 초보 개발자라면 이 메시지를 통해 어떤 부분에서 오류가 있는지 쉽게 파악할 수 있습니다.

비슷한 에러로는 ‘InvalidSnapshotID’나 ‘InvalidInstanceID’ 등이 있으며, 이들 역시 리소스의 ID와 관련된 문제입니다.

🧐 발생 원인 분석

이 에러의 주요 원인 몇 가지를 살펴보겠습니다.

1. 잘못된 AMI ID 사용: 오타나 잘못된 형식으로 인해 AWS가 해당 AMI를 찾을 수 없습니다. 예를 들어, ‘ami-12345678’ 대신 ‘ami-1234567’을 입력하면 이러한 문제가 발생합니다.

2. AMI 삭제: 사용하려는 AMI가 삭제되었거나 만료된 경우입니다. 이는 주로 오래된 AMI를 사용할 때 발생할 수 있습니다.

3. 권한 문제: AMI가 비공개로 설정되어 있거나, 현재 계정에 접근 권한이 없는 경우입니다. 특히 다른 계정의 AMI를 사용할 때 자주 발생합니다.

4. 잘못된 리전 선택: AMI는 특정 리전에 존재하므로, 잘못된 리전에서 접근하면 오류가 발생합니다.

5. 네트워크 문제: AWS 서비스에 대한 일시적인 네트워크 연결 문제도 간혹 원인이 됩니다.

이러한 원인들은 환경에 따라 다르게 나타날 수 있으며, 확인을 위해서는 AWS 콘솔이나 CLI에서 자세한 로그를 분석해야 합니다.

✅ 해결 방법

여기서는 여러 가지 해결 방법을 제시합니다.

즉시 해결

• AMI ID 확인 및 수정:

  aws ec2 describe-images --image-ids ami-xxxxxx

  명령어를 통해 AMI ID가 유효한지 즉시 확인할 수 있습니다.

• 리전 설정 확인: 사용 중인 리전을 확인하고 AMI가 존재하는 리전으로 변경합니다.

  aws configure set region us-west-2

• 권한 확인: AMI가 퍼블릭인지 확인하고, 필요시 소유자에게 접근 권한 요청을 합니다.

표준 해결

• AMI 목록에서 확인:

  aws ec2 describe-images --owners self

  명령어로 사용 가능한 AMI 목록을 확인하고 올바른 ID를 사용합니다.

• IAM 권한 설정 확인: IAM 정책을 검토하여 AMI에 접근할 수 있는 권한이 있는지 확인합니다.
• 삭제된 AMI 복구: AMI가 삭제되었을 경우, 보관된 스냅샷을 통해 복구를 시도합니다.
• 리전 간 AMI 복사: AMI를 다른 리전에서 사용하려면

  aws ec2 copy-image --source-region us-east-1 --source-image-id ami-xxxxxx --region us-west-2

  명령어를 사용합니다.

• 네트워크 설정 확인: 네트워크 연결 상태를 점검하고 AWS 서비스에 문제가 없는지 확인합니다.

고급 해결

• 로그 분석: AWS CloudTrail을 통해 로그를 확인하고 문제의 원인을 찾습니다.
• 자동화 스크립트 사용: AMI ID를 자동으로 검증하고 업데이트하는 스크립트를 작성합니다.

  #!/bin/bash
  # AMI ID 자동 검증 스크립트
  ami_id='ami-xxxxxx'
  if aws ec2 describe-images --image-ids $ami_id; then
    echo "AMI ID is valid"
  else
    echo "Invalid AMI ID"
  fi

• 모니터링 도구 사용: AWS CloudWatch를 통해 AMI 사용 상황을 모니터링하고, 이상 상황 발생 시 경고를 받습니다.

각 해결 방법의 장단점은 상황에 따라 다르며, 사용자의 요구에 맞게 적절한 방법을 선택해야 합니다. 해결 후에는 AMI가 정상적으로 작동하는지 인스턴스를 생성하여 확인합니다.

🛡️ 예방법 및 베스트 프랙티스

이 에러를 예방하기 위해 다음과 같은 방법을 추천합니다.

• AMI 관리 정책 수립: 정기적으로 AMI를 검토하고, 사용하지 않는 AMI는 삭제합니다.
• 리전 간 AMI 동기화: 여러 리전에서 AMI를 사용할 경우, 적절히 동기화합니다.
• 권한 관리: IAM 정책을 통해 AMI 접근 권한을 명확히 설정합니다.
• 코드 리뷰 및 체크리스트 활용: 코드를 배포하기 전, AMI ID 및 관련 설정을 검토할 수 있는 체크리스트를 만듭니다.
• 도구 및 린터 사용: AMI ID를 자동으로 검증하는 도구를 사용하여 오류를 사전에 방지합니다.

🎯 마무리 및 추가 팁

이번 글에서는 ‘InvalidAMIID: AMI not found’ 에러의 원인과 해결 방법을 자세히 살펴보았습니다. 핵심 내용으로는 AMI ID 검증 방법, 리전 및 권한 설정의 중요성, 예방을 위한 베스트 프랙티스가 있습니다. 비슷한 에러로는 ‘InvalidSnapshotID’ 등이 있으며, AWS 공식 문서를 통해 추가 학습을 권장합니다.

이러한 에러는 누구에게나 발생할 수 있지만, 차근차근 접근하면 충분히 해결할 수 있습니다. 개발의 길은 길고 험난하지만, 여러분은 이겨낼 수 있습니다!