AWSAmplifyDomainRole를 찾을 수 없습니다: 빠른 수정 방법

AWS Amplify로 앱을 배포하며 순조롭게 진행하던 중 갑자기 문제가 발생합니다. 배포가 실패하며 모호한 오류 메시지가 표시됩니다: The role with name AWSAmplifyDomainRole-Z073737928BZTN2WA6J6L cannot be found. 숫자와 문자로 된 긴 문자열은 사용자마다 다르지만 문제는 동일합니다. 이 예상치 못한 장애물은 배포를 중단시킬 수 있습니다.

이 문제를 겪고 있다면 혼자가 아닙니다. Amplify Hosting에서 사용자 지정 도메인을 관리할 때 발생할 수 있는 알려진 문제입니다. 이 가이드에서는 이 오류의 의미를 명확히 설명하고 프로젝트를 다시 배포할 수 있도록 명확한 단계별 솔루션을 제공합니다.

”AWSAmplifyDomainRole를 찾을 수 없습니다” 오류 이해하기

그렇다면 AWSAmplifyDomainRole이란 무엇이며 때때로 사라지는 이유는 무엇일까요?

Amplify 애플리케이션에 사용자 지정 도메인을 추가하면 Amplify는 IAM(Identity and Access Management) 역할을 생성합니다. AWSAmplifyDomainRole-…라는 이 역할은 AWS Certificate Manager(ACM)를 통해 SSL/TLS 인증서와 같은 도메인 관련 리소스를 관리하는 데 필요한 권한을 Amplify에 부여합니다.

이 오류는 필수 IAM 역할이 삭제되었지만 Amplify 구성에서는 여전히 해당 역할이 존재할 것으로 기대하기 때문에 발생합니다. 이는 다음과 같은 여러 가지 이유로 발생할 수 있습니다.

• 수동 삭제: 팀 구성원 중 누군가 사용하지 않는 역할을 정리하는 과정에서 실수로 IAM 콘솔에서 역할을 삭제했을 수 있습니다.
• 자동화된 스크립트: 사용하지 않는 AWS 리소스를 제거하도록 설계된 정리 스크립트가 실수로 이 역할을 대상으로 삭제했을 수 있습니다.
• 도메인 재구성: 특정 순서로 사용자 지정 도메인을 제거하고 다시 추가하면 구성이 불일치 상태가 되어 역할이 삭제되고 역할에 대한 참조는 남아 있을 수 있습니다.

원인에 관계없이 결과는 배포 실패입니다. Amplify가 더 이상 도메인 관리에 필요한 역할을 찾을 수 없기 때문입니다.

해결책: IAM 역할 다시 생성하기

역할이 누락되었으므로 가장 직접적인 해결책은 올바른 권한으로 다시 생성하는 것입니다. 이 과정은 새로운 IAM 역할을 생성하고 Amplify가 역할을 맡을 수 있도록 허용하는 특정 신뢰 정책을 첨부하는 것을 포함합니다.

이 문제는 커뮤니티에서 논의되었으며 여기 GitHub 이슈에서 추적되고 있지만 패치를 기다릴 필요는 없습니다. 아래 단계를 따라 몇 분 안에 직접 해결할 수 있습니다.

AWSAmplifyDomainRole 생성 단계별 가이드

필요한 IAM 역할을 생성하는 과정을 살펴보겠습니다. 시작하기 전에 AWS 콘솔에 로그인되어 있는지 확인하세요.

1단계: IAM 콘솔로 이동하기

먼저 AWS 콘솔에서 IAM 서비스로 이동합니다. 기본 검색창에 “IAM”을 입력하고 결과에서 선택하여 찾을 수 있습니다.

2단계: 새 역할 생성하기

IAM 대시보드에서 왼쪽 탐색 창의 **“Roles”**를 클릭합니다. 그런 다음 “Create role” 버튼을 클릭합니다.

3단계: 신뢰할 수 있는 엔티티 선택하기

이 단계가 가장 중요합니다. AWS에 이 역할을 사용할 수 있는 서비스를 지정해야 합니다.

1. 신뢰할 수 있는 엔티티 유형에 대해 **“Custom trust policy”**를 선택합니다.
2. JSON 편집기가 나타납니다. 기본 내용을 다음 정책으로 바꿉니다:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": "amplify.amazonaws.com"
      },
      "Action": "sts:AssumeRole"
    }
  ]
}

이 정책은 AWS Amplify 서비스(amplify.amazonaws.com)에 이 역할을 맡을 수 있는 명시적인 권한을 부여합니다.

정책을 붙여넣은 후 **“Next”**를 클릭합니다.

4단계: 권한 추가 (선택 사항이지만 권장)

“Add permissions” 페이지에서 이 특정 수정에는 엄격하게 정책을 첨부할 필요가 없습니다. 신뢰 관계가 핵심 부분입니다. 그러나 Amplify는 이 역할을 사용하여 인증서를 관리합니다. 문제가 계속 발생하면 안전을 위해 AWS 관리 정책 AWSCertificateManagerFullAccess를 첨부할 수 있지만, Amplify가 이를 관리하므로 일반적으로 필요하지 않습니다.

이 가이드에서는 신뢰 정책만으로 오류를 해결할 수 있으므로 추가 권한을 추가하지 않고 건너뜁니다. **“Next”**를 클릭합니다.

5단계: 역할 이름 지정 및 완료

이제 역할에 이름을 지정합니다. 이는 또 다른 중요한 단계입니다. 이름이 정확해야 합니다.

1. **“Role name”**에 오류 메시지에 표시된 정확한 이름(예: AWSAmplifyDomainRole-Z073737928BZTN2WA6J6L)을 입력합니다.
2. “Role for AWS Amplify to manage custom domain resources and SSL certificates.”와 같은 선택적 설명을 추가할 수 있습니다.
3. 세부 정보를 검토하여 신뢰할 수 있는 엔티티가 amplify.amazonaws.com이고 역할 이름이 정확한지 확인합니다.
4. “Create role” 버튼을 클릭합니다.

역할이 생성되었다는 성공 메시지가 표시되어야 합니다.

6단계: Amplify 배포 다시 시도

이제 AWSAmplifyDomainRole이 다시 생성되었으므로 AWS Amplify 콘솔로 돌아가 이전에 실패했던 빌드나 배포를 다시 시작합니다. Amplify가 이제 필요한 역할을 찾을 수 있으므로 도메인 관리 작업을 계속하여 오류를 해결합니다.

더 영구적인 수정: 실수로 인한 삭제 방지

역할을 다시 생성하는 것은 빠른 수정이지만, 향후 이 문제를 어떻게 방지할 수 있을까요?

1. 팀 교육: IAM 액세스 권한이 있는 팀의 모든 구성원이 AWSAmplifyDomainRole의 중요성을 이해하도록 하세요. 더 이상 사용 중이지 않다는 확신 없이는 IAM 역할을 삭제하지 않도록 조언하세요.
2. 리소스 태그 지정: AWSAmplifyDomainRole에 태그를 적용합니다(예: Project: MyApp, ManagedBy: Amplify). 이는 컨텍스트를 추가하고 사람이나 자동화된 스크립트에 의한 실수로 인한 삭제를 방지하는 데 도움이 될 수 있습니다.
3. 정리 스크립트 개선: 사용하지 않는 AWS 리소스를 정리하는 스크립트를 사용하는 경우, 이름이 AWSAmplifyDomainRole이거나 Amplify에 의해 관리된다는 태그가 있는 역할에 대한 예외를 추가합니다.

결론

AWSAmplifyDomainRole cannot be found 오류를 만나는 것은 AWS Amplify와 사용자 지정 도메인을 사용하는 개발자에게 흔히 발생하는 문제입니다. 다행히 해결책은 간단합니다. 올바른 신뢰 정책으로 누락된 IAM 역할을 수동으로 다시 생성하면 배포 파이프라인의 장애물을 빠르게 제거할 수 있습니다.

이 가이드는 서비스 업데이트를 기다리지 않고 직접 문제를 해결할 수 있는 힘을 제공합니다. 역할이 복원되고 빌드가 통과되면 가장 중요한 것, 즉 훌륭한 애플리케이션을 빌드하고 배포하는 일로 돌아갈 수 있습니다.

---

Meta Information

Meta Title: 수정: AWS Amplify에서 AWSAmplifyDomainRole을 찾을 수 없습니다
Meta Description: “AWSAmplifyDomainRole cannot be found” 오류가 발생하셨나요? 단계별 가이드를 통해 AWS Amplify 문제를 해결하고 배포를 다시 실행하는 방법을 보여줍니다.