Compartir a través de

Configuración de la ejecución de aplicaciones de Databricks con app.yaml

El app.yaml archivo de una aplicación de Databricks define cómo se ejecuta la aplicación. Si la aplicación requiere un punto de entrada diferente o una configuración específica del entorno, puede incluir este archivo opcional en el proyecto para invalidar el comportamiento predeterminado.

Puede usar la .yaml extensión de archivo o .yml . Este archivo debe encontrarse en la raíz del directorio del proyecto.

Configuración admitida

El app.yaml archivo admite la siguiente configuración.

Configuración Tipo Description
command sequence Use esta configuración cuando necesite un comando personalizado para ejecutar la aplicación. De forma predeterminada, Azure Databricks ejecuta aplicaciones de Python mediante el comando python <my-app.py>, donde <my-app.py> es el primer .py archivo de la estructura de archivos de la aplicación. Si la aplicación incluye Node.js, el comando predeterminado es npm run start. Consulte Lógica de implementación.
Dado que Azure Databricks no ejecuta el comando en un shell, las variables de entorno definidas fuera de la configuración de la aplicación no están disponibles para la aplicación. Si la aplicación requiere parámetros adicionales para ejecutarse, use la estructura env.
Esta configuración es opcional.
env list Azure Databricks establece automáticamente varias variables de entorno predeterminadas en el entorno de tiempo de ejecución de la aplicación. Esta clave de nivel superior define una lista opcional de variables de entorno adicionales que se van a pasar a la aplicación. Cada variable puede usar un valor codificado de forma codificada o hacer referencia a un origen externo, como un secreto o una entrada de base de datos.
Los elementos válidos de la lista son:

Esta configuración es opcional.

Ejemplo app.yaml de una aplicación Streamlit

En el siguiente app.yaml archivo se muestra cómo configurar una aplicación Streamlit. Usa un comando personalizado para iniciar la aplicación con streamlit runy establece variables de entorno para el identificador de SQL Warehouse y una marca de seguimiento de uso.

command: ['streamlit', 'run', 'app.py']
env:
  - name: 'DATABRICKS_WAREHOUSE_ID'
    value: 'quoz2bvjy8bl7skl'
  - name: 'STREAMLIT_GATHER_USAGE_STATS'
    value: 'false'

Use una configuración similar a esta si la aplicación depende de un recurso de proceso específico, como una instancia de SQL Warehouse, o requiere ciertas variables de entorno para controlar el comportamiento del entorno de ejecución.

Ejemplo app.yaml de una aplicación de Flask

En este ejemplo se muestra cómo configurar una aplicación de Flask mediante el servidor Gunicorn. La command configuración especifica los parámetros de inicio de Gunicorn y la env sección establece la ruta de acceso a un volumen de catálogo de Unity como una variable de entorno.

command:
  - gunicorn
  - app:app
  - -w
  - 4
env:
  - name: 'VOLUME_URI'
    value: '/Volumes/catalog-name/schema-name/dir-name'

Use este enfoque cuando la aplicación necesite un servidor WSGI listo para producción como Gunicorn y cuando dependa de los datos almacenados en un volumen de Catálogo de Unity u otra ruta de acceso específica del entorno.

Pasos siguientes

  • Last updated on