Migrieren von AKS Automatic-Clustern und verwalteten Systemknotenpools

Gilt für: ✔️ AKS Automatic ✔️ AKS Standard

In diesem Artikel erfahren Sie, wie Sie AKS Automatic Clusters zwischen unterstützten verwalteten Systemknotenpool und AKS Standard-Konfigurationen migrieren.

Unterstützte Migrationspfade

Migrieren von einem automatischen AKS-Cluster mit verwalteten Systemknotenpools zu einem AKS Standardcluster

Funktionsweise der Migration

Ein automatischer AKS-Cluster mit verwalteten Systemknotenpools führt seine Systemkomponenten in Systemknotenpools aus, die AKS für Sie bereit stellt, skaliert und aktualisiert.

Führen Sie die folgenden allgemeinen Schritte aus, um von AKS Automatic zu AKS Standard zu migrieren:

1. Fügen Sie Ihrem automatischen AKS-Cluster einen selbstverwalteten Systemknotenpool hinzu.
2. Aktualisieren Sie die Cluster-SKU von automatic zu base.

Nachdem Sie die SKU aktualisiert haben, wird der Cluster als AKS-Standardcluster betrieben, und Ihre Systemkomponenten werden auf dem von Ihnen hinzugefügten und verwalteten Systemknotenpool ausgeführt.

Migrieren zu einem AKS Standardcluster

1. Fügen Sie ihrem vorhandenen automatischen AKS-Cluster mithilfe des az aks nodepool add Befehls einen selbstverwalteten Systemknotenpool hinzu. Legen Sie den Knotenpoolmodus so fest, System dass er nach der Migration Systemkomponenten ausführen kann.

   az aks nodepool add \
       --resource-group "${RESOURCE_GROUP}" \
       --cluster-name "${RESOURCE_NAME}" \
       --name systempool \
       --mode System \
       --node-count 3
   

2. Aktualisieren Sie die Cluster-SKU von automatic auf base mithilfe des Befehls az aks update.

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

Überprüfen der Migration

1. Vergewissern Sie sich, dass der Cluster jetzt die base SKU mithilfe des az aks show Befehls verwendet.

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

2. Listen Sie die Knotenpools im Cluster auf, um zu bestätigen, dass Ihr selbstverwalteter Systemknotenpool vorhanden ist und den Modus System aufweist, indem Sie den Befehl az aks nodepool list verwenden.

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

Migrieren von einem automatischen AKS-Cluster ohne verwaltete Systemknotenpools zu AKS Automatic mit verwalteten Systemknotenpools (Vorschau)

AKS Automatic unterstützt die Vorschaumigration von nicht verwalteten Systemknotenpools zu verwalteten Systemknotenpools in Regionen, in denen verwaltete Systemknotenpools allgemein verfügbar sind. Diese Migration behält den Cluster auf der automatic SKU bei und verschiebt AKS-Systemkomponenten in einen von AKS verwalteten Systemknotenpool.

Voraussetzungen

• Ein vorhandener automatischer AKS-Cluster ohne verwaltete Systemknotenpools.
• Azure CLI Version 2.86.0 oder höher. Führen Sie az --version aus, um die Version zu finden. Wenn Sie eine Installation oder ein Upgrade durchführen müssen, finden Sie weitere Informationen unter Azure CLI installieren.
• Die neueste Version der aks-preview Azure CLI Erweiterung.
• Das Microsoft.ContainerService/NonHoboToHoboConversionPreview Feature-Flag, das in Ihrem Abonnement registriert ist.

Registrieren Sie das NonHoboToHoboConversionPreview Feature-Flag mithilfe des az feature register Befehls:

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

Überprüfen Sie den Registrierungsstatus mithilfe des az feature show Befehls:

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

Warten Sie, bis der Befehl zurückgegeben wird Registered , bevor Sie fortfahren. Aktualisieren Sie dann die Registrierung des Microsoft.ContainerService Ressourcenanbieters.

az provider register --namespace Microsoft.ContainerService

Installieren oder Aktualisieren der aks-preview Erweiterung:

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

Migrieren eines AKS-verwalteten virtuellen Netzwerkclusters

Migrieren Sie bei einem automatischen AKS-Cluster, der von AKS verwaltete Netzwerke verwendet, mithilfe des az aks update-Befehls mit dem --enable-hosted-system-Parameter zu verwalteten Systemknotenpools:

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

Migrieren eines benutzerdefinierten virtuellen Netzwerkclusters

Stellen Sie für einen automatischen AKS-Cluster, der ein benutzerdefiniertes virtuelles Netzwerk verwendet, ein Subnetz für den verwalteten Systemknotenpool mithilfe des --system-node-subnet-id Parameters bereit. Das Subnetz des Systemknotens muss:

• Befinden Sie sich im selben virtuellen Netzwerk und derselben Region wie der Cluster.
• Seien Sie mindestens /26.
• Nicht an einen anderen Dienst übertragen werden.
• Unterscheiden Sie sich vom Knotensubnetz.

Der --node-subnet-id Parameter ist optional. Wenn Sie sie nicht bereitstellen, verwendet AKS das vorhandene Subnetz des Systemknotenpools.

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}"

Überprüfen der Migration

Vergewissern Sie sich, dass der Cluster verwaltete Systemknotenpools mithilfe des az aks show Befehls verwendet:

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

Die folgende Beispielausgabe zeigt, dass die Eigenschaft hostedSystemProfile.enabled auf true gesetzt ist:

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