Migrar clusters automáticos do AKS e pools de nós de sistema geridos

Aplica-se a: ✔️ AKS Automatic ✔️ AKS Standard

Este artigo mostra-lhe como migrar clusters AKS Automatic entre configurações suportadas de pool de nós de sistema gerido e configurações do AKS Standard.

Caminhos de migração suportados

Caminho de migração Support
AKS Automatic com grupos de nós de sistema geridos para AKS Standard (base SKU) Supported
AKS Automatic sem pools de nós de sistema geridos para AKS Automatic com pools de nós de sistema geridos Suportado em versão prévia nas regiões onde os conjuntos de nós de sistema geridos estão de disponibilidade geral
AKS Standard (base SKU) para AKS Automatic com conjuntos de nós do sistema geridos Brevemente
AKS Automatic com pools de nós de sistema geridos para AKS Automatic sem pools de nós de sistema geridos Não suportado

Migrar de um cluster AKS Automatic com conjuntos de nós de sistema geridos para um cluster AKS Standard

Como funciona a migração

Um cluster automático do AKS com conjuntos de nós de sistema geridos executa os seus componentes do sistema em conjuntos de nós de sistema que o AKS aprovisiona, dimensiona e atualiza por si.

Importante

Um cluster AKS Standard (base SKU) não permite pools de nós do sistema geridos, por isso és responsável por executar, gerir e atualizar o pool de nós do sistema e os componentes do sistema.

Para migrar do AKS Automatic para o AKS Standard, complete os seguintes passos de alto nível:

  1. Adicione um pool de nós do sistema autogerido ao seu cluster AKS Automatic.
  2. Atualize o SKU do cluster de automatic para base.

Depois de atualizar o SKU, o cluster passa a funcionar como um cluster AKS Standard, e os componentes do sistema são executados no pool de nós de sistema que adicionou e gere.

Migrar para um cluster AKS Standard

  1. Adicione um pool de nós do sistema autogerido ao seu cluster AKS Automatic existente usando o az aks nodepool add comando. Defina o modo do pool de nós para System para que possa executar componentes de sistema após a migração.

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

  2. Atualize o SKU do cluster de automatic para base usando o az aks update comando.

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

Verificar a migração

  1. Confirma que o cluster agora usa o base SKU usando o az aks show comando.

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

  2. Liste os pools de nós no cluster para confirmar que o pool de nós do sistema autogerido está presente e no modo System, utilizando o 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

Migrar de um cluster AKS Automatic sem pools de nós de sistema geridos para AKS Automatic com pools de nós de sistema geridos (pré-visualização)

O AKS Automatic suporta a migração em pré-visualização de pools de nós de sistema não geridos para pools de nós de sistema geridos em regiões onde os pools de nós de sistema geridos estão disponíveis de forma geral. Esta migração mantém o cluster no automatic SKU e move os componentes do sistema AKS para um pool de nós do sistema gerido pelo AKS.

Pré-requisitos

Importante

As funcionalidades de pré-visualização do AKS estão disponíveis num regime de autosserviço e de adesão voluntária. As visualizações prévias são fornecidas "como estão" e "conforme disponíveis" e são excluídas dos contratos de nível de serviço e da garantia limitada. As versões de pré-visualização do AKS são apenas parcialmente abrangidas pelo suporte ao cliente, na medida do possível. Assim sendo, estas funcionalidades não se destinam ao uso em produção. Para obter mais informações, consulte os seguintes artigos de suporte:

  • Um cluster AKS Automatic existente sem pools de nós de sistema geridos.
  • CLI do Azure versão 2.86.0 ou posterior. Para localizar a versão, execute az --version. Se precisar de instalar ou atualizar, consulte Install CLI do Azure.
  • A versão mais recente da extensão CLI do aks-preview Azure.
  • A feature flag Microsoft.ContainerService/NonHoboToHoboConversionPreview está registada na sua subscrição.

Registe o sinalizador de funcionalidade NonHoboToHoboConversionPreview usando o comando az feature register:

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

Verifique o estado do registo usando o az feature show comando:

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

Espera até o comando regressar Registered antes de continuares. Depois, atualize o registo do Microsoft.ContainerService fornecedor de recursos.

az provider register --namespace Microsoft.ContainerService

Instale ou atualize a aks-preview extensão:

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

Migrar um cluster de rede virtual gerido por AKS

Para um cluster automático do AKS que utiliza rede gerida pelo AKS, migre para conjuntos de nós de sistema geridos utilizando o comando az aks update com o parâmetro --enable-hosted-system:

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

Migrar um cluster de rede virtual personalizado

Para um cluster AKS Automatic que utiliza uma rede virtual personalizada, forneça uma sub-rede para o pool de nós do sistema gerido usando o --system-node-subnet-id parâmetro. A sub-rede do nó do sistema deve:

  • Encontrar-se na mesma rede virtual e na mesma região que o cluster.
  • Sê, pelo menos, /26.
  • Não ser delegado a outro serviço.
  • Seja diferente da sub-rede dos nós.

O --node-subnet-id parâmetro é opcional. Se não o fornecer, o AKS usa a sub-rede existente do pool de nós do 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}"

Verificar a migração

Confirme que o cluster utiliza pools de nós de sistema geridas utilizando o comando az aks show:

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

O seguinte exemplo de saída mostra a hostedSystemProfile.enabled propriedade definida para true:

{
  "enabled": true,
  "nodeSubnetId": "<node-subnet-resource-id>",
  "systemNodeSubnetId": "<system-node-subnet-resource-id>"
}
  • Última atualização a