Serverless con cartelle git

Importante

Questa funzionalità è in versione beta.

Git Folder Serverless fornisce una singola risorsa di calcolo serverless condivisa tra asset in una cartella Git, inclusi notebook e file. Usa Git Folder Serverless per l'authoring multi-file senza avviare una nuova risorsa di calcolo serverless o configurare un ambiente per ogni notebook o file. L'ambiente è gestito da un pyproject.toml file nella radice della cartella Git.

Requisiti

Per usare Git Folder Serverless:

  • Il tuo progetto deve essere in una cartella Git.
  • Devi aprire la cartella Git nell'editor di cartelle Git.
  • Se la cartella Git contiene un file root pyproject.toml , deve environment_version essere impostato su 5 o successivamente.

Calcolo condiviso e ambiente

  • Notebook e file nella stessa cartella Git si collegano a una risorsa di calcolo serverless Git Folder e utilizzano l'ambiente gestito da pyproject.toml.
  • Solo gli asset all'interno della cartella Git associata possono collegarsi alla risorsa di calcolo.
  • Le variabili Python definite in un quaderno non sono disponibili in un altro quaderno.
  • Un terminale web aperto da qualsiasi notebook o file allegato nella cartella Git funziona sulla stessa risorsa di calcolo.

Usa Git Folder Serverless nell'editor di cartelle Git

  1. Nella barra laterale dello spazio di lavoro, clicca su Spazio di lavoro e naviga nella cartella Git.

  2. Clicca Apri nell'editor.

  3. Apri un quaderno o un file nella cartella Git.

  4. Clicca sul menu a tendina di calcolo.

  5. Seleziona Folder Git serverless.

    Menu a tendina Calcolo che mostra Serverless di cartelle Git selezionato con l'ambiente versione 5

  6. Esegui il notebook o il file per avviare la risorsa di calcolo.

Per usare lo stesso calcolo da un altro asset, apri un altro notebook o file nella stessa cartella Git e seleziona Git Folder Serverless. Gli asset condividono il calcolo e l'ambiente gestito da pyproject.toml.

Gestire l'ambiente con pyproject.toml

Git Folder Serverless gestisce le dipendenze Python per l'intera cartella Git con un pyproject.toml file alla radice della cartella. Questo differisce dai notebook serverless standard, dove le dipendenze configurate nel pannello laterale Ambiente si applicano a un solo notebook.

Puoi aggiungere dipendenze e applicare modifiche ambientali con comandi del notebook o modificando pyproject.toml.

Usa i comandi del notebook

  1. Apri un quaderno collegato a Git Folder Serverless.

  2. Controlla se un pyproject.toml file esiste alla radice della cartella Git. Se non esiste, apri il pannello laterale Ambiente e clicca su Crea pyproject.toml.

  3. Esegui %uv add <package> per aggiungere una dipendenza al file root pyproject.toml . Per esempio:

    %uv add cowsay

  4. Esegui %uv sync per applicare le dipendenze all'ambiente condiviso e generare o aggiornare uv.lock.

    %uv sync

Modifica pyproject.toml

  1. Nell'editor di cartelle Git, verifica se un pyproject.toml file esiste alla radice della cartella Git. Se non esiste, apri il pannello laterale Ambiente e clicca su Crea pyproject.toml.

  2. Aprire il pyproject.toml file.

  3. Modifica manualmente la dependencies lista. Per esempio:

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

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

  4. In cima all'editor pyproject.toml file, clicca su Applica per applicare le modifiche all'ambiente a Git Folder Serverless.

L'ambiente aggiornato è disponibile per notebook e file collegati allo stesso Git Folder Serverless compute. Per ispezionare l'ambiente, apri il pannello laterale Ambiente . Vedi Configura l'ambiente serverless per informazioni sulle versioni dell'ambiente serverless e sulle dipendenze installate.

Collabora tramite Git

Solo l'utente che avvia una risorsa di calcolo serverless Git Folder può eseguire i carichi di lavoro su di essa. Se un altro utente apre la stessa cartella Git, viene bloccato dall'esecuzione di notebook o file sulla risorsa di calcolo esistente.

Databricks raccomanda che ogni collaboratore cloni il repository in una cartella Git nella propria cartella personale dello spazio di lavoro. Ogni collaboratore riceve quindi una risorsa di calcolo e un ambiente separati gestiti pyproject.toml per il proprio clone.

Usa branch, commit, push e pull per scambiare modifiche tramite il repository Git remoto. Vedi Collaborate nelle cartelle Git.

Limitations

  • La condivisione di calcolo è regolata da una politica di utilizzo serverless. Notebook e file nella stessa cartella Git che utilizzano politiche d'uso diverse vengono assegnate risorse di calcolo separate invece di condividerne una.

Risorse aggiuntive

  • Last updated on