Atualizar o anfitrião do AKS no AKS ativado pelo Arc com o PowerShell

  • Artigo

Aplica-se a: AKS no Azure Stack HCI 22H2, AKS no Windows Server

Este artigo descreve como atualizar o anfitrião Azure Kubernetes Service no AKS ativado pelo Azure Arc.

Descrição geral das atualizações do anfitrião do AKS

Atualizações ao anfitrião do AKS incluem sempre a versão mais recente disponível. Embora possa atualizar o anfitrião independentemente das atualizações do cluster de cargas de trabalho, tem sempre de atualizar o anfitrião antes de atualizar um cluster de cargas de trabalho.

Para evitar falhas e perda de disponibilidade do AKS, são executadas atualizações sem interrupção. Quando traz um novo nó com uma compilação mais recente para o cluster, os recursos são movidos do nó antigo para o novo nó. Quando remove os recursos com êxito, o nó antigo é desativado e removido do cluster.

Nota

A Microsoft recomenda atualizar os clusters do AKS no prazo de 30 dias após uma nova versão. Se não atualizar nesta janela, tem até 90 dias a contar da última atualização antes de os certificados internos e os tokens expirarem. Assim que os certificados e os tokens expirarem, o cluster ainda está funcional; no entanto, tem de chamar Suporte da Microsoft para atualizar. Quando reinicia o cluster após o período de 90 dias, este permanece num estado não funcional. Para obter mais informações sobre certificados internos e tokens, veja a descrição geral da gestão de certificados.

Atualizar o anfitrião do AKS

O primeiro passo em qualquer fluxo de atualização é executar o comando Update-AksHci para atualizar o anfitrião do AKS. Update-AksHci não utiliza argumentos e atualiza sempre o cluster de gestão para a versão mais recente. Tem de iniciar este passo antes de executar Update-AksHciCluster para atualizar o cluster do Kubernetes para uma nova versão.

Importante

O comando de atualização só funciona se tiver instalado a versão ga ou posterior. Não funciona para versões anteriores. Este comando de atualização atualiza o anfitrião do AKS e a plataforma na cloud operada pela Microsoft no local. Este comando não atualiza quaisquer clusters de cargas de trabalho do AKS existentes. Os novos clusters de cargas de trabalho do AKS criados após a atualização do anfitrião do AKS podem diferir dos clusters de cargas de trabalho do AKS existentes na versão do SO e na versão do Kubernetes.

Recomendamos que atualize os clusters de cargas de trabalho do AKS imediatamente após atualizar o anfitrião do AKS para obter as versões mais recentes do SO e as correções recentes. Se um cluster de carga de trabalho estiver numa versão do Kubernetes não suportada na próxima versão do AKS Arc, a atualização falhará.

Fluxo de exemplo para atualizar um anfitrião do AKS

Atualizar os módulos do PowerShell

Certifique-se de que tem sempre os módulos mais recentes do PowerShell instalados nos nós do AKS ao executar o seguinte comando em todos os nós físicos na implementação do AKS.

Importante

Deve fechar todas as janelas do PowerShell abertas e, em seguida, abrir uma nova sessão para executar o comando de atualização. Se não fechar todas as janelas do PowerShell, poderão existir módulos que estão a ser utilizados e não podem ser atualizados.

Update-Module -Name AksHci -Force -AcceptLicense

Obter a versão atual do AKS Arc

Get-AksHciVersion                    

1.0.0.10517

Obter as atualizações do AKS Arc disponíveis

Get-AksHciUpdates

O resultado mostra as versões disponíveis para as quais este anfitrião do AKS pode ser atualizado:

1.0.2.10723

Controlo de versões

Utilizando a versão 1.0.2.10723 como exemplo, a tabela seguinte mostra como os números de versão são construídos para versões do AKS Arc.

Valor Significado
1 Versão principal: +1 para cada versão com uma grande alteração interruptiva.
0 Versão secundária: +1 para cada versão após a versão principal mais recente com uma alteração de funcionalidade principal.
2 Atualizações de patch de & de funcionalidades: +1 para cada versão normal (normalmente mensal) após a versão principal mais recente.
1 Tipo de compilação: Sempre 1 para compilações destinadas ao público.
0723 Data de criação da compilação: data de criação da compilação no formato mmdd.

Iniciar a atualização do AKS Arc

Update-AksHci

Verificar se o anfitrião do AKS foi atualizado

Get-AksHciVersion

O resultado mostra a versão atualizada do AKS no anfitrião do AKS:

1.0.2.10723

Passos seguintes