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.

remote bridge を使うと、UI と queries はローカルのまま、デプロイ済みバックエンドに対して開発を進められます。本番データを使ったテストや、アプリを再 deploy せずに deploy 済みのバックエンドコードをデバッグしたい場合に便利です。

次のような場合に remote bridge を使用します。

remote bridge を起動するには、次のコマンドを実行します。

databricks apps dev-remote

このコマンドは次の処理を行います。

コンテキスト (app.yml ファイルまたは CLI でのユーザー入力) からアプリ名を取得します
ローカルの Vite 開発サーバーを起動します
デプロイ済みのアプリへの WebSocket ブリッジを確立します
次の 2 つの URL を発行します。
- App URL: 自分用の直接リンク (<app-url>?dev=true)
- Shareable URL: チームメンバーと共有するためのトンネル ID 付きリンク (<app-url>?dev=<tunnelId>)

note

利用可能なすべてのオプションを確認するには、次を実行します。

databricks apps dev-remote --help

remote bridge を停止するには、ターミナルで Ctrl+C を押します。

remote bridge を起動している間、新しいデバイスのブラウザで URL を開くたびに、接続の承認を求められます。

チームメンバーに URL を共有すれば、各自のブラウザでアプリを表示できます。その場合も、接続の承認はあなたが行う必要があります。

remote bridge は、ローカルの Vite 開発サーバーとデプロイ済みバックエンドの間に WebSocket ブリッジを確立します。これにより、デプロイ済みバックエンドを利用しながら、UI をローカルで開発できます。

ブラウザは、?dev=true または ?dev=<tunnelId> のクエリパラメータを付けて、デプロイ済みアプリのバックエンドに接続します
デプロイ済みバックエンドは、UI からのリクエストを WebSocket トンネル (/dev-tunnel) 経由でローカルマシンにプロキシします
WebSocket ブリッジ (ローカルで実行) は、バックエンドから fetch リクエストとファイル読み取りリクエストを受け取ります
ローカル Vite 開発サーバーは、UI ファイルを配信し、ホットモジュールリプレースメント (HMR) を提供します
ブリッジは WebSocket 経由でレスポンスをバックエンドに返し、バックエンドがそれをブラウザに配信します

remote bridge を使うと、次の変更が即座にホットリロードされます。

バックエンドのコードはホットリロード されません。バックエンドコードの変更を反映するには、アプリを再度 deploy する必要があります。