Atualizar o host do AKS no AKS habilitado pelo Arc usando o PowerShell
Aplica-se a: AKS no Azure Stack HCI 22H2, AKS no Windows Server
Este artigo descreve como atualizar o host do Serviço de Kubernetes do Azure no AKS habilitado pelo Azure Arc.
Visão geral das atualizações de host do AKS
As atualizações para o host do AKS sempre incluem a versão mais recente disponível. Embora você possa atualizar o host independentemente das atualizações do cluster de carga de trabalho, você deve sempre atualizar o host antes de atualizar um cluster de carga de trabalho.
Para evitar interrupções e perda de disponibilidade do AKS, são executadas atualizações sem interrupção. 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.
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 a partir da última atualização antes que os certificados e tokens internos expirem. Depois que os certificados e tokens expiram, o cluster ainda está funcional; no entanto, você deve ligar para 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 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 update só funciona se você tiver instalado a versão GA ou posterior. Não funciona para versões anteriores. Esse 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. Os novos clusters de carga de trabalho do AKS criados após a atualização do host do AKS podem ser diferentes dos clusters de carga de trabalho do AKS existentes em sua versão do sistema operacional e da versão do Kubernetes.
É recomendável atualizar os clusters de carga de trabalho do AKS imediatamente após atualizar o 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 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
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 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 significativa. |
| 0 | Versão secundária: +1 para cada versão após a versão principal mais recente com uma grande alteração de funcionalidade. |
| 2 | Atualizações de recursos e patches: +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 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 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