Modelli di runtime e runtime

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

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

Un modello di runtime è una configurazione VM che specifica un tipo di macchina e altre caratteristiche della VM, nonché impostazioni comuni come la rete e l'eventuale attivazione dell'accesso a internet pubblico. 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 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 colleghi a un altro runtime.

Per configurare un runtime per esigenze specifiche, devi:

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

2. Crea un runtime basato su quel modello.

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 include gli acceleratori.

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

Se utilizzi runtime predefiniti senza acceleratori, Colab Enterprise crea un runtime predefinito senza acceleratori e il corrispondente 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 regione.

Specifiche di runtime predefinite

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

Versioni di Python

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

Se i modelli di runtime predefiniti sono stati creati prima di maggio 2025, potrebbero essere configurati per utilizzare Python 3.10. Per aggiornare un modello di runtime predefinito in modo da utilizzare la versione più recente di Python, devi eliminare il modello di runtime predefinito. Poi, quando viene creato un nuovo modello di runtime predefinito, verrà configurato per utilizzare la versione di Python più recente.

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

La versione di Python dei runtime esistenti non cambia automaticamente, anche se è disponibile una nuova versione di 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 modello di runtime che utilizzi la versione di Python che preferisci.

Modificare la versione Python di un modello di runtime

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

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

• 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 dell'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 delle seguenti opzioni:

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"

$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

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

I runtime sono regionali

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

I runtime sono riservati esclusivamente a un utente

I runtime sono riservati esclusivamente a singoli utenti. Non puoi condividere i tuoi runtime con altri e non puoi utilizzare i loro runtime. Anche se condividi un notebook con un'altra persona, questa 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. Consulta I modelli di runtime possono essere condivisi con gli utenti.

Gestire i file del runtime

Puoi accedere e modificare i file nel tuo runtime utilizzando il pulsante  File in Colab Enterprise. Puoi anche caricare file nel tuo ambiente di runtime.

Quando il runtime viene eliminato, vengono eliminati anche tutti i file caricati. Se hai modificato dei file, questi torneranno allo stato originale quando verrà creato un nuovo runtime. Consulta il periodo di tempo dell'eliminazione automatica nella sezione Specifiche di runtime predefinite.

I runtime possono essere condivisi dai notebook

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

• I notebook potrebbero funzionare lentamente perché condividono le risorse di calcolo 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 da più notebook nello stesso runtime, puoi creare un runtime per ogni notebook in base allo stesso modello di runtime. Consulta Puoi creare più runtime dallo stesso modello di runtime.

Costi di runtime

L'elaborazione in fase di runtime viene addebitata in base al tipo di macchina e agli acceleratori utilizzati. Ti vengono addebitati anche i costi 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.

Quando i runtime sono inattivi:

• Gli addebiti di Compute non vengono generati perché non viene utilizzata alcuna CPU o GPU.
• L'archiviazione del disco di avvio e del disco di dati viene addebitata.

Per ulteriori informazioni, consulta la pagina relativa ai 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ù notebook 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 modello di runtime e può essere utilizzato solo con i notebook nella stessa 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 scoprire 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 tuo notebook. I runtime creati da 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 essere nella stessa regione.

Tipo di macchina

Puoi configurare il tipo di macchina del modello di runtime. Per informazioni sui tipi di macchine, consulta la guida Risorsa e confronto tra famiglie di macchine.

Disco dati

Puoi configurare il tipo e le dimensioni del disco dati nel tuo 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 GB e non può essere configurato.

Acceleratori

Puoi aggiungere acceleratori alla configurazione del modello 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 in caso di inattività 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 in caso di inattività.

Accesso a internet pubblico

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

Autenticazione delle credenziali utente finale

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

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

Addebiti per i modelli di runtime

Non sono previsti costi per la creazione o la memorizzazione dei modelli di runtime. Vedi anche Costi di runtime.

Passaggi successivi

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