AKS 클러스터 업그레이드 중 "SubnetIsFull" 오류 코드 문제 해결

이 문서에서는 AKS(Azure Kubernetes Service) 클러스터를 업그레이드하려고 할 때 발생하는 "SubnetIsFull" 오류를 식별하고 resolve 방법에 대해 설명합니다.

오류 메시지의 예는 다음과 같습니다.

Kubernetes 서비스 '<NAME'에서 노드 풀 <에이전트 풀 이름>> 크기를 조정하지 못했습니다. 오류: VMSSAgentPoolReconciler 재시도 실패: Code='SubnetIsFull' Message='<SUBNET NAME>\ 주소 접두사 <PREFIX>\에는 IP 주소에 대한 충분한 용량이 없습니다.' Details=[]

필수 구성 요소

이 문서에는 Azure CLI 버전 2.0.65 이상이 필요합니다. 버전 번호를 찾으려면 를 실행합니다 az --version. Azure CLI를 설치하거나 업그레이드해야 하는 경우 Azure CLI를 설치하는 방법을 참조하세요.

업그레이드 프로세스에 대한 자세한 내용은 AKS(Azure Kubernetes Service) 클러스터 업그레이드의 "AKS 클러스터 업그레이드" 섹션을 참조하세요.

증상

AKS 클러스터 업그레이드가 실패하고 "SubnetIsFull" 오류 메시지가 표시됩니다.

원인

이 오류는 클러스터에 새 노드를 만들기에 충분한 IP 주소가 없는 경우에 발생합니다.

업그레이드 또는 크기 조정 작업을 수행하려는 경우 필요한 IP 주소 수를 고려합니다. 클러스터에서 구성한 IP 주소 범위가 고정된 수의 노드만 지원하는 경우 업그레이드 또는 크기 조정 작업이 실패합니다. 자세한 내용은 AKS(Azure Kubernetes Service Azure CNI 네트워킹 구성)의 "클러스터에 대한 IP 주소 지정 계획" 섹션을 참조하세요.

해결 방법

업그레이드를 위해 IP 주소를 예약하도록 클러스터 노드를 줄입니다.

스케일 다운이 옵션이 아니며 가상 네트워크 CIDR에 충분한 IP 주소가 있는 경우 고유한 서브넷이 있는 노드 풀을 추가해 보세요.

1. 더 큰 서브넷의 가상 네트워크에 새 사용자 노드 풀을 추가합니다.
2. 원래 노드 풀을 시스템 노드 풀 유형으로 전환합니다.
3. 사용자 노드 풀을 확장합니다.
4. 원래 노드 풀을 축소합니다.

도움을 요청하십시오.

질문이 있거나 도움이 필요한 경우 지원 요청을 생성하거나Azure 커뮤니티 지원에 문의하세요. Azure 피드백 커뮤니티에 제품 피드백을 제출할 수도 있습니다.