Atualizar agentes Kubernetes habilitados para o Azure Arc

  • Artigo

O Kubernetes habilitado para Azure Arc fornece recursos de atualização automática e manual para seus agentes para que os agentes sejam atualizados para a versão mais recente. Se você desabilitar a atualização automática e, em vez disso, se basear na atualização manual, uma política de suporte de versão se aplicará aos agentes Arc e aos clusters do Kubernetes subjacentes.

Ativar ou desativar a atualização automática ao conectar um cluster ao Azure Arc

O Kubernetes habilitado para o Azure Arc fornece aos agentes dele recursos de atualização automática prontos para uso. Quando a atualização automática é habilitada, o agente pesquisa o Azure a cada hora para verificar se há uma versão mais recente. Quando uma versão mais recente se tornar disponível, ela disparará uma atualização do gráfico do Helm para os agentes do Azure Arc.

Quando você conectar um cluster ao Azure Arc, a configuração padrão é habilitar a atualização automática.

O comando seguinte conecta um cluster ao Azure Arc com a atualização automática habilitada:

az connectedk8s connect --name AzureArcTest1 --resource-group AzureArcTest

Importante

Certifique-se de oferecer conectividade com todos os pontos de extremidade necessários. Em particular, a conectividade com dl.k8s.io é necessária para atualizações automáticas.

Para recusar a atualização automática, especifique o parâmetro --disable-auto-upgrade ao conectar o cluster ao Azure Arc.

O comando seguinte conecta um cluster ao Azure Arc com a atualização automática desabilitada:

az connectedk8s connect --name AzureArcTest1 --resource-group AzureArcTest --disable-auto-upgrade

Dica

Se você planeja desabilitar a atualização automática, esteja ciente da política de suporte de versão para o Kubernetes habilitado para o Azure Arc.

Ativar ou desativar a atualização automática depois de conectar um cluster ao Azure Arc

Depois de conectar um cluster ao Azure Arc, você pode alterar a seleção da atualização automática usando o comando az connectedk8s update e a configuração --auto-upgrade para true ou false.

O comando seguinte desativa a atualização automática para um cluster conectado:

az connectedk8s update --name AzureArcTest1 --resource-group AzureArcTest --auto-upgrade false

Atualizar agentes manualmente

Se você desabilitou a atualização automática, poderá iniciar manualmente as atualizações para os agentes usando o comandoaz connectedk8s upgrade. Ao fazer isso, você deverá especificar a versão para a qual deseja atualizar.

O Kubernetes habilitado para o Azure Arc segue o esquema de controle de versão semântico padrão do MAJOR.MINOR.PATCH para o controle de versão de seus agentes. Cada número na versão indica compatibilidade geral com a versão anterior:

  • As versões principais mudam quando há atualizações de API incompatíveis ou a compatibilidade com versões anteriores pode ser interrompida.
  • Versões secundárias mudam quando as alterações de funcionalidade são compatíveis com versões anteriores para outras versões secundárias.
  • As versões de patch são alteradas quando são feitas correções de bugs compatíveis com versões anteriores.

Embora o agendamento possa variar, uma nova versão secundária dos agentes do Kubernetes habilitados para o Azure Arc é lançada aproximadamente uma vez por mês.

O seguinte comando atualiza manualmente o agente para a versão 1.8.14:

az connectedk8s upgrade -g AzureArcTest1 -n AzureArcTest --agent-version 1.8.14

Verificar versão do agente

Para listar clusters conectados e a versão do agente relatado, use o seguinte comando:

az connectedk8s list --query '[].{name:name,rg:resourceGroup,id:id,version:agentVersion}'

Verificar se a atualização automática está habilitada em um cluster

Para verificar se um cluster está habilitado para atualização automática, execute o seguinte comando kubectl. Observe que a configuração de atualização automática não está disponível na API pública para o Kubernetes habilitado para o Azure Arc.

kubectl -n azure-arc get cm azure-clusterconfig -o jsonpath="{.data['AZURE_ARC_AUTOUPDATE']}"

Política de suporte de versão

Quando você cria solicitações de suporte para o Kubernetes habilitado para o Azure Arc, a seguinte política de suporte de versão é aplicada:

  • Agentes do Kubernetes habilitado para o Azure Arc têm uma janela de suporte "N-2", em que 'N' é a versão secundária mais recente dos agentes.

    • Por exemplo, se o Kubernetes habilitado para o Azure Arc apresentar a 0.28.a hoje, as versões 0.28.a, 0.28.b, 0.27.c, 0.27.d, 0.26.e 0.26.f terão suporte.

  • Os clusters do Kubernetes que se conectam ao Azure Arc têm uma janela de suporte "N-2", em que 'N' é a versão secundária estável mais recente do Kubernetes upstream.

    • Por exemplo, se o Kubernetes apresentar 1.20.a hoje, as versões 1.20.a, 1.20.b, 1.19.c, 1.19.d, 1.18.e 1.18.f serão suportadas.

Se você criar uma solicitação de suporte e estiver usando uma versão fora da política de suporte (mais antiga que as versões "N-2" com suporte de agentes e clusters do Kubernetes upstream), será solicitado que você atualize os clusters e agentes para uma versão com suporte.

Próximas etapas