Serverless compartido para carpetas Git

Importante

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

Serverless compartido para carpetas Git proporciona un único recurso de cómputo serverless compartido entre activos dentro de una carpeta Git, incluidos notebooks y archivos. Utiliza Shared Serverless para carpetas Git para trabajar con varios archivos sin necesidad de 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 Serverless compartido para carpetas Git:

  • 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 en la misma carpeta Git se conectan a un recurso de cómputo compartido y utilizan 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 Serverless compartido para carpetas Git 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 Shared Serverless for Git Folders.

    Calcular la opción desplegable de computación para computación sin servidor compartido, con una insignia Beta y un entorno de pyproject.toml

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

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

Gestionar el entorno con pyproject.toml

Shared Serverless para carpetas Git 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 adjunto a Shared Serverless para carpetas Git.

  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 Shared Serverless for Git Folders.

El entorno actualizado está disponible para los cuadernos y los archivos adjuntos al mismo recurso de cómputo compartido. 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 el recurso de cómputo compartido 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

  • Última actualización el