Creazione di una versione specifica di un'istanza

Questa pagina descrive come creare una versione specifica di un'istanza di Vertex AI Workbench.

Perché potresti voler creare una versione specifica

Per assicurarti che la tua istanza di Vertex AI Workbench abbia un software compatibile con il tuo codice o la tua applicazione, potresti voler creare una versione specifica.

Le immagini delle istanze di Vertex AI Workbench vengono aggiornate di frequente e le versioni specifiche del software e dei pacchetti preinstallati variano da versione a versione.

Per saperne di più sulle versioni specifiche di Vertex AI Workbench, consulta le note di rilascio di Vertex AI.

Dopo aver creato una versione specifica di un'istanza di Vertex AI Workbench, puoi eseguirne l'upgrade. L'upgrade dell'istanza aggiorna il software e i pacchetti preinstallati. Per saperne di più, consulta Eseguire l'upgrade dell'ambiente di un'istanza.

Prima di iniziare

  1. Accedi al tuo Google Cloud account. Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti senza costi per l'esecuzione, il test e il deployment dei workload.

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

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. Enable the Notebooks API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

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

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  6. Verify that billing is enabled for your Google Cloud project.

  7. Enable the Notebooks API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

    8.

Creare una versione specifica

Puoi creare una versione specifica di un'istanza di Vertex AI Workbench utilizzando la Google Cloud console o Google Cloud CLI.

Console

Per creare una versione specifica di un'istanza di Vertex AI Workbench:

  1. Quando crei un'istanza, nella sezione Ambiente, seleziona Utilizza una versione precedente.

  2. Fai clic sull'elenco Versione e seleziona una versione. Le versioni sono numerate nel formato di un M seguito dal numero di rilascio, ad esempio M123.

  3. Completa il resto della finestra di dialogo di creazione dell'istanza, quindi fai clic su Crea.

    Vertex AI Workbench crea un'istanza e la avvia automaticamente. Quando l'istanza è pronta per l'uso, Vertex AI Workbench attiva un link Apri JupyterLab.

gcloud

Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:

  • INSTANCE_NAME: il nome dell'istanza di Vertex AI Workbench; deve iniziare con una lettera, deve contenere un massimo di 62 lettere minuscole, numeri o trattini (-) e non può terminare con un trattino
  • PROJECT_ID: il tuo ID progetto
  • LOCATION: la zona in cui vuoi che si trovi l'istanza
  • VM_IMAGE_NAME: il nome dell'immagine; per ottenere un elenco dei nomi delle immagini disponibili, utilizza il comando get-config
  • MACHINE_TYPE: il tipo di macchina della VM dell'istanza

  • METADATA: metadati personalizzati da applicare a questa istanza; ad esempio, per specificare uno script post-startup, puoi utilizzare il tag di metadati post-startup-script, nel formato: --metadata=post-startup-script=gs://BUCKET_NAME/hello.sh

Esegui questo comando:

Linux, macOS o 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

Per saperne di più sul comando per la creazione di un' istanza dalla riga di comando, consulta la documentazione di gcloud CLI.

Vertex AI Workbench crea un'istanza e la avvia automaticamente. Quando l'istanza è pronta per l'uso, Vertex AI Workbench attiva un link Apri JupyterLab nella Google Cloud console.

Passaggi successivi