הוספת סביבת conda למופע של Agent Platform Workbench

בדף הזה מוסבר איך להוסיף סביבת conda למופע של Gemini Enterprise Agent Platform Workbench.

סקירה כללית

כשמוסיפים סביבת conda למופע של Agent Platform Workbench, היא מופיעה כליבה בממשק JupyterLab של המופע.

אפשר להוסיף סביבת conda למופע של Agent Platform Workbench כדי להשתמש בקרנלים שלא זמינים במופעים של Agent Platform Workbench. לדוגמה, אפשר להוסיף סביבות conda ל-R ול-Apache Beam. אפשר גם להוסיף סביבות conda לגרסאות קודמות ספציפיות של המסגרות הזמינות, כמו TensorFlow,‏ PyTorch או Python.

לפני שמתחילים

אם עוד לא עשיתם זאת, צרו מופע של Agent Platform Workbench.

פתיחת JupyterLab

  1. נכנסים לדף Instances במסוף Google Cloud .

    כניסה לדף Instances

  2. לצד השם של מכונת Agent Platform Workbench, לוחצים על Open 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. בוחרים באפשרות קובץ > מרכז אפליקציות חדש.

    הליבה מופיעה בין האפשרויות האחרות בחלון Launcher.

כברירת מחדל, יכול להיות ש-conda ישתמש בחבילות pip בתיקייה pip של המערכת (לדוגמה, /usr/bin/pip). הפעלת conda install pip מבטיחה שההגדרה תשתמש ב-pip מקומי לסביבה.

דוגמה להתקנה: R Essentials

בדוגמה הבאה מותקן R Essentials בסביבת conda בשם r.

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

דוגמה להתקנה: חבילת pip

בדוגמה הבאה מותקנים חבילות pip מקובץ requirements.txt.

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.

המאמרים הבאים