Como solucionar o erro "VMExtensionProvisioningTimeout"

2025-04-22

Este artigo discute como identificar e resolver o VMExtensionProvisioningTimeout erro que ocorre quando você tenta criar e implantar um cluster do AKS (Serviço de Kubernetes do Microsoft Azure).

Pré-requisitos

Azure CLI, versão 2.28.0 ou posterior. Se a CLI do Azure já estiver instalada, você poderá encontrar o número da versão executando az --version.

Sintomas

Ao tentar criar um cluster do AKS usando a CLI do Azure, você recebe o erro "VMExtensionProvisioningTimeout" com texto como o exemplo a seguir:

Failed to reconcile agent pool agentpool0: err: VMSSAgentPoolReconciler retry failed:
Category: InternalError;
SubCode: VMExtensionProvisioningTimeout;
Dependency: Microsoft.Compute/VirtualMachineScaleSet;
OrginalError:
Code="VMExtensionProvisioningTimeout"
Message="Provisioning of VM extension vmssCSE has timed out. Extension provisioning has taken too long to complete. The extension last reported \"Plugin enabled\".\r\n\r\nMore information on troubleshooting is available at <https://aka.ms/VMExtensionCSELinuxTroubleshoot>";
AKSTeam: NodeProvisioning,
Retriable: true

Você também pode exibir os detalhes do erro no portal do Azure.

Motivo

Vários problemas diferentes podem causar erros na classe "VMExtensionProvisioningError". No entanto, as etapas de solução de problemas são as mesmas para todos os problemas. As possíveis causas são as seguintes:

A extensão de script personalizado que provisiona as VMs (máquinas virtuais) não pode estabelecer uma conexão com o ponto de extremidade usado para baixar os binários do Kubernetes.
A extensão de script personalizada que provisiona as VMs não consegue estabelecer uma conexão com o endpoint utilizado para baixar os binários do CNI.
A extensão de script personalizado que provisiona as VMs não pode estabelecer a conectividade de saída necessária para obter pacotes.
O cluster não pode resolver o endereço DNS (Sistema de Nomes de Domínio) necessário para provisionar corretamente o nó.
A extensão de script personalizada que provisiona as VMs atingiu um tempo limite ao executar uma atualização de gerenciamento de pacotes (como apt-get caso o pool de nós use Linux).

Solução

Siga estas etapas:

Se a filtragem de saída estiver configurada no cluster (como rotas personalizadas definidas pelo usuário), consulte Limitar o tráfego de rede com o Firewall do Azure no AKS (Serviço de Kubernetes do Azure) e Regras de rede de saída e FQDN para clusters do AKS para exibir os pré-requisitos necessários e verificar se a configuração atende aos pré-requisitos.
Nos servidores DNS e no firewall, certifique-se de que nada bloqueie a resolução do FQDN (nome de domínio totalmente qualificado) do cluster.
Como o servidor DNS personalizado pode estar configurado incorretamente, examine os seguintes artigos se a resolução FQDN continuar bloqueada:

Mais informações

Solução de problemas gerais de criação de cluster do AKS

Entre em contato conosco para obter ajuda

Se você tiver dúvidas ou precisar de ajuda, crie uma solicitação de suporte ou peça ajuda à comunidade de suporte do Azure. Você também pode enviar comentários sobre o produto para a comunidade de comentários do Azure.

Partilhar via