Aggiungi un ambiente conda

Questa pagina descrive come aggiungere un ambiente conda al tuo Vertex AI Workbench.

Panoramica

Quando aggiungi un ambiente conda dell'istanza di Vertex AI Workbench, apparirà come kernel nell'interfaccia JupyterLab della tua istanza.

Potresti aggiungere un ambiente conda all'istanza di Vertex AI Workbench per utilizzare i kernel non disponibili nelle istanze di Vertex AI Workbench. Ad esempio, puoi aggiungere ambienti conda per R e Apache Beam. Oppure tu è possibile aggiungere ambienti conda per specifiche versioni precedenti come TensorFlow, PyTorch o Python.

Prima di iniziare

Se non l'hai già fatto, creazione un'istanza di Vertex AI Workbench.

Apri JupyterLab

  1. Nella console Google Cloud, vai alla pagina Istanze.

    Vai a Istanze

  2. Accanto al nome dell'istanza di Vertex AI Workbench, fai clic su Apri JupyterLab.

    La tua istanza di Vertex AI Workbench apre JupyterLab.

Aggiungi un ambiente conda

Puoi aggiungere un ambiente conda inserendo i comandi nel Terminale JupyterLab.

  1. In JupyterLab, Seleziona File > Nuovo > Terminale.

  2. Nella finestra Terminale, inserisci i seguenti comandi:

    
# 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

    Sostituisci quanto segue:

    • CONDA_ENVIRONMENT_NAME: scegli tra nome dell'ambiente
    • PACKAGE: il pacchetto conda che vuoi installare
    • KERNEL_DISPLAY_NAME: il nome visualizzato per il riquadro del kernel nell'interfaccia JupyterLab

  3. Per vedere il nuovo kernel, segui questi passaggi:

    1. Aggiorna la pagina.

    2. Seleziona File > Nuovo Avvio app.

    Il kernel è elencato tra gli altri nella finestra Avvio app.

Per impostazione predefinita, conda potrebbe utilizzare pacchetti pip nella cartella di sistema pip (ad es. /usr/bin/pip). L'esecuzione di conda install pip assicura che la configurazione utilizza un pip locale nell'ambiente.

Esempio di installazione: R Essentials

L'esempio seguente installa R Essentials in un ambiente conda denominato r.

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

Esempio di installazione: pacchetto pip

Nell'esempio seguente, i pacchetti pip vengono installati da un 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

Risoluzione dei problemi

Per diagnosticare e risolvere i problemi relativi all'aggiunta di un ambiente conda, consulta la sezione Risoluzione dei problemi Vertex AI Workbench.

Passaggi successivi