Créer une version spécifique d'une instance

Cette page explique comment créer une version spécifique d'une instance Vertex AI Workbench.

Les raisons de créer une version spécifique

Pour vous assurer que votre instance Vertex AI Workbench dispose d'un logiciel compatible avec votre code ou votre application, vous pouvez créer une version spécifique.

Les images d'instance Vertex AI Workbench sont fréquemment mises à jour, et les versions de logiciels et de packages préinstallés varient d'une version à l'autre.

Pour en savoir plus sur des versions spécifiques de Vertex AI Workbench, consultez les notes de version de Vertex AI.

Après avoir créé une version spécifique d'une instance Vertex AI Workbench, vous pouvez la mettre à niveau. La mise à niveau de l'instance met à jour les logiciels et packages préinstallés. Pour en savoir plus, consultez la section Mettre à niveau l'environnement d'une instance.

Avant de commencer

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  3. Make sure that billing is enabled for your Google Cloud project.

  4. Enable the Notebooks API.

    Enable the API

    5.

  5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  6. Make sure that billing is enabled for your Google Cloud project.

  7. Enable the Notebooks API.

    Enable the API

    8.

Créer une version spécifique

Vous pouvez créer une version spécifique d'une instance Vertex AI Workbench à l'aide de la console Google Cloud ou de Google Cloud CLI.

Console

Pour créer une version spécifique d'une instance Vertex AI Workbench, procédez comme suit:

  1. Lorsque vous créez une instance, dans la section Environnement, sélectionnez Utiliser une version précédente.

  2. Cliquez sur la liste Version, puis sélectionnez une version. Les versions sont numérotées sous la forme d'un élément M suivi du numéro de la version, par exemple M123.

  3. Renseignez le reste de la boîte de dialogue de création d'instance, puis cliquez sur Créer.

    Vertex AI Workbench crée une instance et la démarre automatiquement. Lorsque l'instance est prête à l'emploi, Vertex AI Workbench active automatiquement un lien Ouvrir JupyterLab.

gcloud

Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :

  • INSTANCE_NAME : nom de votre instance Vertex AI Workbench. Doit commencer par une lettre suivie de 62 caractères (lettres minuscules, chiffres ou traits d'union (-)) et ne peut pas se terminer par un trait d'union.
  • PROJECT_ID : ID de votre projet.
  • LOCATION : zone dans laquelle vous souhaitez placer votre instance.
  • VM_IMAGE_NAME: nom de l'image. Pour obtenir la liste des noms d'images disponibles, utilisez la commande get-config.
  • MACHINE_TYPE : type de machine de la VM de votre instance

  • METADATA: métadonnées personnalisées à appliquer à cette instance. Par exemple, pour spécifier un script post-démarrage, vous pouvez utiliser la balise de métadonnées post-startup-script au format : --metadata=post-startup-script=gs://BUCKET_NAME/hello.sh.

Exécutez la commande suivante :

Linux, macOS ou Cloud Shell

gcloud workbench instances create INSTANCE_NAME \
    --project=PROJECT_ID \
    --location=LOCATION \
    --vm-image-project="cloud-notebooks-managed" \
    --vm-image-name=VM_IMAGE_NAME \
    --machine-type=MACHINE_TYPE \
    --metadata=METADATA

Windows (PowerShell)

gcloud workbench instances create INSTANCE_NAME `
    --project=PROJECT_ID `
    --location=LOCATION `
    --vm-image-project="cloud-notebooks-managed" `
    --vm-image-name=VM_IMAGE_NAME `
    --machine-type=MACHINE_TYPE `
    --metadata=METADATA

Windows (cmd.exe)

gcloud workbench instances create INSTANCE_NAME ^
    --project=PROJECT_ID ^
    --location=LOCATION ^
    --vm-image-project="cloud-notebooks-managed" ^
    --vm-image-name=VM_IMAGE_NAME ^
    --machine-type=MACHINE_TYPE ^
    --metadata=METADATA

Pour en savoir plus sur la commande permettant de créer une instance à partir de la ligne de commande, consultez la documentation de gcloud CLI.

Vertex AI Workbench crée une instance et la démarre automatiquement. Lorsque l'instance est prête à l'emploi, Vertex AI Workbench active automatiquement un lien Ouvrir JupyterLab dans la console Google Cloud.

Étape suivante