다음을 통해 공유


VMExtensionProvisioningTimeout 오류 문제 해결

이 문서에서는 AKS(Microsoft Azure Kubernetes Service) 클러스터를 만들고 배포하려고 할 때 발생하는 오류를 식별하고 해결하는 VMExtensionProvisioningTimeout 방법을 설명합니다.

필수 조건

  • Azure CLI, 버전 2.28.0 이상. Azure CLI가 이미 설치된 경우 실행 az --version하여 버전 번호를 찾을 수 있습니다.

증상

Azure CLI를 사용하여 AKS 클러스터를 만들려고 하면 다음 예제와 같은 텍스트와 함께 "VMExtensionProvisioningTimeout" 오류가 표시됩니다.

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

Azure Portal에서 오류 세부 정보를 볼 수도 있습니다.

원인

여러 가지 문제로 인해 "VMExtensionProvisioningError" 클래스 오류가 발생할 수 있습니다. 그러나 문제 해결 단계는 모든 문제에 대해 동일합니다. 가능한 원인은 다음과 같습니다.

  • VM(가상 머신)을 프로비전하는 사용자 지정 스크립트 확장은 Kubernetes 이진 파일을 다운로드하는 데 사용되는 엔드포인트에 대한 연결을 설정할 수 없습니다.

  • VM을 프로비전하는 사용자 지정 스크립트 확장은 CNI 이진 파일을 다운로드하는 데 사용되는 엔드포인트에 대한 연결을 설정할 수 없습니다.

  • VM을 프로비전하는 사용자 지정 스크립트 확장은 패키지를 가져오는 데 필요한 아웃바운드 연결을 설정할 수 없습니다.

  • 클러스터에서 노드를 올바르게 프로비전하는 데 필요한 DNS(도메인 이름 시스템) 주소를 확인할 수 없습니다.

  • VM을 프로비전하는 사용자 지정 스크립트 확장은 패킷 관리 업데이트를 실행하는 동안 시간 제한에 도달했습니다(예: 노드 풀에서 Linux를 사용하는 경우 apt-get ).

솔루션

다음 단계를 수행합니다.

  1. 송신 필터링이 클러스터에 설정되어 있는 경우(예: 사용자 지정 사용자 정의 경로) AKS(Azure Kubernetes Service) 에서 Azure Firewall을 사용하여 네트워크 트래픽 제한, AKS 클러스터 에 대한 아웃바운드 네트워크 및 FQDN 규칙을 참조하여 필요한 필수 구성 요소를 확인하고 설치 프로그램이 필수 구성 요소를 충족하는지 확인합니다.

  2. DNS 서버 및 방화벽에서 클러스터의 FQDN(정규화된 도메인 이름) 확인을 차단하는 항목이 없는지 확인합니다.

  3. 사용자 지정 DNS 서버가 잘못 구성될 수 있으므로 FQDN 확인이 계속 차단되는 경우 다음 문서를 검토합니다.

자세한 정보

도움을 요청하십시오.

질문이 있는 경우 Azure 커뮤니티 지원을 요청할 수 있습니다. Azure 피드백 커뮤니티에 제품 피드백을 제출할 수도 있습니다.