incompatible-network 상태의 Amazon DocumentDB 인스턴스 문제를 해결하려면 어떻게 해야 하나요?

간략한 설명

incompatible-network 상태는 Amazon DocumentDB 인스턴스와 관련된 다음 문제 중 하나 이상으로 인해 발생합니다.

• Amazon DocumentDB 인스턴스가 시작된 서브넷에는 사용 가능한 IP 주소가 없습니다.
• Amazon DocumentDB DB 서브넷 그룹에 나열된 서브넷은 Amazon Virtual Private Cloud(Amazon VPC)에 존재하지 않습니다.
• 사용 중인 AWS 리전의 탄력적 네트워크 인터페이스에 대한 서비스 할당량에 도달했습니다.

이러한 문제 중 하나가 발생하는 경우 다음 작업 중 하나를 수행할 때 Amazon DocumentDB 인스턴스가 incompatible-network 상태가 될 수 있습니다.

• Amazon DocumentDB 인스턴스의 클래스를 수정합니다.
• 클러스터에 새 Amazon DocumentDB 인스턴스를 추가합니다.
• 유지 관리 이벤트로 인해 호스트를 교체합니다.
• 탄력적 네트워크 인터페이스가 할당량에 도달하면 새 Amazon DocumentDB 인스턴스를 생성합니다.
• Amazon DocumentDB 스냅샷 백업에서 복원합니다.
• 중지된 Amazon DocumentDB 클러스터를 시작합니다.

해결 방법

incompatible-network 상태란 데이터베이스 수준에서 Amazon DocumentDB 인스턴스에 계속 액세스할 수 있지만 인스턴스를 수정하거나 재부팅할 수 없음을 의미합니다. 인스턴스가 네트워크 incompatible-network 상태로 전환되는 경우 데이터를 다른 인스턴스로 복원할 수 있도록 항상 백업해 두는 것이 좋습니다.

incompatible-network 상태의 Amazon DocumentDB 인스턴스 문제를 해결하려면 다음 해결 방법 중 하나를 선택하세요.

• AWSSupport-ValidateRdsNetworkConfiguration 런북을 사용합니다.
• AWS Management Console을 사용합니다.

AWSSupport-ValidateRdsNetworkConfiguration 런북 사용

Amazon DocumentDB 인스턴스가 incompatible-network 상태에 있는 이유를 확인하려면, AWSSupport-ValidateRdsNetworkConfiguration 런북을 사용하세요. incompatible-network 상태를 피하려면, 수정을 수행하거나 중지된 인스턴스를 시작할 때 이 런북을 사용하세요.

참고: AWSSupport-ValidateRdsNetworkConfiguration 런북을 시작하기 전에 AWS Identity and Access Management(AWS IAM) 사용자 또는 역할에 필요한 권한이 있는지 확인하세요. 자세한 내용을 보려면 AWSSupport-ValidateRdsNetworkConfiguration의 필수 IAM 권한 섹션을 참조하세요.

AWSSupport-ValidateRdsNetworkConfiguration 런북에서 문제를 해결하려면 다음 단계를 완료합니다.

1. AWS Systems Manager 콘솔에 로그인하여 AWSSupport-ValidateRdsNetworkConfiguration 런북에 액세스하세요.
2. 자동화 실행을 선택합니다.
3. 다음 값을 입력합니다.
   AutomationAssumeRole에 자동화가 사용자 본인을 대신하여 작업을 수행하도록 허용하는 IAM 역할의 ARN을 입력합니다. 역할이 지정되지 않은 경우, 자동화는 런북을 시작한 사용자의 권한을 사용합니다.
   DBInstanceIdentifier에 Amazon DocumentDB 인스턴스의 인스턴스 식별자를 입력합니다.
4. 실행을 선택합니다.
5. 자동화가 완료되면, 출력 섹션에서 자세한 결과를 검토하세요. generateReport.Report 파라미터는 이 런북의 일부로 수행된 모든 검사에 대한 통합 보고서를 보여줍니다.
6. (선택 사항) 추가 문제 해결 단계를 보려면 출력 보고서의 ### [Next Steps] 섹션을 확인하세요.

AWS Management Console 사용

AWS Management Console에서 문제를 해결하려면 다음 단계를 완료합니다.

1. Amazon DocumentDB 콘솔을 연 다음 탐색 창에서 인스턴스를 선택합니다.
2. incompatible-network 상태에 있는 Amazon DocumentDB 인스턴스를 선택합니다. 그런 다음 인스턴스 세부 정보의 VPC ID를 기록해 둡니다.
3. Amazon VPC 콘솔을 연 다음 탐색 창에서 서브넷을 선택합니다. Amazon DocumentDB 클러스터에서 사용하는 VPC의 모든 서브넷 그룹이 존재하고 사용 가능한 상태인지 확인합니다.
4. Amazon DocumentDB 클러스터에서 사용하는 서브넷 그룹의 모든 서브넷에 사용 가능한 IP 주소가 있는지 확인합니다.
5. Amazon Elastic Compute Cloud(Amazon EC2) 콘솔을 열고 탄력적 네트워크 인터페이스의 할당량에 도달하지 않았는지 확인합니다. 할당량에 도달한 경우 서비스 할당량 증가를 요청합니다. 자세한 내용은 네트워크 인터페이스를 참조하세요.

Amazon DocumentDB 인스턴스가 이미 incompatible-network 상태인 경우 Amazon DocumentDB 클러스터에 대해 다음 방법 중 하나를 선택합니다.

• incompatible-network 상태를 초래한 문제를 해결한 후 클러스터에 새 Amazon DocumentDB 인스턴스를 생성합니다. 새로운 활성 Amazon DocumentDB 인스턴스와 함께 실행 중인 클러스터를 만든 후, incompatible-network 상태였던 인스턴스를 삭제합니다.
  중요: 전체 클러스터를 삭제하지 마세요. 대신 incompatible-network 상태의 인스턴스만 삭제합니다. 또한 새 활성 Amazon DocumentDB 인스턴스가 이전의 incompatible-network 상태 인스턴스와 동일한 클러스터에 있는지 확인합니다.
• Amazon DocumentDB 인스턴스에 대한 모든 쓰기를 일시적으로 중지한 다음 시점 복구(PITR)를 수행하여 새 클러스터를 생성합니다.

관련 정보

Amazon DocumentDB 인스턴스 상태 모니터링