Fehlerreferenz für die Integritätsprüfung

Artikel
09/28/2024

Im Folgenden finden Sie Informationen zu Fehlercodes, die vom Befehl az acr check-health zurückgegeben werden. Für jeden Fehler werden mögliche Lösungen aufgeführt.

Informationen zum Ausführen von az acr check-health finden Sie unter Überprüfen der Integrität einer Azure-Containerregistrierung.

DOCKER_COMMAND_ERROR

Dieser Fehler weist darauf hin, dass der Docker-Client für die CLI nicht gefunden wurde. Infolgedessen werden die folgenden zusätzlichen Überprüfungen nicht durchgeführt: Ermittlung der Docker-Version, Auswertung des Docker-Daemonstatus und Ausführung eines Docker-Pullbefehls.

Mögliche Lösungen: Installieren Sie den Docker-Client. Fügen Sie den Systemvariablen den Docker-Pfad hinzu.

DOCKER_DAEMON_ERROR

Dieser Fehler weist darauf hin, dass der Docker-Daemonstatus nicht verfügbar ist oder er nicht mit der CLI erreicht werden konnte. Infolgedessen sind Docker-Vorgänge (wie docker login und docker pull) über die CLI nicht verfügbar.

Mögliche Lösungen: Starten Sie den Docker-Daemon neu, oder bestätigen Sie, dass er ordnungsgemäß installiert ist.

DOCKER_VERSION_ERROR

Dieser Fehler weist darauf hin, dass die CLI den Befehl docker --version nicht ausführen konnte.

Mögliche Lösungen: Versuchen Sie, den Befehl manuell auszuführen, stellen Sie sicher, dass Sie über die neueste CLI-Version verfügen, und untersuchen Sie die Fehlermeldung.

DOCKER_PULL_ERROR

Dieser Fehler weist darauf hin, dass die CLI kein Beispielimage in Ihre Umgebung pullen konnte.

Mögliche Lösungen: Vergewissern Sie sich, dass alle Komponenten, die erforderlich sind, um ein Image zu pullen, ordnungsgemäß ausgeführt werden.

HELM_COMMAND_ERROR

Dieser Fehler weist darauf hin, dass der Helm-Client von der CLI nicht gefunden wurde, was andere Helm-Vorgänge ausschließt.

Mögliche Lösungen: Stellen Sie sicher, dass der Helm-Client installiert ist und der Pfad den Systemumgebungsvariablen hinzugefügt wurde.

HELM_VERSION_ERROR

Dieser Fehler weist darauf hin, dass die CLI die installierte Helm-Version nicht ermitteln konnte. Dies kann passieren, wenn die verwendete Version der Azure CLI (oder die Helm-Version) veraltet ist.

Mögliche Lösungen: Führen Sie ein Update auf die neueste Azure CLI-Version oder auf die empfohlene Helm-Version durch. Führen Sie den Befehl manuell aus, und untersuchen Sie die Fehlermeldung.

CMK_ERROR

Dieser Fehler weist darauf hin, dass die Registrierung nicht auf die benutzerseitig oder systemseitig zugewiesene verwaltete Identität zugreifen kann, die zum Konfigurieren der Registrierungsverschlüsselung mit einem kundenseitig verwalteten Schlüssel verwendet wurde. Die verwaltete Identität wurde möglicherweise gelöscht.

Mögliche Lösung: Informationen zum Beheben des Problems und zum Rotieren des Schlüssels mithilfe einer anderen verwalteten Identität finden Sie in den Schritten zur Problembehandlung der benutzerseitig zugewiesenen Identität.

CONNECTIVITY_DNS_ERROR

Dieser Fehler weist darauf hin, dass das DNS für den angegebenen Registrierungsanmeldeserver gepingt wurde, aber nicht geantwortet hat, was bedeutet, dass er nicht verfügbar ist. Dies kann Konnektivitätsprobleme bedeuten. Alternativ kann die Registrierung auch nicht vorhanden sein, der Benutzer hat möglicherweise nicht die Berechtigungen für die Registrierung (um seinen Anmeldeserver ordnungsgemäß abzurufen), oder die Zielregistrierung befindet sich in einer anderen Cloud als die in der Azure CLI verwendete.

Mögliche Lösungen: Überprüfen Sie die Konnektivität, überprüfen Sie die Rechtschreibung der Registrierung und ob die Registrierung vorhanden ist, überprüfen Sie, ob der Benutzer über die richtigen Berechtigungen verfügt und ob die Cloud der Registrierung die gleiche ist, die in der Azure CLI verwendet wird.

CONNECTIVITY_FORBIDDEN_ERROR

Dieser Fehler weist darauf hin, dass der Abfrageendpunkt für die angegebene Registrierung mit dem HTTP-Status 403 Forbidden geantwortet hat. Dieser Fehler weist darauf hin, dass Benutzer keinen Zugriff auf die Registrierung besitzen, wahrscheinlich aufgrund der Konfiguration eines virtuellen Netzwerks oder weil der Zugriff auf den öffentlichen Endpunkt der Registrierung unzulässig ist. Führen Sie az acr show --query networkRuleSet --name <registry> aus, um die zurzeit konfigurierten Firewallregeln anzuzeigen.

Mögliche Lösungen: Entfernen Sie Regeln für virtuelle Netzwerke, oder fügen Sie die aktuelle IP-Clientadresse der Zulassungsliste hinzu.

CONNECTIVITY_CHALLENGE_ERROR

Dieser Fehler weist darauf hin, dass der Abfrageendpunkt der Zielregistrierung keine Abfrage ausgegeben hat.

Mögliche Lösungen: Versuchen Sie es später noch einmal. Wenn der Fehler weiterhin auftritt, öffnen Sie ein Issue unter https://aka.ms/acr/issues.

CONNECTIVITY_AAD_LOGIN_ERROR

Dieser Fehler bedeutet, dass der Abfrageendpunkt der Zielregistrierung eine Abfrage ausgestellt hat, die Registrierung aber keine Microsoft Entra-Authentifizierung unterstützt.

Mögliche Lösungen: Versuchen Sie eine andere Authentifizierungsmöglichkeit, z.B. mit Administratoranmeldeinformationen. Wenn Benutzer sich mithilfe von Microsoft Entra ID authentifizieren müssen, öffnen Sie ein Problem unter https://aka.ms/acr/issues.

CONNECTIVITY_REFRESH_TOKEN_ERROR

Dieser Fehler weist darauf hin, dass der Registrierungsanmeldeserver nicht mit einem Aktualisierungstoken geantwortet hat und der Zugriff auf die Zielregistrierung daher verweigert wurde. Dieser Fehler kann auftreten, wenn der Benutzer nicht über die richtigen Berechtigungen für die Registrierung verfügt oder wenn die Benutzeranmeldeinformationen für die Azure CLI veraltet sind.

Mögliche Lösungen: Überprüfen Sie, ob der Benutzer über die richtigen Berechtigungen für die Registrierung verfügt. Führen Sie az login aus, um Berechtigungen, Token und Anmeldeinformationen zu aktualisieren.

CONNECTIVITY_ACCESS_TOKEN_ERROR

Dieser Fehler bedeutet, dass der Registrierungsanmeldeserver nicht mit einem Zugriffstoken geantwortet hat und der Zugriff auf die Zielregistrierung daher verweigert wurde. Dieser Fehler kann auftreten, wenn der Benutzer nicht über die richtigen Berechtigungen für die Registrierung verfügt oder wenn die Benutzeranmeldeinformationen für die Azure CLI veraltet sind.

CONNECTIVITY_SSL_ERROR

Dieser Fehler bedeutet, dass der Client keine sichere Verbindung mit der Containerregistrierung herstellen konnte. Dieser Fehler tritt im Allgemeinen auf, wenn Sie einen Proxyserver ausführen oder verwenden.

Mögliche Lösungen: Weitere Informationen zum Arbeiten hinter einem Proxy finden Sie hier.

LOGIN_SERVER_ERROR

Dieser Fehler weist darauf hin, dass die CLI den Anmeldeserver der angegebenen Registrierung nicht finden konnte und kein Standardsuffix für die aktuelle Cloud gefunden wurde. Dieser Fehler kann auftreten, wenn die Registrierung nicht vorhanden ist, wenn der Benutzer nicht über die richtigen Berechtigungen für die Registrierung verfügt, wenn die Cloud der Registrierung und die aktuelle Azure CLI Cloud nicht übereinstimmen oder wenn die Version der Azure CLI veraltet ist.

Mögliche Lösungen: Vergewissern Sie sich, dass die Schreibweise richtig und die Registrierung vorhanden ist. Stellen Sie sicher, dass der Benutzer die richtigen Berechtigungen für die Registrierung besitzt und dass die Clouds der Registrierung und der CLI-Umgebung übereinstimmen. Aktualisieren Sie die Azure CLI auf die neueste Version.

NOTARY_VERSION_ERROR

Dieser Fehler bedeutet, dass die CLI nicht mit der aktuell installierten Version von Docker/Notary kompatibel ist. Versuchen Sie, die Version von „notary.exe“ auf eine Version vor 0.6.0 herabzustufen, indem Sie den Notary-Client Ihrer Docker-Installation manuell ersetzen, um dieses Problem zu beheben. Sie können auch versuchen, eine vorkompilierte Binärversion von Notary vor 0.6.0 für 64-Bit-Linux oder macOS X von der Releaseseite des Notary-Repositorys auf GitHub herunterzuladen und zu installieren. Für Windows laden Sie die .exe herunter, legen Sie in den Standardpfad (C:\ProgramFiles\Docker\Docker\resources\bin) ab, und benennen Sie in „notary.exe“ um.

CONNECTIVITY_TOOMANYREQUESTS_ERROR

Dieser Fehler bedeutet, dass der Benutzer in kurzer Zeit zu viele Anforderungen gesendet hat, sodass das Authentifizierungssystem weitere Anforderungen blockiert, um eine Überladung zu verhindern. Dieser Fehler tritt auf, wenn ein konfigurierter Grenzwert in der Registrierungsdienstebene oder -umgebung des Benutzers erreicht wird. Es wird empfohlen, einen Moment zu warten, bevor eine weitere Anforderung gesendet wird. Dadurch kann die Blockierung des Authentifizierungssystems aufgehoben werden, und Sie können erneut versuchen, eine Anforderung zu senden.

Nächste Schritte

Optionen zum Überprüfen der Integrität einer Registrierung finden Sie unter Überprüfen der Integrität einer Azure-Containerregistrierung.

Häufig gestellte Fragen zu Azure Container Registry und andere bekannte Probleme finden Sie unter FAQ.

Teilen über