Atualizar o host 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 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 executadas. 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 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 expirarem, o cluster ainda estará 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. Ele 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. Esse 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 atualizar o 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 sempre ter os módulos do 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
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 lançamento com uma grande mudança de quebra. |
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 | Atualizações de patch de recurso e nome: +1 para cada versão regular (normalmente mensal) após a versão principal mais recente. |
1 | Tipo de compilaçã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