針對 OutboundConnFailVMExtensionError 錯誤碼 (50) 進行疑難排解

發行項
12/30/2024

本文說明如何識別並解決 OutboundConnFailVMExtensionError 當您嘗試啟動或部署 Microsoft azure Kubernetes Service （AKS）叢集時可能發生的錯誤（也稱為錯誤碼 ERR_OUTBOUND_CONN_FAIL、錯誤號碼 50）。

必要條件

Netcat （nc）命令行工具
挖掘命令行工具
用戶端 URL （cURL）工具

徵兆

嘗試啟動或建立 AKS 叢集時，會收到下列錯誤訊息：

無法從代理程式建立輸出連線，如需詳細資訊，請參閱 https://aka.ms/aks-required-ports-and-addresses 。

詳細數據：Code=“VMExtensionProvisioningError”

Message=“VM 在處理擴充功能 'vmssCSE' 時回報失敗。

錯誤訊息：「啟用失敗：無法執行命令：結束狀態為 50\n[stdout]\n\n[stderr]\nnc：連線至 mcr.microsoft.com 連接埠 443 （tcp）失敗：連線逾時\nCommand 結束且狀態為非零

錯誤詳細數據：“vmssCSE 錯誤訊息： {vmssCSE 結束狀態=50，output=pt/apt.conf.d/95proxy...}

原因

下載必要元件來佈建節點的自訂指令碼延伸模組無法建立獲取套件所需的出站連線。針對公用叢集，節點會嘗試與埠 443 上的 Microsoft Container Registry （MCR）端點（mcr.microsoft.com）通訊。

流量可能會遭到封鎖的原因有很多。在這些情況下，測試連線的最佳方式是使用安全殼層通訊協定（SSH）連線到節點。若要進行連線，請依照連線至 Azure Kubernetes Service （AKS）叢集節點中的指示進行維護或疑難解答。然後，依照下列步驟在叢集上測試連線能力：

線上到節點之後，請執行 nc 和 dig 命令：

nc -vz mcr.microsoft.com 443 
dig mcr.microsoft.com 443

注意

如果您無法透過 SSH 存取節點，您可以針對虛擬機擴展集實例執行 az vmss run-command invoke 命令來測試輸出連線能力：

# Get the VMSS instance IDs.
az vmss list-instances --resource-group <mc-resource-group-name> \
    --name <vmss-name> \
    --output table

# Use an instance ID to test outbound connectivity.
az vmss run-command invoke --resource-group <mc-resource-group-name> \
    --name <vmss-name> \
    --command-id RunShellScript \
    --instance-id <vmss-instance-id> \
    --output json \
    --scripts "nc -vz mcr.microsoft.com 443"

如果您嘗試使用 HTTP Proxy 建立 AKS 叢集，請在連線到節點之後執行 nc、 curl和 dig 命令：

# Test connectivity to the HTTP proxy server from the AKS node.
nc -vz <http-s-proxy-address> <port>

# Test traffic from the HTTP proxy server to HTTPS.
curl --proxy http://<http-proxy-address>:<port>/ --head https://mcr.microsoft.com

# Test traffic from the HTTPS proxy server to HTTPS.
curl --proxy https://<https-proxy-address>:<port>/ --head https://mcr.microsoft.com

# Test DNS functionality.
dig mcr.microsoft.com 443

注意

如果您無法透過 SSH 存取節點，您可以對虛擬機擴展集實例執行 az vmss run-command invoke 命令來測試輸出連線能力：

# Get the VMSS instance IDs.
az vmss list-instances --resource-group <mc-resource-group-name> \
    --name <vmss-name> \
    --output table

# Use an instance ID to test connectivity from the HTTP proxy server to HTTPS.
az vmss run-command invoke --resource-group <mc-resource-group-name> \
    --name <vmss-name> \
    --command-id RunShellScript \
    --instance-id <vmss-instance-id> \
    --output json \
    --scripts "curl --proxy http://<http-proxy-address>:<port>/ --head https://mcr.microsoft.com"

# Use an instance ID to test connectivity from the HTTPS proxy server to HTTPS.
az vmss run-command invoke --resource-group <mc-resource-group-name> \
    --name <vmss-name> \
    --command-id RunShellScript \
    --instance-id <vmss-instance-id> \
    --output json \
    --scripts "curl --proxy https://<https-proxy-address>:<port>/ --head https://mcr.microsoft.com"

# Use an instance ID to test DNS functionality.
az vmss run-command invoke --resource-group <mc-resource-group-name> \
    --name <vmss-name> \
    --command-id RunShellScript \
    --instance-id <vmss-instance-id> \
    --output json \
    --scripts "dig mcr.microsoft.com 443"

解決方案

下表列出流量可能遭到封鎖的特定原因，以及每個原因的對應解決方案：

問題	解決方法
流量會遭到防火牆規則、Proxy 伺服器或網路安全組（NSG）封鎖	當防火牆、Proxy 伺服器或 NSG 封鎖 AKS 所需的埠或完整功能變數名稱（FQDN）時，就會發生此問題。請確定允許這些埠和 FQDN。若要判斷封鎖的內容，請檢查上一個 [原因 ] 區段中提供的連線。如需 AKS 必要埠和 FQDN 的詳細資訊，請參閱 Azure Kubernetes Service （AKS）叢集的輸出網路和 FQDN 規則。
AAAA （IPv6）記錄在防火牆上遭到封鎖	在您的防火牆上，確認沒有任何專案會封鎖端點在 Azure DNS 中解析。
私人叢集無法解析內部 Azure 資源	在私人叢集中，如果使用自定義 DNS，則必須將 Azure DNS IP 位址（`168.63.129.16`）新增為上游 DNS 伺服器。確認您的 DNS 伺服器上已設定位址。如需詳細資訊，請參閱建立私人 AKS 叢集和什麼是 IP 位址 168.63.129.16？。

其他相關資訊

AKS 叢集建立問題的一般疑難解答

協力廠商連絡資訊免責聲明

Microsoft 提供協力廠商連絡資訊，以協助您尋找有關此主題的其他資訊。此連絡資訊可能會變更而不另行通知。 Microsoft 不保證協力廠商連絡資訊的準確性。

與我們連絡，以取得說明

如果您有問題或需要相關協助，請建立支援要求，或詢問 Azure community 支援。您也可以向 Azure 意見反應社群提交產品意見反應。

共用方式為

針對 OutboundConnFailVMExtensionError 錯誤碼 (50) 進行疑難排解

必要條件

徵兆

原因

解決方案

其他相關資訊

與我們連絡，以取得說明

意見反應

其他資源