Connettiti a un runtime in Colab Enterprise

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.

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.

Enable the APIs

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

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.

Enable the APIs

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

Uno o più dei ruoli richiesti includono l'autorizzazione dataform.repositories.list. Gli utenti a cui è stata concessa l'autorizzazione dataform.repositories.list o il ruolo Creatore 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) Dataform. Gli utenti non amministratori che utilizzano BigQuery Studio possono visualizzare solo gli asset di codice che hanno creato o che sono stati condivisi con loro.

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

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

   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.

Uno o più dei ruoli richiesti includono l'autorizzazione dataform.repositories.list. Gli utenti a cui è stata concessa l'autorizzazione dataform.repositories.list o il ruolo Creatore 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) Dataform. Gli utenti 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 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, creane uno 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 utilizzare un runtime che non ha accesso alle tue credenziali utente, crea un modello di runtime senza attivare le credenziali dell'utente finale.

   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.

Uno o più dei ruoli richiesti includono l'autorizzazione dataform.repositories.list. Gli utenti a cui è stata concessa l'autorizzazione dataform.repositories.list o il ruolo Creatore 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) Dataform. Gli utenti 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 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 utilizzare un runtime che non ha accesso alle tue credenziali utente, crea un modello di runtime senza attivare le credenziali dell'utente finale.

   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.

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. 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 in modo da consentire il traffico in uscita verso *.aiplatform-notebook.cloud.google.com e *aiplatform.googleapis.com.

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.