Runtime e template di runtime

Runtime e template di runtime

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

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

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

Workflow

Puoi creare un notebook Colab Enterprise ed eseguire il codice al suo interno 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 al suo interno. Colab Enterprise continua a utilizzare il runtime predefinito finché non ti connetti a un runtime diverso.

Per configurare un runtime in base a esigenze specifiche, devi:

1. Crea un template di runtime con la configurazione necessaria.

2. Crea un runtime basato su questo template.

3. Connettiti al runtime dal tuo 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 li include.

Per ogni utente sono consentiti un solo runtime predefinito senza acceleratori e un solo runtime predefinito con acceleratori per progetto e per regione.

Quando Colab Enterprise crea un runtime predefinito, crea prima un template di runtime predefinito corrispondente se il progetto non ne ha già uno nella regione. Sia il runtime predefinito che il modello di runtime vengono visualizzati nella console Google Cloud , dove puoi ottenere informazioni su di essi.

Nota: Il ruolo utente Colab Enterprise (roles/aiplatform.colabEnterpriseUser ) non include un'autorizzazione necessaria per la creazione di un modello di runtime predefinito (aiplatform.notebookRuntimeTemplates.create ). Ciò significa che per creare un runtime predefinito, se non esiste un modello di runtime predefinito, gli utenti con il ruolo Colab Enterprise User devono anche avere un ruolo che includa ilaiplatform.notebookRuntimeTemplates.create permesso.

Se utilizzi i runtime predefiniti senza acceleratori, Colab Enterprise crea un runtime predefinito senza acceleratori e il relativo template di runtime, se non esiste un template di runtime predefinito, per progetto e per regione.

Se utilizzi i runtime predefiniti con acceleratori, Colab Enterprise crea un runtime predefinito con acceleratori e il relativo template di runtime se non esiste un template di runtime predefinito con acceleratori, per progetto, per regione.

Specifiche di runtime predefinite

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

Specifica	Predefinito	Predefiniti con GPU
Versione Python	Ultima versione disponibile (attualmente Python 3.13)	Ultima versione disponibile (attualmente Python 3.13)
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 progetto	La rete Virtual Private Cloud predefinita del progetto
Accesso a internet pubblico	Abilitato	Abilitato
Autenticazione delle credenziali dell'utente finale	Abilitato	Abilitato
Eliminazione automatica	Eliminazione automatica 18 ore dopo la creazione	Eliminazione automatica 18 ore dopo la creazione

Nota: quando il runtime viene eliminato, Colab Enterprise non conserva le modifiche apportate ai file del runtime. Inoltre, tutti i file che hai caricato nel runtime vengono eliminati.

Imposta un template di runtime come template di runtime predefinito

Puoi impostare un template di runtime esistente come template di runtime predefinito per il tuo progetto e la tua regione. Quando imposti un template di runtime come predefinito, i nuovi runtime predefiniti creati nel progetto e nella regione attuali utilizzano la configurazione del template. I runtime esistenti non sono interessati.

Dopo che un template di runtime è stato impostato come predefinito, tutti i nuovi runtime creati dal template di runtime predefinito vengono eliminati automaticamente 18 ore dopo la creazione.

Ogni combinazione di regione e progetto può avere un solo template di runtime predefinito senza acceleratori e un solo template di runtime predefinito con acceleratori. I template di runtime che in precedenza erano i template predefiniti diventano template definiti dall'utente e i nuovi runtime creati da questi vengono eliminati automaticamente dopo 6 mesi.

Puoi impostare sia un template di runtime predefinito senza acceleratori sia un template di runtime predefinito con acceleratori.

Nota: L'impostazione di un modello di runtime come predefinito richiede l'autorizzazione aiplatform.notebookRuntimeTemplates.setDefault. Questa autorizzazione è inclusa in ruoli come Colab Enterprise Admin (roles/aiplatform.colabEnterpriseAdmin) e Notebook Runtime Admin (roles/aiplatform.notebookRuntimeAdmin).

Per impostare un template di runtime come predefinito, puoi utilizzare la consoleGoogle Cloud . Puoi farlo dalla pagina Template di runtime o dalla pagina dei dettagli di un template di runtime.

Dalla pagina dei template di runtime:

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

   Vai a Modelli di runtime

2. Nel menu Regione, seleziona la regione che contiene il template di runtime.

3. Nella riga del template di runtime che vuoi impostare come predefinito, fai clic su  Azioni.

4. A seconda che il template includa o meno acceleratori:

   • Per un template senza acceleratori, fai clic su Imposta come predefinito.
   • Per un template con acceleratori, fai clic su Imposta come predefinito con GPU.

5. Nella finestra di dialogo di conferma, fai clic su Imposta come predefinito o Imposta come predefinito con GPU per confermare.

Dalla pagina dei dettagli del template di runtime:

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

   Vai a Modelli di runtime

2. Nel menu Regione, seleziona la regione che contiene il template di runtime.

3. Nella colonna ID, fai clic sull'ID del template di runtime che vuoi impostare come predefinito.

4. Nella barra delle azioni nella parte superiore della pagina, fai clic su  Imposta come predefinito o  Imposta come predefinito con GPU.

5. Nella finestra di dialogo di conferma, fai clic su Imposta come predefinito o Imposta come predefinito con GPU per confermare.

Versioni Python

Quando Colab Enterprise crea un template di runtime predefinito, questo viene configurato per utilizzare l'ultima versione disponibile di Python (attualmente Python 3.13). Ciò significa che quando una nuova versione di Python è disponibile in Colab Enterprise, i nuovi runtime creati dal template di runtime predefinito utilizzeranno l'ultima versione di Python.

Se i template di runtime predefiniti sono stati creati a maggio 2025 o in un periodo precedente, potrebbero essere configurati per l'utilizzo di 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. In questo modo, quando viene creato un nuovo template di runtime predefinito, questo verrà configurato per utilizzare l'ultima versione di Python.

Per aggiornare la versione di Python di un template di runtime che hai creato, consulta Gestisci i template di runtime.

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

Modifica la versione di Python di un template di runtime

Per modificare la versione di Python di un template di runtime, puoi utilizzare la console Google Cloud o l'API REST.

Console

Per modificare un template di runtime:

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

   Vai a Modelli di runtime

2. Nel menu Regione, seleziona la regione che contiene il tuo template di runtime.

3. Nella colonna ID, fai clic sul numero ID del template di runtime che vuoi modificare.

4. Fai clic su  Modifica.

5. Nel riquadro Modifica template di runtime, apporta modifiche al template di runtime.

6. Fai clic su Aggiorna.

REST

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

• REGION: la regione in cui si trova il template di runtime.
• PROJECT_ID: il tuo ID progetto.
• NOTEBOOK_RUNTIME_TEMPLATE_ID: l'ID del template 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 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

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 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

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 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 saperne di più, consulta la documentazione dell'API REST notebookRuntimeTemplates.patch.

Versioni di Python supportate

Colab Enterprise supporta le versioni di Python per periodi di tempo specifici.

La tabella seguente elenca la data di fine delle patch e dell'assistenza e la data di fine della disponibilità per ogni versione supportata di Python. Per saperne di più su queste date, consulta Informazioni sulle date di fine del supporto.

Versione Python	Data di fine delle patch e del supporto	Data di fine disponibilità
Python 3.13	Da stabilire	Da stabilire
Python 3.12	Da stabilire	Da stabilire
Python 3.11	Da stabilire	Da stabilire
Python 3.10	23 febbraio 2026	17 agosto 2026

Informazioni sulle date di fine del supporto

Il supporto per una versione di Python termina in base alle seguenti date:

• Data di fine delle patch e dell'assistenza: dopo questa data, verranno applicate le seguenti modifiche:

  • Non puoi creare template di runtime che utilizzano questa versione di Python.
  • Tutti i modelli di runtime esistenti che utilizzano questa versione di Python vengono aggiornati automaticamente per utilizzare l'ultima versione di Python disponibile.
  • Non è più possibile eseguire l'upgrade dei runtime esistenti.
  • I runtime smettono di funzionare sei mesi dopo l'upgrade più recente o, se non è stato eseguito l'upgrade, sei mesi dopo la loro creazione.

  Per richiedere un'estensione per l'utilizzo di questa versione di Python fino alla data di fine disponibilità, contatta il tuo rappresentante dell'account Google Cloud.

• Data di fine disponibilità: dopo questa data, verranno applicate le seguenti modifiche:

  • Questa versione di Python non è disponibile in Colab Enterprise, nemmeno per gli utenti a cui è stata concessa un'estensione.
  • Tutti i template di runtime esistenti che utilizzano questa versione di Python vengono aggiornati automaticamente per utilizzare l'ultima versione di Python disponibile.

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 runtime con altri utenti e non puoi utilizzare i loro runtime. Anche se condividi un notebook con qualcuno, questo 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 template di runtime. Consulta I template di runtime possono essere condivisi con gli utenti.

Gestione dei file del runtime

Puoi accedere ai file nel 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 hai caricato. Se hai modificato dei file, questi verranno ripristinati allo stato originale quando viene creato un nuovo runtime. Consulta il periodo di tempo per l'eliminazione automatica nella sezione Specifiche di runtime predefinite.

I runtime possono essere condivisi dai notebook

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

• I notebook potrebbero essere lenti perché condividono le risorse di computing del runtime.

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

Anziché eseguire il codice di più notebook sullo stesso runtime, puoi creare un runtime per ogni notebook in base allo stesso template di runtime. Consulta Puoi creare più runtime dallo stesso template di runtime.

Addebiti di runtime

Ti vengono addebitati i costi per l'elaborazione del runtime in base al tipo di macchina e agli acceleratori che utilizzi. 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 template di runtime. Il disco di avvio non è configurabile.

Mentre i runtime sono arrestati:

• Non vengono generati costi di computing perché non viene utilizzato alcun utilizzo della CPU o della GPU.
• L'archiviazione su disco di avvio e su disco dati è a pagamento.

Per saperne di più, consulta i prezzi di Colab Enterprise.

Puoi creare più runtime dallo stesso template di runtime

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

Modelli di runtime

Questa sezione descrive le caratteristiche dei template di runtime.

I template di runtime sono regionali

I template 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 notebook in quella regione.

I template di runtime possono essere condivisi con gli utenti

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

Per saperne di più, consulta Gestisci l'accesso a un template di runtime.

Configurazione

I template di runtime determinano la configurazione della VM del runtime. Puoi specificare una delle seguenti opzioni:

Regione

Scegli la regione in cui si trova il notebook. I runtime creati dai template di runtime si trovano nella stessa regione del template 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 tuo template di runtime. Per informazioni sui tipi di macchine, 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 template 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 template di runtime. La disponibilità degli acceleratori 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 per inattività per impostazione predefinita. Questa impostazione arresta l'istanza dopo 180 minuti di inattività. Puoi modificare il numero di minuti di inattività prima dell'arresto o disattivare l'arresto per inattività.

Accesso a internet pubblico

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

Autenticazione delle credenziali dell'utente finale

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

Se le credenziali dell'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 template di runtime

Non sono previsti addebiti per la creazione o l'archiviazione di template di runtime. Consulta anche Costi di runtime.

Passaggi successivi

• Crea un runtime basato su un template di runtime.
• Connettiti a un runtime.
• Crea un template di runtime.