Atualizar imagens de nós do Serviço de Kubernetes do Azure (AKS)

O Azure Kubernetes Service (AKS) fornece regularmente novas imagens node, por isso é benéfico atualizar frequentemente as imagens dos seus nós para usar as funcionalidades mais recentes do AKS. As imagens dos nós Linux são atualizadas semanalmente, e as imagens dos nós do Windows são atualizadas mensalmente. Os anúncios de atualização de imagem estão incluídos nas notas de lançamento AKS, e pode demorar até uma semana para que estas atualizações sejam implementadas em todas as regiões. Verifique o rastreador de lançamentos para o estado de implementação. Você também pode executar atualizações automáticas das imagens dos nós e programá-las através de manutenção programada. Para obter mais informações, consulte Atualizar automaticamente imagens de nó.

A AKS recomenda canais de atualização automática que podem atualizar automaticamente as imagens dos seus nós ou aplicar patches de segurança durante as suas janelas de manutenção. Se quiser atualizar manualmente as imagens dos seus nós, pode fazê-lo seguindo as instruções deste artigo. Este artigo mostra como atualizar imagens de nós de cluster AKS e como atualizar imagens de conjunto de nós sem ter de atualizar a versão do Kubernetes. Para obter informações sobre como atualizar a versão do Kubernetes para seu cluster, consulte Atualizar um cluster AKS.

Conecte-se ao cluster AKS

1. Conecte-se ao cluster AKS usando o comando.

   az aks get-credentials \
       --resource-group $AKS_RESOURCE_GROUP \
       --name $AKS_CLUSTER
   

Verifique se há atualizações de imagens de nós disponíveis

1. Verifique se há atualizações de imagem de nó disponíveis usando o comando .

   az aks nodepool get-upgrades \
       --nodepool-name $AKS_NODEPOOL \
       --cluster-name $AKS_CLUSTER \
       --resource-group $AKS_RESOURCE_GROUP
   

2. Na saída, localize e anote o valor. Esse valor é a versão de imagem de nó mais recente disponível para seu pool de nós.

3. Verifique a versão atual da imagem do nó para comparar com a versão mais recente usando o comando .

   az aks nodepool show \
       --resource-group $AKS_RESOURCE_GROUP \
       --cluster-name $AKS_CLUSTER \
       --name $AKS_NODEPOOL \
       --query nodeImageVersion
   

4. Se o valor for diferente do , você poderá atualizar a imagem do nó.

Atualizar todas as imagens de nós em todos os clusters de nós

1. Atualize todas as imagens de nó em todos os pools de nós do seu cluster usando o comando com a opção .

   az aks upgrade \
       --resource-group $AKS_RESOURCE_GROUP \
       --name $AKS_CLUSTER \
       --node-image-only \
       --yes
   

2. Você pode verificar o status das imagens do nó usando o comando .

   Observação

   Este comando pode diferir ligeiramente dependendo do shell que você usa. Para mais informações sobre ambientes Windows e PowerShell, consulte a documentação Kubernetes JSONPath.

   kubectl get nodes -o jsonpath='{range .items[*]}{.metadata.name}{"\t"}{.metadata.labels.kubernetes\.azure\.com\/node-image-version}{"\n"}{end}'
   

3. Quando a atualização for concluída, use o comando para obter os detalhes do pool de nós atualizados. A imagem do nó atual é apresentada na propriedade .

   az aks show \
       --resource-group $AKS_RESOURCE_GROUP \
       --name $AKS_CLUSTER  \
       --query "agentPoolProfiles[].{Name:name, NodeImageVersion:nodeImageVersion}"
   

Atualizar um conjunto de nós específico

1. Atualize a imagem do SO de um pool de nós sem atualizar o cluster do Kubernetes usando o comando com a flag.

   az aks nodepool upgrade \
       --resource-group $AKS_RESOURCE_GROUP \
       --cluster-name $AKS_CLUSTER \
       --name $AKS_NODEPOOL \
       --node-image-only
   

2. Você pode verificar o status das imagens do nó com o comando .

   Observação

   Este comando pode diferir ligeiramente dependendo do shell que você usa. Para mais informações sobre ambientes Windows e PowerShell, consulte a documentação Kubernetes JSONPath.

   kubectl get nodes -o jsonpath='{range .items[*]}{.metadata.name}{"\t"}{.metadata.labels.kubernetes\.azure\.com\/node-image-version}{"\n"}{end}'
   

3. Quando a atualização for concluída, use o comando para obter os detalhes do pool de nós atualizados. A imagem do nó atual é apresentada na propriedade .

   az aks nodepool show \
       --resource-group $AKS_RESOURCE_GROUP \
       --cluster-name $AKS_CLUSTER \
       --name $AKS_NODEPOOL \
       --query nodeImageVersion
   

Atualizar imagens de nós com expansão de nó

Para acelerar o processo de atualização das imagens do nó, pode atualizar estas imagens utilizando um valor personalizável de aumento do nó. Por padrão, o AKS usa um nó extra para gerir atualizações.

1. Atualize as imagens de nó com incremento de nó usando o comando com o sinalizador para configurar o número de nós utilizados para as atualizações.

   Observação

   Para saber mais sobre as compensações de várias configurações, consulte Personalizar atualização de expansão de nós.

   az aks nodepool update \
       --resource-group $AKS_RESOURCE_GROUP \
       --cluster-name $AKS_CLUSTER \
       --name $AKS_NODEPOOL \
       --max-surge 33% \
       --no-wait
   

2. Você pode verificar o status das imagens do nó com o comando .

   kubectl get nodes -o jsonpath='{range .items[*]}{.metadata.name}{"\t"}{.metadata.labels.kubernetes\.azure\.com\/node-image-version}{"\n"}{end}'
   

3. Obtenha os detalhes atualizados do pool de nós usando o comando. A imagem do nó atual é apresentada na propriedade .

   az aks nodepool show \
       --resource-group $AKS_RESOURCE_GROUP \
       --cluster-name $AKS_CLUSTER \
       --name $AKS_NODEPOOL \
       --query nodeImageVersion
   

Próximos passos

• Para informações sobre as imagens mais recentes dos nós, consulte as notas de atualização AKS.
• Saiba como atualizar a versão do Kubernetes com Atualizar um cluster AKS.
• Aplica automaticamente as atualizações do cluster e do pool de nós com GitHub Actions.
• Saiba mais sobre vários pools de nós com Criar vários pools de nós.
• Saiba mais sobre como atualizar as práticas recomendadas com o patch AKS e as diretrizes de atualização.