Crea un runtime

Questa pagina mostra come creare, avviare ed eliminare un runtime in Colab Enterprise.

Puoi creare un runtime per eseguire il codice in un runtime con una configurazione diversa da quella predefinita. I runtime vengono creati in base a un template di runtime, che include specifiche come il tipo di macchina e le dimensioni del disco.

Per saperne di più sui runtime, consulta Runtime e template di runtime.

Prima di iniziare

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.

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

Verify that billing is enabled for your Google Cloud project.

Enable the Vertex AI, Dataform, and Compute Engine APIs.

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 APIs

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

Verify that billing is enabled for your Google Cloud project.

Enable the Vertex AI, Dataform, and Compute Engine APIs.

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 APIs

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per creare un runtime in Colab Enterprise, chiedi all'amministratore di concederti il ruolo IAM Colab Enterprise Admin (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'dataform.repositories.list autorizzazione. 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) 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 un runtime

Per creare un runtime, puoi utilizzare la Google Cloud console, Google Cloud CLI, o Terraform.

Console

Per creare un runtime:

Nella Google Cloud console, vai alla pagina Runtime di Colab Enterprise.

Vai a Runtime
Nel menu Regione, seleziona la regione in cui vuoi che si trovi il runtime. Deve trovarsi nella stessa regione del notebook che utilizza.
Fai clic su Crea.

Viene visualizzata la finestra di dialogo Crea runtime Vertex AI.
Nel menu Template di runtime , seleziona un template di runtime. Se non sono elencati template di runtime, crea un template di runtime.
Nel campo Nome runtime, inserisci un nome per il runtime.
Fai clic su Crea.

Per impostazione predefinita, quando crei un runtime, hai automaticamente le autorizzazioni necessarie per avviare ed eliminare quel runtime.

gcloud

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

DISPLAY_NAME: il nome visualizzato del runtime.
RUNTIME_TEMPLATE_ID: l'ID del template di runtime. Il template di runtime specifica la configurazione di calcolo del runtime.
PROJECT_ID: il tuo ID progetto.
REGION: la regione in cui vuoi che si trovi il runtime.

Esegui questo comando:

Linux, macOS o Cloud Shell

gcloud colab runtimes create --display-name="DISPLAY_NAME" \
    --runtime-template=RUNTIME_TEMPLATE_ID \
    --project=PROJECT_ID \
    --region=REGION

Windows (PowerShell)

gcloud colab runtimes create --display-name="DISPLAY_NAME" `
    --runtime-template=RUNTIME_TEMPLATE_ID `
    --project=PROJECT_ID `
    --region=REGION

Windows (cmd.exe)

gcloud colab runtimes create --display-name="DISPLAY_NAME" ^
    --runtime-template=RUNTIME_TEMPLATE_ID ^
    --project=PROJECT_ID ^
    --region=REGION

Per impostazione predefinita, quando crei un runtime, hai automaticamente le autorizzazioni necessarie per avviare ed eliminare quel runtime.

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

Terraform

Per scoprire come applicare o rimuovere una configurazione Terraform, consulta Comandi Terraform di base. Per saperne di più, consulta la documentazione di riferimento del fornitore Terraform.

Il seguente esempio utilizza la google_colab_runtime risorsa Terraform per creare un runtime Colab Enterprise runtime.

resource "google_colab_runtime_template" "my_template" {
  name        = "{{index $.Vars "runtime_name"}}"
  display_name = "Runtime template full"
  location    = "us-central1"
  description = "Full runtime template"
  machine_spec {
    machine_type     = "n1-standard-2"
    accelerator_type = "NVIDIA_TESLA_T4"
    accelerator_count = "1"
  }

  data_persistent_disk_spec {
    disk_type    = "pd-standard"
    disk_size_gb = 200
  }

  network_spec {
    enable_internet_access = true
  }

  labels = {
    k = "val"
  }

  idle_shutdown_config {
    idle_timeout = "3600s"
  }

  euc_config {
    euc_disabled = true
  }

  shielded_vm_config {
    enable_secure_boot = true
  }

  network_tags = ["abc", "def"]

  encryption_spec {
    kms_key_name = "{{index $.Vars "key_name"}}"
  }
}

resource "google_colab_runtime" "{{$.PrimaryResourceId}}" {
  name = "{{index $.Vars "runtime_name"}}"
  location = "us-central1" 

  notebook_runtime_template_ref {
    notebook_runtime_template = google_colab_runtime_template.my_template.id
  }

  display_name = "Runtime full"
  runtime_user = "gterraformtestuser@gmail.com"
  description = "Full runtime"

  desired_state = "ACTIVE"

  auto_upgrade = true

  depends_on = [
    google_colab_runtime_template.my_template
  ]
}

Risoluzione dei problemi

Questa sezione mostra come risolvere i problemi relativi alla creazione di runtime in Colab Enterprise.

Impossibile creare un runtime

Questo problema si verifica quando non riesci a creare un runtime. Vedi anche Impossibile creare un runtime predefinito. Le cause più comuni sono:

Quota insufficiente

Se non riesci a creare un runtime, potresti aver superato la quota di runtime di Compute Engine.

Colab Enterprise utilizza la quota di Compute Engine per i runtime. Per saperne di più, consulta la panoramica di quote e limiti di Compute Engine.

Per risolvere il problema, Richiedi una modifica della quota.

Risorse non disponibili

Quando provi a creare un runtime, si verifica il seguente errore.

No available zone found for runtime RUNTIME_ID
for machine type MACHINE_TYPE
with accelerator type: ACCELERATOR. Please try again later.

Questo errore si verifica se non sono disponibili risorse per la configurazione del tipo di macchina nella regione del notebook.

Per risolvere il problema, prova una delle seguenti soluzioni:

Crea un runtime in un'altra regione.
Crea un template di runtime con una configurazione del tipo di macchina diversa, quindi crea un runtime basato sul nuovo template di runtime.

Esiste già un runtime predefinito

Quando provi a creare un runtime dal template di runtime predefinito se il runtime predefinito esiste già, si verifica il seguente errore.

Failed to create runtime

One click runtime already exists.

Se provi a creare un runtime da un template di runtime predefinito, Colab Enterprise tenta di creare un runtime predefinito. Può esistere un solo runtime predefinito per utente, progetto e regione. Se il runtime predefinito esiste già, Colab Enterprise non può crearne un altro.

Per risolvere il problema, connettiti al runtime predefinito esistente o crea un runtime da un template di runtime non predefinito.

Impossibile creare un runtime predefinito

Quando Colab Enterprise crea un runtime predefinito, crea prima un template di runtime predefinito che utilizza per generare il runtime predefinito. Se provi a creare un runtime predefinito senza le autorizzazioni necessarie per creare un template di runtime, allora Colab Enterprise non può creare il runtime predefinito.

Per risolvere il problema, chiedi all'amministratore di concederti un ruolo che includa l' aiplatform.notebookRuntimeTemplates.create autorizzazione.

Passaggi successivi

Per gestire il runtime, consulta Gestisci i runtime.
Scopri di più su runtime e template di runtime.
Connettiti al runtime.
Scopri come creare un template di runtime.