Partilhar via

Atualizar agentes Kubernetes habilitados para 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, depender da atualização manual, uma política de suporte de versão será aplicada aos agentes Arc e aos clusters Kubernetes subjacentes.

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

O Kubernetes habilitado para Arco do Azure fornece aos seus agentes recursos de atualização automática prontos para uso. Quando a atualização automática está habilitada, o agente sonda o Azure de hora em hora para verificar se há uma versão mais recente. Quando uma versão mais recente fica disponível, ela aciona uma atualização de gráfico de leme para os agentes do Azure Arc.

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

O comando a seguir 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 permitir a conectividade com todos os pontos de extremidade necessários. Em particular, a conectividade é necessária para dl.k8s.io atualizações automáticas.

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

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

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

Gorjeta

Se você planeja desabilitar a atualização automática, conheça a política de suporte de versão para Kubernetes habilitado para 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 de atualização automática usando o comando e a az connectedk8s update configuração --auto-upgrade como true ou false.

O comando a seguir 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ê tiver desabilitado a atualização automática, poderá iniciar manualmente as atualizações para os agentes usando o az connectedk8s upgrade comando. Ao fazer isso, você deve especificar a versão para a qual deseja atualizar.

O Kubernetes habilitado para ArcGIS do Azure segue o esquema de controle de versão semântico padrão de MAJOR.MINOR.PATCH 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.
  • As versões secundárias mudam quando as alterações de funcionalidade são compatíveis com versões anteriores de outras versões secundárias.
  • As versões de patch mudam quando correções de bugs compatíveis com versões anteriores são feitas.

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

O comando a seguir atualiza manualmente os agentes para a versão 1.8.14:

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

Verifique a 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 Kubernetes habilitado para 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 Kubernetes habilitados para Azure Arc, a seguinte política de suporte de versão se aplica:

  • Os agentes Kubernetes habilitados para Azure Arc têm uma janela de suporte de "N-2", onde 'N' é a versão secundária mais recente dos agentes.

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

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

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

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

Próximos passos