Git Folder Serverless

Importante

Este recurso está em versão Beta.

Git Folder Serverless fornece um único recurso computacional serverless partilhado entre ativos numa pasta Git, incluindo cadernos e ficheiros. Use o Git Folder Serverless para autoria de múltiplos ficheiros sem iniciar um novo recurso de computação serverless ou configurar um ambiente para cada caderno ou ficheiro. O ambiente é gerido por um pyproject.toml ficheiro na raiz da pasta Git.

Requisitos

Para usar o Git Folder Serverless:

  • O teu projeto tem de estar numa pasta Git.
  • Deves abrir a pasta Git no editor da pasta Git.
  • Se a pasta Git contiver um ficheiro pyproject.toml na raiz, o environment_version tem de ser definido como 5 ou superior.

Computação e ambiente partilhados

  • Cadernos e ficheiros na mesma pasta Git associam-se a um único recurso de computação sem servidor do Git Folder e utilizam o ambiente gerido por pyproject.toml.
  • Apenas os ativos dentro da pasta Git associada podem ser ligados ao recurso de computação.
  • Variáveis Python definidas num caderno não estão disponíveis noutro caderno.
  • Um terminal web aberto a partir de qualquer caderno ou ficheiro anexo na pasta Git corre no mesmo recurso de computação.

Utilize o Git Folder Serverless no editor da pasta Git

  1. Na barra lateral do espaço de trabalho, clique em Espaço de Trabalho e navegue até à pasta Git.

  2. Clique em Abrir no editor.

  3. Abre um caderno ou ficheiro na pasta Git.

  4. Clique no menu pendente Compute.

  5. Selecione a pasta Git Serverless.

    Menu suspenso de computação que mostra a pasta Git Serverless selecionada com a versão 5 do ambiente

  6. Executa o caderno ou ficheiro para iniciar o recurso de computação.

Para usar o mesmo cálculo de outro asset, abra outro caderno ou ficheiro na mesma pasta Git e selecione Git Folder Serverless. Os ativos partilham computação e o ambiente gerido por pyproject.toml.

Gerir o ambiente com pyproject.toml

O Git Folder Serverless gere as dependências de Python para toda a pasta Git com um pyproject.toml ficheiro na raiz da pasta. Isto difere dos notebooks serverless padrão, em que as dependências configuradas no painel lateral Ambiente se aplicam a um único notebook.

Pode adicionar dependências e aplicar alterações de ambiente com comandos do notebook ou editando pyproject.toml.

Usar comandos de caderno

  1. Abra um caderno ligado ao Git Folder Serverless.

  2. Verifique se existe um pyproject.toml ficheiro na raiz da pasta Git. Se não existir, abra o painel lateral do Ambiente e clique em Criar pyproject.toml.

  3. Execute %uv add <package> para adicionar uma dependência ao ficheiro raiz.pyproject.toml Por exemplo:

    %uv add cowsay

  4. Execute %uv sync para aplicar as dependências ao ambiente partilhado e gerar ou atualizar uv.lock.

    %uv sync

Editar pyproject.toml

  1. No editor de pastas Git, verifique se existe um pyproject.toml ficheiro na raiz da pasta Git. Se não existir, abra o painel lateral do Ambiente e clique em Criar pyproject.toml.

  2. Abra o ficheiro pyproject.toml.

  3. Editar manualmente a lista dependencies. Por exemplo:

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

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

  4. No topo do pyproject.toml editor de ficheiros, clique em Aplicar para aplicar as alterações de ambiente ao Git Folder Serverless.

O ambiente atualizado está disponível para notebooks e ficheiros associados ao mesmo Git Folder Serverless compute. Para inspecionar o ambiente, abra o painel lateral Ambiente. Consulte Configurar o ambiente serverless para informações sobre versões do ambiente serverless e dependências instaladas.

Colaborar através do Git

Só o utilizador que inicia um recurso de computação serverless Git Folder pode executar cargas de trabalho nele. Se outro utilizador abrir a mesma pasta Git, fica impedido de executar notebooks ou ficheiros no recurso computacional existente.

O Databricks recomenda que cada colaborador clone o repositório numa pasta Git na sua pasta pessoal do espaço de trabalho. Cada colaborador recebe então um recurso de computação e um ambiente separados, geridos por pyproject.toml, para o seu clone.

Usa branches, commits, pushes e pulls para trocar alterações através do repositório Git remoto. Consulte Colaborar em pastas do Git.

Limitações

  • A partilha de capacidade de computação está limitada a uma política de utilização serverless. Cadernos e ficheiros na mesma pasta Git que usam políticas de uso diferentes recebem recursos de computação separados em vez de partilharem um.

Recursos adicionais

  • Last updated on