Créez un bac à sable à partir d’une image personnalisée

Important

Cette fonctionnalité est en version bêta. Pour activer cette aperçu de fonctionnalité dans l’espace de travail, optez pour le paramètre Sandbox Databricks dans la page Aperçu de l’espace de travail. Consultez Gérer les préversions d’Azure Databricks.

Vous pouvez créer un sandbox à partir de votre propre image conteneur stockée dans Artifact Registry. Artifact Registry stocke les images de conteneur comme des actifs gouvernés dans Unity Catalog, afin que vous contrôliez leur accès à l’aide des privilèges Unity Catalog. Le bac à sable commence avec les packages, outils et configuration de l’image déjà installés, de sorte que vous n’êtes pas tenu d’installer les dépendances à chaque création de bac à sable.

Pour un aperçu du bac à sable Databricks, voir le bac à sable Databricks.

Requirements

  • Votre espace de travail répond aux prérequis de Databricks Sandbox. Voir Conditions préalables.
  • Votre espace de travail répond aux prérequis d’Artifact Registry, y compris l’activation de l’aperçu de Databricks Artifact Registry. Consultez Spécifications.
  • Vous avez les privilèges USE CATALOG, USE SCHEMA et READ VOLUME sur le catalogue et le schéma contenant l’image. Voir Accorder des autorisations.
  • L’image utilise glibc 2.25 et plus. Si l’image utilise une base Ubuntu, utilisez Ubuntu 18.04 et versions ultérieures. Les images qui utilisent musl au lieu de glibc, comme Alpine Linux et les images construites dessus (par exemple, python:<version>-alpine ou node:<version>-alpine), ne sont pas prises en charge.

Publier une image et créer un bac à sable

  1. Construis l’image avec Docker et pousse-la dans Artifact Registry. Voir Publier une image.

  2. Attendez que l’état d’accélération de l’image soit SUCCESS. L’accélération d’image s’active automatiquement après avoir effectué un push et peut prendre 15 minutes ou plus. Voir Vérifier l’état de l’accélération de l’image.

  3. Créez le bac à sable et définissez image_uri au nom Unity Catalog de l’image, au format catalog.schema.artifact:tag. Pour en déterminer une version exacte, utilisez un digest au lieu d’un tag : catalog.schema.artifact@sha256:<digest>.

    Par exemple, pour créer un bac à sable à partir de l’image main.agents.agent-base:v1 , exécutez ce qui suit :

    from databricks.sdk import WorkspaceClient
from databricks.sdk.service.sandbox import EnvironmentSpec, Sandbox, SandboxSpec

w = WorkspaceClient()

created = w.sandbox.create_sandbox(
    sandbox=Sandbox(
        spec=SandboxSpec(
            environment=EnvironmentSpec(image_uri="main.agents.agent-base:v1"),
        ),
    ),
    sandbox_id="my-custom-sandbox",
)
print(created.name)   # "sandboxes/my-custom-sandbox"

Un bac à sable créé à partir d’une image personnalisée conserve le même répertoire personnel persistant et le même comportement d’arrêts et de démarrage que n’importe quel autre bac à sable.

Troubleshooting

Si la requête de création échoue, vérifiez le message d’erreur :

  • Image <uri> is not ready for use: L’accélération de l’image n’est pas terminée. Vérifiez l’état d’accélération de l’image et réessayez après qu’elle a atteint SUCCESS.
  • Not authorized to access image <uri>: Vous n’avez pas les privilèges requis sur l’image. Demandez au propriétaire du catalogue ou du schéma de vous les accorder.

Limitations

  • Les images personnalisées doivent être stockées dans Artifact Registry. Vous ne pouvez pas créer un bac à sable à partir d’une image dans un registre externe, et Azure Databricks ne crée pas les images pour vous.
  • Les environnements de test créés à partir d’une image personnalisée peuvent mettre plus de temps à démarrer que les environnements de test utilisant l’environnement par défaut.

Ressources additionnelles

  • Dernière mise à jour :