Implementación de una aplicación de Databricks

Después de crear y desarrollar la aplicación de Azure Databricks, impleméntela para que sea accesible en el área de trabajo de Azure Databricks. La implementación compila la aplicación, instala dependencias y la ejecuta mediante la configuración definida en los archivos del proyecto. Puede implementar aplicaciones mediante la interfaz de usuario de Azure Databricks o la CLI de Azure Databricks.

Nota:

Si crea una aplicación a partir de una plantilla, Azure Databricks la implementa automáticamente al crearla por primera vez. Sin embargo, todavía puede volver a implementarlo más adelante después de realizar cambios. Consulte Creación de una aplicación de Databricks a partir de una plantilla.

Lógica de implementación

Databricks Apps admite la implementación de aplicaciones que usan Python, Node.jso una combinación de ambos. Esto permite arquitecturas flexibles, como un front-end de Node.js con un back-end de Python.

Durante la implementación, el proceso de compilación comprueba si hay un package.json archivo en la raíz del directorio de la aplicación para determinar si se usa Node.js. Si está presente, incluye pasos de compilación específicos del nodo junto con los pasos de Python. La lógica de implementación sigue este patrón:

Si package.json está presente:

1. Ejecute npm install:
2. Ejecutar pip install -r requirements.txt (si existe)
3. Ejecutar npm run build (si se define un script build en package.json)
4. Ejecute el comando especificado en app.yamlo npm run start si no se especifica ningún comando.

Nota:

Si no se especifica ningún comando en app.yaml, Azure Databricks ejecuta npm run start, incluso si la aplicación incluye código de Python. Para ejecutar tanto los procesos de Python como los de Node.js, defina un script personalizado start que use una herramienta como concurrently para iniciar ambos. Por ejemplo: concurrently "npm run start:node" "python my_app.py".

Si package.json no está presente:

1. Ejecutar pip install -r requirements.txt (si existe)
2. Ejecute el comando especificado en app.yamlo python <my-app>.py si no se especifica ningún comando.

Preparación para la implementación

Antes de implementar la aplicación, compruebe que el proyecto incluye los componentes necesarios:

• Script principal : el archivo de punto de entrada, como app.py o app.js.
• Archivo opcional app.yaml : si la aplicación requiere un comando personalizado o variables de entorno, incluya un app.yaml archivo para configurar la ejecución. Vea Configurar la ejecución de la aplicación de Databricks con app.yaml.
• Dependencias : asegúrese de que todas las dependencias están disponibles. Consulte Administración de dependencias para una aplicación de Databricks.
• Secretos o valores de entorno : si usa la env sección de app.yaml, compruebe que los secretos a los que se hace referencia o los orígenes externos están configurados y accesibles correctamente. Consulte Incorporación de recursos a una aplicación de Databricks.

Además, asegúrese de que la entidad de servicio de la aplicación tiene acceso a la carpeta de código fuente.

Implementación de la aplicación

Interfaz de usuario de Databricks

Para implementar una aplicación desde la interfaz de usuario de Azure Databricks:

1. Cargue los archivos de la aplicación en el área de trabajo de Azure Databricks. Para obtener instrucciones, consulte Importación de un archivo.
2. Haga clic en Proceso en la barra lateral.
3. Vaya a la pestaña Aplicaciones y haga clic en el vínculo a la aplicación en la columna Nombre .
4. Haga clic en Implementar y seleccione la carpeta del área de trabajo donde cargó los archivos de la aplicación.
5. Haga clic en Seleccionar y, a continuación, en Implementar.
6. Revise la configuración y haga clic en Implementar.

CLI de Databricks

Para implementar una aplicación mediante la CLI:

1. Abra un terminal y vaya al directorio que contiene los archivos de la aplicación.

2. Cargue los archivos de la aplicación en el área de trabajo de Azure Databricks mediante el sync comando . Reemplace la ruta de acceso por la ubicación del área de trabajo donde desea cargar los archivos.

   databricks sync --watch . /Workspace/Users/my-email@org.com/my-app
   

   La --watch marca mantiene el proceso de sincronización en ejecución y carga automáticamente los cambios al modificar archivos localmente. Para excluir archivos o directorios específicos de la sincronización, agréguelos a un .gitignore archivo en el directorio de la aplicación local. Los archivos comunes que se van a excluir son node_modules/, .env, __pycache__/, .DS_Storey cualquier archivo de datos grande o artefactos de compilación.

3. Compruebe la carga viendo los archivos del área de trabajo. Haga clic en de trabajo Área de trabajo en la barra lateral y vaya al directorio que creó para la aplicación.

4. Implemente la aplicación mediante la ejecución del comando siguiente. Reemplace el nombre de la aplicación y la ruta de acceso del código fuente por los valores.

   databricks apps deploy my-app-name \
      --source-code-path /Workspace/Users/my-email@org.com/my-app
   

   La CLI muestra el progreso de la implementación y confirma cuándo se está ejecutando la aplicación.

Una vez implementado, Azure Databricks inicia la aplicación en el command definido en el archivo app.yaml o, por defecto, ejecuta python app.py.

Comportamiento posterior a la implementación

Una vez completada la implementación, Azure Databricks inicia la aplicación en un entorno administrado. La página de detalles de la aplicación muestra el estado actual y proporciona acceso a los registros, el historial de implementación y la información del entorno.

Para ver la salida de la aplicación implementada, haga clic en el vínculo de la aplicación.

Vaya a la pestaña Registros para depurar y supervisar en tiempo de ejecución. Consulte Registro y supervisión de aplicaciones de Databricks.

Actualizar o volver a implementar la aplicación

Es posible que quiera actualizar o volver a implementar la aplicación si realizó cambios en el código fuente, actualizó el app.yaml archivo o debe implementar desde una ruta de acceso de código fuente diferente. La reimplementación aplica las actualizaciones más recientes sin necesidad de volver a crear la aplicación desde cero.

Para realizar cambios en una aplicación implementada:

1. Actualice el código de la aplicación o de la configuración app.yaml.
2. Vuelva a la página Aplicaciones del área de trabajo de Azure Databricks.
3. Seleccione la aplicación y elija Implementar de nuevo. Si ha cambiado la ruta de acceso del código fuente, haga clic en la flecha situada junto a Implementar y seleccione Implementar con otra ruta de acceso de código fuente.

Solución de problemas de implementación

Si la aplicación no se puede implementar o no se ejecuta según lo previsto, pruebe los pasos de solución de problemas siguientes:

• Comprobar registros - Ver los mensajes de error o los resultados de ejecución en el panel de registros.
• Validar app.yaml - Asegúrese de que la sintaxis sea correcta y se use la configuración admitida.
• Verificar secretos y variables de entorno: asegúrese de que todas las referencias de la sección env se resuelvan correctamente.
• Confirmar dependencias : asegúrese de que todos los paquetes necesarios están incluidos o instalados.

Pasos siguientes

• Registro y supervisión de aplicaciones de Databricks
• Configuración de permisos para una aplicación de Databricks
• Configuración de la ejecución de aplicaciones de Databricks con app.yaml