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

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

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. テストを作成するプロジェクトにいることを確認します。
    Vertex AI のプロジェクトを選択
  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. 削除するテストに関連付けられたチェックボックスをオンにします。[Delete] オプションが表示されます。
  3. [Delete] をクリックします。
    • または、テストと同じ行にある オプション メニューに移動して、[削除] を選択します。

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

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

    [テスト] ページに移動

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

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

Vertex AI のテストリスト

次のステップ

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