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 を開く
Google Cloud コンソールで、[インスタンス] ページに移動します。
Vertex AI Workbench インスタンス名の横にある [JupyterLab を開く] をクリックします。
Vertex AI Workbench インスタンスで JupyterLab が表示されます。
conda 環境を追加する
conda 環境を追加するには、インスタンスの JupyterLab ターミナルにコマンドを入力します。
JupyterLab で、[File] > [New] > [Terminal] を選択します。
[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 インターフェースのカーネルタイルに表示される名前
新しいカーネルを表示するには、次の手順を行います。
ページを更新してください。
[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 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 の詳細を確認する。
conda 環境を変更する。conda 環境を管理するをご覧ください。