Partilhar via

Atualizar o host AKS no AKS habilitado pelo Arc usando o PowerShell

  • Artigo

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

Este artigo descreve como atualizar o host do Serviço Kubernetes do Azure no AKS habilitado pelo Azure Arc.

Visão geral das atualizações do host AKS

As atualizações para o host AKS sempre incluem a versão mais recente disponível. Embora seja possível atualizar o host independentemente das atualizações de cluster de carga de trabalho, você sempre deve atualizar o host antes de atualizar um cluster de carga de trabalho.

Para evitar interrupções e perda de disponibilidade do AKS, atualizações contínuas são realizadas. Quando você 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 você remove os recursos com êxito, o nó antigo é desativado e removido do cluster.

Nota

A Microsoft recomenda atualizar seus clusters AKS dentro de 30 dias após uma nova versão. Se você não atualizar nessa janela, terá até 90 dias a partir da última atualização antes que os certificados e tokens internos expirem. Quando os certificados e tokens expiram, o cluster ainda está funcional; no entanto, você deve chamar o Suporte da Microsoft para atualizar. Quando você reinicializa o cluster após o período de 90 dias, ele permanece em um estado não funcional. Para obter mais informações sobre certificados e tokens internos, consulte a visão geral do gerenciamento de certificados.

Atualizar o host AKS

A primeira etapa em qualquer fluxo de atualização é executar o comando Update-AksHci para atualizar o host AKS. Update-AksHci não usa argumentos e sempre atualiza o cluster de gerenciamento para a versão mais recente. Você deve iniciar esta etapa antes de executar Update-AksHciCluster para atualizar o cluster Kubernetes para uma nova versão.

Importante

O comando update só funciona se você tiver instalado a versão GA ou posterior. Não funciona para versões anteriores. Este comando de atualização atualiza o host AKS e a plataforma de nuvem local operada pela Microsoft. Este comando não atualiza nenhum cluster de carga de trabalho AKS existente. Novos clusters de carga de trabalho AKS criados após a atualização do host AKS podem diferir dos clusters de carga de trabalho AKS existentes em sua versão do sistema operacional e versão do Kubernetes.

Recomendamos atualizar os clusters de carga de trabalho do AKS imediatamente após a atualização do host AKS para obter as versões mais recentes do sistema operacional e as correções recentes. Se um cluster de carga de trabalho estiver em uma versão não suportada do Kubernetes na próxima versão do AKS Arc, a atualização falhará.

Exemplo de fluxo para atualizar um host AKS

Atualizar os módulos do PowerShell

Certifique-se de ter sempre os módulos PowerShell mais recentes instalados nos nós AKS executando o seguinte comando em todos os nós físicos em sua implantação do AKS.

Importante

Você deve fechar todas as janelas abertas do PowerShell e, em seguida, abrir uma nova sessão para executar o comando update. Se você não fechar todas as janelas do PowerShell, pode haver módulos que estão em uso e não podem ser atualizados.

Update-Module -Name AksHci -Force -AcceptLicense

Obtenha a versão atual do AKS Arc

Get-AksHciVersion                    

1.0.0.10517

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

Get-AksHciUpdates

A saída mostra as versões disponíveis para as quais este host AKS pode ser atualizado:

1.0.2.10723

Controlo de Versão

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

Value Significado
1 Versão principal: +1 para cada versão com uma grande alteração de rutura.
0 Versão secundária: +1 para cada versão após a última versão principal com uma grande alteração de funcionalidade.
2 Feature & atualizações de patch: +1 para cada versão regular (normalmente mensal) após a última versão principal.
1 Tipo de construção: Sempre 1 para compilações voltadas para o 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

Verifique se o host AKS foi atualizado

Get-AksHciVersion

A saída mostra a versão atualizada do AKS no host AKS:

1.0.2.10723

Próximos passos