Condividi tramite


Codice di errore InsufficientSubnetSize

Questo articolo illustra come risolvere un InsufficientSubnetSize errore che si verifica quando si tenta di distribuire un cluster Microsoft servizio Azure Kubernetes (AKS) che usa la rete avanzata. Questo articolo si applica sia ai cluster Kubernetes che ai cluster CNI (Azure Container Networking Interface).

Sintomi

L'errore InsufficientSubnetSize si verifica durante una delle operazioni seguenti. Questo errore viene rilevato anche nella diagnostica del servizio Azure Kubernetes, che individua in modo proattivo problemi come una dimensione della subnet insufficiente.

Operazione 1: Ridimensionamento di un cluster del servizio Azure Kubernetes o di un pool di nodi del servizio Azure Kubernetes

Tipo di cluster Sintomo:
Il numero di indirizzi IP liberi nella subnet è minore di...
Kubenet Numero di nuovi nodi richiesti.
Azure CNI Numero di nuovi nodi richiesti quando il valore del pool di nodi nel --max-pod parametro .
Sovrimpressione di Azure CNI Numero di nuovi nodi richiesti.
Nei pool di nodi che usano il ridimensionamento automatico, il numero di nodi è il valore nel --max-count parametro .

Operazione 2: Aggiornamento di un cluster del servizio Azure Kubernetes o di un pool di nodi del servizio Azure Kubernetes

Tipo di cluster Sintomo:
Il numero di indirizzi IP liberi nella subnet è minore di...
Kubenet Numero di nodi del buffer da aggiornare.
Azure CNI Numero di nodi del buffer che devono essere aggiornati quando il valore del --max-pod pool di nodi nel parametro .
Sovrimpressione di Azure CNI Numero di nodi del buffer da aggiornare.
Nei pool di nodi che usano il ridimensionamento automatico, il numero di nodi è il valore nel --max-count parametro .

Per impostazione predefinita, un cluster del servizio Azure Kubernetes imposta un valore massimo di picco (buffer di aggiornamento) pari a uno (1). Tuttavia, è possibile personalizzare questo comportamento di aggiornamento impostando il valore massimo di picco di un pool di nodi. Questa azione aumenta il numero di indirizzi IP disponibili necessari per completare un aggiornamento.

Operazione 3: Creazione di un cluster del servizio Azure Kubernetes o aggiunta di un pool di nodi del servizio Azure Kubernetes

Tipo di cluster Sintomo:
Il numero di indirizzi IP liberi nella subnet è minore di...
Kubenet Numero di nodi richiesti.
Azure CNI Numero di nodi richiesti quando il valore del pool di nodi nel --max-pod parametro .
Sovrimpressione di Azure CNI Numero di nodi richiesti.
Nei pool di nodi che usano il ridimensionamento automatico, il numero di nodi è il valore nel --max-count parametro .

Causa

Una subnet in uso per un cluster non ha più indirizzi IP disponibili all'interno dello spazio indirizzi CIDR (Classless Inter-Domain Routing) per l'assegnazione corretta delle risorse.

Tipo di cluster Requisito
Kubenet Spazio IP sufficiente per ogni nodo nel cluster
Azure CNI Spazio IP sufficiente per ogni nodo e pod nel cluster
Sovrimpressione di Azure CNI Spazio IP sufficiente per ogni nodo nel cluster

Altre informazioni sulla progettazione di Azure CNI per assegnare indirizzi IP ai pod.

Soluzione

Il tentativo di aggiornare lo spazio indirizzi CIDR di una subnet in un pool di nodi esistente non è attualmente supportato. Per eseguire la migrazione dei carichi di lavoro a un nuovo pool di nodi in una subnet più grande, seguire questa procedura:

  1. Creare una subnet nella rete virtuale del cluster che contiene un intervallo di indirizzi CIDR maggiore rispetto a quello della subnet esistente. Per informazioni su come ridimensionare adeguatamente la subnet per il cluster, vedere Pianificare l'indirizzamento IP per il cluster.

  2. Creare un pool di nodi nella nuova subnet eseguendo il comando az aks nodepool add insieme al --vnet-subnet-id parametro .

  3. Eseguire la migrazione dei carichi di lavoro al nuovo pool di nodi svuotando i nodi nel pool di nodi precedente. Per informazioni su come svuotare in modo sicuro i nodi del ruolo di lavoro del servizio Azure Kubernetes, vedere Svuotare in modo sicuro un nodo.

  4. Eliminare il pool di nodi originale eseguendo il comando az aks nodepool delete .

Dichiarazione di non responsabilità di contatti di terze parti

Microsoft fornisce informazioni di contatto di terze parti per aiutarti a trovare ulteriori informazioni su questo argomento. Queste informazioni di contatto sono soggette a modifica senza preavviso. Microsoft non garantisce l'accuratezza delle informazioni di contatto di terze parti.

Contattaci per ricevere assistenza

In caso di domande, è possibile porre domande al supporto della community di Azure. È possibile anche inviare un feedback sul prodotto al feedback della community di Azure.