Serverloser Git-Ordner

Important

Dieses Feature befindet sich in der Betaversion.

Git-Ordner Serverless stellt eine einzige serverlose Rechenressource bereit, die über Assets in einem Git-Ordner geteilt wird, einschließlich Notizbücher und Dateien. Verwenden Sie Git Folder Serverless für Multi-File Authoring, ohne eine neue serverlose Compute-Ressource zu starten oder für jedes Notizbuch oder jede Datei eine Umgebung einrichten zu müssen. Die Umgebung wird von einer pyproject.toml Datei am Root-Satz des Git-Ordners verwaltet.

Anforderungen

So verwenden Sie Git Folder Serverless:

  • Dein Projekt muss in einem Git-Ordner liegen.
  • Du musst den Git-Ordner im Git-Ordnereditor öffnen.
  • Wenn der Git-Ordner eine pyproject.toml-Datei im Stammverzeichnis enthält, muss environment_version auf 5 oder höher festgelegt werden.

Gemeinsames Rechnen und Umgebung

  • Notebooks und Dateien im selben Git-Ordner werden an dieselbe serverlose Git-Ordner-Computeressource angehängt und verwenden die von pyproject.toml verwaltete Umgebung.
  • Nur Assets im zugehörigen Git-Ordner können an die Compute-Ressource angehängt werden.
  • Python-Variablen, die in einem Notebook definiert sind, sind in einem anderen Notebook nicht verfügbar.
  • Ein Webterminal, das von einem beliebigen angehängten Notizbuch oder einer Datei im Git-Ordner geöffnet wird, läuft auf derselben Rechenressource.

Verwenden Sie Git-Ordner Serverless im Git-Ordnereditor

  1. Klicken Sie in der Seitenleiste des Arbeitsbereichs auf Arbeitsbereich und navigieren Sie zum Git-Ordner.

  2. Klicken Sie auf Im Editor öffnen.

  3. Öffne ein Notizbuch oder eine Datei im Git-Ordner.

  4. Klicken Sie auf das Dropdown-Menü „Berechnung“.

  5. Wähle Git Folder Serverless.

    Compute-Drop-down-Menü zeigt Git Folder Serverless als ausgewählt mit Umgebungsversion 5

  6. Führe das Notizbuch oder die Datei aus, um die Compute-Ressource zu starten.

Um denselben Compute von einem anderen Asset zu verwenden, öffne ein anderes Notizbuch oder eine Datei im selben Git-Ordner und wähle Git-Ordner Serverless. Die Ressourcen teilen sich die Rechenressourcen und die von pyproject.toml verwaltete Umgebung.

Verwalten Sie die Umgebung mit pyproject.toml

Git Folder Serverless verwaltet Python-Abhängigkeiten im gesamten Git-Ordner mit einer Datei pyproject.toml im Stammverzeichnis des Ordners. Dies unterscheidet sich von herkömmlichen serverlosen Notebooks, bei denen Abhängigkeiten, die in der Seitenleiste Environment konfiguriert werden, für ein Notebook gelten.

Du kannst Abhängigkeiten hinzufügen und Umweltänderungen mit Notizbuchbefehlen oder durch Bearbeiten pyproject.tomlanwenden.

Verwenden Sie Notebook-Befehle

  1. Öffne ein Notizbuch, das mit dem Git-Ordner Serverless verbunden ist.

  2. Überprüfen Sie, ob eine pyproject.toml Datei im Root-Teil des Git-Ordners existiert. Falls sie nicht existiert, öffne den Seitenbereich Umgebung und klicke auf Create pyproject.toml.

  3. Führe %uv add <package> aus, um eine Abhängigkeit zur Root-Datei pyproject.toml hinzuzufügen. Beispiel:

    %uv add cowsay

  4. Führe %uv sync aus, um die Abhängigkeiten auf die gemeinsame Umgebung anzuwenden und generiere oder aktualisiere uv.lock.

    %uv sync

Bearbeiten pyproject.toml

  1. Im Git-Ordnereditor prüfen Sie, ob eine pyproject.toml Datei im Root-Teil des Git-Ordners existiert. Falls sie nicht existiert, öffne den Seitenbereich Umgebung und klicke auf Create pyproject.toml.

  2. Öffnen Sie die Datei pyproject.toml .

  3. Bearbeiten Sie die dependencies Liste manuell. Beispiel:

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

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

  4. Oben im pyproject.toml Dateieditor klickt man auf Anwenden , um die Umgebungsänderungen auf Git Folder Serverless anzuwenden.

Die aktualisierte Umgebung steht Notizbüchern und Dateien zur Verfügung, die mit demselben Git-Ordner Serverless Compute verbunden sind. Um die Umgebung zu inspizieren, öffne den Seitenbereich Umwelt . Siehe Konfigurieren der serverlosen Umgebung für Informationen zu serverlosen Umgebungsversionen und installierten Abhängigkeiten.

Kollaborieren Sie über Git

Nur der Benutzer, der eine Git-Mappe Serverless Compute Resource startet, kann darauf Workloads ausführen. Wenn ein anderer Benutzer denselben Git-Ordner öffnet, wird er daran gehindert, Notizbücher oder Dateien auf der bestehenden Compute-Ressource auszuführen.

Databricks empfiehlt, dass jeder Kollaborateur das Repository in einen Git-Ordner in seinem persönlichen Workspace-Ordner klont . Jede mitwirkende Person erhält dann für ihren Klon eine separate Rechenressource und Umgebung, die von pyproject.toml verwaltet wird.

Verwenden Sie Branches, Commits, Pushes und Pulls, um Änderungen über das entfernte Git-Repository auszutauschen. Siehe In Git-Ordnern zusammenarbeiten.

Limitations

  • Compute Sharing ist auf eine serverlose Nutzungsrichtlinie beschränkt. Notizbücher und Dateien im selben Git-Ordner, die unterschiedliche Nutzungsrichtlinien verwenden, erhalten getrennte Rechenressourcen, anstatt eine zu teilen.

Weitere Ressourcen

  • Last updated on