Creare un modello di runtime in Colab Enterprise

Questa pagina mostra come creare un template di runtime in Colab Enterprise.

Per eseguire il codice nel tuo notebook, utilizza una risorsa di computing chiamata runtime. Puoi utilizzare il runtime predefinito o un runtime creato da un template di runtime. Creando un template di runtime, puoi configurarlo per ottimizzare le prestazioni, i costi e altre caratteristiche di un runtime in base alle tue esigenze.

Scopri di più su runtime e modelli di runtime.

Prima di iniziare

1. 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.
   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

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

3. Enable the Agent Platform, Dataform, and Compute Engine APIs, if any are not already enabled.

   Roles required to enable APIs

   To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

   Enable the APIs

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per creare un template di runtime in Colab Enterprise, chiedi all'amministratore di concederti il ruolo IAM Amministratore di Colab Enterprise (roles/aiplatform.colabEnterpriseAdmin) nel progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Uno o più dei ruoli richiesti includono l'autorizzazione dataform.repositories.list. Gli utenti a cui è stata concessa l'autorizzazione dataform.repositories.list o il ruolo Code Creator (roles/dataform.codeCreator) in un progetto possono elencare i nomi degli asset di codice in quel progetto utilizzando l'API Dataform o l'interfaccia a riga di comando (CLI) di Dataform. I non amministratori che utilizzano BigQuery Studio possono visualizzare solo gli asset di codice che hanno creato o che sono stati condivisi con loro.

Crea il template di runtime

Per creare un template di runtime, puoi utilizzare la console Google Cloud , Google Cloud CLI, l'API REST o Terraform.

Console

Per creare un template di runtime:

1. Nella console Google Cloud , vai alla pagina Modelli di runtime di Colab Enterprise.

   Vai a Modelli di runtime

2. Fai clic su  Nuovo modello.

   Viene visualizzata la finestra di dialogo Crea nuovo template di runtime.

Informazioni di base del runtime

1. Nella sezione Nozioni di base sul runtime, inserisci un Nome visualizzato.

2. Nel menu Regione, seleziona la regione in cui vuoi creare il template di runtime.

3. (Facoltativo) Aggiungi una descrizione del template di runtime.

4. (Facoltativo) Per aggiungere un'etichetta, fai clic su  Aggiungi etichetta, quindi inserisci una coppia Chiave e Valore. Per aggiungere altre etichette, ripeti questo passaggio.

5. Fai clic su Continua.

Configura elaborazione

1. Nella sezione Configura computing, nel menu Tipo di macchina, seleziona un tipo di macchina. Per informazioni sui tipi di macchine, consulta la guida alle risorse e al confronto per le famiglie di macchine.

   Se selezioni un tipo di macchina con GPU, seleziona Tipo di acceleratore e Numero di acceleratori. Se non riesci a selezionare il numero di GPU che vuoi, potresti dover aumentare la quota. Consulta Richiedi un aggiustamento delle quote.

2. Nel menu Tipo di disco dati, seleziona un tipo di disco.

3. Nel campo Dimensione disco dati, inserisci una dimensione in GB.

4. Nella sezione Arresto per inattività:

   • Per disattivare l'arresto per inattività, deseleziona Abilita arresto per inattività.

   • Per modificare il periodo di tempo di inattività, in Tempo di inattività prima dell'arresto (minuti), modifica il numero impostando il numero di minuti di inattività che preferisci. Nella console Google Cloud , questa impostazione può essere impostata su qualsiasi valore intero compreso tra 10 e 1440.

5. Fai clic su Continua.

Ambiente

1. Nella sezione Ambiente, seleziona un Ambiente. Il valore predefinito è Più recente (attualmente Python 3.13).

2. (Facoltativo) Nel campo Script post-avvio, inserisci l'URI di uno script post-avvio. Per saperne di più sull'utilizzo di uno script post-avvio, consulta Utilizza uno script post-avvio.

3. (Facoltativo) Sotto l'URL dello script post-avvio, seleziona il comportamento dello script post-avvio. Il comportamento predefinito è Esegui una volta. Per saperne di più, consulta Comportamento dello script di avvio post-avvio.

4. (Facoltativo) Per aggiungere una variabile di ambiente, fai clic su  Aggiungi variabile di ambiente, quindi inserisci una coppia Chiave e Valore. Per aggiungere altre variabili di ambiente, ripeti questo passaggio.

5. Fai clic su Continua.

Networking e sicurezza

1. Nella sezione Networking e sicurezza, nel menu Rete, seleziona una rete. Se non selezioni una rete, viene selezionata la rete predefinita.

2. Nel menu Subnet, seleziona una subnet.

3. Per disattivare l'accesso a internet pubblico, deseleziona Attiva l'accesso a internet pubblico.

4. Per disattivare l'accesso alle credenziali dell'utente finale, deseleziona Abilita credenziali utente finale.

Completa la creazione del template di runtime

Fai clic su Crea per completare la creazione del template di runtime.

Il template di runtime viene visualizzato nell'elenco nella scheda Template di runtime.

gcloud

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

• DISPLAY_NAME: il nome visualizzato del template di runtime.
• PROJECT_ID: il tuo ID progetto.
• REGION: la regione in cui vuoi creare il template di runtime.
• MACHINE_TYPE: il tipo di macchina da utilizzare per il runtime.
• ACCELERATOR_TYPE: il tipo di acceleratore hardware da utilizzare per il runtime.
• ACCELERATOR_COUNT: il numero di acceleratori da utilizzare per il runtime.

Esegui questo comando:

Linux, macOS o Cloud Shell

Nota: assicurati di aver inizializzato Google Cloud CLI con l'autenticazione e un progetto eseguendo gcloud init o gcloud auth login e gcloud config set project.

gcloud colab runtime-templates create --display-name="DISPLAY_NAME" \
    --project=PROJECT_ID \
    --region=REGION \
    --machine-type=MACHINE_TYPE \
    --accelerator-type=ACCELERATOR_TYPE \
    --accelerator-count=ACCELERATOR_COUNT

Windows (PowerShell)

Nota: assicurati di aver inizializzato Google Cloud CLI con l'autenticazione e un progetto eseguendo gcloud init o gcloud auth login e gcloud config set project.

gcloud colab runtime-templates create --display-name="DISPLAY_NAME" `
    --project=PROJECT_ID `
    --region=REGION `
    --machine-type=MACHINE_TYPE `
    --accelerator-type=ACCELERATOR_TYPE `
    --accelerator-count=ACCELERATOR_COUNT

Windows (cmd.exe)

Nota: assicurati di aver inizializzato Google Cloud CLI con l'autenticazione e un progetto eseguendo gcloud init o gcloud auth login e gcloud config set project.

gcloud colab runtime-templates create --display-name="DISPLAY_NAME" ^
    --project=PROJECT_ID ^
    --region=REGION ^
    --machine-type=MACHINE_TYPE ^
    --accelerator-type=ACCELERATOR_TYPE ^
    --accelerator-count=ACCELERATOR_COUNT

Per saperne di più sul comando per creare un template di runtime dalla riga di comando, consulta la documentazione di gcloud CLI.

REST

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

• REGION: la regione in cui vuoi creare il template di runtime.
• PROJECT_ID: il tuo ID progetto.
• DISPLAY_NAME: il nome visualizzato del template di runtime.
• MACHINE_TYPE: il tipo di macchina da utilizzare per il runtime.
• ACCELERATOR_TYPE: il tipo di acceleratore hardware da utilizzare per il runtime.
• ACCELERATOR_COUNT: il numero di acceleratori da utilizzare per il runtime.

Metodo HTTP e URL:

POST https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimeTemplates

Corpo JSON della richiesta:

{
  "displayName": "DISPLAY_NAME",
  "machineSpec": {
    {
      "machineType": MACHINE_TYPE
      "acceleratorType": ACCELERATOR_TYPE,
      "acceleratorCount": ACCELERATOR_COUNT,
    }
  },
}

Per inviare la richiesta, scegli una di queste opzioni:

curl

Nota: il seguente comando presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che consente di accedere automaticamente all'interfaccia a riga di comando gcloud. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimeTemplates"

PowerShell

Nota: il comando seguente presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimeTemplates" | Select-Object -Expand Content

In caso di esito positivo, il corpo della risposta contiene un'istanza di Operation.

Per saperne di più, consulta la documentazione dell'API REST notebookRuntimeTemplates.create.

Concessione dell'accesso al template di runtime

Dopo aver creato un template di runtime, devi concedere l'accesso a un'entità per poterlo utilizzare. Un'entità può creare un runtime da un template di runtime solo se dispone di quanto segue:

• Accesso al template di runtime.
• Le autorizzazioni necessarie per creare i runtime.

Passaggi successivi

• Scopri di più su runtime e modelli di runtime.
• Scopri come creare un runtime basato su un template di runtime.