Pasta Git sem servidor

Important

Esse recurso está em Beta.

Git Folder Serverless fornece um único recurso computacional serverless compartilhado entre ativos em uma pasta Git, incluindo notebooks e arquivos. Use o Git Folder Serverless para autoria de múltiplos arquivos sem iniciar um novo recurso de computação serverless ou configurar um ambiente para cada notebook ou arquivo. O ambiente é gerenciado por um pyproject.toml arquivo na raiz da pasta Git.

Requirements

Para usar o Git Folder Serverless:

  • Seu projeto deve estar em uma pasta Git.
  • Você deve abrir a pasta Git no editor de pastas Git.
  • Se a pasta Git contiver um arquivo pyproject.toml raiz, o environment_version deverá ser definido como 5 ou posterior.

Computação e ambiente compartilhados

  • Notebooks e arquivos na mesma pasta Git se vinculam a um recurso de computação sem servidor da Pasta Git e usam o ambiente gerenciado por pyproject.toml.
  • Apenas ativos dentro da pasta Git associada podem se conectar ao recurso de computação.
  • Variáveis em Python definidas em um caderno não estão disponíveis em outro caderno.
  • Um terminal web aberto a partir de qualquer notebook ou arquivo anexado na pasta Git roda no mesmo recurso de computação.

Use o Git Folder Serverless no editor de pastas Git

  1. Na barra lateral do workspace, clique em Workspace e navegue até a pasta Git.

  2. Clique em Abrir no editor.

  3. Abra um caderno ou arquivo na pasta Git.

  4. Clique no menu suspenso Computação.

  5. Selecione a pasta Git Serverless.

    Menu suspenso Compute mostrando Git Folder Serverless selecionado com a versão de ambiente 5

  6. Execute o notebook ou arquivo para iniciar o recurso de computação.

Para usar o mesmo cálculo de outro recurso, abra outro notebook ou arquivo na mesma pasta Git e selecione Git Folder Serverless. Os ativos compartilham computação e o ambiente gerenciado por pyproject.toml.

Gerencie o ambiente com pyproject.toml

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

Você pode adicionar dependências e aplicar mudanças no ambiente com comandos de notebook ou editando pyproject.toml.

Use comandos de caderno

  1. Abra um caderno conectado ao Git Folder Serverless.

  2. Verifique se existe um pyproject.toml arquivo na raiz da pasta Git. Se ele 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 arquivo raiz.pyproject.toml Por exemplo:

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

    %uv sync
    

Editar pyproject.toml

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

  2. Abra o arquivo pyproject.toml .

  3. Edite a dependencies lista manualmente. 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 arquivos, clique em Aplicar para aplicar as alterações de ambiente ao Git Folder Serverless.

O ambiente atualizado está disponível para notebooks e arquivos anexados à mesma computação sem servidor da Pasta Git. Para inspecionar o ambiente, abra o painel lateral do Ambiente . Veja Configurar o ambiente serverless para informações sobre versões e dependências instaladas do ambiente serverless.

Colabore via Git

Somente o usuário que inicia um recurso de computação serverless Git Folder pode rodar cargas de trabalho nele. Se outro usuário abrir a mesma pasta Git, ele é bloqueado de rodar notebooks ou arquivos no recurso de computação existente.

O Databricks recomenda que cada colaborador clone o repositório em uma pasta Git em sua pasta pessoal de workspace. Cada colaborador recebe, em seguida, um recurso computacional e um ambiente separados, gerenciados por pyproject.toml, para seu clone.

Use branches, commits, pushes e pulls para trocar alterações por meio do repositório Git remoto. Veja Colaborar nas pastas Git.

Limitations

  • O compartilhamento de computação se restringe a uma política de uso serverless. Cadernos e arquivos na mesma pasta Git que usam políticas de uso diferentes recebem recursos de computação separados em vez de compartilhar um.

Recursos adicionais