健康情況檢查錯誤參考

發行項
04/26/2024

以下是 az acr check-health 命令所傳回之錯誤碼的詳細資料。針對每個錯誤，列出可能的解決方案。

如需執行 az acr check-health 的詳細資訊，請參閱檢查 Azure 容器登錄的健康情況。

DOCKER_COMMAND_ERROR

此錯誤表示找不到 CLI 的 Docker 用戶端。因此，不會執行下列其他檢查：尋找 Docker 版本、評估 Docker 精靈狀態，以及執行 Docker 提取命令。

可能的解決方案：安裝 Docker 用戶端；將 Docker 路徑新增至系統變數。

DOCKER_DAEMON_ERROR

此錯誤表示 Docker 精靈狀態無法使用，或無法使用 CLI 連線至 Docker 精靈狀態。因此，無法透過 CLI 使用 Docker 作業 (例如 docker login 和 docker pull)。

可能的解決方案：重新啟動 Docker 精靈，或驗證其是否已正確安裝。

DOCKER_VERSION_ERROR

此錯誤表示 CLI 無法執行命令 docker --version。

可能的解決方案：請嘗試手動執行命令，確定您有最新的 CLI 版本，並調查錯誤訊息。

DOCKER_PULL_ERROR

此錯誤表示 CLI 無法將樣本影像提取至環境。

可能的解決方案：驗證提取影像所需的所有元件都正常執行。

HELM_COMMAND_ERROR

此錯誤表示 CLI 找不到 Helm 用戶端，而會排除其他 Helm 作業。

可能的解決方案：確認已安裝 Helm 用戶端，並將其路徑新增至系統環境變數。

HELM_VERSION_ERROR

此錯誤表示 CLI 無法判斷已安裝的 Helm 版本。如果正在使用的 Azure CLI 版本 (或 Helm 版本) 已過時，就會發生這種情況。

可能的解決方案：更新為最新的 Azure CLI 版本或建議的 Helm 版本；手動執行命令，並調查錯誤訊息。

CMK_ERROR

此錯誤表示登錄無法存取使用者指派或系統指派的受控識別，您可以使用客戶管理的金鑰搭配使用者指派或系統指派的受控識別設定登錄加密。受控識別可能已被刪除。

可能的解決方案：若要解決此問題，並使用不同的受控識別輪替金鑰，請參閱針對使用者指派的身分識別進行疑難排解的步驟。

CONNECTIVITY_DNS_ERROR

此錯誤表示指定登錄登入伺服器的 DNS 已偵測但未回應，這表示其無法使用。這表示某些連線問題。或者，登錄可能不存在，使用者可能沒有登錄的權限 (以適當擷取其登入伺服器)，或目標登錄位於與 Azure CLI 中使用的登錄不同的雲端中。

可能的解決方案：驗證連線能力；確認登錄的拼字，且該登錄存在；確認使用者具有正確的權限，而且登錄的雲端與 Azure CLI 中使用的相同。

CONNECTIVITY_FORBIDDEN_ERROR

此錯誤表示給定登錄的挑戰端點回應了 403 禁止 HTTP 狀態。此錯誤表示使用者沒有登錄的存取權，最有可能是因為虛擬網路設定或因為不允許存取登錄的公用端點。若要查看目前設定的防火牆規則，請執行 az acr show --query networkRuleSet --name <registry>。

可能的解決方案：移除虛擬網路規則，或將目前的用戶端 IP 位址新增至允許清單。

CONNECTIVITY_CHALLENGE_ERROR

此錯誤表示目標登錄的挑戰端點未發出挑戰。

可能的解決方案：在一段時間後再試一次。如果錯誤持續發生，請在 https://aka.ms/acr/issues 開立問題。

CONNECTIVITY_AAD_LOGIN_ERROR

此錯誤表示目標登錄的挑戰端點發出挑戰，但登錄不支援 Microsoft Entra 驗證。

可能的解決方案：嘗試以不同的方式來驗證，例如使用管理員認證。如果使用者需要使用 Microsoft Entra 進行驗證，請在 https://aka.ms/acr/issues 開立問題。

CONNECTIVITY_REFRESH_TOKEN_ERROR

此錯誤表示登錄登入伺服器未回應重新整理權杖，因此目標登錄的存取遭到拒絕。如果使用者沒有登錄的正確權限，或 Azure CLI 的使用者認證過時，就會發生此錯誤。

可能的解決方案：確認使用者是否具有登錄的正確權限；執行 az login 以重新整理權限、權杖和認證。

CONNECTIVITY_ACCESS_TOKEN_ERROR

此錯誤表示登錄登入伺服器未回應存取權杖，因此目標登錄的存取遭到拒絕。如果使用者沒有登錄的正確權限，或 Azure CLI 的使用者認證過時，就會發生此錯誤。

可能的解決方案：確認使用者是否具有登錄的正確權限；執行 az login 以重新整理權限、權杖和認證。

CONNECTIVITY_SSL_ERROR

此錯誤表示用戶端無法建立與容器登錄的安全連線。如果您正在執行或使用 Proxy 伺服器，通常會發生此錯誤。

可能的解決方案：如需在 Proxy 後方運作的詳細資訊，請參閱這裡。

LOGIN_SERVER_ERROR

此錯誤表示 CLI 找不到指定登錄的登入伺服器，而且目前雲端找不到預設尾碼。如果登錄不存在、使用者沒有登錄的正確權限、登錄的雲端和目前的 Azure CLI 雲端不相符，或 Azure CLI 版本已過時，就會發生此錯誤。

可能的解決方案：確認拼字正確且登錄存在；確認使用者具有登錄的正確權限，以及登錄和 CLI 環境的雲端相符；將 Azure CLI 更新為最新版本。

NOTARY_VERSION_ERROR

此錯誤表示 CLI 與目前安裝的 Docker/Notary 版本不相容。請手動取代 Docker 安裝的 Notary 用戶端，將 notary.exe 版本降級至 0.6.0 之前的版本，以解決此問題。您也可以從 GitHub 的 Notary 存放庫發行頁面，嘗試下載並安裝 0.6.0 之前的 64 位 Linux 或 macOS X 預先編譯的二進位檔。針對 windows 下載 .exe，請將其放在 (預設路徑：C:\ProgramFiles\Docker\Docker\resources\bin)，並將其重新命名為 notary.exe。

CONNECTIVITY_TOOMANYREQUESTS_ERROR

此錯誤表示使用者在短時間內傳送了太多要求，導致驗證系統阻止進一步的要求以防止多載。當達到使用者的登錄服務層級或環境中設定的限制時，就會發生此錯誤。建議您先等候一會兒再傳送另一個要求。這可讓驗證系統的阻止解除，而您可以再次嘗試傳送要求。

下一步

如需檢查登錄健康情況的選項，請參閱檢查 Azure 容器登錄的健康情況。

請參閱 Azure Container Registry 常見問題和其他已知問題的常見問題集。