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 carichi di lavoro.

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.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Agent Platform, Dataform, and Compute Engine APIs.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). 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.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Agent Platform, Dataform, and Compute Engine APIs.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). 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
• Connettiti 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) 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.

Connettiti 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 Colab Enterprise I miei notebook.

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

Connettiti a un runtime esistente

Questa sezione descrive come connetterti a un runtime esistente utilizzando la finestra di dialogo Connetti ad Agent Platform Runtime.

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

Connettiti al runtime esistente

Per connetterti a un runtime esistente:

1. Nella Google Cloud console, vai a alla pagina Colab Enterprise I miei notebook.

   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 ad Agent Platform Runtime.

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, creane uno 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 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 ad Agent Platform Runtime. 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 utilizzando la finestra di dialogo Connetti ad Agent Platform Runtime :

1. Nella Google Cloud console, vai a alla pagina Colab Enterprise I miei notebook.

   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 ad Agent Platform Runtime.

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 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 Abilita 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 Gestisci 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.