Agent Platform Workbench インスタンスに conda 環境を追加する

このページでは、Gemini Enterprise Agent Platform Workbench インスタンスに conda 環境を追加する方法について説明します。

概要

Agent Platform Workbench インスタンスに conda 環境を追加すると、インスタンスの JupyterLab インターフェースにカーネルとして表示されます。

Agent Platform Workbench インスタンスに conda 環境を追加すると、Agent Platform Workbench インスタンスでは使用できないカーネルを使用することもできます。 たとえば、R と Apache Beam の conda 環境を追加できます。また、TensorFlow、PyTorch、Python など、利用可能なフレームワークの古いバージョン用の conda 環境を追加することもできます。

始める前に

まだ作成していない場合は、 Agent Platform Workbench インスタンスを作成します。

JupyterLab を開く

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

    [インスタンス] に移動

  2. Agent Platform Workbench インスタンス名の横にある [JupyterLab を開く] をクリックします。

    Agent Platform Workbench インスタンスで JupyterLab が表示されます。

conda 環境を追加する

conda 環境を追加するには、インスタンスの JupyterLab ターミナルにコマンドを入力します。

  1. JupyterLab で、[File] > [New] > [Terminal] を選択します。

  2. [Terminal] ウィンドウで、次のコマンドを入力します。

    # Creates a conda environment.
conda create -n CONDA_ENVIRONMENT_NAME -y
conda activate CONDA_ENVIRONMENT_NAME

# Install packages using a pip local to the conda environment.
conda install pip
pip install PACKAGE
pip install ipykernel

# Adds the conda kernel.
DL_ANACONDA_ENV_HOME="${DL_ANACONDA_HOME}/envs/CONDA_ENVIRONMENT_NAME"
python -m ipykernel install --prefix "${DL_ANACONDA_ENV_HOME}" --name CONDA_ENVIRONMENT_NAME --display-name KERNEL_DISPLAY_NAME

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

    • CONDA_ENVIRONMENT_NAME: 環境の名前
    • PACKAGE: インストールするパッケージ
    • KERNEL_DISPLAY_NAME: JupyterLab インターフェースのカーネルタイルに表示される名前

  3. デフォルトのカーネルは、特定の conda 環境にインストールするときに作成できます。デフォルトのカーネルの削除は、次のコマンドで行えます。

    rm -rf "/opt/micromamba/envs/CONDA_ENVIRONMENT_NAME/share/jupyter/kernels/python3

  4. 新しいカーネルを表示するには、次の手順を行います。

    1. ページを更新してください。

    2. [File] > [New Launcher] を選択します。

    カーネルは [Launcher] ウィンドウに表示されます。

デフォルトでは、conda はシステムの pip フォルダの pip パッケージを使用します（/usr/bin/pip など）。conda install pip を実行すると、セットアップで環境にローカルな pip が使用されます。

インストールの例: R Essentials

次の例では、r という名前の conda 環境に R Essentials をインストールします。

conda create -n r
conda activate r
conda install -c r r-essentials

インストールの例: pip パッケージ

次の例では、requirements.txt ファイルから pip パッケージをインストールします。

conda create -n myenv
conda activate myenv
conda install pip
pip install -r requirements.txt
pip install ipykernel
DL_ANACONDA_ENV_HOME="${DL_ANACONDA_HOME}/envs/myenv"
python -m ipykernel install --prefix "${DL_ANACONDA_ENV_HOME}" --name myenv --display-name myenv

トラブルシューティング

conda 環境の追加に関連する問題を診断して解決するには、 トラブルシューティング Agent Platform Workbenchをご覧ください。

次のステップ