Résoudre les problèmes d'Artifact Registry
Bêta
This feature is in Beta. To use it, a workspace admin must turn on Databricks Artifact Registry from the Previews page. See Manage Databricks previews. Databricks will announce Tarifs for Artifact Registry when it becomes generally available.
Utilisez cette page pour résoudre les problèmes courants avec Artifact Registry. Pour connaître la procédure complète de configuration et de transfert d’image, consultez la page Get started with Artifact Registry.
Problèmes d’accès à la version bêta
Artefacts Registry n'est pas activé
Ask a workspace admin to enable Databricks Artifact Registry on the workspace Previews page. If the preview is not available, verify that the workspace is in a region that supports Artifact Registry. See Limitations.
Le statut de prévisualisation est temporairement indisponible
Veuillez réessayer l’opération. Si l’erreur persiste, veuillez collecter les détails de l’erreur ainsi que l’identifiant de la requête, le cas échéant, lorsque vous demandez de l’aide.
Problèmes d'authentification Docker
La commande d'authentification Docker n'est pas disponible
Installez ou mettez à jour la CLI Databricks (interface de ligne de commande) vers la version minimale prise en charge dans Prerequisites, puis réexécutez databricks auth docker configure.
Docker ne parvient pas à obtenir les identifiants du registre
Créer ou refresh un profil OAuth de Workspace, configurer Docker pour la région du registre et réessayer l'opération Docker. Exécutez les commandes suivantes :
databricks auth login --profile <profile>
databricks auth docker configure --profile <profile> --region <region>
Vérifiez que <profile> pointe vers le workspace prévu. Si vous utilisez le profil default, omettez --profile <profile> de la commande d’authentification Docker.
L’assistant d’identification Docker ne prend pas en charge les profils qui utilisent des jetons d’accès personnels, des identifiants OAuth machine à machine (M2M) ou une authentification réservée au compte. Pour connaître les étapes complètes d’authentification, consultez Configurer l’authentification Docker.
A long-running push returns an authorization error
L'assistant d'identification Docker fournit un jeton d'accès OAuth Workspace éphémère. Si un envoi de longue durée renvoie une erreur d'autorisation, réessayez docker push afin que l'assistant d'identification demande un nouveau jeton. Pour connaître la durée de vie des identifiants, consultez la section Limitations.
The registry hostname or region does not match
Vérifiez que le hostname du registre correspond au cloud et à la région que vous avez transmis à databricks auth docker configure. Vérifiez également que le profil Databricks CLI sélectionné pointe vers le workspace souhaité. Réétiquetez l’image avec le hostname de registre correct avant de réessayer un push.
Image push issues
L'envoi renvoie une erreur d'autorisation
Vérifiez que le principal dispose des privilèges requis pour l'opération de publication. Consultez Accorder les autorisations.
Le nom d'image est rejeté
Utilisez le format <registry-hostname>/<catalog>.<schema>.<artifact>:<tag>. Pour connaître les exigences relatives aux segments d’artefact, consultez la section Artifact name requirements.
The catalog or schema does not exist
Artifact Registry ne crée ni catalogues, ni schémas. Le catalogue et le schéma cible doivent déjà exister dans Unity Catalog et être accessibles depuis le workspace. Créez l’objet manquant ou utilisez un catalogue et un schéma existants, puis vérifiez les privilèges requis avant de réessayer le push.
Image discovery issues
L'image ou la version ne s'affiche pas
Confirm that the Docker push completed successfully and that you are listing the same catalog, schema, and artifact name that you pushed. Use the Software Artifacts API rather than the registry endpoint to list artifacts and versions. See Discover images and versions.
A registry operation is not supported
The registry endpoint does not support this operation. Use the Software Artifacts API to discover images and versions. For the restrictions, see Limitations.
Problèmes d'accélération des images
Image acceleration remains UNSPECIFIED
UNSPECIFIED n'identifie pas d'échec. Consultez la page Limitations pour connaître les critères d'éligibilité à l'accélération d'image, y compris la limite de taille d'image. La conversion des images éligibles les plus grandes prend plus de temps. Veuillez vérifier à nouveau le statut ultérieurement. Si une image éligible n’atteint pas SUCCESS après plusieurs heures, contactez l’assistance Databricks. Pour en savoir plus sur la définition des états, consultez Vérifier l'état de l'accélération d'image.
Obtenir de l'aide
Lorsque vous demandez de l'aide, incluez les informations suivantes :
- Le cloud, la région, l'URL du workspace et la version de Databricks CLI.
- La commande ayant échoué et son message d'erreur complet.
- Le hostname du registre et le nom
catalog.schema.artifact:tag. - L’empreinte de l’image, l’ID de requête API et le Timestamp de l’opération, le cas échéant.
Ne partagez ces informations que par le biais d'un Canal de distribution de support privé. Ne publiez pas d'URL de Workspace, de hostname de registre, de noms d'artefacts ou d'erreurs complètes sur les forums publics.
Supprimez les jetons, les mots de passe et les informations d’identification du Registre des messages d’erreur, des sorties de commande et des autres diagnostics avant de les partager.