マネージド ノートブックの実行をスケジュールする
このページでは、Vertex AI Workbench マネージド ノートブック エグゼキュータを使用して、Python ノートブック ファイルを 1 時間ごとに実行する方法について説明します。
始める前に
- Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Notebooks and Vertex AI APIs.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Notebooks and Vertex AI APIs.
必要なロール
インスタンスのサービス アカウントに Vertex AI Workbench エグゼキュータの操作に必要な権限を付与するには、プロジェクトに対する次の IAM ロールをインスタンスのサービス アカウントに付与するよう管理者に依頼してください。
- Notebooks 閲覧者(
roles/notebooks.viewer
) - Vertex AI ユーザー(
roles/aiplatform.user
) - ストレージ管理者(
roles/storage.admin
)
ロールの付与の詳細については、アクセスの管理をご覧ください。
管理者は、インスタンスのサービス アカウントに、カスタムロールや他の事前定義ロールを使用して必要な権限を付与することもできます。
マネージド ノートブック インスタンスとサンプル ノートブック ファイルを作成する
ノートブック ファイルの最初のセルに、次のように入力します。
# Import datetime import datetime # Get the time and print it datetime.datetime.now() print(datetime.datetime.now())
ノートブック ファイルを保存するには、[File] > [Save Notebook] の順に選択します。
実行のスケジュールの設定
Google Cloud コンソールで、[マネージド ノートブック] ページに移動します。
使用するマネージド ノートブック インスタンスの横にある [Open JupyterLab] をクリックします。
マネージド ノートブック インスタンスで JupyterLab が開きます。
[
File Browser] で、サンプル ノートブック ファイルをダブルクリックして開きます。[ Execute] ボタンをクリックします。
[Submit notebooks to Executor] ダイアログの [Type] フィールドで、[Schedule-based recurring executions] を選択します。
デフォルトでは、エグゼキュータはノートブック ファイルを 1 時間ごとに
00
分実行します。[Advanced options] で、ノートブックを実行するリージョンを選択します。
[Cloud Storage bucket] フィールドでバケット名を入力し、[Create and select] を選択します。エグゼキュータは、この Cloud Storage バケットにノートブックの出力を保存します。
[Submit] をクリックします。
ノートブック ファイルは、設定したスケジュールで自動的に実行されます。
このドキュメントに記載されているタスクの完了後、作成したリソースを削除すると、それ以上の請求は発生しません。詳細については、クリーンアップをご覧ください。
実行されたノートブック ファイルの表示、共有、インポート
マネージド ノートブック インスタンスの JupyterLab インターフェースを使用すると、実行結果の表示、他のユーザーとの共有、実行されたノートブック ファイルの JupyterLab へのインポートを行うことができます。
実行結果を確認する
JupyterLab のナビゲーション メニューで [Notebook Executor] ボタンをクリックします。
[Executions] タブをクリックします。
表示する実行条件の下にある [View result] をクリックします。
エグゼキュータが新しいブラウザタブに結果を表示します。
実行結果を共有する
マネージド ノートブック インスタンスの JupyterLab ユーザー インターフェースで、ナビゲーション メニューで [Notebook Executor] ボタンをクリックします。
[Executions] タブをクリックします。
共有する実行の横にあるオプション メニューをクリックして、[
Share execution result] を選択します。ダイアログの指示に沿って、実行結果へのアクセス権をユーザーに付与します。
実行したノートブックを JupyterLab にインポートする
マネージド ノートブック インスタンスの JupyterLab ユーザー インターフェースで、ナビゲーション メニューで [Notebook Executor] ボタンをクリックします。
[Executions] タブをクリックします。
インポートする実行の横にあるオプション メニューをクリックし、[
Import executed notebook] を選択します。[Select Kernel] ダイアログが表示されたら、ノートブックを開くカーネルを選択します。
エグゼキュータは、実行されたノートブック ファイルを JupyterLab で開きます。JupyterLab ファイル ブラウザで、このノートブック ファイルは imported_notebook_jobs フォルダに保存されています。
スケジュールを表示または削除する
スケジュールを表示および削除するには、Google Cloud コンソールまたはマネージド ノートブック インスタンスの JupyterLab ユーザー インターフェースを使用します。
スケジュールの表示
スケジュールを表示してスケジュールの頻度設定を確認します。また、ノートブック ファイル実行の直近の 5 つの結果を確認することもできます。
コンソール
Google Cloud コンソールで、[スケジュール] ページに移動します。
スケジュールを表示するリージョンを選択します。
表示したいスケジュールの詳細ページで、スケジュールの名前をクリックします。
[スケジュールの詳細] ページに、スケジュールの直近の 5 回の実行が表示されます。
実行名の横の [結果を表示] をクリックして、実行されたノートブック ファイルを開きます。
エグゼキュータが新しいブラウザタブに結果を表示します。
JupyterLab
マネージド ノートブック インスタンスの JupyterLab ユーザー インターフェースで、ナビゲーション メニューで [Notebook Executor] ボタンをクリックします。
[スケジュール] タブをクリックします。
表示する実行の下で、[View latest execution result] をクリックします。
エグゼキュータが新しいブラウザタブに結果を表示します。
スケジュールを削除する
スケジュールを削除しても、そのスケジュールから生成された実行は削除されません。
コンソール
Google Cloud コンソールで、[スケジュール] ページに移動します。
削除するスケジュールが含まれるリージョンを選択します。
削除するスケジュールを選択します。
[
削除] をクリックします。
JupyterLab
マネージド ノートブック インスタンスの JupyterLab ユーザー インターフェースで、ナビゲーション メニューで [Notebook Executor] ボタンをクリックします。
[スケジュール] タブをクリックします。
スケジュール名の最後にある
(Open in new)アイコンをクリックします。Google Cloud コンソールで、そのスケジュールの [スケジュールの詳細] ページが開きます。[
削除] をクリックします。
クリーンアップ
このページで使用したリソースについて、Google Cloud アカウントに課金されないようにするには、次の操作を行います。
インスタンスの削除
Google Cloud コンソールで、[マネージド ノートブック] ページに移動します。
インスタンスが含まれるリージョンを選択します。
削除するマネージド ノートブック インスタンスを選択します。
[
削除] をクリックします。
プロジェクトを削除する
スケジュールの作成に必要な Cloud Storage バケットなど、マネージド ノートブック インスタンス以外のリソースを使用した場合は、それ以上の課金が発生しないように、プロジェクトを削除することをおすすめします。
- In the Google Cloud console, go to the Manage resources page.
- In the project list, select the project that you want to delete, and then click Delete.
- In the dialog, type the project ID, and then click Shut down to delete the project.
次のステップ
- マネージド ノートブック インスタンスの作成方法を確認する。