Connetti a un runtime

Connetti a un runtime

Questa pagina mostra come connetterti 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 codice.

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.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

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.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

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

Connetti utilizzando metodi diversi

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

• Utilizza il runtime predefinito
• Connetti a un runtime esistente
• Crea un runtime

Utilizza il runtime predefinito

Questa sezione descrive come connetterti al runtime predefinito.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per connetterti al runtime predefinito in un notebook 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.

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 di Creator di codice (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) di 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.

Connetti 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 ne specifichi uno diverso.

Per connetterti al runtime predefinito senza eseguire il codice:

1. Nella Google Cloud console, vai a alla pagina I miei notebook 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 notebook, 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 abilitate, viene visualizzata una finestra di dialogo Accedi.

   Per impostazione predefinita, il runtime predefinito ha le credenziali dell'utente finale abilitate. Per utilizzare un runtime che non ha accesso alle tue credenziali utente, crea un modello di runtime senza le credenziali dell'utente finale abilitate.

   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 Visualizza, modifica, configura ed elimina i tuoi Google Cloud dati... 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 avvia il runtime predefinito e poi si connette.

Connetti a un runtime esistente

Questa sezione descrive come connetterti 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 notebook 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.

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 di Creator di codice (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) di 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.

Connetti al runtime esistente

Per connetterti a un runtime esistente:

1. Nella Google Cloud console, vai a alla pagina I miei notebook 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 notebook, creane uno.

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

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

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

6. In 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 il runtime ha le credenziali dell'utente finale abilitate e questa è la prima volta che ti connetti a un runtime con le credenziali dell'utente finale abilitate, viene visualizzata una finestra di dialogo Accedi.

   Per utilizzare un runtime che non ha accesso alle tue credenziali utente, crea un modello di runtime senza le credenziali dell'utente finale abilitate.

   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 Visualizza, modifica, configura ed elimina i tuoi Google Cloud dati... 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 avvia il runtime e poi si connette.

Crea un runtime

Questa sezione descrive come creare un runtime e connetterti 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) 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.

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 di Creator di codice (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) di 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 e connettiti

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

1. Nella Google Cloud console, vai a alla pagina I miei notebook 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 notebook, creane uno.

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

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

5. In 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 abilitate, e questa è la prima volta che ti connetti a un runtime con le credenziali dell'utente finale abilitate, viene visualizzata una finestra di dialogo Accedi.

   Per utilizzare un runtime che non ha accesso alle tue credenziali utente, crea un modello di runtime senza le credenziali dell'utente finale abilitate.

   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 Visualizza, modifica, configura ed elimina i tuoi Google Cloud dati... 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 abilitato 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 aver eseguito la connessione al runtime predefinito.

Nel notebook, fai clic su Passa a GPU.

Per scoprire come abilitare i runtime predefiniti con GPU, consulta Abilitare i runtime predefiniti con GPU.

Gestione del runtime

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

Per scoprire come gestire il runtime, inclusa la procedura per 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 utilizzato da Colab Enterprise per stabilire una connessione HTTPS con il runtime.

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

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

Le regole firewall della 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 in modo da 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 tenti di 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, allora 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' aiplatform.notebookRuntimeTemplates.create autorizzazione.

Il notebook impiega molto tempo per connettersi 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 minuto in più. 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 tenti di 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 tenti di creare un runtime dal modello di runtime predefinito quando il runtime predefinito esiste già.

Failed to create runtime

One click runtime already exists.

Se tenti di creare un runtime da un modello 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 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 tenti di 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' aiplatform.notebookRuntimeTemplates.create autorizzazione.

Passaggi successivi

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