A criação do cluster ARK do AKS falha no Azure Local 2511 ou 2512 após a atualização do 2510

Depois de atualizar o Azure Local da versão 2510 para a 2511 ou 2512, a criação de novos clusters AKS Arc falha enquanto os clusters existentes e outras operações continuam a funcionar normalmente.

Visão geral

O AKS ativado pelo Azure Arc no Azure Local suporta operações do ciclo de vida do cluster, incluindo criação, atualização e gestão. Quando o Azure Local é atualizado da versão 2510 para a 2511 ou 2512, um problema de configuração com o HybridAksExtension impede a criação de novos clusters do AKS Arc. Este problema não afeta clusters AKS existentes nem instalações novas do Azure Local 2511 ou 2512.

Sintomas

Após atualizar o Azure Local da versão 2510 para a 2511 ou 2512, poderá observar o seguinte problema ao tentar criar novos clusters ARKS Arc:

  • A criação do cluster falha devido a um erro de tempo limite.

    "message": "Error: Timed out waiting for the operation to complete. Detailed message: AKSAddonsReady: Warning: AddonNotReady: ProviderCSIDriver: AddOn not ready.\n: Timed out CorrelationId: "

  • A falha reproduz-se consistentemente apenas em sistemas atualizados a partir do 2510.

  • Não foram observadas falhas na atualização do host ou nas atualizações existentes do cluster.

Motivo

Este problema ocorre devido a um problema com o HybridAksExtension no Azure Local 2511 ou 2512. Quando se atualiza da versão 2510 para a 2511 ou 2512, o sistema entra num estado que impede a criação de novos clusters. No entanto, clusters existentes e outras operações continuam a funcionar normalmente.

Âmbito e impacto

Esta secção descreve os cenários de atualização afetados por esta questão e o impacto nos ambientes dos clientes.

Cenários afetados

  • Azure Local atualizado da versão 2510 para 2511.
  • Azure Local atualizado da versão 2510 para a 2512.
  • Tentativa de criar um novo cluster AKS Arc após a atualização.
Caminho de atualização local do Azure Resultado da criação do cluster AKS Arc
Atualização 2510 → 2511 ❌ Fracasso
Atualização 2510 → 2512 ❌ Fracasso

Impacto no cliente

  • Os clientes que atualizam o Azure Local de 2510 para 2511 ou 2512 são bloqueados de criar novos clusters AKS Arc.
  • Risco de produção para clientes que planeiam a expansão do cluster pós-atualização.
  • O caminho de atualização continua a funcionar, mascarando o problema até que se tente a criação de clusters.

Confirme o problema

Verifique se o seu ambiente é afetado ao verificar a versão HybridAksExtension.

Passo 1: Verifique a versão da extensão

Execute os seguintes comandos para verificar a versão do HybridAksExtension:

az login --use-device-code --tenant <Azure tenant ID>
az account set -s <subscription ID>
$res=get-archcimgmt
az k8s-extension show -g $res.HybridaksExtension.resourceGroup -c $res.ResourceBridge.name --cluster-type appliances --name hybridaksextension

Passo 2: Verificar a aplicabilidade da questão

É afetado por este problema se os seguintes itens se aplicarem:

  • A versão do HybridAksExtension é a 4.0.X (versões anteriores à 4.0.92).
  • O Azure Local foi atualizado da versão 2510 para 2511 ou 2512.
  • Estás a tentar criar um novo cluster AKS Arc.

Solução

Para resolver o problema da criação do cluster, atualize o HybridAksExtension para a versão mais recente usando os seguintes comandos PowerShell.

Atualizar o HybridAksExtension para a versão mais recente

Execute os seguintes comandos PowerShell para atualizar o HybridAksExtension para a versão mais recente do patch:

Install-Module -Name Support.AksArc
Import-Module Support.AksArc
Invoke-SupportAksArcRemediation_HotFix_2511_2512CreateCluster

Este comando atualiza a extensão para a versão 4.0.92 ou posterior, o que resolve o problema da criação do cluster.

Verifica a correção

Após executar os comandos de remediação, verifique se a extensão foi atualizada:

az login --use-device-code --tenant <Azure tenant ID>
az account set -s <subscription ID>
$res=get-archcimgmt
az k8s-extension show -g $res.HybridaksExtension.resourceGroup -c $res.ResourceBridge.name --cluster-type appliances --name hybridaksextension

Confirme que a versão do HybridAksExtension é 4.0.92 ou posterior.

Resolução

Este problema está atualmente a ser investigado e está em curso uma correção permanente.

Até que a correção seja totalmente validada e lançada, recomenda-se aos clientes que sigam a solução alternativa recomendada descrita neste artigo. Esta página é atualizada à medida que mais orientações forem disponíveis.

Próximos passos

  • Se está a planear atualizar do Azure Local 2510 para o 2511 ou 2512, aplique os passos de mitigação antes de tentar criar novos clusters AKS Arc.
  • Se o seu ambiente já estiver afetado, execute os comandos de remediação e verifique a versão da extensão antes de tentar novamente a criação do cluster.
  • Consulte os registos de criação de clusters para mais detalhes de erro caso persistam problemas.
  • Se persistirem problemas ou se precisar de ajuda, contacte o Suporte da Microsoft com detalhes sobre o caminho de atualização e o comportamento observado.
  • Last updated on