Artefaktregister

Important

Dieses Feature befindet sich in der Betaversion. Um es zu verwenden, muss ein Workspace-Administrator Databricks Artifact Registry auf der Seite Previews aktivieren. Siehe Manage Azure Databricks Previews. Databricks wird die Preise für das Artefaktregister bekannt geben, sobald es allgemein verfügbar ist.

Das Artifact Registry speichert Container-Bilder als verwaltete Assets im Unity Catalog. Die Bilder werden im selben Bereich wie der Unity-Katalog-Metastore gespeichert. Nutze es, um Images mit Standard-Docker-Befehlen zu pushen, den Zugriff mit Unity-Katalog-Rechten zu steuern und Images für unterstützte Azure Databricks-Workloads verfügbar zu machen.

Wichtige Konzepte

• Artefakt: Ein benanntes Container-Bild, das in Unity Catalog gespeichert ist und durch einen dreistufigen Namen im Format catalog.schema.artifactidentifiziert wird.
• Tag: Ein veränderbarer Alias, der auf eine Artefaktversion mit dem Format catalog.schema.artifact:tagverweist. Wenn ein Tag erneut gepusht wird, kann sich die Version ändern, auf die der Tag verweist. Vermeiden Sie für reproduzierbare Bereitstellungen änderbare Tags wie latest und verweisen Sie auf einen Digest, sofern der Workload Digest-Referenzen akzeptiert.
• Bildzusammenfassung: Ein unveränderlicher, inhaltsbezogener Identifikator für eine bestimmte Version eines Artefakts.
• Bildbeschleunigung: Eine Optimierung, die Azure Databricks automatisch anwendet, nachdem Sie ein geeignetes Image in die Artifact Registry geschickt haben. Dieser Prozess wandelt das Bild in ein Format um, das darauf ausgelegt ist, die Ziehungslatenz für unterstützte Workloads zu reduzieren. Um den Bildbeschleunigungsstatus einer Artefaktversion zu überprüfen, siehe Bildbeschleunigungsstatus prüfen.

Wie das Artefaktregister funktioniert

Publisher und Nutzer arbeiten mit Container-Bildern im Artefaktregister durch den folgenden Lebenszyklus:

1. Erstellen und pushen: Ein Publisher erstellt ein Image, markiert es mit einem dreistufigen Unity-Catalog-Namen im entsprechenden Format catalog.schema.artifact:tagund pusht es in die Workspace-Registry. Siehe Artefakt-Namensanforderungen und Push an Image.
2. Verwalten: Artifact Registry speichert das Bild unter dem angegebenen Unity-Catalog-Katalog und -Schema. Die Privilegien des Unity-Katalogs steuern, wer das Bild veröffentlichen, entdecken und lesen kann. Siehe Berechtigungen erteilen.
3. Entdecken: Nutzer rufen die Software Artifacts API auf, um verfügbare Bilder und Versionen zu entdecken und den Status der Bildbeschleunigung zu überprüfen. Siehe Discover-Bilder und -Versionen.
4. Nutzung: Benutzer beziehen sich auf ein Image, wenn sie unterstützte Azure Databricks-Workloads erstellen, wie z. B. Jobs, die benutzerdefinierte Container-Images ausführen. Siehe Verwenden von Images in unterstützten Azure Databricks-Workloads.

Einschränkungen

Es gelten die folgenden Einschränkungen:

Verfügbarkeit

• Dein Arbeitsbereich und sein Unity-Katalog-Metastore müssen sich in derselben Region befinden. Wenn die Regionen unterschiedlich sind, kannst du das Artefaktregister nicht von diesem Arbeitsbereich aus verwenden.

• Das Artefaktregister ist in den folgenden Regionen verfügbar:

  • australiaeast
  • brazilsouth
  • canadacentral
  • centralindia
  • centralus
  • eastasia
  • eastus
  • eastus2
  • francecentral
  • germanywestcentral
  • japaneast
  • koreacentral
  • northcentralus
  • northeurope
  • southcentralus
  • southeastasia
  • swedencentral
  • switzerlandnorth
  • uaenorth
  • uksouth
  • ukwest
  • westcentralus
  • westeurope
  • westus
  • westus2
  • westus3

Unterstützte Nutzung

• Sie können Images im Artifact Registry nur mit unterstützten Azure Databricks Workloads verwenden. Siehe Images in unterstützten Azure Databricks-Workloads verwenden.
• Du kannst Docker oder einen anderen Registry-Client nicht verwenden, um diese Bilder direkt zu laden oder Bildblobs herunterzuladen.

Authentication

• Das für die Docker-Authentifizierung verwendete Workspace-OAuth-Zugriffstoken läuft nach einer Stunde ab. Ein länger dauernder Push kann dazu führen, dass die Autorisierung für einen nach Ablauf hochgeladenen Layer fehlschlägt. Versuchen Sie den Push erneut, sodass der Docker-Credential-Helfer ein neues Token anfordert.

Bildbeschleunigung

• Bilder größer als 30 GB können nicht zur Bildbeschleunigung konvertiert werden.
• Die Bildbeschleunigung zeigt keinen Status für eine fehlgeschlagene Konvertierung an. Siehe Status der Bildbeschleunigung prüfen.

Entdeckung und Verwaltung

• Catalog Explorer bietet keine Benutzeroberfläche für Bilder.
• Der Registry-Endpunkt unterstützt keine Open Container Initiative (OCI) Tag-List-Anfragen oder Löschanfragen.
• Die Software Artifacts API liefert höchstens 10 Tags für eine Version, wenn mehr als 10 Tags auf denselben Digest verweisen.

Artefaktnamen

• Artefaktnamen haben Zeichen- und Formatierungseinschränkungen. Siehe Anforderungen an Artefaktnamen.

Weitere Ressourcen

• Um die Authentifizierung zu konfigurieren, Zugriff zu gewähren, ein Image zu pushen und dessen Versionen zu entdecken, siehe Get Start with Artifact Registry.
• Um häufige Probleme bei Beta-Zugriff, Authentifizierung, Push, Discovery und Bildbeschleunigung zu beheben, siehe Troubleshoot Artifact Registry.