Eseguire la migrazione di cluster automatici di AKS e pool di nodi di sistema gestiti

Si applica a: ✔️ Servizio Azure Kubernetes Standard automatico ✔️ Servizio Azure Kubernetes standard

Questo articolo illustra come eseguire la migrazione dei cluster automatici del servizio Azure Kubernetes tra il pool di nodi di sistema gestito supportato e le configurazioni standard del servizio Azure Kubernetes.

Percorsi di migrazione supportati

Percorso di migrazione Support
Servizio Azure Kubernetes automatico con pool di nodi di sistema gestiti nel servizio Azure Kubernetes Standard (SKU base) Supported
Servizio Azure Kubernetes Automatico senza pool di nodi di sistema gestiti al servizio Azure Kubernetes Automatico con pool di nodi di sistema gestiti Supportato in anteprima nelle aree in cui i pool di nodi di sistema gestiti sono disponibili a livello generale
AKS Standard (base SKU) ad AKS Automatic con pool di nodi di sistema gestiti Presto disponibile
Servizio Azure Kubernetes Automatico con pool di nodi di sistema gestiti al servizio Azure Kubernetes Automatico senza pool di nodi di sistema gestiti Non supportato

Eseguire la migrazione da un cluster automatico del servizio Azure Kubernetes con pool di nodi di sistema gestiti a un cluster del servizio Azure Kubernetes Standard

Funzionamento della migrazione

Un cluster AKS Automatic con pool di nodi di sistema gestiti esegue i propri componenti di sistema in pool di nodi di sistema di cui AKS esegue il provisioning, il ridimensionamento e l'aggiornamento.

Importante

Un cluster AKS Standard (base SKU) non supporta i pool di nodi di sistema gestiti, quindi la responsabilità dell'esecuzione, della gestione e dell'aggiornamento del pool di nodi di sistema e dei componenti di sistema ricade sull'utente.

Per eseguire la migrazione dal servizio Azure Kubernetes Automatico al servizio Azure Kubernetes Standard, completare i passaggi generali seguenti:

  1. Aggiungere un pool di nodi di sistema autogestito al cluster AKS Automatic.
  2. Aggiornare lo SKU del cluster da automatic a base.

Dopo aver aggiornato lo SKU, il cluster funziona come un cluster AKS Standard e i componenti di sistema vengono eseguiti nel pool di nodi di sistema che hai aggiunto e che gestisci.

Eseguire la migrazione a un cluster AKS Standard

  1. Aggiungi un pool di nodi di sistema autogestito al cluster AKS Automatic esistente usando il comando az aks nodepool add. Impostare la modalità pool di nodi su System in modo che possa eseguire i componenti di sistema dopo la migrazione.

    az aks nodepool add \
        --resource-group "${RESOURCE_GROUP}" \
        --cluster-name "${RESOURCE_NAME}" \
        --name systempool \
        --mode System \
        --node-count 3
    
  2. Aggiornare lo SKU del cluster da automatic a base usando il az aks update comando .

    az aks update \
        --resource-group "${RESOURCE_GROUP}" \
        --name "${RESOURCE_NAME}" \
        --sku base
    

Verificare la migrazione

  1. Verificare che il cluster usi ora lo base SKU usando il az aks show comando .

    az aks show \
        --resource-group "${RESOURCE_GROUP}" \
        --name "${RESOURCE_NAME}" \
        --query "sku" \
        --output table
    
  2. Elenca i pool di nodi nel cluster per verificare che il pool di nodi di sistema autogestito sia presente e in modalità System utilizzando il comando az aks nodepool list.

    az aks nodepool list \
        --resource-group "${RESOURCE_GROUP}" \
        --cluster-name "${RESOURCE_NAME}" \
        --query "[].{Name:name, Mode:mode, Count:count}" \
        --output table
    

Eseguire la migrazione da un cluster automatico del servizio Azure Kubernetes senza pool di nodi di sistema gestiti al servizio Azure Kubernetes Automatico con pool di nodi di sistema gestiti (anteprima)

AKS Automatic supporta la migrazione in anteprima dai pool di nodi di sistema non gestiti ai pool di nodi di sistema gestiti nelle aree geografiche in cui i pool di nodi di sistema gestiti sono generalmente disponibili. Questa migrazione mantiene il cluster nello automatic SKU e sposta i componenti di sistema del servizio Azure Kubernetes in un pool di nodi di sistema gestito dal servizio Azure Kubernetes.

Prerequisiti

Importante

Le funzionalità in anteprima di AKS sono disponibili in modalità self-service, su base volontaria. Le anteprime vengono fornite "così come sono" e "come disponibili" e sono escluse dai contratti di servizio e dalla garanzia limitata. Le anteprime di AKS sono coperte solo parzialmente dall'assistenza clienti nei limiti del possibile. Di conseguenza, queste funzionalità non sono destinate all'uso in produzione. Per altre informazioni, vedere gli articoli di supporto seguenti:

  • Un cluster AKS Automatic esistente senza pool di nodi di sistema gestiti.
  • interfaccia della riga di comando di Azure versione 2.86.0 o successiva. Per trovare la versione, eseguire az --version. Se è necessario installare o aggiornare, vedere Installare interfaccia della riga di comando di Azure.
  • L'ultima versione dell'aks-previewestensione dell'interfaccia della riga di comando di Azure.
  • Flag di funzionalità Microsoft.ContainerService/NonHoboToHoboConversionPreview registrato nella sottoscrizione.

Registrare il feature flag NonHoboToHoboConversionPreview usando il comando az feature register:

az feature register \
    --namespace Microsoft.ContainerService \
    --name NonHoboToHoboConversionPreview

Controllare lo stato della registrazione usando il az feature show comando :

az feature show \
    --namespace Microsoft.ContainerService \
    --name NonHoboToHoboConversionPreview \
    --query properties.state \
    --output tsv

Attendere che il comando venga restituito Registered prima di continuare. Aggiornare quindi la registrazione del Microsoft.ContainerService provider di risorse.

az provider register --namespace Microsoft.ContainerService

Installare o aggiornare l'estensione aks-preview :

az extension add --name aks-preview
az extension update --name aks-preview

Eseguire la migrazione di un cluster di rete virtuale gestito da AKS

Per un cluster automatico di AKS che usa la rete gestita da AKS, eseguire la migrazione ai pool di nodi di sistema gestiti usando il comando az aks update con il parametro --enable-hosted-system:

az aks update \
    --resource-group "${RESOURCE_GROUP}" \
    --name "${RESOURCE_NAME}" \
    --enable-hosted-system

Eseguire la migrazione di un cluster di rete virtuale personalizzato

Per un cluster AKS Automatic che usa una rete virtuale personalizzata, fornire una subnet per il pool di nodi di sistema gestito usando il parametro --system-node-subnet-id. La subnet del nodo di sistema deve:

  • Trovarsi nella stessa rete virtuale e nella stessa area del cluster.
  • Sii almeno /26.
  • Non essere delegato a un altro servizio.
  • Deve essere diversa dalla subnet del nodo.

Il parametro --node-subnet-id è facoltativo. Se non la fornisci, AKS usa la subnet del pool di nodi di sistema esistente.

az aks update \
    --resource-group "${RESOURCE_GROUP}" \
    --name "${RESOURCE_NAME}" \
    --enable-hosted-system \
    --system-node-subnet-id "${SYSTEM_NODE_SUBNET_ID}" \
    --node-subnet-id "${NODE_SUBNET_ID}"

Verificare la migrazione

Verificare che il cluster usi pool di nodi di sistema gestiti usando il az aks show comando :

az aks show \
    --resource-group "${RESOURCE_GROUP}" \
    --name "${RESOURCE_NAME}" \
    --query hostedSystemProfile \
    --output json

L'output di esempio seguente mostra la hostedSystemProfile.enabled proprietà impostata su true:

{
  "enabled": true,
  "nodeSubnetId": "<node-subnet-resource-id>",
  "systemNodeSubnetId": "<system-node-subnet-resource-id>"
}