Atualizar a versão do Kubernetes de clusters do AKS no AKS habilitado pelo Arc usando o PowerShell

Aplica-se a: AKS no Azure Stack HCI 22H2, AKS no Windows Server

Dois tipos de atualizações estão disponíveis para um cluster de carga de trabalho do AKS (Serviço de Kubernetes do Azure) no AKS habilitado pelo Azure Arc:

  • Atualize a versão do Kubernetes de um cluster do AKS.
  • Atualize a versão do sistema operacional de um cluster do AKS sem atualizar a versão do Kubernetes.

Observação

Você também pode usar Windows Admin Center para atualizar clusters de carga de trabalho do AKS.

Recomendamos atualizar um cluster de carga de trabalho do AKS pelo menos uma vez a cada 60 dias. As novas atualizações de versão do Kubernetes estão disponíveis a cada 30 dias. Para evitar interrupções na disponibilidade da carga de trabalho, 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 os recursos são movidos com êxito, o nó antigo é desativado e removido do cluster.

Importante

Atualizar o Serviço de Kubernetes do Azure no host do AKS é a primeira etapa em qualquer fluxo de atualização e deve ser iniciado antes de executar Update-AksHciCluster. Para obter informações sobre como atualizar o host do AKS, consulte Atualizar o host do AKS no Azure Stack HCI.

Obter versões disponíveis do Kubernetes

Use o Get-AksHciKubernetesVersion comando para marcar para versões do Kubernetes com suporte:

Get-AksHciKubernetesVersion

Saída de exemplo:

OrchestratorType OrchestratorVersion OS      IsPreview
---------------- ------------------- --      ---------
Kubernetes       v1.18.14            Linux       False
Kubernetes       v1.18.17            Linux       False
Kubernetes       v1.19.7             Linux       False
Kubernetes       v1.19.9             Linux       False
Kubernetes       v1.20.2             Linux       False
Kubernetes       v1.20.5             Linux       False
Kubernetes       v1.18.14            Windows     False
Kubernetes       v1.18.17            Windows     False
Kubernetes       v1.19.7             Windows     False
Kubernetes       v1.19.9             Windows     False
Kubernetes       v1.20.2             Windows     False
Kubernetes       v1.20.5             Windows     False

Obter atualizações de cluster de carga de trabalho disponíveis

O exemplo a seguir pressupõe que o cluster myCluster de carga de trabalho esteja atualmente no Kubernetes versão 1.19.7:

Get-AksHciClusterUpdates -name myCluster
details                                                     kubernetesversion operatingsystemversion
-------                                                     ----------------- ----------------------
This is a patch kubernetes upgrade. (i.e v1.1.X  to v1.1.Y) v1.19.9           @{mariner=April 2021; windows=April 2021}
This is a minor kubernetes upgrade. (i.e v1.X.1 to v1.Y.1)  v1.20.5           @{mariner=April 2021; windows=April 2021}

Como você pode ver nessa saída, você pode executar uma atualização de patch para v1.19.9 ou uma atualização secundária para v1.20.5.

Atualizar a versão do Kubernetes de um cluster de carga de trabalho usando o PowerShell

Use o comando Update-AksHciCluster do PowerShell para executar uma atualização secundária do Kubernetes. Esse comando também atualiza a versão do sistema operacional do sistema operacional do host de contêiner:

Update-AksHciCluster -name myCluster -kubernetesVersion v1.20.5

Atualizar a versão do sistema operacional do contêiner sem atualizar o Kubernetes

Se você carregar um cluster de carga de trabalho em uma versão mais recente do sistema operacional sem alterar a versão do Kubernetes, ele não funcionará, a menos que a nova versão do sistema operacional não exija uma versão diferente do Kubernetes. Execute o comando Update-AksHciCluster e especifique o operatingSystem parâmetro para atualizar os hosts de contêiner de clusters de carga de trabalho do AKS para uma versão mais recente do sistema operacional. O exemplo a seguir pressupõe que o cluster myCluster de carga de trabalho atualmente tem uma versão do sistema operacional com mais de 30 dias:

Update-AksHciCluster -name myCluster -operatingSystem

Próximas etapas

Neste artigo, você aprendeu a atualizar clusters de carga de trabalho do AKS no AKS Arc. Em seguida, você pode: