マネージド ノートブックの実行をスケジュールする

マネージド ノートブックの実行をスケジュールする

Vertex AI Workbench マネージド ノートブックは非推奨になりました。2025 年 1 月 30 日にマネージド ノートブックのサポートが終了し、マネージド ノートブック インスタンスを作成する機能が削除されます。既存のインスタンスは引き続き機能しますが、パッチ、更新、アップグレードは利用できなくなります。Vertex AI Workbench を引き続き使用するには、マネージド ノートブック インスタンスを Vertex AI Workbench インスタンスに移行することをおすすめします。

このページでは、Vertex AI Workbench マネージド ノートブック エグゼキュータを使用して、Python ノートブック ファイルを 1 時間ごとに実行する方法について説明します。

始める前に

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.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

4. Enable the Notebooks and Vertex AI APIs.

   Enable the APIs

5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

6. Make sure that billing is enabled for your Google Cloud project.

7. Enable the Notebooks and Vertex AI APIs.

   Enable the APIs

必要なロール

インスタンスのサービス アカウントに Vertex AI Workbench エグゼキュータの操作に必要な権限を付与するには、プロジェクトに対する次の IAM ロールをインスタンスのサービス アカウントに付与するよう管理者に依頼してください。

• Notebooks 閲覧者（roles/notebooks.viewer）
• Vertex AI ユーザー（roles/aiplatform.user）
• ストレージ管理者（roles/storage.admin）

ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。

管理者は、インスタンスのサービス アカウントに、カスタムロールや他の事前定義ロールを使用して必要な権限を付与することもできます。

マネージド ノートブック インスタンスとサンプル ノートブック ファイルを作成する

1. マネージド ノートブック インスタンスを作成する。

2. JupyterLab を開く。

3. 新しいノートブック ファイルを開きます。

4. ノートブック ファイルの最初のセルに、次のように入力します。

   # Import datetime
   import datetime
   
   # Get the time and print it
   datetime.datetime.now()
   print(datetime.datetime.now())

5. ノートブック ファイルを保存するには、[File] > [Save Notebook] の順に選択します。

実行のスケジュールの設定

1. Google Cloud コンソールで、[マネージド ノートブック] ページに移動します。

   [マネージド ノートブック] に移動

2. 使用するマネージド ノートブック インスタンスの横にある [Open JupyterLab] をクリックします。

   マネージド ノートブック インスタンスで JupyterLab が開きます。

3. [File Browser] で、サンプル ノートブック ファイルをダブルクリックして開きます。

4. [ Execute] ボタンをクリックします。

5. [Submit notebooks to Executor] ダイアログの [Type] フィールドで、[Schedule-based recurring executions] を選択します。

   デフォルトでは、エグゼキュータはノートブック ファイルを 1 時間ごとに 00 分実行します。

6. [Advanced options] で、ノートブックを実行するリージョンを選択します。

7. [Cloud Storage bucket] フィールドでバケット名を入力し、[Create and select] を選択します。エグゼキュータは、この Cloud Storage バケットにノートブックの出力を保存します。

8. [Submit] をクリックします。

   ノートブック ファイルは、設定したスケジュールで自動的に実行されます。

注: マネージド ノートブック インスタンスがシャットダウンされても、エグゼキュータはスケジュールに従ってノートブック ファイルを実行します。

このドキュメントに記載されているタスクの完了後、作成したリソースを削除すると、それ以上の請求は発生しません。詳細については、クリーンアップをご覧ください。

実行されたノートブック ファイルの表示、共有、インポート

マネージド ノートブック インスタンスの JupyterLab インターフェースを使用すると、実行結果の表示、他のユーザーとの共有、実行されたノートブック ファイルの JupyterLab へのインポートを行うことができます。

注: Google Cloud コンソールで実行結果を表示して共有するには、[実行] ページで [実行数] をクリックします。

実行結果を確認する

1. JupyterLab のナビゲーション メニューで [Notebook Executor] ボタンをクリックします。

2. [Executions] タブをクリックします。

3. 表示する実行条件の下にある [View result] をクリックします。

   エグゼキュータが新しいブラウザタブに結果を表示します。

実行結果を共有する

1. マネージド ノートブック インスタンスの JupyterLab ユーザー インターフェースで、ナビゲーション メニューで [Notebook Executor] ボタンをクリックします。

2. [Executions] タブをクリックします。

3. 共有する実行の横にあるオプション メニューをクリックして、[Share execution result] を選択します。

4. ダイアログの指示に沿って、実行結果へのアクセス権をユーザーに付与します。

実行したノートブックを JupyterLab にインポートする

1. マネージド ノートブック インスタンスの JupyterLab ユーザー インターフェースで、ナビゲーション メニューで [Notebook Executor] ボタンをクリックします。

2. [Executions] タブをクリックします。

3. インポートする実行の横にあるオプション メニューをクリックし、[Import executed notebook] を選択します。

4. [Select Kernel] ダイアログが表示されたら、ノートブックを開くカーネルを選択します。

   エグゼキュータは、実行されたノートブック ファイルを JupyterLab で開きます。JupyterLab ファイル ブラウザで、このノートブック ファイルは imported_notebook_jobs フォルダに保存されています。

スケジュールを表示または削除する

スケジュールを表示および削除するには、Google Cloud コンソールまたはマネージド ノートブック インスタンスの JupyterLab ユーザー インターフェースを使用します。

スケジュールの表示

スケジュールを表示してスケジュールの頻度設定を確認します。また、ノートブック ファイル実行の直近の 5 つの結果を確認することもできます。

コンソール

1. Google Cloud コンソールで、[スケジュール] ページに移動します。

   [スケジュール] に移動

2. スケジュールを表示するリージョンを選択します。

3. 表示したいスケジュールの詳細ページで、スケジュールの名前をクリックします。

   [スケジュールの詳細] ページに、スケジュールの直近の 5 回の実行が表示されます。

4. 実行名の横の [結果を表示] をクリックして、実行されたノートブック ファイルを開きます。

   エグゼキュータが新しいブラウザタブに結果を表示します。

JupyterLab

1. マネージド ノートブック インスタンスの JupyterLab ユーザー インターフェースで、ナビゲーション メニューで [Notebook Executor] ボタンをクリックします。

2. [スケジュール] タブをクリックします。

3. 表示する実行の下で、[View latest execution result] をクリックします。

   エグゼキュータが新しいブラウザタブに結果を表示します。

スケジュールを削除する

スケジュールを削除しても、そのスケジュールから生成された実行は削除されません。

コンソール

1. Google Cloud コンソールで、[スケジュール] ページに移動します。

   [スケジュール] に移動

2. 削除するスケジュールが含まれるリージョンを選択します。

3. 削除するスケジュールを選択します。

4. [削除] をクリックします。

JupyterLab

1. マネージド ノートブック インスタンスの JupyterLab ユーザー インターフェースで、ナビゲーション メニューで [Notebook Executor] ボタンをクリックします。

2. [スケジュール] タブをクリックします。

3. スケジュール名の最後にある （Open in new）アイコンをクリックします。Google Cloud コンソールで、そのスケジュールの [スケジュールの詳細] ページが開きます。

4. [削除] をクリックします。

クリーンアップ

このページで使用したリソースについて、Google Cloud アカウントに課金されないようにするには、次の操作を行います。

インスタンスの削除

1. Google Cloud コンソールで、[マネージド ノートブック] ページに移動します。

   [マネージド ノートブック] に移動

2. インスタンスが含まれるリージョンを選択します。

3. 削除するマネージド ノートブック インスタンスを選択します。

4. [削除] をクリックします。

プロジェクトを削除する

スケジュールの作成に必要な Cloud Storage バケットなど、マネージド ノートブック インスタンス以外のリソースを使用した場合は、それ以上の課金が発生しないように、プロジェクトを削除することをおすすめします。

注意: プロジェクトを削除すると、次のような影響があります。

• プロジェクト内のすべてのものが削除されます。このドキュメントのタスクで既存のプロジェクトを使用した場合、それを削除すると、そのプロジェクトで行った他の作業もすべて削除されます。
• カスタム プロジェクト ID が失われます。このプロジェクトを作成したときに、将来使用するカスタム プロジェクト ID を作成した可能性があります。そのプロジェクト ID を使用した URL（たとえば、appspot.com）を保持するには、プロジェクト全体ではなくプロジェクト内の選択したリソースだけを削除します。

複数のアーキテクチャ、チュートリアル、クイックスタートを実施する予定がある場合は、プロジェクトを再利用すると、プロジェクトの割り当て上限を超えないようにすることができます。

1. In the Google Cloud console, go to the Manage resources page.

   Go to Manage resources

2. In the project list, select the project that you want to delete, and then click Delete.
3. In the dialog, type the project ID, and then click Shut down to delete the project.

次のステップ

• マネージド ノートブック インスタンスの作成方法を確認する。

より包括的なワークフローの一部としてノートブックの実行をスケジュールする方法の例を確認する。次のいずれかの環境で Jupyter ノートブック「広告のターゲット設定用にマルチクラス分類モデルをトレーニングする」を実行します。

Colab で開く | Colab Enterprise で開く | Vertex AI Workbench のユーザー管理のノートブックで開く | GitHub で表示する