Remote Bridge

Prerequisites

Node.js v22+ environment with npm
Databricks CLI (v1.0.0 or higher): install and configure it according to the official tutorial.
A new Databricks app with AppKit installed. See Bootstrap a new Databricks app for more details.

El remote bridge te permite desarrollar contra un backend desplegado mientras mantienes la UI y las queries en local. Resulta útil para hacer pruebas con datos de producción o depurar el código del backend desplegado sin tener que volver a hacer deploy de la aplicación.

Cuándo usar el remote bridge

Usa el remote bridge cuando:

Hagas pruebas con datos de producción
Depures código de backend ya desplegado
Desarrolles la UI sin ejecutar el backend en local
Colabores con miembros del equipo sobre el mismo backend

Iniciar y detener Remote Bridge

Para iniciar el remote bridge, ejecuta el siguiente comando:

databricks apps dev-remote

El comando hará lo siguiente:

Obtener el nombre de la app desde el contexto (ya sea del archivo app.yml o de lo que introduzca el usuario en la CLI)
Iniciar un servidor de desarrollo local de Vite
Establecer un WebSocket bridge con tu app desplegada
Proporcionar dos URL:
- URL de la app: enlace directo para tu propio uso (<app-url>?dev=true)
- URL para compartir: enlace con el ID del túnel para compartir con los miembros del equipo (<app-url>?dev=<tunnelId>)

note

Para ver todas las opciones disponibles, ejecuta:

databricks apps dev-remote --help

Para detener el remote bridge, presiona Ctrl+C en la terminal.

Aprobación de la conexión

Cuando inicias el remote bridge, cada vez que abras la URL en tu navegador desde un dispositivo nuevo se te pedirá que apruebes la conexión.

Puedes compartir la URL con los miembros de tu equipo para que vean la aplicación en su navegador. Aun así, tendrás que aprobar la conexión desde tu lado.

Cómo funciona

El remote bridge crea un WebSocket bridge entre tu servidor de desarrollo local de Vite y el backend desplegado, lo que te permite desarrollar la UI en local mientras usas el backend desplegado.

Detalles

El navegador se conecta al backend de la app desplegada con el parámetro de query ?dev=true o ?dev=<tunnelId>
El backend desplegado redirige las solicitudes de la UI a tu máquina local a través de un túnel WebSocket (/dev-tunnel)
El WebSocket Bridge (que se ejecuta localmente) recibe del backend las solicitudes de fetch y de lectura de archivos
El servidor de desarrollo local de Vite sirve los archivos de la UI y ofrece reemplazo de módulos en caliente (HMR)
El bridge devuelve las respuestas al backend a través del WebSocket, y este las sirve al navegador

Qué se recarga en caliente

Con el remote bridge obtienes recarga en caliente instantánea para:

Cambios en la UI: cualquier cambio en tus archivos de React/TypeScript/CSS del directorio client/
Archivos de queries: archivos SQL del directorio config/queries/ (solo archivos .sql)

El código del backend no se recarga en caliente. Debes volver a desplegar la aplicación para ver los cambios en el código del backend.