Menambahkan lingkungan conda

Halaman ini menjelaskan cara menambahkan lingkungan conda ke instance Vertex AI Workbench.

Ringkasan

Saat Anda menambahkan lingkungan conda ke instance Vertex AI Workbench, lingkungan tersebut akan muncul sebagai kernel di antarmuka JupyterLab instance Anda.

Anda dapat menambahkan lingkungan conda ke instance Vertex AI Workbench untuk menggunakan kernel yang tidak tersedia di instance Vertex AI Workbench. Misalnya, Anda dapat menambahkan lingkungan conda untuk R dan Apache Beam. Atau, Anda dapat menambahkan lingkungan conda untuk versi lama tertentu dari framework yang tersedia, seperti TensorFlow, PyTorch, atau Python.

Sebelum memulai

Jika belum melakukannya, buat instance Vertex AI Workbench.

Membuka JupyterLab

  1. Di konsol Google Cloud, buka halaman Instance.

    Buka Instance

  2. Di samping nama instance Vertex AI Workbench, klik Buka JupyterLab.

    Instance Vertex AI Workbench akan membuka JupyterLab.

Menambahkan lingkungan conda

Anda dapat menambahkan lingkungan conda dengan memasukkan perintah di terminal JupyterLab instance Anda.

  1. Di JupyterLab, pilih File > Baru > Terminal.

  2. Di jendela Terminal, masukkan perintah berikut:

    
# 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

    Ganti kode berikut:

    • CONDA_ENVIRONMENT_NAME: pilihan nama Anda untuk lingkungan
    • PACKAGE: paket conda yang ingin Anda instal
    • KERNEL_DISPLAY_NAME: nama tampilan untuk tile kernel di antarmuka JupyterLab

  3. Untuk melihat kernel baru, lakukan hal berikut:

    1. Muat ulang halaman.

    2. Pilih File > New Launcher.

    Kernel tercantum di antara yang lain di jendela Peluncur.

Secara default, conda mungkin menggunakan paket pip dalam folder pip sistem (misalnya, /usr/bin/pip). Menjalankan conda install pip akan memastikan bahwa penyiapan menggunakan pip lokal ke lingkungan.

Memodifikasi kernel konda

Instance Vertex AI Workbench dilengkapi dengan framework yang telah diinstal sebelumnya, seperti PyTorch dan TensorFlow. Jika memerlukan versi yang berbeda, Anda dapat memodifikasi library dengan menggunakan pip di lingkungan kondensasi yang relevan.

Misalnya, jika Anda ingin mengupgrade PyTorch:


# Check name of the conda environment for PyTorch
conda env list

# Activates the environment for PyTorch
conda activate pytorch

# Display the PyTorch version
python -c "import torch; print(torch.__version__)"

# Ensures that we use pip from the conda environment for PyTorch
# Should be `/opt/conda/envs/pytorch/bin/pip`
which pip

# Upgrades PyTorch
pip install --upgrade torch

Menghapus kernel konda

Beberapa paket kondom menambahkan kernel default ke lingkungan Anda saat paket diinstal. Misalnya, saat Anda menginstal R, konden juga mungkin menambahkan kernel python3. Hal ini dapat menyebabkan duplikasi kernel di lingkungan Anda. Untuk menghindari kernel duplikat, hapus kernel default sebelum Anda membuat kernel baru dengan nama yang sama.


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

Contoh penginstalan: R Essentials

Contoh berikut menginstal R Essentials di lingkungan conda bernama r.

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

Contoh penginstalan: paket pip

Contoh berikut menginstal paket pip dari file requirements.txt.

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

Memecahkan masalah

Untuk mendiagnosis dan menyelesaikan masalah terkait penambahan lingkungan kondensasi, lihat Memecahkan Masalah Vertex AI Workbench.

Langkah selanjutnya

  • Pelajari conda lebih lanjut.