Runtime e modelli di runtime

Questa pagina descrive i runtime e i modelli di runtime per Colab Enterprise.

Un runtime è una macchina virtuale (VM) di cui Google fa il provisioning che può eseguire il codice nel notebook (file IPYNB).

Un template di runtime è una configurazione VM che specifica un tipo di macchina e altre caratteristiche della VM, nonché impostazioni comuni come la rete e se l'accesso a internet pubblico è abilitato. Quando crei un runtime, la relativa VM viene creata in base alle specifiche di un modello di runtime.

Flusso di lavoro

Puoi creare un notebook Colab Enterprise ed eseguire il codice senza dover comprendere i runtime. Quando esegui il codice per la prima volta, Colab Enterprise esegue il provisioning di un runtime predefinito ed esegue il codice. Colab Enterprise continua a utilizzare il runtime predefinito finché non ti connetti a un runtime diverso.

Per configurare un runtime per esigenze specifiche, devi:

  1. Crea un modello di runtime con la configurazione che ti serve.

  2. Crea un runtime basato su questo modello.

  3. Connettiti al runtime dal notebook ed esegui il codice.

Runtime

Questa sezione descrive le caratteristiche dei runtime.

Runtime predefinito

Se non crei un runtime, ne viene creato uno senza acceleratori la prima volta che esegui il codice o ti connetti al runtime predefinito. Puoi utilizzare il runtime predefinito senza acceleratori o passare a un runtime predefinito che include gli acceleratori.

Quando Colab Enterprise crea un runtime predefinito, crea prima un modello di runtime predefinito corrispondente. Sia il runtime che il modello di runtime vengono visualizzati nella console Google Cloud , dove puoi trovare informazioni al riguardo.

Se utilizzi runtime predefiniti senza acceleratori, Colab Enterprise crea un runtime predefinito senza acceleratori e il relativo modello di runtime per progetto e per regione.

Se utilizzi runtime predefiniti con acceleratori, Colab Enterprise crea un runtime predefinito con acceleratori e il relativo modello di runtime per progetto e per regione.

Specifiche di runtime predefinite

I runtime predefiniti e i relativi modelli di runtime predefiniti includono le seguenti specifiche:

Specifica Predefinito Predefinito con GPU
Versione Python Ultima versione disponibile (attualmente Python 3.12) Ultima versione disponibile (attualmente Python 3.12)
Tipo di macchina e2-standard-4 Dipende dalla disponibilità regionale. Consulta le specifiche.
Acceleratore Nessuno Dipende dalla disponibilità regionale. Consulta le specifiche.
Disco di avvio Disco permanente SSD da 100 GiB (pd-ssd) Disco permanente SSD da 100 GiB (pd-ssd)
Disco dati Disco permanente standard da 100 GiB (pd-standard) Dipende dalla disponibilità regionale. Consulta le specifiche.
Arresto per inattività Attivato, impostato su 180 minuti Attivato, impostato su 180 minuti
Rete La rete Virtual Private Cloud predefinita del tuo progetto La rete Virtual Private Cloud predefinita del tuo progetto
Accesso a internet pubblico Abilitato Abilitato
Autenticazione delle credenziali utente finale Abilitato Abilitato
Eliminazione automatica Eliminazione automatica 18 ore dopo la creazione Eliminazione automatica 18 ore dopo la creazione

Versioni di Python

A partire da maggio 2025, quando Colab Enterprise crea un modello di runtime predefinito, questo viene configurato per utilizzare l'ultima versione di Python (attualmente Python 3.12). Ciò significa che quando una nuova versione di Python è disponibile in Colab Enterprise, i nuovi runtime creati dal modello di runtime predefinito utilizzeranno l'ultima versione di Python.

Se i tuoi modelli di runtime predefiniti sono stati creati entro maggio 2025, potrebbero essere configurati per utilizzare Python 3.10. Per aggiornare un modello di runtime predefinito in modo che utilizzi l'ultima versione di Python, devi eliminare il modello di runtime predefinito. Quando viene creato un nuovo modello di runtime predefinito, questo viene configurato per utilizzare l'ultima versione di Python.

Per aggiornare la versione Python di un modello di runtime che hai creato, consulta Modificare la versione Python di un modello di runtime.

La versione di Python dei runtime esistenti non cambia automaticamente, anche quando una nuova versione di Python è disponibile in Colab Enterprise. La modifica della versione di Python di un runtime esistente non è supportata. Devi invece creare un nuovo runtime derivato da un modello di runtime che utilizza la versione di Python che ti interessa.

Modificare la versione Python di un modello di runtime

Per modificare la versione di Python di un modello di runtime, puoi utilizzare l'API REST.

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

  • REGION: la regione in cui si trova il modello di runtime.
  • PROJECT_ID: il tuo ID progetto.
  • NOTEBOOK_RUNTIME_TEMPLATE_ID: l'ID del modello di runtime.
  • RELEASE_NAME: il nome della release dell'immagine che vuoi utilizzare. Ad esempio, py311 è il nome della release per l'immagine Python 3.11. Per impostare l'immagine su Latest, lascia vuoto il campo RELEASE_NAME.

Metodo HTTP e URL: 

PATCH https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimeTemplates/NOTEBOOK_RUNTIME_TEMPLATE_ID?updateMask=software_config.colab_image.release_name

Corpo JSON della richiesta: 

{
  softwareConfig: {
    colabImage: {
      releaseName: "RELEASE_NAME"
    }
  }
}

Per inviare la richiesta, scegli una di queste opzioni:

curl

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

curl -X PATCH \
     -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/NOTEBOOK_RUNTIME_TEMPLATE_ID?updateMask=software_config.colab_image.release_name"

PowerShell

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 PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimeTemplates/NOTEBOOK_RUNTIME_TEMPLATE_ID?updateMask=software_config.colab_image.release_name" | Select-Object -Expand Content
In caso di esito positivo, il corpo della risposta contiene un'istanza di Operation.

Per ulteriori informazioni, consulta la documentazione dell'API REST di notebookRuntimeTemplates.patch.

I runtime sono regionali

I runtime sono regionali e devono trovarsi nella stessa regione del notebook.

I runtime sono esclusivi per un utente

I runtime sono esclusivi per un utente. Non puoi condividere i tuoi tempi di esecuzione con altre persone e non puoi utilizzare i loro tempi di esecuzione. Anche se condividi un notebook con qualcuno, quest'ultimo non ha accesso al tuo runtime e deve eseguire il notebook sul proprio runtime.

Tuttavia, gli utenti possono creare i propri runtime in base allo stesso modello di runtime. Vedi I modelli di runtime possono essere condivisi con gli utenti.

Gestire i file del runtime

Puoi accedere ai file sul runtime e modificarli utilizzando il pulsante  File in Colab Enterprise. Puoi anche caricare file nel runtime.

Quando il runtime viene eliminato, vengono eliminati anche tutti i file che carichi. Se hai modificato i file, questi torneranno al loro stato originale quando viene creato un nuovo runtime. Il periodo di eliminazione automatica è indicato nella sezione Specifiche di runtime predefinite.

I runtime possono essere condivisi dai notebook

Puoi connettere più di un blocco note allo stesso runtime, ma non è consigliabile. Più blocchi note che condividono lo stesso runtime possono causare problemi, tra cui:

  • I blocchi note potrebbero essere eseguiti lentamente perché condividono le risorse di calcolo del runtime.

  • Il codice in un blocco note può influire sullo stato della VM del runtime per l'altro blocco note. Ad esempio, se installi la versione 1.3 di un pacchetto in un blocco note, ma l'altro blocco note richiede la versione 1.2, potresti riscontrare un'incompatibilità di versione quando esegui il secondo blocco note.

Anziché eseguire il codice di più blocchi note nello stesso runtime, puoi creare un runtime per ogni blocco note in base allo stesso modello di runtime. Consulta Puoi creare più runtime dallo stesso modello di runtime.

Addebiti per il runtime

L'elaborazione in fase di runtime viene addebitata in base al tipo di macchina e agli acceleratori utilizzati. Ti viene addebitato anche lo spazio di archiviazione del disco di avvio e del disco di dati. I dischi di avvio e i dischi di dati vengono eliminati quando vengono eliminati i runtime.

I runtime includono sempre un disco permanente SSD da 100 GiB oltre al disco dati specificato nel modello di runtime. Il disco di avvio non è configurabile.

Durante l'arresto dei runtime:

  • I costi di calcolo non vengono generati perché non viene utilizzato alcun utilizzo di CPU o GPU.
  • L'archiviazione del disco di avvio e del disco di dati viene addebitata.

Per ulteriori informazioni, consulta la pagina Prezzi di Colab Enterprise.

Puoi creare più runtime dallo stesso modello di runtime

Puoi creare più runtime da un singolo modello di runtime non predefinito. In questo modo, puoi eseguire più blocchi note su VM con la stessa configurazione senza condividere le risorse della VM.

Modelli di runtime

Questa sezione descrive le caratteristiche dei modelli di runtime.

I modelli di runtime sono regionali

I modelli di runtime sono regionali. Quando crei un runtime, questo si trova nella stessa regione del template di runtime e può essere utilizzato solo con i blocchi note in quella regione.

I modelli di runtime possono essere condivisi con gli utenti

Puoi condividere un modello di runtime con altri utenti. In questo modo, ogni utente può creare il proprio runtime in base allo stesso modello di runtime e quindi più utenti possono eseguire lo stesso notebook sulla stessa configurazione VM.

Per saperne di più, consulta Gestire l'accesso a un modello di runtime.

Configurazione

I modelli di runtime determinano la configurazione della VM del runtime. Puoi specificare uno dei seguenti valori:

Regione

Scegli la regione in cui si trova il notebook. I runtime creati dai modelli di runtime si trovano nella stessa regione del modello di runtime. Affinché il notebook esegua il codice nel runtime, il notebook e il runtime devono trovarsi nella stessa regione.

Tipo di macchina

Puoi configurare il tipo di macchina del modello di runtime. Per informazioni sui tipi di macchina, consulta la guida alle risorse e al confronto per le famiglie di macchine.

Disco dati

Puoi configurare il tipo e le dimensioni del disco dati nel modello di runtime.

Quando viene creato il runtime, viene incluso anche un disco di avvio. Il disco di avvio è un disco permanente SSD da 100 GiB e non può essere configurato.

Acceleratori

Puoi aggiungere acceleratori alla configurazione del modello di runtime. La disponibilità dell'acceleratore dipende dal tipo di macchina e dalla regione.

Rete

Specifica la tua rete o utilizza la rete Virtual Private Cloud predefinita del progetto.

Arresto per inattività

Colab Enterprise attiva l'arresto inattivo per impostazione predefinita. Questa impostazione arresta l'istanza dopo 180 minuti di inattività. Puoi modificare il numero di minuti di inattività prima dello spegnimento o disattivare lo spegnimento inattivo.

Accesso a internet pubblico

Per avere un maggiore controllo sulla sicurezza del notebook e di altre risorse, puoi disattivare l'accesso a internet pubblico. Se configuri il modello di runtime in questo modo, i notebook che utilizzano runtime creati dal modello di runtime non avranno accesso a internet pubblico.

Autenticazione delle credenziali utente finale

Per impostazione predefinita, i modelli di runtime utilizzano l'autenticazione delle credenziali dell'utente finale per consentire al notebook di accedere alle Credenziali predefinite dell'applicazione (ADC). Puoi utilizzare questo accesso ad ADC per eseguire codice nel notebook che interagisce con Vertex AI e altri servizi Google Cloud . Quando le credenziali dell'utente finale sono abilitate, il notebook utilizza le credenziali di chiunque esegua il notebook per determinare l'accesso alle risorse. Google Cloud

Se le credenziali utente finale non sono abilitate, puoi accedere ad ADC autenticando l'utente tramite il codice del notebook. Per saperne di più, consulta la sezione "Credenziali utente" di Configura ADC per un ambiente di sviluppo locale.

Addebiti per i modelli di runtime

Non sono previsti costi per la creazione o l'archiviazione di modelli di runtime. Vedi anche Costi di runtime.

Passaggi successivi