Blog

🚨 도입부

이런 에러, 정말 짜증나죠? AWS를 사용하다가 ‘ResourceNotFound: Resource not found’라는 에러 메시지를 접하면 많은 개발자들이 좌절감을 느끼곤 합니다. 특히 프로젝트의 중요한 순간에 이러한 에러가 발생하면 심장이 덜컥 내려앉기도 합니다. 이 에러는 주로, AWS 리소스를 찾으려고 할 때 해당 리소스가 존재하지 않을 경우 발생합니다.

여러 상황에서 이 에러를 만날 수 있습니다. 예를 들어, AWS Lambda 함수를 호출했는데 존재하지 않는 함수 이름을 사용한 경우, 혹은 S3 버킷을 참조했는데 버킷 이름이 잘못된 경우 등이 있습니다. 이 글에서는 이러한 에러를 해결하기 위한 구체적인 해결책을 제시합니다. 예상 해결 시간은 문제의 복잡성에 따라 달라질 수 있지만, 일반적으로 10분에서 1시간 정도면 해결할 수 있습니다. 난이도는 초급에서 중급 수준으로, AWS 환경에 대한 기본적인 이해만 있으면 충분히 따라올 수 있습니다.

🔍 에러 메시지 상세 분석

이 에러 메시지는 AWS에서 리소스를 찾을 수 없을 때 발생합니다. 정확한 메시지는 ‘ResourceNotFound: Resource not found’이며, 상황에 따라 약간씩 변형될 수 있습니다. 예를 들어, ‘ResourceNotFoundException: Requested resource not found’ 같은 메시지도 있습니다.

에러가 발생할 수 있는 상황은 다양합니다. 첫째, AWS SDK로 API 호출 시 잘못된 파라미터가 전달된 경우입니다. 둘째, 존재하지 않는 리소스 ID를 참조했을 때입니다. 셋째, AWS CLI를 사용해 잘못된 명령어를 입력했을 때입니다. 넷째, IAM 정책에 의해 리소스 접근이 제한된 경우입니다. 마지막으로, 리소스가 삭제되었거나 다른 지역에 존재할 때입니다.

이 에러의 각 부분을 해석해보겠습니다. ‘ResourceNotFound’는 요청한 리소스를 찾을 수 없다는 의미이고, ‘Resource not found’는 더 구체적으로 어떤 리소스가 찾을 수 없는지를 나타냅니다. 초보자를 위해, 에러 메시지는 문제가 발생한 지점을 알려주기 때문에, 이 부분을 집중적으로 파악하는 것이 중요합니다.

이 에러와 혼동하기 쉬운 메시지로는 ‘AccessDenied’, ‘InvalidParameterValue’ 등이 있습니다. 이들은 각각 접근이 거부되었거나, 파라미터 값이 잘못되었음을 의미합니다.

🧐 발생 원인 분석

첫 번째 주요 원인은 잘못된 리소스 식별자입니다. AWS에서 제공하는 리소스들은 고유 식별자를 가지며, 이 식별자가 잘못되면 리소스를 찾을 수 없습니다. 예를 들어 EC2 인스턴스 ID를 잘못 입력하면 이 에러가 발생합니다. 두 번째는 리소스가 다른 리전(Region)에 존재하는 경우입니다. AWS는 리전 별로 리소스를 관리하므로 올바른 리전을 선택했는지 확인해야 합니다.

세 번째 원인은 삭제된 리소스입니다. 개발 과정에서 불필요한 리소스를 삭제하는 경우가 많습니다. 이때 코드가 여전히 삭제된 리소스를 참조하고 있다면 이 에러가 발생합니다. 네 번째는 IAM 정책 문제입니다. 리소스에 접근하기 위한 권한이 제대로 설정되지 않았다면 접근이 거부됩니다. 마지막으로 네트워크 연결 문제로 인해 리소스에 접근할 수 없을 경우도 있습니다.

주요 원인의 발생 시나리오를 조금 더 구체적으로 살펴보면, 예를 들어 잘못된 리소스 식별자는 주로 수작업으로 ID를 입력하거나, 복사/붙여넣기를 할 때 발생할 수 있습니다. 리전 문제는 AWS 콘솔에서 다른 리전을 선택한 후 리소스를 생성하고, 이후 다른 리전에서 리소스를 찾으려고 할 때 발생합니다.

왜 이러한 원인들이 발생하는지 근본적 이유를 살펴보면, AWS의 복잡한 리소스 관리 체계와 다양한 설정 옵션이 주된 이유입니다. 또한, 개발 환경별로 OS, AWS SDK 버전, CLI 버전 등이 달라질 수 있으며, 각 환경의 특성을 이해하지 못하면 이러한 에러가 발생할 수 있습니다.

각 원인을 확인하는 간단한 방법으로는, AWS 콘솔에서 직접 리소스를 검색해보거나, AWS CLI로 리소스 리스트를 조회하는 방법이 있습니다. 이를 통해 리소스가 존재하는지, 올바른 리전에 있는지 등을 확인할 수 있습니다.

✅ 해결 방법

즉시 해결할 수 있는 방법으로는 먼저 AWS 콘솔에서 리소스를 직접 확인하는 것입니다. 리소스가 존재하는지, 올바른 리전에 있는지를 확인하는 것은 가장 빠른 방법입니다. 두 번째 방법은 AWS CLI 명령어를 사용해 리소스 리스트를 조회하는 것입니다.

aws s3 ls

이 명령어는 현재 리전에 존재하는 S3 버킷을 모두 나열합니다. 세 번째는 IAM 정책을 검토하는 것입니다. 해당 리소스에 접근할 수 있는 권한이 올바르게 설정되어 있는지 확인합니다.

aws iam list-policies

표준 해결법으로는, 첫째로 리소스 ID를 하드코딩하지 않고 환경 변수나 설정 파일을 사용하는 것입니다. 둘째, 리전 문제를 방지하기 위해 리소스를 생성할 때 항상 리전을 명시적으로 지정합니다. 셋째, 리소스를 삭제할 때는 코드에서도 해당 리소스를 참조하는 부분을 삭제합니다.

aws ec2 describe-instances --region us-west-2

넷째, IAM 정책을 주기적으로 검토하고, 필요 없는 권한은 과감히 제거합니다. 이는 보안에도 큰 도움이 됩니다. 다섯째, 네트워크 연결 문제를 해결하기 위해 VPC 설정을 점검합니다.

고급 해결책으로는 CloudFormation을 사용해 리소스 관리를 자동화하는 방법이 있습니다. CloudFormation 템플릿을 사용하면 리소스의 생성, 삭제, 업데이트를 코드로 관리할 수 있습니다.

aws cloudformation deploy --template-file template.yaml --stack-name myStack

이 방법은 특히 복잡한 인프라를 관리할 때 유용합니다. 두 번째로는 Terraform과 같은 IaC(Infrastructure as Code) 도구를 사용하는 것입니다. 이를 통해 인프라를 코드로 정의하고, 버전 관리 및 롤백 기능을 활용할 수 있습니다.

terraform apply

세 번째 방법은 AWS SDK를 활용한 프로그램적 접근입니다. SDK를 통해 리소스를 생성할 때, 존재 여부를 미리 체크함으로써 에러를 사전에 방지할 수 있습니다.

import boto3
s3 = boto3.client('s3')
response = s3.list_buckets()
for bucket in response['Buckets']:
    print(bucket['Name'])

각 방법의 장단점으로는, 즉시 해결 방법은 간단하지만 지속적인 해결책은 아닙니다. 표준 방법은 안전하지만 시간이 걸릴 수 있습니다. 고급 방법은 강력하지만 초기 학습 곡선이 있습니다. 해결 후에는 AWS 콘솔이나 CLI를 통해 리소스가 정상적으로 접근 가능한지 확인합니다.

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

이 에러가 재발하지 않게 하려면, 리소스 ID를 하드코딩하지 않고, 환경 변수나 설정 파일을 사용하는 것이 좋습니다. 또한 리소스를 생성할 때 리전을 명시하는 습관을 들이세요. IAM 정책은 항상 최소 권한 원칙을 따르며, 주기적으로 검토하는 것이 중요합니다.

코딩 시 주의사항으로는, 리소스 생성 후에는 반드시 해당 리소스의 존재 여부를 확인하는 코드 패턴을 사용해야 합니다. 예를 들어, S3 버킷을 생성한 후에는 버킷이 실제로 생성되었는지 확인하는 코드 패턴을 적용하세요.

import boto3
s3 = boto3.client('s3')
try:
    s3.head_bucket(Bucket='my-bucket')
    print('Bucket exists')
except Exception as e:
    print('Bucket does not exist')

팀 개발 시에는 리소스 관리에 대한 명확한 가이드라인을 설정하고, 이를 문서화하여 공유하세요. 관련 문서화 방법으로는, 프로젝트의 README 파일에 리소스 관리에 대한 설명을 추가하고, 주기적으로 업데이트하는 것이 좋습니다.

🎯 마무리 및 추가 팁

이 글의 핵심은 세 가지입니다. 첫째, 에러의 원인을 정확히 파악하고 해결하는 방법을 학습하였습니다. 둘째, 다양한 해결책을 통해 에러를 효과적으로 해결하는 방법을 배웠습니다. 셋째, 재발 방지를 위한 예방법과 베스트 프랙티스를 이해하였습니다.

비슷한 에러로는 ‘AccessDenied’와 ‘InvalidParameterValue’가 있으며, 이들에 대한 해결책도 필요하다면 추가로 학습하세요. 추가 리소스로는 AWS 공식 문서와 관련 서적을 추천합니다.

마지막으로, 에러를 해결하는 과정은 때때로 길고 지칠 수 있지만, 문제를 해결한 후의 성취감은 매우 큽니다. 여러분도 할 수 있습니다! 함께 이 어려움을 극복해 나갑시다.