Artefacts Registry

info

Bêta

Cette fonctionnalité est en version bêta. Pour l'utiliser, un administrateur du workspace doit activer Databricks Artifact Registry depuis la page Previews . Consultez Gérer les aperçus Databricks. Databricks communiquera les tarifs d’Artifact Registry lors de sa disponibilité générale.

Artifact Registry stocke les images de conteneurs en tant qu'actifs gérés dans Unity Catalog. Les images sont stockées dans la même région que le métastore Unity Catalog. Utilisez-le pour envoyer des images avec des commandes Docker standard, contrôler l'accès avec les privilèges Unity Catalog et rendre les images disponibles pour les charges de travail Databricks prises en charge.

Key concepts

• Artefact : conteneur d’images nommé stocké dans Unity Catalog et identifié par un nom à trois niveaux au format catalog.schema.artifact.
• Tag : Un alias mutable qui pointe vers une version d’artefact en utilisant le format catalog.schema.artifact:tag. L’envoi répété d’un tag peut modifier la version vers laquelle le tag est résolu. Pour des déploiements reproductibles, évitez les tags mutables tels que latest et faites référence à un résumé (digest) lorsque la charge de travail accepte les références de résumé.
• Résumé d'image : un identifiant immuable et basé sur le contenu pour une version spécifique d'un artefact.
• Accélération d'image : Une optimisation que Databricks applique automatiquement après que vous avez transmis une image éligible à Artifact Registry. Ce processus convertit l'image dans un format conçu pour réduire la latence de récupération pour les charges de travail prises en charge. Pour vérifier le statut d'accélération d'image d'une version d'artefact, consultez Vérifier le statut d'accélération d'image.

Fonctionnement d'Artifact Registry

Les éditeurs et les utilisateurs manipulent les images de conteneur dans Artifact Registry selon le cycle de vie suivant :

1. Build and push: A publisher builds an image, tags it with a three-level Unity Catalog name in the format catalog.schema.artifact:tag, and pushes it to the workspace registry. See Artifact name requirements and Push an image.
2. Gouvernance : Artifact Registry stocke l'image sous le catalogue et le schéma Unity Catalog spécifiés. Les privilèges Unity Catalog contrôlent qui peut publier, découvrir et lire l'image. Voir Accorder les autorisations.
3. Découverte : Les utilisateurs appellent l'API Software Artifacts pour découvrir les images et versions disponibles ainsi que pour vérifier le statut d'accélération d'image. Consultez Découvrir les images et les versions.
4. Utilisation : Les utilisateurs font référence à une image lorsqu'ils créent des charges de travail Databricks prises en charge, telles que des jobs qui exécutent des images de conteneur personnalisées. Voir Utiliser des images dans les charges de travail Databricks prises en charge.

Limitations

Les limitations suivantes s'appliquent :

Disponibilité

• Votre workspace et son métastore Unity Catalog doivent se trouver dans la même région. Si les régions diffèrent, vous ne pouvez pas utiliser Artifact Registry à partir de ce workspace.

• Artifact Registry est disponible dans les régions suivantes :

  • asia-south1
  • asia-southeast1
  • europe-west1
  • europe-west2
  • europe-west3
  • us-central1
  • us-east1
  • us-east4
  • us-west1

Utilisation prise en charge

• Vous pouvez utiliser des images dans Artifact Registry uniquement avec les charges de travail Databricks prises en charge. Consultez Utiliser des images dans les charges de travail Databricks prises en charge.
• Vous ne pouvez pas utiliser Docker ou un autre client de registre pour extraire ces images ou download directement des objets blob d'images.

Authentification

• Le jeton d’accès OAuth du workspace utilisé pour l’authentification Docker expire au bout d’une heure. Un envoi prenant plus de temps peut échouer lors de l’autorisation pour une couche upload après expiration. Réessayez l’envoi afin que l’assistant d’identification Docker demande un nouveau jeton.

Accélération d'image

• Les images de plus de 30 Go ne peuvent pas être converties pour l’accélération d’image.
• L'accélération d'image n'expose pas d'état de conversion échoué. Consultez Vérifier le statut d'accélération d'image.

Découverte et gestion

• Explorateur de catalogue ne fournit pas d'interface pour les images.
• L’Endpoint de registre ne prend pas en charge les requêtes de liste de tags ou les requêtes de suppression Open Container Initiative (OCI).
• L’API Software Artifacts renvoie au plus 10 tags pour une version lorsque plus de 10 tags pointent vers le même digest.

Noms des artefacts

• Les noms d'artefacts sont soumis à des restrictions de caractères et de formatage. Voir Artifact name requirements.

Ressources supplémentaires

• Pour configurer l’authentification, accorder des accès, transférer une image et découvrir ses versions, consultez Bien start avec Artifact Registry.
• To resolve common Beta access, authentication, push, discovery, and image acceleration issues, see Troubleshoot Artifact Registry.