conda 環境を追加する

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

概要

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

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

始める前に

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

JupyterLab を開く

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

    [インスタンス] に移動

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

    Vertex AI 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

# 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: インストールする conda パッケージ
    • KERNEL_DISPLAY_NAME: JupyterLab インターフェースのカーネルタイルに表示される名前

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

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

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

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

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

conda カーネルを削除する

一部の conda パッケージは、インストール時にデフォルトのカーネルを環境に追加します。たとえば、R をインストールすると、conda により python3 カーネルが追加される場合があります。これにより、環境内でカーネルの重複が発生する可能性があります。カーネルの重複を避けるため、同じ名前の新しいカーネルを作成する前にデフォルトのカーネルを削除します。


rm -rf /opt/conda/envs/CONDA_ENVIRONMENT_NAME/share/jupyter/kernels/python3

インストールの例: R Essentials

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

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

DL_ANACONDA_ENV_HOME="${DL_ANACONDA_HOME}/envs/r>"
python -m ipykernel install --prefix "${DL_ANACONDA_ENV_HOME}" --name r --display-name r
rm -rf /opt/conda/envs/r/share/jupyter/kernels/python3
rm -rf /opt/conda/envs/r/share/jupyter/kernels/ir

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

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

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

トラブルシューティング

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

次のステップ

  • conda の詳細を確認する。