Administración de entornos base sin servidor

Importante

Esta característica está en versión preliminar pública.

En esta página se explica cómo crear y administrar entornos base sin servidor en un área de trabajo.

Permissions

• Solo los administradores del área de trabajo pueden crear y administrar los entornos base de un área de trabajo.
• Todos los usuarios del área de trabajo tienen acceso a los entornos base de un área de trabajo.
• Todos los usuarios del área de trabajo pueden crear especificaciones de entorno sin servidor personalizadas.

Funcionamiento de los entornos base en Azure Databricks

En Azure Databricks, un entorno base es una especificación YAML que se puede compartir que define una versión del entorno sin servidor y un conjunto de dependencias adicionales de Python para cuadernos sin servidor. Los administradores del área de trabajo crean y administran entornos base para que los usuarios puedan empezar rápidamente desde un entorno coherente y almacenado en caché y, opcionalmente, agregar sus propias bibliotecas.

Creación y exportación de una especificación de entorno

La manera más sencilla de crear una especificación YAML válida es compilar el entorno en el panel lateral Entorno y, a continuación, usar el botón Exportar entorno para descargar el archivo YAML.

1. Abra un cuaderno y conéctese al proceso sin servidor.
2. Haga clic en el En el panel lateral del cuaderno.
3. Seleccione la versión del entorno. Databricks recomienda usar la versión más reciente del entorno sin servidor compatible con el área de trabajo.
4. En el campo Dependencias , agregue las dependencias que quiera que tenga el entorno base. Haga clic en Agregar dependencia después de escribir cada dependencia. Para obtener más instrucciones sobre cómo agregar dependencias, consulte Agregar dependencias al cuaderno.
5. Haga clic en Aplicar en la parte inferior del panel de entorno para asegurarse de que la especificación es válida.
6. Haga clic en el icono de menú En la parte inferior del panel de entorno, haga clic en Exportar entorno.
7. Asigne un nombre al archivo YAML y agregue a una carpeta workspace o al volumen del catálogo de Unity.

Especificación de entorno de ejemplo

El ejemplo siguiente de YAML se basa en la especificación del entorno de proyectos de MLflow. Define un entorno base con algunas dependencias de biblioteca:

environment_version: '4'
dependencies:
  - --index-url https://pypi.org/simple
  - -r "/Workspace/Shared/requirements.txt"
  - my-library==6.1
  - /Workspace/Shared/Path/To/simplejson-3.19.3-py3-none-any.whl
  - git+https://github.com/databricks/databricks-cli

Adición de un entorno base al área de trabajo

Para agregar la especificación del entorno como un entorno base al área de trabajo:

1. En el área de trabajo, vaya a Configuración.
2. En Administrador del área de trabajo, seleccione Proceso.
3. Junto a Entornos base para proceso sin servidor, haga clic en Administrar.
4. Haga clic en Crear nuevo entorno.
5. Asigne un nombre al entorno base. Este es el nombre que verán los usuarios en el menú desplegable Entorno base .
6. Seleccione el archivo YAML de especificación del entorno mediante el selector de archivos. Puede examinar los archivos del área de trabajo o los volúmenes del catálogo de Unity.
7. Haga clic en Crear.

El entorno base comenzará a compilarse. Compruebe la columna Estado en la lista de entornos base. Cambiará a Listo para usar cuando esté listo.

Nota:

Los registros de uso asociados a la construcción y actualización de entornos base tienen la billing_origin_product columna establecida en BASE_ENVIRONMENTS. Además, el identificador de entorno base específico se rellena en la columna usage_metadata.base_environment_id.

Establecimiento del entorno base predeterminado del área de trabajo

De forma predeterminada, los cuadernos sin servidor de un área de trabajo no usan un entorno base. Los administradores del área de trabajo pueden seleccionar un entorno base para aplicarlos a todos los cuadernos nuevos de forma predeterminada.

1. En el área de trabajo, vaya a Configuración.
2. En Administrador del área de trabajo, seleccione Proceso.
3. Junto a Entornos base para proceso sin servidor, haga clic en Administrar.
4. Haga clic en el icono de estrella situado junto al entorno base para establecerlo como predeterminado.

Todos los nuevos cuadernos sin servidor ahora tendrán como valor predeterminado el entorno base seleccionado.

Actualización de un entorno base

Es posible que quiera editar el archivo de entorno base para actualizar los números de versión o agregar o quitar dependencias.

En la lista de entornos base, haga clic en la ruta de acceso del archivo YAML del entorno base que desea actualizar. Esto abre el archivo en una nueva pestaña. Puede revisar o actualizar el contenido del archivo allí. Los cambios se guardan automáticamente.

Después de realizar una actualización a la especificación DE YAML, debe actualizar el entorno base para que los cuadernos y los trabajos recojan la configuración más reciente.

1. Junto al entorno base que desea actualizar, haga clic en el icono de menú A continuación, seleccione Actualizar.
2. Haga clic en Confirmar.

Las nuevas sesiones ahora usan el entorno base actualizado. Las sesiones de cuaderno existentes deben reiniciarse para obtener las actualizaciones.

Limitaciones

• En el caso de los trabajos, solo las tareas de cuaderno pueden usar entornos base.
• No se admite la versión 1 del entorno sin servidor. Use la versión 2 o posterior.
• Los entornos base están disponibles para todos los usuarios del área de trabajo.
• Las áreas de trabajo están limitadas a 10 entornos base.