Configuración

Esta guía describe las variables de entorno y las opciones de configuración de las aplicaciones de AppKit.

Configuración del deployment de la app

Archivo `app.yaml`

El archivo app.yaml configura el entorno de ejecución (runtime) de tu app en Databricks Apps.

Ejemplo básico:

command:
  - node
  - build/index.mjs
env:
  - name: DATABRICKS_WAREHOUSE_ID
    valueFrom: sql-warehouse

Especificación del comando

Especifica cómo iniciar tu app en el campo command:

command:
  - node
  - build/index.mjs

Esto ejecuta la compilación de producción de tu servidor AppKit (creada con npm run build).

Vincular un SQL warehouse

Para usar el Analytics plugin, vincula un SQL warehouse en tu app.yaml:

env:
  - name: DATABRICKS_WAREHOUSE_ID
    valueFrom: sql-warehouse

Esto hace que el ID del warehouse esté disponible para tu app en runtime. La directiva valueFrom: sql-warehouse le indica a Databricks Apps que inyecte el ID del warehouse configurado.

Vinculación de volúmenes de Unity Catalog (plugin files)

El plugin files usa volúmenes con nombre. Cada clave de volumen se corresponde con una variable de entorno DATABRICKS_VOLUME_{KEY_UPPERCASE}:

env:
  - name: DATABRICKS_VOLUME_UPLOADS
    valueFrom: volume
  - name: DATABRICKS_VOLUME_EXPORTS
    valueFrom: volume

Consulta la documentación del plugin Files para obtener más detalles.

Para conocer las opciones de configuración avanzada (autorización, redes, límites de recursos), consulta la documentación de Configuración de Databricks Apps.

Variables de entorno

Requeridas para el deployment en Databricks Apps

Normalmente las proporciona el runtime de Databricks Apps (el conjunto exacto puede variar según la plataforma o la versión):

Variable	Descripción
`DATABRICKS_HOST`	URL del workspace (p. ej. `https://xxx.cloud.databricks.com`)
`DATABRICKS_APP_PORT`	Puerto de escucha (valor predeterminado: `8000`)
`DATABRICKS_APP_NAME`	Nombre de la app en Databricks

Requerido para queries SQL (Analytics plugin)

Variable	Descripción	Cómo configurarla
`DATABRICKS_WAREHOUSE_ID`	ID del SQL warehouse	En `app.yaml`: `valueFrom: sql-warehouse`

Consulta la sección Configuración del deployment de la app más arriba para ver cómo vincular esta variable.

Variables opcionales

Variable	Descripción	Valor predeterminado
`DATABRICKS_WORKSPACE_ID`	ID del workspace	Se obtiene automáticamente desde la API
`NODE_ENV`	`"development"` o `"production"`	—
`FLASK_RUN_HOST`	Host al que enlazar	`0.0.0.0`

Telemetría (opcional)

Variable	Descripción
`OTEL_EXPORTER_OTLP_ENDPOINT`	Endpoint del colector de OpenTelemetry
`OTEL_SERVICE_NAME`	Nombre del servicio para las trazas

Autenticación para desarrollo local

En el desarrollo local, debes autenticarte con Databricks. Elige una de las siguientes opciones:

Opción 1: autenticación con la CLI de Databricks (recomendada)

Configura la autenticación una sola vez con la CLI de Databricks:

databricks auth login --host [host] --profile [profile-name]

Si usas DEFAULT como nombre de perfil, puedes ejecutar tu servidor de desarrollo directamente:

npm run dev

Para ejecutar con un perfil específico, define la variable de entorno DATABRICKS_CONFIG_PROFILE:

DATABRICKS_CONFIG_PROFILE=my-profile npm run dev

Nota: Algunas versiones del SDK de Databricks usan DATABRICKS_PROFILE en lugar de DATABRICKS_CONFIG_PROFILE.

Opción 2: Variables de entorno

export DATABRICKS_HOST="https://xxx.cloud.databricks.com"
export DATABRICKS_TOKEN="dapi..."
export DATABRICKS_WAREHOUSE_ID="abc123..."
npm run dev

Opción 3: archivo `.env` (cargado automáticamente por AppKit)

Crea un archivo .env en la raíz de tu proyecto (¡agrégalo a .gitignore!):

DATABRICKS_HOST=https://xxx.cloud.databricks.com
DATABRICKS_TOKEN=dapi...
DATABRICKS_WAREHOUSE_ID=abc123...

Luego ejecuta:

npm run dev

Configuración avanzada

Para la configuración avanzada de Databricks Apps (autorización, redes, límites de recursos), consulta la documentación de Configuración de Databricks Apps.

Véase también

Gestión de aplicaciones - Despliegue y gestión de aplicaciones
Plugins - Opciones de configuración de plugins