Vertex AI クライアント ライブラリをインストールする

Google Distributed Cloud（GDC）エアギャップ アプライアンスの Vertex AI クライアント ライブラリを使用すると、未加工のサーバー リクエストを記述することなく、サポートされている言語から Optical Character Recognition（OCR）、Speech-to-Text、Vertex AI Translation、Vertex AI Platform API にプログラムでアクセスできます。CentOS または Ubuntu オペレーティング システムの tar ファイルからクライアント ライブラリを直接抽出してインストールします。

Vertex AI クライアント ライブラリ

Vertex AI には、CentOS と Ubuntu のオペレーティング システム用に異なるバージョンのクライアント ライブラリが用意されています。

tar ファイル内の Vertex AI クライアント ライブラリの命名規則は、オペレーティング システム、サービス名、バージョンに基づいています。ファイル名は次の形式に従います。

OS-google-cloud-SERVICE-VERSION.tar.gz

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

  • OS: クライアント ライブラリをインストールするオペレーティング システムの名前。使用できる値は centos と ubuntu です。

  • SERVICE: クライアント ライブラリをダウンロードする Vertex AI サービスの名前。使用できる値は次のとおりです。

    • aiplatform: Vertex AI Platform クライアント ライブラリ。
    • speech: Speech-to-Text クライアント ライブラリ。
    • translate: Vertex AI Translation クライアント ライブラリ。
    • vision: OCR クライアント ライブラリ。

  • VERSION: クライアント ライブラリのバージョン番号（3.8.0 など）。

次の表に、GDC エアギャップ アプライアンスがサポートする Vertex AI クライアント ライブラリを示します。

Vertex AI サービス オペレーティング システム ファイル名
OCR Centos centos-google-cloud-vision-3.0.0.tar.gz
Ubuntu ubuntu-google-cloud-vision-3.0.0.tar.gz
Speech-to-Text Centos centos-google-cloud-speech-2.15.0.tar.gz
Ubuntu ubuntu-google-cloud-speech-2.15.0.tar.gz
Vertex AI Translation Centos centos-google-cloud-translate-3.8.0.tar.gz
Ubuntu ubuntu-google-cloud-translate-3.8.0.tar.gz
Vertex AI Platform Centos centos-google-cloud-aiplatform-1.34.0.tar.gz
Ubuntu ubuntu-google-cloud-aiplatform-1.34.0.tar.gz

始める前に

tar ファイルをダウンロードしてクライアント ライブラリを抽出する前に、次の手順を行います。

  1. Vertex AI 用のプロジェクトを設定する。

  2. gdcloud CLI を使用して認証します。

    gdcloud auth login

    構成済みの ID プロバイダで認証する方法については、gdcloud CLI 認証をご覧ください。

  3. Cloud AI 閲覧者（cloud-ai-viewer）ロールをサービス アカウントに割り当てます。サービス アカウントが Vertex AI サービスにアクセスするには、このロールが必要です。

  4. Python バージョン 3.7 がインストールされていることを確認します。

クライアント ライブラリをインストールする

前提条件を完了したら、次の手順で tar ファイルをダウンロードし、tar ファイルを使用してクライアント ライブラリをインストールします。

  1. インストールするクライアント ライブラリをダウンロードします。

    wget https://GDC_URL/.well-known/static/client-libraries/CLIENT_LIBRARY

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

  2. ライブラリ ファイルを解凍します。

    tar -zxf CLIENT_LIBRARY

  3. GDC エアギャップ アプライアンスにクライアント ライブラリをインストールします。

    pip install -r FOLDER_NAME/requirements.txt --no-index --find-links FOLDER_NAME

    FOLDER_NAME は、ライブラリ ファイルをダウンロードしたローカル ディレクトリのパスに置き換えます。

  4. Python スクリプトを使用してクライアント ライブラリをインポートします。次の例は、Vertex AI Translation クライアント ライブラリをインポートする Python スクリプトのコード スニペットです。ライブラリのインポートがどのように行われるかを示しています。

    from google.cloud import translate
translate_client = translate.Client(
 client_options={"API_ENDPOINT": "https://foo-translation.googleapis.com"})
result
= translate_client.translate(text, target_language="ru")

[...]

    このコードサンプルは完全ではありません。Vertex AI Translation リクエストを行うには、翻訳機能の詳細をご覧ください。

  5. Python スクリプトを translation-service.py などの名前で保存します。

  6. Python スクリプトを実行します。

    python SCRIPT_NAME

    SCRIPT_NAME は、Python スクリプトに付けた名前（translation-service.py など）に置き換えます。