テストを作成または削除する

テストを作成または削除するには、Vertex AI SDK for Python または Google Cloud コンソールを使用します。この SDK は Python コードのライブラリであり、プログラムでテストを作成、管理するために使用できます。このコンソールは、テストを視覚的に作成および管理するために使用できるウェブベースのユーザー インターフェースです。

Google Cloud コンソールを使用して初めてテストを作成する場合は、default メタデータ ストアがあることを確認してください。このことを確認するには、Google Cloud コンソールでプロジェクトの [メタデータ] ページに移動します。プロジェクトのメタデータ ストアを構成するをご覧ください。

TensorBoard インスタンスを使用してテストを作成する

Vertex AI SDK for Python

テストを作成し、必要に応じて Vertex AI SDK for Python を使用して Vertex AI TensorBoard インスタンスを関連付けます。テストの説明を追加して、テストの目的を文書化します。Vertex AI SDK リファレンス ドキュメントの init をご覧ください。

Python

from typing import Optional, Union

from google.cloud import aiplatform


def create_experiment_sample(
    experiment_name: str,
    experiment_description: str,
    experiment_tensorboard: Optional[Union[str, aiplatform.Tensorboard]],
    project: str,
    location: str,
):
    aiplatform.init(
        experiment=experiment_name,
        experiment_description=experiment_description,
        experiment_tensorboard=experiment_tensorboard,
        project=project,
        location=location,
    )

• experiment_name: テストの名前を指定します。
• experiment_description: テストの説明を入力します。
• experiment_tensorboard: 省略可。指定したテストの補助 TensorBoard として使用する Vertex TensorBoard インスタンス。 experiment_tensorboard が指定されていない場合、デフォルトの TB インスタンスが作成され、このテストで使用されます。注: CMEK（暗号鍵）を TensorBoard インスタンスに関連付ける必要がある場合、experiment_tensorboard は省略できません。
• project: 実際のプロジェクト ID。これらの ID は、Google Cloud コンソールの [ようこそ] ページで確認できます。
  
• location: 使用可能なロケーションのリストをご確認ください。TensorBoard インスタンスを作成する場合は、必ず TensorBoard をサポートしているリージョンを使用してください。

Google Cloud コンソール

テストは次の手順に沿って作成します。

1. Google Cloud コンソールで、[テスト] ページに移動します。
   [テスト] に移動
2. テストを作成するプロジェクトにいることを確認します。
   
3. [ 作成] をクリックして、[テスト] ペインを開きます。[テストの作成] ペインが表示されます。
4. [テスト名] フィールドに、テストを一意に識別する名前を入力します。
5. 省略可。[TensorBoard インスタンス] フィールドで、プルダウンからインスタンスを選択するか、新しい TensorBoard インスタンスの名前を入力します。
6. [作成] をクリックしてテストを作成します。

デフォルトの TensorBoard インスタンスなしでテストを作成する

Vertex AI SDK for Python

テストを作成します。テストの説明を追加して、テストの目的を文書化します。Vertex AI SDK リファレンス ドキュメントの init をご覧ください。

Python

from google.cloud import aiplatform


def create_experiment_without_default_tensorboard_sample(
    experiment_name: str,
    experiment_description: str,
    project: str,
    location: str,
):
    aiplatform.init(
        experiment=experiment_name,
        experiment_description=experiment_description,
        experiment_tensorboard=False,
        project=project,
        location=location,
    )

• experiment_name: テストの名前を指定します。
• experiment_description: テストの説明を入力します。
• project: 実際のプロジェクト ID。これらの ID は、Google Cloud コンソールの [ようこそ] ページで確認できます。
  
• location: 使用可能なロケーションのリストをご確認ください。TensorBoard インスタンスを作成する場合は、必ず TensorBoard をサポートしているリージョンを使用してください。

テストを削除する

テストを削除すると、そのテストと、そのテストに関連して実行されるすべてのテストが削除されます。そのテストに関連付けられている Vertex AI TensorBoard テストは削除されません。TensorBoard テストを削除するには、古い Vertex AI TensorBoard テストを削除するをご覧ください。

また、削除されたテストに関連するパイプライン実行、アーティファクト、実行ファイルも削除されません。これらは Google Cloud コンソールにあります。アーティファクトと実行ファイルについては、Vertex ML Metadata サービスにより月額 10 ドル / GB の料金が請求されます。

Vertex AI SDK for Python

次のサンプルでは、ExperimentClass の delete メソッドを使用します。

Python

from google.cloud import aiplatform


def delete_experiment_sample(
    experiment_name: str,
    project: str,
    location: str,
    delete_backing_tensorboard_runs: bool = False,
):
    experiment = aiplatform.Experiment(
        experiment_name=experiment_name, project=project, location=location
    )

    experiment.delete(delete_backing_tensorboard_runs=delete_backing_tensorboard_runs)

• experiment_name: テストの名前を指定します。
• project: 実際のプロジェクト ID。これらの ID は、Google Cloud コンソールの [ようこそ] ページで確認できます。
• location: 利用可能なロケーションの一覧をご確認ください。
• delete_backing_tensorboard_runs: True の場合、時系列指標の保存に使用した、このテストで実行されるテストに関連する Vertex AI TensorBoard の実行も削除されます。

コンソール

実行を削除する手順は次のとおりです。

1. Google Cloud コンソールで、[テスト] ページに移動します。
   [テスト] に移動
2. 削除するテストに関連付けられたチェックボックスをオンにします。[削除] オプションが表示されます。
3. [削除] をクリックします。
   • または、テストと同じ行にある オプション メニューに移動して、[削除] を選択します。

Google Cloud コンソールでテストのリストを表示する

1. Google Cloud コンソールの [Vertex AI] セクションで、[テスト] ページに移動します。

   [テスト] ページに移動

2. 正しいプロジェクトが選択されていることを確認します。

3. プロジェクトのテストのリストが [テスト追跡] ビューに表示されます。
   Vertex AI TensorBoard インスタンスをテストに関連付けている場合は、リストに「テストの名前 Backing TensorBoard Experiment」と表示されます。

次のステップ

• テスト実行を作成して管理する
• 古い Vertex AI TensorBoard テストを削除する

関連するノートブックのサンプル

• 事前構築されたデータの前処理コードを使用したモデルのトレーニング