이 문서에서는 게이트웨이 마이그레이션 워크플로와 관련된 오류 코드와 원인 및 해결 방법의 개요를 제공합니다. 마이그레이션 프로세스의 각 단계에서 일반적으로 발생하는 문제: 유효성 검사, 준비, 마이그레이션 및 커밋 또는 중단.
마이그레이션 오류를 방지하기 위한 모범 사례
게이트웨이 마이그레이션 프로세스 중에 오류를 최소화하려면 다음 모범 사례를 따릅니다.
리소스 상태 유지: 모든 리소스가 마이그레이션 전체에서 성공 상태로 유지되도록 합니다. 프로세스 중에 관련 리소스에 대한 업데이트를 실행하지 않습니다.
속성 업데이트 방지: 이러한 업데이트로 인해 리소스 오류가 발생할 수 있으므로 FastPath, 경로 가중치 또는 연결 및 게이트웨이에 대한 트래픽 토글 과 같은 속성을 업데이트하지 않습니다.
순차 게이트웨이 마이그레이션: 동일한 회로에 연결된 게이트웨이를 한 번에 하나씩 마이그레이션합니다. 동일한 회로의 병렬 마이그레이션은 지원되지 않습니다.
수동 변경 방지: 마이그레이션 프로세스 중에 트래픽(관리 상태 사용)을 적극적으로 수행하는 동안 게이트웨이 또는 해당 연결을 수동으로 생성, 삭제, 업데이트 또는 다시 설정하지 마세요.
유지 관리 확인: 이 작업이 실패하므로 유지 관리가 진행 중인 게이트웨이에 대한 연결을 만들지 않습니다. 실패한 연결은 다시 시도하기 전에 삭제해야 합니다.
이러한 사례를 준수하면 마이그레이션 중에 오류가 발생할 가능성을 줄일 수 있습니다.
마이그레이션 단계 및 해결 방법 중 일반적인 문제
다음 표에서는 각 마이그레이션 단계에서 발생하는 일반적인 문제를 간략하게 설명하고 이를 해결하기 위한 전략을 제공합니다.
| 마이그레이션 단계 | 문제 | 해결 방법 |
|---|---|---|
| 유효성 검사 | 리소스가 성공 상태가 아닙니다. | 이 문제를 해결하려면 영향을 받는 리소스에 대해 GET 및 SET 작업을 수행합니다. |
| 준비 | 새 리소스를 만들지 못합니다. | 작업을 다시 시도하세요. 다시 시도가 계속 실패하는 경우 새로 만든 리소스를 삭제하고 작업을 다시 시도합니다. |
| 이주하다 | 두 게이트웨이는 마이그레이션 실패 후에도 계속 사용하도록 설정됩니다. | 트래픽을 이전 게이트웨이로 다시 리디렉션하고 마이그레이션 프로세스를 다시 시도합니다. |
| 커밋 | 이전 게이트웨이는 계속 사용하도록 설정되어 있으며 커밋 단계가 실패합니다. | 마이그레이션 단계를 다시 시도합니다. 이전 게이트웨이를 사용하지 않도록 설정하면 이전 게이트웨이 및 관련 리소스를 삭제합니다. |
| 중단 | 중단 단계 중에 리소스 정리가 실패합니다. | 트래픽을 새 게이트웨이로 리디렉션하고 중단 작업을 다시 시도합니다. |
일반적인 오류 메시지
다음 표에서는 마이그레이션 프로세스 중에 발생하는 일반적인 오류 메시지와 원인 및 해결에 대해 간략하게 설명합니다.
조건부 지원이 있는 시나리오
이러한 시나리오에는 오류를 방지하고 성공적인 마이그레이션을 보장하는 솔루션이 포함됩니다.
| 오류 이름 | 메시지 | 해결 방법 |
|---|---|---|
| 게이트웨이 서브넷 크기가 부족합니다. | 가상 네트워크에 {vnetName} 는 다른 게이트웨이를 배포할 충분한 공간이 없습니다. |
GatewaySubnet을 /27 이하 접두사(예: /26 또는 /25)로 삭제하고 다시 만듭니다. 지침은 서브넷 삭제 및 다시 만들기를 참조하세요. |
| 레거시 연결 모드 | 게이트웨이에 연결된 ExpressRoute 연결은 2017(레거시 모드) 이전에 만들어졌습니다. | 마이그레이션을 시작하기 전에 모든 연결을 삭제하고 다시 만듭니다. 자세한 단계는 레거시 ExpressRoute 게이트웨이 연결 변환을 참조하세요. |
| 호환되지 않는 전용 회로 | 가상 네트워크에 연결된 전용 HSM(하드웨어 보안 모듈)으로 인해 게이트웨이 마이그레이션을 진행할 수 없습니다. | 마이그레이션을 계속하려면 전용 HSM(하드웨어 보안 모듈)의 할당을 취소합니다. 자세한 문제 해결 단계는 전용 HSM 문제 해결을 참조하세요. |
| 실패한 상태의 리소스 | 게이트웨이 또는 회로, 연결, 공용 IP, VNet 또는 GatewaySubnet과 같은 연결된 리소스가 실패한 상태이면 유효성이 검사된 단계가 실패합니다. | 마이그레이션 프로세스를 시작하기 전에 모든 리소스가 성공 상태인지 확인합니다. 자세한 내용을 보려면 실패 상태 문제 해결를 참조하세요. |
| 기본 게이트웨이 SKU 제한 사항 | 영역 복원력을 보장하려면 마이그레이션 전에 기본 게이트웨이를 표준 SKU로 업그레이드해야 합니다. | 마이그레이션을 계속하기 전에 게이트웨이 SKU를 표준으로 변경합니다. 자세한 내용은 게이트웨이 SKU 크기 조정을 참조하세요. |
| FastPath 구성 제한 | 마이그레이션 중에 FastPath를 사용하거나 사용하지 않도록 설정하는 것은 지원되지 않습니다. | 마이그레이션을 계속하기 전에 FastPath가 원래 구성에 남아 있는지 확인합니다. |
| 경로 가중치 수정 제한 | 마이그레이션 중 경로 가중치 조정은 허용되지 않습니다. | 마이그레이션 프로세스를 계속하기 전에 경로 가중치를 원래 값으로 되돌려 갑니다. |
지원되지 않는 시나리오를 피해야 함
다음 표에서는 마이그레이션 오류가 발생할 수 있고 사용 가능한 해결 방법이 없는 지원되지 않는 시나리오를 간략하게 설명합니다.
| 오류 이름 | 메시지 | 원인 |
|---|---|---|
| 도달한 VNet의 최대 게이트웨이 수 | 허용된 최대 게이트웨이 수가 이미 포함되어 있으므로 가상 네트워크에 {virtualNetworkName} 대한 작업이 실패했습니다. |
가상 네트워크에는 둘 이상의 ExpressRoute 게이트웨이가 배포될 수 없습니다. |
| 연결 제한을 초과했습니다. | 기존 게이트웨이에는 {connectionCount} 새 게이트웨이 크기에 {circuitLimit}대한 연결 제한을 {gatewaySize} 초과하는 연결이 있습니다. |
기존 게이트웨이보다 연결 제한이 낮은 게이트웨이로 마이그레이션하는 것은 허용되지 않습니다. SKU 형식의 다운그레이드는 지원되지 않습니다. |
| FastPath 제한 | ExpressRouteGatewayByPass는 게이트웨이 크기에 {gatewaySize}대해 지원되지 않습니다. |
FastPath 사용 연결에 연결된 게이트웨이는 UltraPerf 또는 ERGW3AZ SKU로만 마이그레이션할 수 있습니다. SKU 형식의 다운그레이드는 지원되지 않습니다. |
| 해지된 회로 권한 부여 | 허용된 최대 게이트웨이 수가 이미 포함되어 있으므로 가상 네트워크에 {virtualNetworkName} 대한 작업이 실패했습니다. |
해지된 권한 부여를 사용하여 회로에 연결된 게이트웨이는 마이그레이션을 진행할 수 없습니다. |
다음 단계
- Azure Portal을 사용하여 마이그레이션하는 방법을 알아봅니다.
- PowerShell을 사용하여 마이그레이션하는 방법을 알아봅니다.
- 고가용성을 위한 모범 사례를 살펴봅니다.