Artefacts Registry
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 régis dans Unity Catalog. Utilisez-le pour envoyer des images à l’aide de 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 quelatestet 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 :
- 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. - 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.
- 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.
- Use: Users reference an image when they create supported Databricks workloads, such as jobs that run custom container images.
Limitations
Les limitations suivantes s'appliquent :
-
Disponibilité :
-
Artifact Registry est disponible dans les régions suivantes :
ap-northeast-1ap-northeast-2ap-south-1ap-southeast-1ap-southeast-2ca-central-1eu-central-1eu-north-1eu-west-1eu-west-2eu-west-3sa-east-1us-east-1us-east-2us-west-2
-
-
Utilisation prise en charge :
- Vous pouvez utiliser des images dans Artifact Registry uniquement avec 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 d’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.