プロジェクトと開発環境を設定する

このガイドでは、Vertex AI Vision の使用を開始するために Google Cloud プロジェクトを設定する方法について説明します。

プロジェクトを設定する

  1. Google Cloud アカウントにログインします。 Google Cloudを初めて使用する場合は、 アカウントを作成して、実際のシナリオでの Google プロダクトのパフォーマンスを評価してください。新規のお客様には、ワークロードの実行、テスト、デプロイができる無料クレジット $300 分を差し上げます。

  2. Google Cloud CLI をインストールします。

  3. 外部 ID プロバイダ（IdP）を使用している場合は、まず連携 ID を使用して gcloud CLI にログインする必要があります。

  4. gcloud CLI を初期化するには、次のコマンドを実行します。

    gcloud init

  5. Google Cloud プロジェクトを作成または選択します。

    プロジェクトの選択または作成に必要なロール

    • プロジェクトを選択する: プロジェクトの選択に特定の IAM ロールは必要ありません。ロールが付与されているプロジェクトであれば、どのプロジェクトでも選択できます。
    • プロジェクトを作成する: プロジェクトを作成するには、resourcemanager.projects.create 権限を含むプロジェクト作成者ロール（roles/resourcemanager.projectCreator）が必要です。ロールを付与する方法を確認する。

    • Google Cloud プロジェクトを作成します。

      gcloud projects create PROJECT_ID

      PROJECT_ID は、作成する Google Cloud プロジェクトの名前に置き換えます。

    • 作成した Google Cloud プロジェクトを選択します。

      gcloud config set project PROJECT_ID

      PROJECT_ID は、 Google Cloud プロジェクトの名前に置き換えます。

  6. Google Cloud プロジェクトに対して課金が有効になっていることを確認します。

  7. Vertex AI Vision API を有効にします。

    API を有効にするために必要なロール

    API を有効にするには、serviceusage.services.enable 権限を含む Service Usage 管理者 IAM ロール（roles/serviceusage.serviceUsageAdmin）が必要です。ロールを付与する方法を確認する。

    gcloud services enable visionai.googleapis.com

  8. 認証を設定します。

    1. サービス アカウントの作成 IAM ロール（roles/iam.serviceAccountCreator）とプロジェクト IAM 管理者ロール（roles/resourcemanager.projectIamAdmin）があることを確認します。ロールを付与する方法を確認する。

    2. サービス アカウントを作成します。

      gcloud iam service-accounts create SERVICE_ACCOUNT_NAME

      SERVICE_ACCOUNT_NAME をサービス アカウントの名前に置き換えます。

    3. サービス アカウントに roles/visionai.editor IAM ロールを付与します。

      gcloud projects add-iam-policy-binding PROJECT_ID --member="serviceAccount:SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com" --role=roles/visionai.editor

      以下を置き換えます。

      • SERVICE_ACCOUNT_NAME: サービス アカウントの名前
      • PROJECT_ID: サービス アカウントを作成したプロジェクト ID

    4. 鍵ファイルを生成します。

      gcloud iam service-accounts keys create FILE_NAME.json --iam-account=SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com

      次のように置き換えます。

      • FILE_NAME: 鍵ファイルの名前
      • SERVICE_ACCOUNT_NAME: サービス アカウントの名前
      • PROJECT_ID: サービス アカウントを作成したプロジェクト ID

  9. 環境変数 GOOGLE_APPLICATION_CREDENTIALS を、認証情報を含む JSON ファイルのパスに設定します。この変数は現在のシェル セッションにのみ適用されるため、新しいセッションを開く場合は、変数を再度設定する必要があります。

  10. Google Cloud CLI をインストールします。

  11. 外部 ID プロバイダ（IdP）を使用している場合は、まず連携 ID を使用して gcloud CLI にログインする必要があります。

  12. gcloud CLI を初期化するには、次のコマンドを実行します。

    gcloud init

  13. Google Cloud プロジェクトを作成または選択します。

    プロジェクトの選択または作成に必要なロール

    • プロジェクトを選択する: プロジェクトの選択に特定の IAM ロールは必要ありません。ロールが付与されているプロジェクトであれば、どのプロジェクトでも選択できます。
    • プロジェクトを作成する: プロジェクトを作成するには、resourcemanager.projects.create 権限を含むプロジェクト作成者ロール（roles/resourcemanager.projectCreator）が必要です。ロールを付与する方法を確認する。

    • Google Cloud プロジェクトを作成します。

      gcloud projects create PROJECT_ID

      PROJECT_ID は、作成する Google Cloud プロジェクトの名前に置き換えます。

    • 作成した Google Cloud プロジェクトを選択します。

      gcloud config set project PROJECT_ID

      PROJECT_ID は、 Google Cloud プロジェクトの名前に置き換えます。

  14. Google Cloud プロジェクトに対して課金が有効になっていることを確認します。

  15. Vertex AI Vision API を有効にします。

    API を有効にするために必要なロール

    API を有効にするには、serviceusage.services.enable 権限を含む Service Usage 管理者 IAM ロール（roles/serviceusage.serviceUsageAdmin）が必要です。ロールを付与する方法を確認する。

    gcloud services enable visionai.googleapis.com

  16. 認証を設定します。

    1. サービス アカウントの作成 IAM ロール（roles/iam.serviceAccountCreator）とプロジェクト IAM 管理者ロール（roles/resourcemanager.projectIamAdmin）があることを確認します。ロールを付与する方法を確認する。

    2. サービス アカウントを作成します。

      gcloud iam service-accounts create SERVICE_ACCOUNT_NAME

      SERVICE_ACCOUNT_NAME をサービス アカウントの名前に置き換えます。

    3. サービス アカウントに roles/visionai.editor IAM ロールを付与します。

      gcloud projects add-iam-policy-binding PROJECT_ID --member="serviceAccount:SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com" --role=roles/visionai.editor

      以下を置き換えます。

      • SERVICE_ACCOUNT_NAME: サービス アカウントの名前
      • PROJECT_ID: サービス アカウントを作成したプロジェクト ID

    4. 鍵ファイルを生成します。

      gcloud iam service-accounts keys create FILE_NAME.json --iam-account=SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com

      次のように置き換えます。

      • FILE_NAME: 鍵ファイルの名前
      • SERVICE_ACCOUNT_NAME: サービス アカウントの名前
      • PROJECT_ID: サービス アカウントを作成したプロジェクト ID

  17. 環境変数 GOOGLE_APPLICATION_CREDENTIALS を、認証情報を含む JSON ファイルのパスに設定します。この変数は現在のシェル セッションにのみ適用されるため、新しいセッションを開く場合は、変数を再度設定する必要があります。

    18.

一部のタスクでは、Vertex AI Vision に加えて追加のGoogle Cloud プロダクトを使用する必要があります。他の Google Cloud プロダクトを使用するには、追加の設定作業が必要になる場合があります。

Vertex AI Vision SDK

Vertex AI Vision ソフトウェア開発キット（SDK）には、Vertex AI Vision でプログラムとカスタム ワークフローを開発するためのツールとライブラリが含まれています。

これらのツールは、Vertex AI Vision を使用または使用してソリューションを開発する際の生産性を高めるのに役立つバイナリ ソースファイルのセットを指します。これらのバイナリ ソースファイルをスクリプトに追加して、大規模なデプロイの管理に役立てることもできます。このカテゴリの例として、コマンドライン インターフェース（CLI）vaictl があります。

ライブラリとは、Vertex AI Vision でさまざまな形式の I/O をプログラムで管理、制御、実行するために使用できるプログラミング API のセットを指します。このカテゴリの例としては、C++ プログラミング API があります。

ツールとライブラリの両方のコードはオープンソースであり、デベロッパーが直接構築することを歓迎します。ツールについては、特定のプラットフォームで事前構築済みのバイナリ ファイルも提供しています。このファイルはダウンロードして直接使用できます。プラットフォームが直接サポートされていない場合は、Docker イメージも提供しています。

前提条件

Vertex AI Vision SDK を使用する前に、次の前提条件を確認してください。

対応プラットフォーム

現在、Debian ベースの Linux ディストリビューションを実行する x86 マシンのみを直接サポートしています。別のプラットフォームを使用している場合は、ツールがすでにビルドされてインストールされている Docker イメージも提供しています。

その他のソフトウェア要件

Vertex AI Vision SDK が必要とするサードパーティ ソフトウェアの依存関係のほとんどは、事前構築済みバイナリをインストールすると自動的に管理されます。ただし、SDK の機能とワークフローの特定の側面を使用するには、追加の依存関係をインストールする必要があります。このセクションでは、これらの例外と、そのダウンロードとインストール方法について説明します。

Python SDK

Python pip パッケージは、すべての依存関係を自動的にインストールします。ただし、基本的な基盤となる Python インストールは、次の条件を満たしている必要があります。

  • Python >= 3.8。

ソースからのビルドの依存関係

ほとんどのユーザーは、ワークフローにビルド済みの SDK バイナリを使用できます。ソースから SDK を開発してビルドする場合は、システムが次の要件を満たしていることも確認する必要があります。

  • Bazel をインストールします。インストール手順については、Bazel のドキュメントをご覧ください。

  • Ubuntu 20.04 では、いくつかのシステム依存関係も必要です。次のコマンドを使用してインストールできます。

    apt-get install -y --no-install-recommends \
    autoconf \
    automake \
    build-essential \
    ca-certificates \
    flex \
    bison \
    python3 \
    nasm \
    libjpeg-dev

ビルド済みのバイナリを取得する

vaictl ツールは、Vertex AI Vision の制御に使用できるだけでなく、処理するデータの送受信にも使用できる既製のバイナリツールです。

このセクションでは、このツールをダウンロードしてインストールする方法について説明します。

Debian パッケージをインストールする

I/O（ストリーム データ）を操作するために必要な vaictl コマンドライン ツールを使用するには、次の 2 つの方法があります。

  • コマンドライン ツールをローカルにインストールする（OS: Debian GNU/Linux、CPU アーキテクチャ: x86_64）または
  • すべての依存関係がインストールされている Docker イメージでコマンドを実行します。

vaictl コマンドライン ツールを取得する手順は次のとおりです。

パッケージをダウンロードする

直接インストールの場合、現在サポートされているのは Debian/Ubuntu ディストリビューションのみです。

この Debian パッケージは、Vertex AI Vision SDK の GitHub リリース ページからダウンロードすることもできます。

  1. （省略可）以前のバージョンの vaictl を削除します。

    vaictl コマンドライン ツールをインストールする前に、お使いのマシンにこのツールの以前のバージョンがあれば削除する必要があります。

    sudo apt-get remove visionai
  2. 必要なパッケージをダウンロードします。パッケージは GitHub リリース ページからダウンロードするか、次のコマンドを使用します。
    wget https://github.com/google/visionai/releases/download/v0.0.5/visionai_0.0-5_amd64.deb
  3. パッケージをダウンロードしたら、ファイルをダウンロードしたディレクトリで次のコマンドを実行します。
    sudo apt install ./visionai_0.0-5_amd64.deb
  4. インストールを確認します。
    vaictl --help

Docker を入手する

Vertex AI Vision SDK とそのすべての依存関係がすでにプリインストールされている Docker イメージを取得できます。この Docker イメージは gcr.io/visionai-public-images/vaictl で入手できます。

  1. Container Registry からイメージをダウンロードします。
    docker pull gcr.io/visionai-public-images/vaictl
  2. インタラクティブ コンテナ ターミナルを実行します。
    docker run -it --rm gcr.io/visionai-public-images/vaictl /bin/bash
  3. 機能を確認します。 
    vaictl --help

ソースコードを取得する

Vertex AI Vision SDK はオープンソースであり、GitHub で公開されています。

SDK はサービス API 定義に依存しますが、この依存関係は Bazel によって自動的に管理されるため、明示的に取得する必要はありません。ただし、サービス API に直接アクセスする必要がある場合は、googleapis GitHub リポジトリで取得できます。

Python プログラミング SDK

Vertex AI Vision は Python SDK もサポートしています。この SDK を使用してプログラミングするには、Python SDK をインストールする前に、Python SDK の基本的な依存関係を満たしていることを確認してください。

SDK リファレンス情報については、Python SDK リファレンスをご覧ください。

Python SDK を使用するコード例については、Python SDK を使用した顔のぼかしチュートリアルを参照するか、visionai/python/examples/ ディレクトリのソース ディストリビューションにある例を参照してください。

Python SDK パッケージを取得する

Vertex AI Vision SDK には Python ライブラリも含まれています。次の手順に沿って、Python SDK のビルド済みバージョンをダウンロードしてインストールします。

  1. パッケージをダウンロードします。

    Python SDK パッケージは、Vertex AI Vision SDK の GitHub リリース ページからダウンロードできます。または、次のコマンドを実行することもできます。

    wget https://github.com/google/visionai/releases/download/v0.0.5/visionai-0.0.5-py3-none-any.whl

  2. 省略可。新しい仮想環境を作成して有効にします。

    python3 -m venv vaivenv
source vaivenv/bin/activate

  3. パッケージをインストールします。

    pip3 install visionai-0.0.5-py3-none-any.whl

  4. 省略可。インストールが機能したことを確認します。

    python3

    import visionai

  5. 省略可。仮想環境を無効にします。

    deactivate

C++ プログラミング SDK

C++ は、Google がサポートする最初のプログラミング SDK です。C++ 公開 SDK は visionai/public/streams.h にあります。リファレンス情報については、リファレンス ドキュメントをご覧ください。

次のステップ

前へ
クイックスタート: コンソールでアプリをビルドする