conda 환경 추가

이 페이지에서는 Gemini Enterprise Agent Platform Workbench 인스턴스에 conda 환경을 추가하는 방법을 설명합니다.

개요

Agent Platform Workbench 인스턴스에 conda 환경을 추가하면 인스턴스의 JupyterLab 인터페이스에 커널로 표시됩니다.

Agent Platform Workbench 인스턴스에서 사용할 수 없는 커널을 사용하기 위해 Agent Platform Workbench 인스턴스에 conda 환경을 추가할 수 있습니다. 예를 들어 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 환경 추가

인스턴스의 JupyterLab 터미널에 명령어를 입력하여 conda 환경을 추가할 수 있습니다.

  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. 파일 > 새 런처를 선택합니다.

    커널은 런처 창에 다른 커널과 나열됩니다.

기본적으로 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 문제 해결을 참조하세요.

다음 단계