Migración de clústeres automáticos de AKS y grupos de nodos de sistema administrados

Se aplica a: ✔️ AKS Automatic ✔️ AKS Standard

En este artículo se muestra cómo migrar clústeres AKS Automatic entre las configuraciones compatibles de grupo de nodos del sistema administrado y AKS Standard.

Rutas de migración admitidas

Migración desde un clúster automático de AKS con grupos de nodos del sistema administrado a un clúster estándar de AKS

Funcionamiento de la migración

Un clúster automático de AKS con grupos de nodos del sistema administrado ejecuta sus componentes del sistema en grupos de nodos del sistema que AKS aprovisiona, escala y actualiza automáticamente.

Para migrar de AKS Automatic a AKS Standard, complete los siguientes pasos de alto nivel:

1. Agregue un grupo de nodos del sistema autoadministrado al clúster automático de AKS.
2. Actualice la SKU del clúster de automatic a base.

Después de actualizar la SKU, el clúster se ejecuta como un clúster estándar de AKS y los componentes del sistema se ejecutan en el grupo de nodos del sistema que agregó y administra.

Migración a un clúster estándar de AKS

1. Agregue un grupo de nodos del sistema autoadministrado al clúster automático de AKS existente mediante el az aks nodepool add comando . Establezca el modo de grupo de nodos en System para que pueda ejecutar componentes del sistema después de la migración.

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

2. Actualice la SKU del clúster desde automatic a base mediante el az aks update comando .

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

Comprobar la migración.

1. Confirme que el clúster usa ahora la base SKU mediante el az aks show comando .

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

2. Enumere los grupos de nodos del clúster para confirmar que el grupo de nodos del sistema autoadministrado esté presente y en modo System con el 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
   

Migración desde un clúster automático de AKS sin grupos de nodos del sistema administrados a AKS Automatic con grupos de nodos del sistema administrados (versión preliminar)

AKS Automatic admite la migración en versión preliminar de grupos de nodos del sistema no administrados a grupos de nodos de sistema administrados en regiones donde los grupos de nodos del sistema administrado están disponibles con carácter general. Esta migración mantiene el clúster en la automatic SKU y mueve los componentes del sistema de AKS a un grupo de nodos del sistema administrado por AKS.

Prerequisites

• Un clúster automático de AKS existente sin grupos de nodos del sistema administrados.
• CLI de Azure versión 2.86.0 o posterior. Para encontrar la versión, ejecute az --version. Si necesita instalar o actualizar, consulte Install CLI de Azure.
• La versión más reciente de la extensión de la CLI de Azure aks-preview.
• La marca de característica Microsoft.ContainerService/NonHoboToHoboConversionPreview registrada en la suscripción.

Registre el indicador de función NonHoboToHoboConversionPreview con el comando az feature register.

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

Compruebe el estado del registro mediante el az feature show comando :

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

Espere hasta que el comando vuelva Registered antes de continuar. A continuación, actualice el registro del Microsoft.ContainerService proveedor de recursos.

az provider register --namespace Microsoft.ContainerService

Instale o actualice la aks-preview extensión:

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

Migración de un clúster de red virtual administrado por AKS

Para un clúster automático de AKS que usa redes administradas por AKS, migre a grupos de nodos del sistema administrados mediante el az aks update comando con el --enable-hosted-system parámetro :

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

Migración de un clúster de red virtual personalizado

Para un clúster automático de AKS que usa una red virtual personalizada, proporcione una subred para el grupo de nodos del sistema administrado mediante el --system-node-subnet-id parámetro . La subred del nodo del sistema debe:

• Estar en la misma red virtual y región que el clúster.
• Debe ser al menos /26.
• No se delegará en otro servicio.
• Debe ser diferente de la subred del nodo.

El --node-subnet-id parámetro es opcional. Si no la especifica, AKS usa la subred existente del grupo de nodos del sistema.

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

Comprobar la migración.

Confirme que el clúster usa grupos de nodos de sistema administrados mediante el az aks show comando :

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

En la siguiente salida de ejemplo se muestra la propiedad hostedSystemProfile.enabled establecida en true:

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