バンドルデプロイメント履歴
ベータ版
この機能はベータ版です。
デプロイメント履歴は、ワークスペース内のすべてのDeclarative Automation Bundlesのデプロイメントに関する、構造化された監査可能な記録を提供します。 デプロイ とは、特定のターゲットにデプロイされるバンドルです。デプロイするたびに、新しい バージョン が記録されます。
各デプロイメントについて、以下を確認できます：
- デプロイメントメタデータ ：デプロイを実行したID、Timestamp、ターゲット、および結果のステータス。
- ソース管理コンテキスト : Gitリポジトリ、Branch、commit SHA、およびバージョンに関連付けられたリリースタグ。
- リソースの変更 : 各バージョンで作成、更新、削除、または再作成されたリソース。
デプロイメント履歴は、デプロイメントの検証、回帰の調査、ジョブやパイプラインを最後に変更したユーザーの確認といった疑問への回答を一元的に行える場所です。これは、Databricksリソースをコードとして管理するチームにとって、ガバナンスの効いたデプロイメントの基盤となります。
バンドルの概要については、「宣言型オートメーションバンドルとは？」を参照してください。バンドルのデプロイ方法については、「ワークスペースからのバンドルのデプロイとワークフローの実行」および「宣言型オートメーションバンドルのデプロイモード」を参照してください。
デプロイメント履歴を有効にする
デプロイ履歴は、Databricks CLIバージョン1.23.0以降で利用できます。
デプロイ履歴は、ワークスペースからデプロイするバンドルに対してdefaultで有効になっています。アカウント内のすべてのワークスペースに対してこの設定を切り替えるか、バンドル構成で特定のバンドルに対して設定できます。
デプロイメント履歴アカウント設定
デプロイ履歴 設定は、ワークスペースからデプロイするバンドルがデプロイ履歴を記録するかどうかを制御します。この設定は、アカウント内のすべてのワークスペースに適用されます。
設定を変更するには、次のいずれかの操作を行います。
- バンドルエディタで、 「デプロイメント」 ペインの上部にある 「デプロイメント履歴」 をクリックし、設定を切り替えます。バンドルデプロイメントの情報については、「 ワークスペースからバンドルをデプロイし、ワークフローを実行する」を参照してください。
- ワークスペースの右上にあるユーザー名をクリックし、 設定 をクリックします。 設定 サイドバーで、 開発者 を選択します。 実験的な機能 の下で、 デプロイ履歴 を切り替えます。
デプロイ履歴 のユーザー設定は、ワークスペースからのデプロイにのみ適用されます。Databricks CLI でデプロイするときにデプロイ履歴を記録するには、experimental.deployment_history を true に設定します。実験段階を参照してください。
バンドルの設定をオーバーライドする
特定のバンドルのデプロイメント履歴を有効または無効にするには、バンドル設定でexperimental.deployment_historyを次のように設定します。
experimental:
deployment_history: true
デプロイメントを表示
デプロイを表示するには、以下のいずれかを実行します。
- バンドルの デプロイメント ペインから、そのバンドルのデプロイメント履歴を開きます。ワークスペースからのバンドルのデプロイとワークフローの実行を参照してください。
- バンドルによって管理されるジョブ、パイプライン、またはダッシュボードの場合、 Managed by インジケーターを使用して、それを所有するデプロイメントにジャンプします。
- バンドル名で検索して、そのデプロイメント履歴を直接開きます。
デプロイメントリストには、CAN_READアクセス権を持つすべてのデプロイメント（および対応するバージョンとリソース）が表示されます。
リストは次の列でフィルタリングおよび並べ替えができます：
列 | 説明 |
|---|---|
名前 | バンドルとターゲット、またはデプロイメントの表示名。 |
ターゲット |
|
ステータス | 最新のデプロイメントの状態。 |
デプロイメントバージョンの詳細を表示
デプロイ履歴からデプロイを選択して詳細を開き、バージョンを選択して、デプロイがいつ誰によって開始されたか、ソースGitリポジトリとBranch、commit SHA（Gitプロバイダーの差分にリンク）、および該当する場合はリリースタグなどの情報を確認します。
ヘッダーにあるバージョン履歴のドロップダウンを使用して、バージョン間を移動します。
リソースの変更は、各行に、変更されたリソースのキー（jobs.ETL_Mainなど）、リソースに対して実行されたアクション（作成、更新、削除、再作成）、リソースの状態、および変更のTimestampが含まれるテーブルにリストされます。
CLIからのデプロイメント履歴
自動化されたワークフローでは、Databricks CLIのbundle-deploymentsコマンドを使用してデプロイメント履歴にアクセスできます。databricks bundle-deploymentsを参照してください。
制限事項
- デプロイ履歴はベストエフォート方式で記録されますが、デプロイ状態の唯一の真実となるものではありません。稀なケースとして、Databricksのインフラストラクチャの問題などの場合、デプロイが成功しても履歴エントリが欠落する可能性があります。
- デプロイの基盤となるエンティティ（ジョブ ランなど）には、保持ポリシーが設定されている場合があります。
- ダイレクトエンジンを使用したデプロイメントのみがサポートされています。ダイレクトデプロイメントエンジンへの移行を参照してください。