メインコンテンツまでスキップ
に最終更新

チュートリアル: ワークスペースでのバンドルの作成とデプロイ

ワークスペースで宣言型自動化バンドルを使い始めるのに役立つよう、このチュートリアルでは、ワークスペースからジョブを含むバンドルを作成し、デプロイし、バンドル内のジョブを実行する手順を説明します。

ワークスペースでバンドルを使用するための要件については、ワークスペース要件の「宣言型自動化バンドル」を参照してください。

バンドルに関する詳細については、 「宣言型自動化バンドルとは？」を参照してください。

バンドルを作成する​

まず、Databricks ワークスペースにバンドルを作成します。

  1. バンドルを作成するGitフォルダに移動します。
ヒント

以前にワークスペースのエディターで Git フォルダーを開いたことがある場合は、ワークスペース ブラウザーのオーサリング コンテキスト メニューを使用して、Git フォルダーにすばやく移動できます。オー サリングコンテキストを参照してください。

  1. 作成 ボタンをクリックし、 アセットバンドル をクリックします。または、ワークスペースツリーで Git フォルダまたはそれに関連するケバブを右クリックし、 作成 > アセットバンドル をクリックします。

    アセットバンドルを作成

  2. [ Create an asset bundle ] ダイアログで、アセットバンドルに totally-awesome-bundle などの名前を付けます。バンドル名には、文字、数字、ダッシュ、アンダースコアのみを含めることができます。 「空のプロジェクト」 を選択し、「 作成してデプロイ 」をクリックします。

    「新規アセットバンドルの作成」ダイアログ

これにより、Git フォルダー内に初期バンドルが作成されます。このバンドルには、 .gitignore Git 設定ファイルと必要な Declarative Automation Bundles databricks.ymlファイルが含まれます。databricks.ymlファイルには、バンドルの主要な設定が含まれています。詳細については、 「宣言型自動化バンドルの構成」を参照してください。

新しいアセットバンドル

ノートブックを追加する​

次に、バンドルにノートブックを追加します。次の例のノートブックは「Hello World!」を出力します。

  1. [ノートブック バンドル プロジェクトの追加 ] タイルをクリックします。または、目次でバンドルのケバブをクリックし、 [作成] > [ノートブック] をクリックします。

  2. ノートブックの名前を helloworld に変更します。

  3. ノートブックの言語を Python に設定し、ノートブックのセルに次のものを貼り付けます。

    Python
    print("Hello World!")

ジョブを定義する​

次に、ノートブックを実行するジョブを定義します。

  1. バンドルのデプロイメント・アイコンをクリックして、 デプロイメント パネルに切り替えます。

    デプロイパネルのアイコン

  2. バンドル リソース セクションで、[ 追加] をクリックし、 [新しいジョブ定義] を クリックします。

    ジョブ定義を作成

  3. [既存のバンドルにジョブを追加] ダイアログの[ジョブ名] フィールドに 「実行ノートブック」 と入力します。 [追加してデプロイ]を クリックします。

  4. 開発ターゲット ワークスペースに作成されるジョブ リソースに関する情報を含む「 開発にデプロイ」 確認ダイアログが表示されます。 [デプロイ]を クリックします。

  5. デプロイメント アイコンの上にあるフォルダー アイコンをクリックして、バンドルのファイルに戻ります。ジョブ リソースrun-notebook.job.yml 、ジョブの基本 YAML と、コメント アウトされた追加のジョブ タスク例 YAML を使用して作成されました。

  6. ジョブ定義にノートブック タスクを追加します。run-notebook.job.ymlファイル内のサンプル YAML を次のものに置き換えます。

    YAML
    resources:
      jobs:
        run_notebook:
          name: run-notebook
          queue:
            enabled: true
          tasks:
            - task_key: my-notebook-task
              notebook_task:
                notebook_path: ../helloworld.ipynb

    ジョブ ノートブック タスク構成 YAML

YAML でのジョブの定義の詳細については、 「ジョブ」を参照してください。 サポートされている他のジョブ タスク タイプの YAML 構文については、 「宣言的オートメーション バンドルのジョブにタスクを追加する」を参照してください。

バンドルをデプロイする​

次に、バンドルをデプロイし、 helloworld ノートブック タスクを含むジョブを実行します。

  1. バンドルの 「デプロイメント」 ペインの「 ターゲット」 で、ドロップダウンをクリックして、 devターゲットワークスペースが選択されていない場合は選択します。ターゲットワークスペースは、バンドルのdatabricks.ymlのtargetsマッピングで定義されます。宣言型自動化バンドルのデプロイモードを参照してください。

    ターゲットデプロイメントの選択

  2. デプロイ ボタンをクリックします。バンドルが検証され、検証の詳細がダイアログに表示されます。

  3. この devへのデプロイ 確認ダイアログでデプロイの詳細を確認し、 デプロイ をクリックします。

    開発へのデプロイダイアログ

重要

バンドルをデプロイし、バンドル リソースを実行すると、現在のユーザーとしてコードが実行されます。バンドル内のコード (コマンドを実行する構成設定を含む YAML) を信頼していることを確認します。

デプロイメントのステータスは、 プロジェクト出力 ウィンドウに出力されます。

ジョブを実行する​

デプロイされたバンドルリソースは 、バンドルリソース の下にリストされます。ジョブリソースに関連付けられている再生アイコンをクリックして、ジョブリソースを実行します。

デプロイされたリソースの一覧表示

左側のナビゲーションバーから 「ジョブ実行 」に移動して、バンドルの実行を確認します。 バンドル・ジョブ実行の名前には、接頭部が付きます (例: [dev someone] run-notebook.

次のステップ​