다음을 통해 공유


SubnetIsFull 오류 코드 문제 해결

이 문서에서는 AKS(Microsoft Azure Kubernetes ServiceSubnetIsFull) 클러스터의 크기를 조정하려고 할 때 발생하는 오류를 식별하고 resolve 방법에 대해 설명합니다.

필수 구성 요소

증상

AKS 클러스터의 크기를 조정하려고 하면 다음과 같은 오류 메시지가 표시됩니다.

"code": "SubnetIsFull"

"message": "주소 접두사 서브넷 접두사를 <사용하는 서브넷 <서브넷> 이름>에는 새 IP 개수 IP 주소에 대한 <충분한 용량이> 없습니다."

원인

AKS 클러스터(스케일 아웃)에 노드를 추가하려면 노드 풀이 배포된 서브넷에서 더 많은 IP 주소를 사용해야 합니다. 클러스터 크기 조정 작업을 성공적으로 완료하는 데 필요한 정확한 새 IP 주소 수는 클러스터에서 사용하는 네트워킹 플러그 인에 따라 달라집니다. 이러한 각 네트워킹 모델에서 IP 주소를 할당하는 방법에 대한 자세한 내용은 AKS의 애플리케이션에 대한 네트워크 개념을 참조하세요.

참고

Azure는 서브넷당 5개의 IP 주소를 예약합니다. 서브넷의 첫 번째 주소는 네트워크 ID에 대한 주소이고, 그 다음에는 Azure에서 내부적으로 사용되는 세 개의 주소가 있습니다. 서브넷의 마지막 주소는 브로드캐스트 패킷용으로 예약되어 있습니다. 자세한 내용은 이러한 서브넷 내에서 IP 주소 사용에 대한 제한이 있나요?를 참조하세요.

해결 방법

기존 노드 풀에서 서브넷의 CIDR(클래스리스 Inter-Domain 라우팅) 주소 공간을 업데이트하는 것은 현재 지원되지 않습니다. 워크로드를 더 큰 서브넷의 새 노드 풀로 마이그레이션하려면 다음 단계를 수행합니다.

  1. 기존 서브넷보다 더 큰 CIDR 주소 범위를 포함하는 클러스터 가상 네트워크에 서브넷을 만듭니다. 클러스터의 서브넷 크기를 적절하게 조정하는 방법에 대한 자세한 내용은 클러스터에 대한 IP 주소 지정 계획을 참조하세요.

  2. az aks nodepool add 명령을 매개 변수와 함께 실행하여 새 서브넷에 노드 풀을 --vnet-subnet-id 만듭니다.

  3. 이전 노드 풀의 노드를 드레이닝하여 워크로드를 새 노드 풀로 마이그레이션합니다. AKS 작업자 노드를 안전하게 드레이닝하는 방법에 대한 자세한 내용은 노드 드레이닝 안전을 참조하세요.

  4. az aks nodepool delete 명령을 실행하여 원래 노드 풀을 삭제합니다.

추가 정보

타사 연락처 고지

Microsoft는 이 항목에 대한 추가 정보를 찾는 데 도움이 되는 타사 연락처 정보를 제공합니다. 이 연락처 정보는 공지 없이 변경될 수 있습니다. Microsoft는 타사 연락처 정보의 정확성을 보장하지 않습니다.

도움을 요청하십시오.

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