Creazione di una versione specifica di un'istanza

Questa pagina descrive come creare una versione specifica di un'istanza di Agent Platform Workbench di Gemini Enterprise.

Perché potresti voler creare una versione specifica

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

Le immagini delle istanze di Agent Platform Workbench vengono aggiornate di frequente e le versioni specifiche di software e pacchetti preinstallati variano da versione a versione.

Per saperne di più sulle versioni specifiche di Agent Platform Workbench, consulta le note di rilascio di Agent Platform.

Dopo aver creato una versione specifica di un'istanza di Agent Platform 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.

Crea una versione specifica

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

Console

Per creare una versione specifica di un'istanza di Agent Platform 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 release, ad esempio M123.

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

    Agent Platform Workbench crea un'istanza e la avvia automaticamente. Quando l'istanza è pronta per l'uso, Agent Platform 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 Agent Platform Workbench; deve iniziare con una lettera, contenere un massimo di 62 lettere minuscole, numeri o trattini (-) e non 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 creare un' istanza dalla riga di comando, consulta la documentazione di gcloud CLI.

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

Passaggi successivi