Carpeta Git sin servidor

Importante

Esta característica se encuentra en su versión beta.

Git Folder Serverless proporciona un único recurso de cómputo serverless compartido entre activos en una carpeta Git, incluyendo cuadernos y archivos. Usa Git Folder Serverless para la creación de múltiples archivos sin iniciar un nuevo recurso de computación serverless ni configurar un entorno para cada notebook o archivo. El entorno se gestiona mediante un pyproject.toml archivo en la raíz de la carpeta Git.

Requisitos

Para usar Git Folder Serverless:

  • Tu proyecto debe estar en una carpeta Git.
  • Debes abrir la carpeta Git en el editor de carpetas Git.
  • Si la carpeta Git contiene un archivo raíz pyproject.toml, debe environment_version establecerse en 5 o posterior.

Computación y entorno compartidos

  • Los cuadernos y archivos de la misma carpeta Git se asocian a un único recurso de proceso sin servidor de Git Folder y usan el entorno gestionado por pyproject.toml.
  • Solo los activos dentro de la carpeta Git asociada pueden conectarse al recurso de cómputo.
  • Las variables de Python definidas en un cuaderno no están disponibles en otro.
  • Un terminal web abierto desde cualquier cuaderno o archivo adjunto en la carpeta Git se ejecuta en el mismo recurso de cómputo.

Usa Git Folder Serverless en el editor de carpetas Git

  1. En la barra lateral del espacio de trabajo, haz clic en Espacio de trabajo y ve a la carpeta Git.

  2. Haz clic en Abrir en el editor.

  3. Abre un cuaderno o archivo en la carpeta Git.

  4. Haz clic en el menú desplegable de cálculo.

  5. Selecciona la carpeta Git sin servidor.

    Menú desplegable de computación que muestra la carpeta Git Serverless seleccionada con el entorno versión 5

  6. Ejecuta el cuaderno o archivo para iniciar el recurso de cómputo.

Para usar el mismo cálculo desde otro recurso, abre otro cuaderno o archivo en la misma carpeta Git y selecciona Git Folder Serverless. Los activos comparten computación y el entorno gestionado por pyproject.toml.

Gestionar el entorno con pyproject.toml

Git Folder Serverless gestiona las dependencias de Python para toda la carpeta Git con un pyproject.toml archivo en la raíz de la carpeta. Esto es diferente de los cuadernos sin servidor estándar, donde las dependencias configuradas en el panel lateral Entorno se aplican a un solo cuaderno.

Puedes añadir dependencias y aplicar cambios de entorno con comandos de notebook o editando pyproject.toml.

Usar comandos del cuaderno

  1. Abre un cuaderno conectado a Git Folder Serverless.

  2. Comprueba si existe un pyproject.toml archivo en la raíz de la carpeta Git. Si no existe, abre el panel lateral de Entorno y haz clic en Crear pyproject.toml.

  3. Ejecuta %uv add <package> para añadir una dependencia al archivo raíz pyproject.toml . Por ejemplo:

    %uv add cowsay
    
  4. Ejecuta %uv sync para aplicar las dependencias al entorno compartido y genera o actualiza uv.lock.

    %uv sync
    

Editar pyproject.toml

  1. En el editor de carpetas Git, comprueba si existe un pyproject.toml archivo en la raíz de la carpeta Git. Si no existe, abre el panel lateral de Entorno y haz clic en Crear pyproject.toml.

  2. Abra el archivo pyproject.toml .

  3. Edita la dependencies lista manualmente. Por ejemplo:

    [project]
    name = "my-project"
    version = "0.1.0"
    dependencies = [
      "simplejson==3.18.1",
    ]
    
    [tool.databricks.environment]
    environment_version = "5"
    
  4. En la parte superior del pyproject.toml editor de archivos, haz clic en Aplicar para aplicar los cambios de entorno a Git Folder Serverless.

El entorno actualizado está disponible para notebooks y archivos adjuntos al mismo proceso sin servidor de carpeta Git. Para inspeccionar el entorno, abre el panel lateral Entorno. Consulta Configurar el entorno serverless para información sobre versiones y dependencias instaladas del entorno serverless.

Colaborar a través de Git

Solo el usuario que inicia un recurso informático sin servidor Git Folder puede ejecutar cargas de trabajo sobre él. Si otro usuario abre la misma carpeta Git, se le bloquea la ejecución de cuadernos o archivos en el recurso de cómputo existente.

Databricks recomienda que cada colaborador clone el repositorio en una carpeta Git dentro de su carpeta personal de espacio de trabajo. Cada colaborador recibe entonces un recurso informático y un entorno independientes, gestionados por pyproject.toml, para su clon.

Use ramas, confirmaciones, inserciones y extracciones para intercambiar cambios a través del repositorio Git remoto. Consulta Colabora en carpetas de Git.

Limitations

  • El compartición de cómputo está regulada por una política de uso sin servidor. Los cuadernos y archivos en la misma carpeta Git que usan diferentes políticas de uso reciben recursos de cómputo separados en lugar de compartir uno.

Recursos adicionales