Fehlerbehebung für Artifact Registry

Nutzen Sie diese Seite, um häufige Probleme mit dem Artefaktregister zu lösen. Den vollständigen Workflow für die Einrichtung und das Pushen von Images finden Sie unter Erste Schritte mit Artifact Registry.

Probleme mit dem Beta-Zugriff

Das Artefaktregister ist nicht aktiviert

Bitten Sie einen Workspace-Administrator, das Databricks Artifact Registry auf der Workspace-Vorschauseite zu aktivieren. Falls die Vorschau nicht verfügbar ist, überprüfen Sie, dass der Arbeitsbereich sich in einer Region befindet, die das Artifact Registry unterstützt. Informationen finden Sie unter Einschränkungen.

Der Vorschaustatus ist vorübergehend nicht verfügbar

Wiederholen Sie den Vorgang. Wenn der Fehler weiterhin besteht, sammeln Sie die Fehlerdaten und fordern Sie eine ID an, falls vorhanden, wenn Sie Hilfe anfordern.

Docker-Authentifizierungsprobleme

Der Docker-Authentifizierungsbefehl ist nicht verfügbar

Installieren oder aktualisieren Sie die Databricks-CLI (Kommandozeilenschnittstelle) auf die minimal unterstützte Version in Requirements und führen Sie dann erneut aus databricks auth docker configure .

Docker kann keine Registrierungsdaten erhalten

Erstellen oder aktualisieren Sie ein OAuth-Profil im Arbeitsbereich, konfigurieren Sie Docker für die Arbeitsbereichsregistrierung und versuchen Sie die Docker-Operation erneut. Führen Sie die folgenden Befehle aus:

databricks auth login --profile <profile>
databricks auth docker configure --profile <profile>

Überprüfen Sie, ob das <profile> auf den vorgesehenen Arbeitsbereich hinweist. Wenn Sie das Standardprofil verwenden, lassen Sie --profile <profile> im Docker-Authentifizierungsbefehl weg.

Der Docker-Zugangshilfe-Helfer unterstützt keine Profile, die persönliche Zugriffstoken, OAuth-Maschinen-zu-Maschine (M2M)-Zugangsdaten oder reine Konto-Authentifizierung verwenden. Für die vollständigen Authentifizierungsschritte siehe Docker-Authentifizierung einrichten.

Ein langlaufender Push liefert einen Autorisierungsfehler zurück

Der Docker-Zugangshilfer stellt einen kurzlebigen Arbeitsbereich-OAuth-Zugriffstoken bereit. Wenn ein länger laufender Push einen Autorisierungsfehler meldet, versuchen Sie es docker push erneut, damit der Credential-Helper ein neues Token anfordert. Für die Lebensdauer der Qualifikation siehe Einschränkungen.

Der Registry-Hostname stimmt nicht überein

Führen Sie aus, databricks auth docker host --profile <profile> um den Registry-Hostnamen und den Docker-Credential-Hilfsstatus für das ausgewählte Profil zu überprüfen. Überprüfen Sie, dass das Profil auf den vorgesehenen Arbeitsbereich verweist. Bevor du einen Push erneut versuchst, markiere das Image erneut mit dem richtigen Registry-Hostnamen .

Probleme beim Pushen von Images

Der Push gibt einen Berechtigungsfehler zurück

Überprüfen Sie, dass der Hauptmann die für die Push-Operation erforderlichen Rechte besitzt. Siehe Berechtigungen erteilen.

Der Imagename wird abgelehnt

Verwenden Sie das Format <registry-hostname>/<catalog>.<schema>.<artifact>:<tag>. Für die Anforderungen an das Artefaktsegment siehe Anforderungen für Artefaktnamen.

Der Katalog oder das Schema existiert nicht

Das Artefaktregister erstellt keine Kataloge oder Schemata. Der Zielkatalog und das Schema müssen bereits im Unity-Katalog vorhanden sein und vom Arbeitsbereich aus zugänglich sein. Erstelle das fehlende Objekt oder verwende einen bestehenden Katalog und ein Schema und verifiziere dann die erforderlichen Rechte, bevor du den Push erneut versuchst.

Probleme mit der Bildsuche

Das Bild oder die Version erscheint nicht

Bestätigen Sie, dass der Docker-Push erfolgreich abgeschlossen wurde und dass Sie denselben Katalog, dasselbe Schema und denselben Artefaktnamen angeben, den Sie gepusht haben. Verwenden Sie die Software Artifacts API anstelle des Registry-Endpunkts, um Artefakte und Versionen aufzulisten. Siehe Images und Versionen entdecken.

Eine Registrierungsoperation wird nicht unterstützt

Der Registry-Endpunkt unterstützt diese Operation nicht. Nutzen Sie die Software Artifacts API, um Bilder und Versionen zu entdecken. Für die Einschränkungen siehe Einschränkungen.

Probleme mit der Bildbeschleunigung

Die Bildbeschleunigung bleibt erhalten UNSPECIFIED

UNSPECIFIED identifiziert keinen Fehlschlag. Siehe Einschränkungen für die Bildbeschleunigungsberechtigung, einschließlich der Bildgrößenbegrenzung. Größere, berechtigte Bilder benötigen länger, um sie zu konvertieren. Überprüfe später nochmal den Status. Wenn ein berechtigtes Bild nach mehreren Stunden nicht ankommt SUCCESS , wenden Sie sich an den Databricks-Support. Für Statusdefinitionen siehe Bildbeschleunigungsstatus prüfen.

Hol dir Hilfe

Wenn Sie um Hilfe bitten, geben Sie folgende Informationen an:

• Die Cloud, die Region, die Workspace-URL und die Databricks CLI-Version.
• Der Befehl, der fehlschlug, und die vollständige Fehlermeldung.
• Der Registrierungs-Hostname und der catalog.schema.artifact:tag-Name.
• Der Bilddigest, API-Anforderungs-ID und der Betriebszeitstempel, falls verfügbar.

Teilen Sie diese Informationen ausschließlich über einen privaten Support-Kanal. Posten Sie keine Workspace-URLs, Registry-Hostnamen, Artefaktnamen oder komplette Fehler in öffentlichen Foren.

Entferne Token, Passwörter und Registrierungsdaten aus Fehlermeldungen, Befehlsausgaben und anderen Diagnosen, bevor du sie teilst.