Atualizar o host do 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 Serviço de Kubernetes do Azure no AKS habilitado pelo Azure Arc.

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

Atualizações para o host do AKS sempre incluem a versão mais recente disponível. Embora seja possível atualizar o host independentemente das atualizações do 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, as atualizações sem interrupção são executadas. Quando você traz um novo nó com um build mais recente para o cluster, os recursos passam do nó antigo para o novo nó. Quando você remove os recursos com êxito, o nó antigo é desativado e removido do cluster.

Observação

A Microsoft recomenda atualizar seus clusters do AKS dentro de 30 dias após uma nova versão. Se você não atualizar dentro dessa janela, terá até 90 dias da última atualização antes que os certificados e tokens internos expirem. Depois que os certificados e tokens expirarem, o cluster ainda estará funcional; no entanto, você deve chamar 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 do AKS

A primeira etapa em qualquer fluxo de atualização é executar o comando Update-AksHci para atualizar o host do 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 do Kubernetes para uma nova versão.

Importante

O comando de atualização só funcionará se você tiver instalado a versão ga ou posterior. Ele não funciona para versões anteriores. Este comando de atualização atualiza o host do AKS e a plataforma de nuvem local operada pela Microsoft. Esse comando não atualiza nenhum cluster de carga de trabalho do AKS existente. Novos clusters de carga de trabalho do AKS criados após a atualização do host AKS podem ser diferentes dos clusters de carga de trabalho do AKS existentes na versão do sistema operacional e na versão do Kubernetes.

Recomendamos atualizar os clusters de carga de trabalho do AKS imediatamente após a atualização do host do 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 do Kubernetes sem suporte na próxima versão do AKS Arc, a atualização falhará.

Exemplo de fluxo para atualizar um host do AKS

Atualizar os módulos do PowerShell

Verifique se você sempre tem os módulos mais recentes do PowerShell instalados nos nós do AKS executando o comando a seguir 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 de atualização. 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

Obter a versão atual do AKS Arc

Get-AksHciVersion                    

1.0.0.10517

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

Get-AksHciUpdates

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

1.0.2.10723

Controle 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.

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 O recurso & atualizações de patch: +1 para cada versão regular (normalmente mensal) após a versão principal mais recente.
1 Tipo de build: Sempre 1 para builds voltados para o público.
0723 Data de criação do build: data de criação do build no formato mmdd.

Iniciar a atualização do AKS Arc

Update-AksHci

Verifique se o host do AKS foi atualizado

Get-AksHciVersion

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

1.0.2.10723

Próximas etapas