メインコンテンツまでスキップ

Databricks アプリをデプロイする

Databricks アプリを作成して開発したら、それをデプロイして、Databricks ワークスペースでアクセスできるようにします。デプロイメントでは、プロジェクト ファイルで定義された構成を使用してアプリがビルドされ、依存関係がインストールされ、実行されます。Databricks UI または Databricks CLI を使用してアプリをデプロイできます。

注記

テンプレートからアプリを作成した場合、Databricks は最初にアプリを作成したときに自動的にデプロイします。ただし、変更を加えた後でも再デプロイできます。テンプレートから Databricks アプリを作成するを参照してください。

ロジックのデプロイ​

Databricks Apps は、Python、Node.js、またはその両方の組み合わせを使用するアプリケーションのデプロイをサポートしています。これにより、Pythonバックエンドを備えたNode.jsフロントエンドなどの柔軟なアーキテクチャが可能になります。

デプロイ中、ビルド プロセスはアプリ ディレクトリのルートにある package.json ファイルをチェックして、Node.js が使用されているかどうかを判断します。存在する場合は、Python ステップと並んでノード固有のビルド ステップが含まれます。デプロイ ロジックは、次のパターンに従います。

package.jsonが存在する場合 :

  1. Node.jsの依存関係をインストールします。pnpm-lock.yamlが存在する場合はpnpm install --frozen-lockfileを実行し、そうでない場合はnpm installを実行します。Node.jsの依存関係を定義するを参照してください。

  2. Pythonの依存関係をインストールします。

    • requirements.txtが存在する場合、実行する pip install -r requirements.txt
    • requirements.txt存在せず、 pyproject.tomlとuv.lockの両方が存在する場合は、 uv syncを実行して依存関係をインストールします。
  3. package.json(npm run buildまたはpnpm run build)でスクリプトが定義されている場合は、buildスクリプトを実行します。

  4. app.yaml で指定されたコマンドを実行してください。npmアプリの場合、コマンドが指定されていない場合、Databricks は npm run start を実行します。pnpm アプリでは、app.yamlでコマンドを指定する必要があります。

注記

npmアプリでは、app.yamlでコマンドが指定されておらず、アプリにPythonコードが含まれている場合でも、Databricks は npm run start を実行します。PythonとNode.jsの両方のプロセスを実行するには、concurrentlyのようなツールを使用して両方を起動するカスタムのstartスクリプトを定義します。たとえば、concurrently "npm run start:node" "python my_app.py"。

package.json存在しない場合 :

  1. Pythonの依存関係をインストールします。

    • requirements.txtが存在する場合、実行する pip install -r requirements.txt
    • requirements.txt存在せず、 pyproject.tomlとuv.lockの両方が存在する場合は、 uv syncを実行して依存関係をインストールします。
  2. app.yamlで指定されたコマンドを実行するか、コマンドが指定されていない場合は python <my-app>.py を実行します

デプロイメントの準備​

アプリをデプロイする前に、プロジェクトに必要なコンポーネントが含まれていることを確認します。

  • メインスクリプト - エントリポイントファイル( app.py や app.jsなど)
  • オプションの app.yaml ファイル - アプリでカスタム コマンドまたは環境変数が必要な場合は、実行を構成するための app.yaml ファイルを含めます。「app.yamlを使用した Databricks アプリの実行の構成」を参照してください。
  • 依存関係 - すべての依存関係が使用可能であることを確認します。Databricks アプリの依存関係を管理するを参照してください。
  • シークレットまたは環境の値 - app.yamlの env セクションを使用する場合は、参照されているシークレットまたは外部ソースが正しく構成され、アクセス可能であることを確認します。Databricks アプリにリソースを追加するを参照してください。

さらに、アプリ サービスプリンシパル がソース コード フォルダーにアクセスできることを確認します。

デプロイメントソースを選択する​

次のソースから Databricks アプリをデプロイできます。

  • ワークスペース フォルダー - アプリ ファイルをワークスペース フォルダーにアップロードし、そこから展開します。 これは標準的な導入方法です。ワークスペースフォルダからのデプロイを参照してください。
  • Gitリポジトリ - アプリのGitリポジトリを設定し、ワークスペースにファイルをアップロードせずに直接デプロイします。 アプリは、デプロイのたびに、設定されたGit参照(ブランチ、タグ、またはコミット)からコードを読み取ります。Gitリポジトリからのデプロイ」を参照してください。

同じアプリのワークスペースとGitソースをいつでも切り替えることができます。 アプリの更新または再デプロイを参照してください。

アプリをデプロイする​

次のセクションでは、ワークスペース フォルダーから、または Git リポジトリから直接デプロイする方法について説明します。

ワークスペースフォルダからデプロイする​

Databricks UI からアプリをデプロイするには:

  1. アプリ ファイルを Databricks ワークスペースにアップロードします。手順については、「 ファイルのインポート」を参照してください。
  2. Databricksワークスペースで、アプリのアイコン。アプリスイッチャーで Databricks Apps を選択します。
  3. 「名前」 欄でアプリを選択してください。
  4. デプロイ をクリックします。アプリが既にデプロイされている場合は、 [デプロイ] の横にある矢印をクリックし、 [別のソースを使用してデプロイ] を選択します。
  5. Create deployment ダイアログで、 From ワークスペース tab を選択します。
  6. ソースコードパス にアプリファイルをuploadしたフォルダのパスを入力するか、フォルダアイコンをクリックして参照します。 選択 をクリックしてから、 デプロイ をクリックします。

Gitリポジトリからデプロイする​

Gitリポジトリからアプリをデプロイするには、アプリ レベルでリポジトリを追加し、デプロイ時にGit参照を指定します。 Gitリポジトリには、 app.yaml 、依存関係、エントリ ポイントを含むアプリ ファイルが含まれている必要があります。 GitHub、GitLab、Bitbucketなど、主要なGitプロバイダーはすべてサポートされています。Gitをバックエンドとするアプリケーションは、UI、CLI、API、または宣言型自動化バンドルを使用してデプロイすることもできます。

Git からアプリを構成してデプロイするには:

  1. アプリ ファイルを Git リポジトリにアップロードします。
  2. Databricksワークスペースで、アプリのアイコン。アプリスイッチャーで Databricks Apps を選択します。
  3. 編集する既存のアプリを選択するか、 + アプリを作成 をクリックし、続けて カスタムアプリを作成 をクリックします。カスタム Databricks アプリを作成するを参照してください。
  4. Gitリポジトリの構成ステップ 」で、 Gitリポジトリ URL (例: https://github.com/org/repo ) を入力し、 Gitプロバイダーを選択します。
  5. 新規アプリケーションについては、 Gitリファレンス (Branch/タグ/commit) を入力します。GitHubまたはAzure DevOpsリポジトリの場合、Branchが選択されていると、必要に応じて プッシュイベントでの自動デプロイを有効にする を選択できます。「 自動 Git デプロイメントを有効にする」を参照してください。
  6. 「アプリを作成」 または 「保存」 をクリックすると、アプリの概要ページに戻ります。
  7. プライベート リポジトリの場合、アプリのService PrincipalにGit認証情報が設定されている必要があります。アプリの概要ページで、 Configure Git credential をクリックします。Git認証情報を追加するには、アプリのService Principalに対するCAN MANAGE権限が必要です。パブリック リポジトリにはGit認証情報は必要ありません。各プロバイダーの手順については、 Git プロバイダーを Databricks に接続するを参照してください。

次に、アプリをデプロイします。

  1. アプリの概要ページで、 デプロイ をクリックします。アプリが既にデプロイされている場合は、 [デプロイ] の横にある矢印をクリックし、 [別のソースを使用してデプロイ] を選択します。
  2. デプロイの作成 ダイアログで、 Git から を選択します。
  3. Gitリファレンス (Branch/タグ/commit) の場合は、Branch名、タグ、またはcommit SHA (例: main、 v1.0.0、またはcommitハッシュ) を入力します。
  4. 参照タイプ には、ブランチ、タグ、コミットなどの参照のタイプを指定します。
  5. (オプション) ソースコードパス には、リポジトリ内の特定のディレクトリへのパスを入力します。アプリはそのディレクトリを最上位ディレクトリとして扱い、そのディレクトリ外のファイルにはアクセスできません。パスを指定しない場合、Databricksはリポジトリのルートを使用します。
  6. (オプション) Branchへのすべての commit で自動的にデプロイするには、 プッシュイベントでの自動デプロイを有効にする を選択します。 監視対象のBranch を設定する必要があります。オプションで、 ソースコードパス を指定して、リポジトリルート以外のパスを設定できます。自動Gitデプロイメントの有効化を参照してください。
  7. [デプロイ] をクリックします。

ブランチまたはタグ参照の場合、Databricks はそのブランチまたはタグから最新のコミットをデプロイします。コミット SHA 参照の場合、Databricks は常にその特定のコミットをデプロイします。サービスプリンシパルのGit資格情報が無効であるか期限切れの場合、デプロイは失敗します。

注記

Gitデプロイメントが一般公開される前に作成されたアプリは、アプリのサービスプリンシパルに対するCAN MANAGE権限をクリエイターに自動的に付与しません。古いアプリにGit認証情報を追加する必要がある場合は、ワークスペース管理者にサービスプリンシパルに対するCAN MANAGE権限を付与するよう依頼してください。

サービスプリンシパルは、プロバイダーごとに1つのGit認証情報をサポートします。アカウントコンソールなど、他の場所で認証情報を更新すると、そのプロバイダーの既存の認証情報が置き換えられます。

自動Gitデプロイメントを有効にする​

注記

GitHub および Azure DevOps は、自動デプロイメントでサポートされているプロバイダーです。

自動デプロイを有効にすると、Databricks は Git リポジトリに Webhook (Azure DevOps ではサービスフックと呼ばれます) を登録し、構成されたブランチに新しい commit が行われるたびにアプリを再デプロイします。デプロイされたアプリは、手動のステップなしでリポジトリと同期された状態に保たれます。

自動デプロイメントには、Git プロバイダーに応じて以下のセットアップが必要です。

  • The Databricks GitHub app must be installed on theリポジトリ.
  • リポジトリはプライベートである必要があります。Databricks は公開リポジトリからの自動デプロイメントをサポートしていません。
  • アプリのサービスプリンシパルには、リポジトリにアクセスできるGit認証情報が設定されている必要があります。DatabricksにGitプロバイダーを接続するを参照してください。

リポジトリの Webhook は 20 個までに制限されています(GitHub Enterprise の場合は 250 個)。

自動デプロイを有効にするには、 GitプロバイダーとしてGitHubまたはAzure DevOpsを構成し、 [プッシュイベントで自動デプロイを有効にする] を選択します。これは、以下の場所のいずれかで実行できます。

Gitリファレンスはブランチ名である必要があります。タグは自動デプロイメントと互換性がありません。

注記

アプリのサービスプリンシパルに、リポジトリ用のGit認証情報がない場合、自動デプロイを有効にしたときにDatabricksはそれを追加するよう促します。アクセスを承認すると自動デプロイメントが有効になりますが、それらを開始するには、アプリを手動で再デプロイする必要があります。

自動デプロイを無効にするには、既存のアプリの 自動デプロイ バッジをクリックし、 プッシュイベントで自動デプロイを有効にする のチェックを外します。これらの設定は、アプリの 設定 ページで変更することもできます。

Gitのみのデプロイメントを強制する​

ワークスペース管理者は、ワークスペース内のすべてのアプリをGitリポジトリからデプロイするよう要求できます。 設定 > 開発 > アプリ に移動し、 「Git からのアプリのデプロイのみを許可する」 をオンにします。この設定はデフォルトではオフになっています。

Gitデプロイメントを強制する場合:

  • ユーザーはアプリを作成する前にGitリポジトリを構成する必要があります。
  • ユーザーはGitからのみデプロイでき、ワークスペースフォルダからはデプロイできません。
  • Databricksはワークスペース内のアプリテンプレートを無効にします。
  • ユーザーは、Gitリポジトリを持つアプリからGitリポジトリを削除することはできません。
  • 既存のアプリは引き続き実行されますが、アプリにGitリポジトリがない限り、ユーザーはそれらをデプロイしたり、再度起動したりすることはできません。

デプロイメント後の挙動​

デプロイ中、Databricks は app.yaml ファイルで定義された command に基づいてアプリを起動するか、defaultで python app.py を実行します。アプリの概要ページには現在のステータスが表示され、Logs、デプロイ履歴、環境情報へのアクセスが提供されます。

defaultでは、アプリプロセスが起動するとすぐにデプロイメントが成功します。アプリがHTTP Endpointで正常に応答するまでデプロイメントを待機させるには、app.yamlでヘルスチェックを構成します。ヘルスチェックが失敗した場合、デプロイメントは失敗します。デプロイメントのヘルスチェックを構成するを参照してください。

アプリのデプロイ後にアプリの概要ページを表示する

デプロイされたアプリの出力を表示するには、アプリのリンクをクリックします。

デバッグとランタイムモニタリングのために Logs ページに移動します。Databricks Appsのログ記録とモニタリングを参照してください。

アプリを更新または再デプロイする​

ソース コードまたは構成に変更を加えた後は、アプリを再デプロイします。再デプロイすると、アプリを再作成せずに最新の更新が適用されます。ワークスペースまたは Git リポジトリからいつでも再デプロイできます。

ワークスペースフォルダから再デプロイする​

ワークスペース フォルダーから再デプロイするには:

  1. ワークスペース フォルダー内のアプリ ファイルを更新します。
  2. アプリを選択し、 「デプロイ」 をクリックします。
  3. ソース コード パスが変更された場合、または Git ソースから切り替える場合は、 [デプロイ] の横にある矢印をクリックし、 [別のソースを使用してデプロイ] を選択します。

Gitリポジトリから再デプロイする​

Git リポジトリから再デプロイするには:

  1. 変更を Git リポジトリにプッシュします。
  2. Databricksワークスペースでアプリを選択し、 [デプロイ] をクリックします。 Git の参照が変更された場合、またはワークスペース ソースを切り替える場合は、 [デプロイ] の横にある矢印をクリックして、 [別のソースを使用してデプロイ] を選択します。

CLIまたはAPIを使用してGitリポジトリを更新するには、作成-更新コマンドを使用します。 アプリからGitリポジトリを削除すると、ワークスペースからのデプロイメントが強制されます。

重要

Gitリポジトリを変更するか、デプロイ ソース ( Gitとワークスペース) を切り替えると、アプリのサービスプリンシパルのすべてのGit資格情報が削除されます。 Git参照のみを変更しても、認証情報は削除されません。Gitから再度デプロイする前に、認証情報を再設定する必要があります。

以前のバージョンにロールバックする​

Databricks Appsには、単一のロールバックアクションはありません。ロールバックするには、アプリの以前の安定版を再デプロイします。ステップは、アプリがGitリポジトリからデプロイされるか、ワークスペースフォルダーからデプロイされるかによって異なります。ロールバック先のバージョンを選択するには、アプリの デプロイメント ページでアプリのデプロイメント履歴を確認します。Databricks アプリの詳細を表示するを参照してください。

CLIからアプリのデプロイメントを一覧表示するには、以下を実行します:

Bash
databricks apps list-deployments my-app

Git ベースのアプリをロールバックする​

アプリがGitリポジトリからデプロイされる場合は、目的のバージョンが含まれている以前のcommitまたはタグを再デプロイします。Gitは正確なソースをピン留めするため、これが最も信頼性の高いロールバック方法です。

  1. Databricksワークスペースで、アプリのアイコン。 アプリスイッチャーをクリックして Databricks Apps を選択し、アプリを選択します。
  2. [デプロイ] の横にある矢印をクリックし、 [別のソースを使用してデプロイ] を選択します。
  3. [ デプロイの作成 ] ダイアログで、 [ Git から ] tab を選択します。
  4. Gitリファレンス (Branch/タグ/commit) の場合は、Branch名、タグ、またはcommit SHA (例: main、 v1.0.0、またはcommitハッシュ) を入力します。
  5. 参照タイプ には、ブランチ、タグ、コミットなどの参照のタイプを指定します。
  6. ソースコードのパス には、リポジトリ内のアプリコードへのパスを入力します。
  7. [デプロイ] をクリックします。

Databricks では、すべてのバージョンが再デプロイ可能な特定の commit またはタグにマッピングされるよう、本番運用アプリを Git からデプロイすることを推奨しています。Databricks Apps のベストプラクティスを参照してください。

ワークスペースソースアプリをロールバックする​

アプリがワークスペースフォルダーからデプロイされる場合は、ソースの安定版を再デプロイします。「Gitベースのアプリのロールバック」で説明されているように、アプリのソースをバージョン管理下に置き、安定したcommitまたはタグを再デプロイします。バージョン管理されていないワークスペースフォルダーからデプロイする場合は、ソースの安定したコピーをフォルダーに復元してから再デプロイします:

  1. ワークスペースフォルダ内のファイルを、ロールバック先のバージョンに置き換えます。
  2. アプリを選択し、 [デプロイ] をクリックして、そのフォルダーからデプロイします。

最後に成功したデプロイとそのランの時刻を確認するには、 [デプロイ] ページまたは databricks apps list-deploymentsを使用します。Databricksは、依存関係のバージョンを固定し、 Gitからデプロイしてロールバックを再現できるようにすることを推奨します。Databricks Appsのベストプラクティスを参照してください。

アプリデプロイコマンドの全リストについては、appsコマンド・グループを参照してください。

デプロイメントの問題のトラブルシューティング​

アプリがデプロイに失敗するか、期待どおりに実行されない場合は、次のトラブルシューティング ステップを試してください。

  • ログでエラー メッセージまたはランタイム出力を確認します。
  • app.yaml構文と設定を検証します。
  • ヘルスチェック エラーでデプロイメントが失敗した場合は、ヘルスチェック path が 2xx ステータス コードを返し、アプリが timeout_seconds 以内に準備完了になることを確認してください。「 デプロイメント ヘルスチェックを構成する」を参照してください。
  • envセクションのシークレットと環境変数が適切に解決されることを確認します。
  • 必要な依存関係がすべて含まれているかインストールされているかを確認します。
  • ワークスペースでプライベートサービスコネクトまたは制限付き送信ネットワークポリシーを使用している場合は、必要なドメインが許可されていることを確認してください。プライベートサービスコネクト環境において、送信許可リストのエントリが欠落していることは、デプロイメント失敗の一般的な原因です。プライベートサービスコネクト環境でアプリをデプロイする方法を参照してください。

Git リポジトリのデプロイメントの場合:

  • プライベートリポジトリの場合は、アプリのサービスプリンシパルにGit認証情報が設定されていることを確認してください。
  • Gitリポジトリ URL が正しいこと、およびGit参照 (ブランチ、タグ、またはコミット) がリポジトリに存在することを確認してください。
  • ワークスペース管理者がGitのみのデプロイメントを強制する場合、 Gitリポジトリが構成されていない限り、アプリをデプロイしたり起動したりすることはできません。
  • CLI、API、または宣言型自動化バンドルからデプロイする場合は、まずアプリを作成し、次にGit認証情報をアプリのサービスプリンシパルに追加してください。

その他のリソース​