InvalidAMIID: AMI not found 에러 해결법 – 원인 분석부터 완벽 해결까지

🚨 도입부

AWS 환경에서 서비스를 운영하다 보면 ‘InvalidAMIID: AMI not found’라는 에러 메시지를 접하게 될 때가 있습니다. 이 에러는 특히 신규 인스턴스를 론칭하려고 할 때, 혹은 AMI를 이용해 기존 인스턴스를 복제하려 할 때 주로 발생합니다. 이 에러를 처음 접할 때 많은 개발자들이 좌절감을 느끼게 됩니다. 예상치 못한 시점에서 발생할 뿐만 아니라, 해결 방법을 찾지 못해 프로젝트 일정에 차질을 빚을 수 있기 때문입니다.

이 글에서는 이 에러가 발생할 수 있는 다양한 시나리오를 살펴보고, 각 상황에 맞는 해결책을 제시하려고 합니다. 예를 들어, 잘못된 AMI ID를 사용했거나, AMI가 위치한 리전이 잘못 설정된 경우, 또는 AMI가 삭제된 경우 등이 있습니다. 이 글을 통해 해당 에러를 빠르게 해결할 수 있는 방법을 배우게 될 것입니다. 일반적으로 이 에러를 해결하는 데 걸리는 시간은 30분에서 1시간 정도이며, 난이도는 중급 수준으로 분류할 수 있습니다.

🔍 에러 메시지 상세 분석

‘InvalidAMIID: AMI not found’라는 에러 메시지는 AWS에서 AMI(Application Machine Image)를 찾을 수 없을 때 발생합니다. 이 메시지는 “InvalidAMIID”와 “AMI not found” 두 부분으로 나뉩니다. “InvalidAMIID”는 제공된 AMI ID가 잘못되었거나, “AMI not found”는 해당 AMI가 AWS의 특정 리전에서 존재하지 않음을 의미합니다.

이 에러는 다음과 같은 다양한 상황에서 발생할 수 있습니다:

• 잘못된 AMI ID를 입력한 경우
• AMI가 삭제된 경우
• 잘못된 리전에서 AMI를 찾으려는 경우
• AMI가 퍼블릭이 아닌 경우
• 사용자 권한이 부족한 경우

초보자들에게는 이 에러 메시지가 다소 난해하게 느껴질 수 있습니다. 하지만 메시지의 각 부분을 이해하면 문제를 해결하는 데 큰 도움이 됩니다. ‘InvalidAMIID’는 제공된 AMI ID가 유효하지 않다는 것을, ‘AMI not found’는 해당 AMI ID를 가진 이미지가 존재하지 않는다는 것을 의미합니다. 비슷한 에러로는 “InvalidInstanceID” 또는 “InvalidSnapshotID” 등이 있으며, 이들은 각각 인스턴스 ID나 스냅샷 ID가 유효하지 않을 때 발생합니다.

🧐 발생 원인 분석

이 에러의 주요 원인은 다양합니다. 첫째, 가장 흔한 원인은 잘못된 AMI ID를 입력한 경우입니다. 사용자가 복사/붙여넣기를 잘못하거나, AMI ID를 수동으로 입력할 때 오타가 발생할 수 있습니다. 예를 들어, AMI ID는 “ami-12345678″과 같은 형식을 가지며, 이 형식에서 하나의 문자나 숫자라도 틀리면 에러가 발생할 수 있습니다.

둘째, AMI가 삭제된 경우입니다. AWS에서 AMI를 삭제한 경우, 해당 AMI ID는 더 이상 유효하지 않으며, 이를 사용하려고 하면 ‘AMI not found’ 에러가 발생합니다. 이는 사용자가 AMI를 수동으로 삭제했거나, 자동화된 스크립트가 작동하면서 삭제했을 때 발생할 수 있습니다.

셋째, AMI가 다른 리전에 있을 때 발생할 수 있습니다. AWS는 각 리전마다 리소스를 독립적으로 관리하므로, 특정 리전에서 사용 가능한 AMI가 다른 리전에서는 존재하지 않을 수 있습니다. 예를 들어, 서울 리전에 있는 AMI를 오레곤 리전에서 사용하려고 하면 에러가 발생합니다.

넷째, AMI가 퍼블릭이 아닌 경우입니다. 퍼블릭이 아닌 AMI는 해당 AMI를 생성한 계정 외에는 접근할 수 없으므로, 접근하려는 계정에 권한이 없다면 에러가 발생합니다.

다섯째, 사용자가 해당 AMI에 접근할 수 있는 권한이 없는 경우입니다. IAM 정책 설정에 따라 특정 AMI에 대한 접근이 제한될 수 있습니다. 이 경우, IAM 권한을 확인하여 적절한 권한이 부여되었는지 확인해야 합니다.

각 원인은 AWS 콘솔이나 CLI를 통해 쉽게 확인할 수 있습니다. 예를 들어, AMI ID가 올바른지 확인하기 위해 AWS CLI에서 다음 명령어를 사용할 수 있습니다:

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

위 명령어를 통해 AMI가 존재하는지, 올바른 리전에 있는지 확인할 수 있습니다.

✅ 해결 방법

이제 실제로 이 에러를 해결할 수 있는 방법들을 살펴보겠습니다.

즉시 해결: 1분 내 적용 가능한 빠른 방법

• 1. 올바른 AMI ID 확인: AWS 콘솔이나 CLI에서 AMI ID를 다시 확인하고 입력합니다.

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

위 명령어를 통해 AMI ID가 올바른지 확인할 수 있습니다.

• 2. 리전 확인: 현재 작업 중인 리전이 올바른지 체크합니다.

aws configure get region

위 명령어로 현재 설정된 리전을 확인하고, 필요한 경우 변경합니다.

• 3. 삭제 여부 확인: AMI가 삭제되지 않았는지 확인합니다.

표준 해결: 일반적이고 안전한 해결법

• 1. IAM 권한 확인: IAM 콘솔에서 해당 AMI에 접근할 수 있는 권한이 있는지 확인하고, 필요하다면 권한을 추가합니다.
• 2. 퍼블릭 AMI 설정: AMI가 퍼블릭으로 설정되어 있는지 확인합니다. 퍼블릭으로 설정하면 다른 계정에서도 접근할 수 있습니다.
• 3. 스크립트 자동화 점검: AMI ID를 사용하는 자동화 스크립트를 점검 후, 올바른 AMI ID가 사용되고 있는지 확인합니다.
• 4. 리전 간 AMI 복제: 다른 리전에서 AMI를 사용해야 할 경우, 해당 리전으로 AMI를 복제합니다.

aws ec2 copy-image --source-image-id ami-12345678 --source-region us-west-1 --region us-east-1 --name "My-Ami-Copy"

• 5. AMI 상태 확인: AMI의 상태가 ‘available’인지 확인합니다.

aws ec2 describe-images --image-ids ami-12345678 --query "Images[0].State"

결과가 ‘available’이 아니면, AMI가 아직 준비되지 않은 상태일 수 있습니다.

고급 해결: 복잡한 상황을 위한 해결법

• 1. IAM 정책 수정: 특정 AMI에 대한 접근을 허용하는 사용자 지정 IAM 정책을 작성합니다.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": "ec2:DescribeImages",
      "Resource": "arn:aws:ec2:us-west-1:123456789012:image/ami-12345678"
    }
  ]
}

• 2. CloudFormation 템플릿 수정: AMI ID를 사용하는 CloudFormation 템플릿에서 AMI ID를 매개변수화하여, 잘못된 ID 입력을 방지합니다.
• 3. AMI 라이프사이클 관리: AMI의 생성, 사용, 삭제를 체계적으로 관리하여, 사용 중인 AMI가 삭제되지 않도록 관리합니다.

각 해결 방법의 장단점과 사용 상황은 다양합니다. 즉시 해결 방법은 빠르고 쉬우나, 임시방편일 수 있습니다. 표준 해결 방법은 안정적이며, 장기적으로 효과적입니다. 고급 해결 방법은 복잡한 환경에서 필요한 경우 유용합니다.

해결 후에는 AMI가 정상적으로 인스턴스에 적용되는지 확인해야 합니다. 이를 위해 새로운 인스턴스를 론칭하거나, 기존 인스턴스를 AMI로 변경하여 테스트할 수 있습니다.

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

이 에러가 재발하지 않도록 하기 위해 몇 가지 예방 방법을 제시합니다. 우선, AMI ID를 사용할 때는 항상 AWS 콘솔이나 CLI를 통해 확인된 ID를 사용해야 합니다. 이를 통해 오타로 인한 에러 발생을 줄일 수 있습니다.

또한, 팀 내에서 AMI 사용에 대한 명확한 가이드라인을 설정하고, 이를 문서화하여 공유해야 합니다. 이는 특히 다양한 리전에서 작업하는 팀에 유용합니다. AMI ID를 매개변수화하여, 실수로 인한 잘못된 설정을 방지할 수 있습니다.

IAM 정책을 통해 접근 권한을 명확히 하고, 필요하지 않은 권한은 최소화하여 보안을 강화해야 합니다. 이를 위해 정기적으로 IAM 정책을 검토하고, 필요 시 수정해야 합니다.

마지막으로, AMI의 라이프사이클을 관리하는 도구를 사용하여, 필요한 AMI가 삭제되지 않도록 합니다. AWS에서는 AMI 관리에 도움이 되는 다양한 도구 및 서비스를 제공합니다.

🎯 마무리 및 추가 팁

이 글에서는 ‘InvalidAMIID: AMI not found’ 에러의 원인과 해결 방법을 자세히 설명했습니다. AMI ID를 올바르게 사용하고, 리전과 권한을 적절히 설정하는 것이 중요합니다. 또한, 정기적인 IAM 정책 검토와 AMI 라이프사이클 관리를 통해 이러한 에러를 예방할 수 있습니다.

비슷한 에러로는 ‘InvalidInstanceID’나 ‘InvalidSnapshotID’가 있으며, 각 에러의 해결 방법은 유사합니다. 추가 학습을 원하시는 분들은 AWS 공식 문서나 관련 블로그를 참고하실 수 있습니다.

이 에러를 해결하는 과정에서 어려움을 겪으셨다면, 이 글이 도움이 되었길 바랍니다. 문제를 해결하면서 AWS에 대한 이해를 더욱 깊게 할 수 있는 기회가 되었기를 바랍니다.