Aller au contenu principal
Dernière mise à jour le

Dossier Git serverless

info

Bêta

Cette fonctionnalité est en version Bêta.

Git Folder Serverless fournit une ressource de compute serverless unique partagée entre les assets d’un dossier Git, y compris les notebooks et les fichiers. Utilisez Git Folder Serverless pour la création multi-fichiers sans démarrer une nouvelle ressource de compute serverless ni configurer un environnement pour chaque notebook ou fichier. L’environnement est géré par un fichier pyproject.toml à la racine du dossier Git.

Exigences​

Pour utiliser le dossier Git serverless :

  • Votre projet doit se trouver dans un dossier Git.
  • Vous devez ouvrir le dossier Git dans l’éditeur de dossier Git.
  • Si le dossier Git contient un fichier pyproject.toml racine, le environment_version doit être défini sur 5 ou une version ultérieure.

Compute partagé et environnement​

  • Les notebooks et les fichiers situés dans le même dossier Git sont attachés à une ressource de compute Dossier Git serverless et utilisent l'environnement géré par pyproject.toml.
  • Seuls les assets situés dans le dossier Git associé peuvent être attachés à la ressource de compute.
  • Les variables Python définies dans un Notebook ne sont pas disponibles dans un autre Notebook.
  • Un terminal Web ouvert depuis n'importe quel Notebook ou fichier attaché dans le dossier Git s'exécute sur la même ressource de compute.

Utilisez Git Folder Serverless dans l’éditeur de dossier Git​

  1. Dans la barre latérale du workspace, cliquez sur Workspace et accédez au dossier Git.

  2. Cliquez sur Ouvrir dans l’éditeur .

  3. Ouvrez un notebook ou un fichier dans le dossier Git.

  4. Cliquez sur le menu déroulant du compute.

  5. Sélectionnez Dossier Git serverless .

    Menu déroulant de compute affichant Dossier Git serverless sélectionné avec la version d’environnement 5

  6. Exécutez le notebook ou le fichier pour start la ressource de compute.

Pour utiliser le même compute à partir d’un autre asset, ouvrez un autre notebook ou fichier dans le même dossier Git et sélectionnez Git Folder Serverless . Les assets partagent le compute et l’environnement géré par pyproject.toml.

Gérez l’environnement avec pyproject.toml​

Le dossier Git serverless gère les dépendances Python pour l’ensemble du dossier Git avec un fichier pyproject.toml à la racine du dossier. Ceci diffère des notebooks serverless standard, où les dépendances configurées dans le volet latéral Environnement s’appliquent à un seul notebook.

Vous pouvez ajouter des dépendances et appliquer des modifications d’environnement avec des commandes de notebook ou en modifiant pyproject.toml.

Utiliser les commandes de notebook​

  1. Ouvrez un notebook attaché à un dossier Git serverless.

  2. Vérifiez si un fichier pyproject.toml existe à la racine du dossier Git. S’il n’existe pas, ouvrez le panneau latéral Environnement et cliquez sur Créer pyproject.toml .

  3. Exécutez %uv add <package> pour ajouter une dépendance au fichier racine pyproject.toml. Par exemple :

    Python
    %uv add cowsay

  4. Exécutez %uv sync pour appliquer les dépendances à l’environnement partagé et générer ou mettre à jour uv.lock.

    Python
    %uv sync

Modifier pyproject.toml​

  1. Dans l’éditeur de dossier Git, vérifiez si un fichier pyproject.toml existe à la racine du dossier Git. S’il n’existe pas, ouvrez le panneau latéral Environnement et cliquez sur Créer pyproject.toml .

  2. Ouvrez le fichier pyproject.toml.

  3. Modifiez manuellement la liste dependencies. Par exemple :

    Toml
    [project]
    name = "my-project"
    version = "0.1.0"
    dependencies = [
      "simplejson==3.18.1",
    ]

    [tool.databricks.environment]
    environment_version = "5"

  4. En haut de l’éditeur de fichiers pyproject.toml, cliquez sur Appliquer pour appliquer les modifications d’environnement au dossier Git serverless.

L’environnement mis à jour est disponible pour les notebooks et les fichiers connectés au même compute Serverless Git Folder. Pour inspecter l’environnement, ouvrez le panneau latéral Environnement . Consultez Configurer l’environnement serverless pour obtenir des informations sur les versions de l’environnement serverless et les dépendances installées.

Collaborer via Git​

Seul l’utilisateur qui start une ressource de compute de dossier Git Serverless peut y exécuter des charges de travail. Si un autre utilisateur ouvre le même dossier Git, il ne pourra pas exécuter de notebooks ou de fichiers sur la ressource de compute existante.

Databricks recommande à chaque collaborateur de cloner le repository dans un dossier Git situé dans son dossier de workspace personnel. Chaque collaborateur obtient ensuite une ressource de compute et un environnement distincts, gérés par pyproject.toml pour son clone.

Utilisez des branches, des commits, des envois (push) et des extractions (pull) pour échanger des modifications via le repository Git distant. Voir Collaborer dans des dossiers Git.

Limitations​

  • Le partage de compute est limité à une politique d’utilisation serverless. Les notebooks et les fichiers situés dans le même dossier Git qui utilisent des politiques d’utilisation différentes se voient attribuer des ressources de compute distinctes au lieu d’en partager une.

Ressources supplémentaires​

Sur cette page