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

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

Este artigo mostra como migrar clusters AKS Automatic entre pools de nós de sistemas gerenciados permitidos e configurações AKS Standard.

Caminhos de migração com suporte

Caminho de migração Support
AKS Automático com pools de nós de sistema gerenciados para o AKS Standard (base SKU) Supported
AKS Automatic sem pools de nós de sistema gerenciados para AKS Automatic com pools de nós de sistema gerenciados Disponível em versão prévia nas regiões em que os pools de nós de sistema gerenciados estão em disponibilidade geral
AKS Standard (base SKU) para AKS Automatic com pools de nós do sistema gerenciados Em breve
AKS Automatic com pools de nós do sistema gerenciados para AKS Automatic sem pools de nós do sistema gerenciados Sem suporte

Migrar de um cluster AKS Automatic com pools de nós de sistema gerenciados para um cluster AKS Standard

Como a migração funciona

Um cluster AKS Automático com pools de nós de sistema gerenciados executa seus componentes de sistema em pools de nós de sistema que o AKS provisiona, dimensiona e atualiza para você.

Importante

Um cluster do AKS Standard (base SKU) não habilita pools de nós de sistema gerenciados, portanto você é responsável por operar, gerenciar e atualizar o pool de nós de sistema e os componentes do sistema.

Para migrar do AKS Automatic para o AKS Standard, conclua as seguintes etapas de alto nível:

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

Depois de atualizar o SKU, o cluster será executado como um cluster do AKS Standard e os componentes do sistema serão executados no pool de nós do sistema que você adicionou e gerenciou.

Migrar para um cluster do AKS Standard

  1. Adicione um pool de nós do sistema autogerenciado ao cluster AKS Automatic existente usando o comando az aks nodepool add. Defina o modo do pool de nós como System para que ele possa executar componentes do 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. Confirme se o cluster agora usa a 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 se o pool de nós do sistema autogerenciado está presente e no modo System, usando 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 gerenciados para AKS Automatic com pools de nós de sistema gerenciados (versão prévia)

O AKS Automatic dá suporte à migração em versão prévia de pools de nós do sistema não gerenciados para pools de nós do sistema gerenciados em regiões nas quais os pools de nós do sistema gerenciados estão disponíveis de forma geral. Essa migração mantém o cluster no automatic SKU e move os componentes do sistema AKS para um pool de nós do sistema gerenciado pelo AKS.

Pré-requisitos

Importante

As funcionalidades em versão preliminar do AKS estão disponíveis de forma optativa e por autoatendimento. As versões prévias são fornecidas “no estado em que se encontram” e “conforme disponíveis” e são excluídas dos contratos de nível de serviço e da garantia limitada. As versões prévias do AKS são parcialmente cobertas pelo suporte ao cliente em uma base de melhor esforço. Dessa forma, esses recursos não são destinados ao uso em produção. Para obter mais informações, consulte os seguintes artigos:

  • Um cluster automático do AKS existente sem pools de nós do sistema gerenciado.
  • CLI do Azure versão 2.86.0 ou posterior. Para saber qual é a versão, execute az --version. Se precisar instalar ou atualizar, consulte Instalar CLI do Azure.
  • A última versão da extensão da CLI do Azure aks-preview.
  • O sinalizador de recurso Microsoft.ContainerService/NonHoboToHoboConversionPreview registrado em sua assinatura.

Registre o sinalizador de recurso NonHoboToHoboConversionPreview usando o comando az feature register.

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

Verifique o status do registro usando o az feature show comando:

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

Aguarde até que o comando retorne Registered antes de continuar. Em seguida, atualize o registro do Microsoft.ContainerService provedor 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 gerenciado pelo AKS

Para um cluster AKS Automático que usa a rede gerenciada pelo AKS, migre para pools de nós de sistema gerenciados usando 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 automático do AKS que usa uma rede virtual personalizada, forneça uma sub-rede para o pool de nós do sistema gerenciado usando o --system-node-subnet-id parâmetro. A sub-rede do nó do sistema deve:

  • Esteja na mesma rede virtual e região que o cluster.
  • Seja pelo menos /26.
  • Não seja delegado a outro serviço.
  • Seja diferente da sub-rede do nó.

O --node-subnet-id parâmetro é opcional. Se você não o fornecer, o AKS usará 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 se o cluster usa conjuntos de nós de sistema gerenciados usando o comando az aks show:

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

A saída de exemplo a seguir mostra a hostedSystemProfile.enabled propriedade definida como true:

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