Connetti a un runtime

Questa pagina mostra come connettersi a un runtime in Colab Enterprise.

Per eseguire il codice nel notebook, devi connetterti a un runtime. Un runtime è una risorsa di calcolo che esegue il tuo codice.

Prima di iniziare

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Go to project selector

Make sure that billing is enabled for your Google Cloud project.

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

Enable the APIs

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Go to project selector

Make sure that billing is enabled for your Google Cloud project.

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

Enable the APIs

Connettersi utilizzando metodi diversi

Questa pagina mostra come connettersi a un runtime utilizzando i seguenti metodi:

• Utilizzare il runtime predefinito
• Connettersi a un runtime esistente
• Creare un runtime

Utilizza il runtime predefinito

Questa sezione descrive come connettersi al runtime predefinito.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per connetterti al runtime predefinito in un blocco note Colab Enterprise, chiedi all'amministratore di concederti il ruolo IAM Utente Colab Enterprise (roles/aiplatform.colabEnterpriseUser) 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.

Connettersi al runtime predefinito

Quando esegui il codice in un notebook per la prima volta, Colab Enterprise si connette automaticamente al runtime predefinito, a meno che tu non specifica un runtime diverso.

Per connetterti al runtime predefinito senza eseguire codice:

1. Nella console Google Cloud , vai alla pagina I miei blocchi note di Colab Enterprise.

   Vai a I miei notebook

2. Nel menu Regione, seleziona la regione che contiene il notebook.

3. Fai clic sul notebook che vuoi aprire. Se non hai ancora creato un blocco note, creane uno.

4. Nel notebook, fai clic su Connetti.
   

5. Se è la prima volta che ti connetti a un runtime con le credenziali dell'utente finale attive, viene visualizzata una finestra di dialogo Accedi.

   Per concedere a Colab Enterprise l'accesso alle tue credenziali utente, completa i seguenti passaggi:

   1. Nella finestra di dialogo Accedi, fai clic sul tuo account utente.

   2. Seleziona Visualizzare, modificare, configurare ed eliminare i tuoi dati di Google Cloud … per concedere a Colab Enterprise l'accesso alle tue credenziali utente.

      

   3. Fai clic su Continua.

Colab Enterprise si connette al runtime predefinito. Se il runtime predefinito non è in esecuzione, Colab Enterprise lo avvia e poi si connette.

Connetti a un runtime esistente

Questa sezione descrive come connettersi a un runtime esistente utilizzando la finestra di dialogo Connetti al runtime di Vertex AI.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per connetterti a un runtime esistente in un blocco note Colab Enterprise, chiedi all'amministratore di concederti il ruolo IAM Utente Colab Enterprise (roles/aiplatform.colabEnterpriseUser) sul 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.

Connetti al runtime esistente

Per connetterti a un runtime esistente:

1. Nella console Google Cloud , vai alla pagina I miei blocchi note di Colab Enterprise.

   Vai a I miei notebook

2. Nel menu Regione, seleziona la regione che contiene il notebook.

3. Fai clic sul notebook che vuoi aprire. Se non hai ancora creato un blocco note, creane uno.

4. Nel notebook, fai clic sulla freccia di espansione Opzioni di connessione aggiuntive, e poi seleziona Connetti a un runtime.
   

   Si apre la finestra di dialogo Connetti al runtime di Vertex AI.

5. Per Seleziona un runtime, seleziona Connetti a un runtime esistente.

6. Per Seleziona un'opzione di runtime esistente, seleziona il runtime a cui vuoi connetterti. Se nell'elenco non sono presenti runtime, crea un runtime o connettiti al runtime predefinito.

7. Fai clic su Connetti.

8. Se le credenziali dell'utente finale sono attive nel runtime e questa è la prima volta che ti connetti a un runtime con le credenziali dell'utente finale attive, viene visualizzata una finestra di dialogo Accedi.

   Per concedere a Colab Enterprise l'accesso alle tue credenziali utente, completa i seguenti passaggi:

   1. Nella finestra di dialogo Accedi, fai clic sul tuo account utente.

   2. Seleziona Visualizzare, modificare, configurare ed eliminare i tuoi dati di Google Cloud … per concedere a Colab Enterprise l'accesso alle tue credenziali utente.

      

   3. Fai clic su Continua.

Colab Enterprise si connette al runtime. Se il runtime non è in esecuzione, Colab Enterprise lo avvia e poi si connette.

Crea un runtime

Questa sezione descrive come creare un runtime e connettersi a esso utilizzando la finestra di dialogo Connetti al runtime di Vertex AI. In alternativa, puoi creare un runtime dalla scheda Runtime.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per creare un runtime in Colab Enterprise, chiedi all'amministratore di concederti il ruolo IAM Amministratore 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.

Crea un runtime e connettiti

Per creare un runtime e connetterti a esso utilizzando la finestra di dialogo Connetti al runtime di Vertex AI:

1. Nella console Google Cloud , vai alla pagina I miei blocchi note di Colab Enterprise.

   Vai a I miei notebook

2. Nel menu Regione, seleziona la regione che contiene il notebook.

3. Fai clic sul notebook che vuoi aprire. Se non hai ancora creato un blocco note, creane uno.

4. Nel notebook, fai clic sulla freccia di espansione Opzioni di connessione aggiuntive, e poi seleziona Connetti a un runtime.
   

   Si apre la finestra di dialogo Connetti al runtime di Vertex AI.

5. Per Seleziona un runtime, seleziona Crea nuovo runtime.

6. Nel menu Modello di runtime, seleziona un modello di runtime. Se non sono elencati modelli di runtime, creane uno.

7. Nel campo Nome runtime, inserisci un nome per il runtime.

8. Fai clic su Connetti.

9. Se il modello di runtime selezionato ha le credenziali dell'utente finale attive e questa è la prima volta che ti connetti a un runtime con le credenziali dell'utente finale attive, viene visualizzata una finestra di dialogo Accedi.

   Per concedere a Colab Enterprise l'accesso alle tue credenziali utente, completa i seguenti passaggi:

   1. Nella finestra di dialogo Accedi, fai clic sul tuo account utente.

   2. Seleziona Visualizzare, modificare, configurare ed eliminare i tuoi dati di Google Cloud … per concedere a Colab Enterprise l'accesso alle tue credenziali utente.

      

   3. Fai clic su Continua.

Colab Enterprise avvia il runtime predefinito e poi si connette.

Passa a un runtime predefinito con GPU

Se l'amministratore ha attivato i runtime predefiniti con GPU o se il tuo account utente dispone dell'autorizzazione aiplatform.notebookRuntimeTemplates.create, puoi passare a un runtime con GPU dopo la connessione al runtime predefinito.

Nel notebook, fai clic su Passa a GPU.

Per scoprire come attivare i runtime predefiniti con GPU, consulta Attivare i runtime predefiniti con GPU.

Gestione del runtime

Per impostazione predefinita, quando crei un runtime, disponi automaticamente delle autorizzazioni necessarie per eliminarlo (aiplatform.googleapis.com/notebookRuntimes.delete) e avviarlo (aiplatform.googleapis.com/notebookRuntimes.start).

Per scoprire come gestire il runtime, inclusi come eliminarlo, avviarlo o disconnetterti, consulta Gestire i runtime.

Risoluzione dei problemi

Questa sezione mostra come risolvere i problemi di connessione ai runtime in Colab Enterprise.

Impossibile connettersi a un runtime

Questo problema si verifica per diversi motivi. Vedi anche Impossibile connettersi a un runtime predefinito. Le cause più comuni sono:

Il browser blocca i cookie di terze parti

Il browser che stai utilizzando blocca un cookie di terze parti che Colab Enterprise utilizza per stabilire una connessione HTTPS con il runtime.

Per risolvere il problema, configura le impostazioni del browser in modo da consentire il cookie di terze parti DATALAB_TUNNEL_TOKEN del dominio *.aiplatform-notebook.googleusercontent.com.

La rete blocca il traffico in uscita verso i domini dei notebook

Le regole firewall della tua rete bloccano il traffico in uscita verso *.aiplatform-notebook.cloud.google.com o *aiplatform.googleapis.com.

Per risolvere il problema, configura le regole firewall della rete per consentire il traffico in uscita verso *.aiplatform-notebook.cloud.google.com e *aiplatform.googleapis.com.

Impossibile connettersi a un runtime predefinito

Il seguente errore si verifica quando provi a connetterti a un runtime predefinito quando non esiste un modello di runtime predefinito.

Failed to connect to runtime

Quando ti connetti a un runtime predefinito che non è ancora stato creato, Colab Enterprise crea prima un modello di runtime predefinito, e poi lo utilizza per generare il runtime predefinito. Tuttavia, se non disponi delle autorizzazioni necessarie per creare un modello di runtime, Colab Enterprise non può creare il modello di runtime predefinito né il runtime predefinito.

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

Il notebook si connette lentamente al runtime

Alcuni minuti dopo aver avviato una connessione a un runtime, il messaggio Connecting è ancora nell'angolo in alto a destra del notebook e Colab Enterprise non si è ancora connesso al runtime.

Per risolvere il problema, attendi qualche altro minuto. Colab Enterprise è ancora in fase di connessione a un runtime. La connessione a un runtime non ancora in esecuzione può richiedere alcuni minuti perché Vertex AI sta allocando una nuova istanza di macchina virtuale (VM).

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:

Risorse non disponibili

Il seguente errore si verifica quando provi a creare un runtime.

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 modello di runtime con una configurazione del tipo di macchina diversa, quindi crea un runtime basato sul nuovo modello di runtime.

Esiste già un runtime predefinito

Il seguente errore si verifica quando provi a creare un runtime dal modello di runtime predefinito quando il runtime predefinito esiste già.

Failed to create runtime

One click runtime already exists.

Se provi a creare un runtime da un modello di runtime predefinito, Colab Enterprise tenta di creare un runtime predefinito. Può esserci un solo runtime predefinito per utente, progetto e regione. Se il runtime predefinito esiste già, Colab Enterprise non è in grado di crearne un altro.

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

Impossibile creare un runtime predefinito

Quando Colab Enterprise crea un runtime predefinito, crea prima un modello di runtime predefinito che utilizza per generare il runtime predefinito. Se provi a creare un runtime predefinito senza le autorizzazioni necessarie per creare un modello 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'autorizzazione aiplatform.notebookRuntimeTemplates.create.

Passaggi successivi

• Scopri di più su runtime e modelli di runtime.
• Crea un modello di runtime.
• Per trovare un notebook che ti aiuti ad avviare rapidamente il tuo progetto, consulta la galleria dei notebook.