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

Prima di iniziare

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

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

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

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

   Enable the APIs

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

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

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

   Enable the APIs

Connettiti usando metodi diversi

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

• Utilizzare il runtime predefinito
• Connettiti a un runtime esistente
• Crea un runtime

Utilizza il runtime predefinito

Questa sezione descrive come connettersi al runtime predefinito.

Ruoli obbligatori

Per assicurarti che il tuo account utente disponga delle autorizzazioni necessarie per connettersi al runtime predefinito in un blocco note Colab Enterprise, chiedi all'amministratore di concedere al tuo account utente il ruolo IAM Utente Colab Enterprise (roles/aiplatform.colabEnterpriseUser) nel progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso a progetti, cartelle e organizzazioni.

L'amministratore potrebbe anche essere in grado di fornire il tuo account utente le autorizzazioni richieste tramite la ruoli o altri ruoli predefiniti ruoli.

Uno o più ruoli obbligatori includono dataform.repositories.list autorizzazione. 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 nel progetto utilizzando l'API Dataform o l'interfaccia a riga di comando (CLI) Dataform. I non amministratori che utilizzano BigQuery Studio può visualizzare solo gli asset di codice che hanno creato o che sono stati condivisi con loro.

Connettiti al runtime predefinito

Quando esegui il codice in un blocco note per la prima volta, Colab Enterprise si connette automaticamente al runtime predefinito, a meno che non lo specifichi un altro.

Per connetterti al runtime predefinito senza eseguire codice, segui questi passaggi:

1. Nella console Google Cloud, vai alla pagina Notebook di Colab Enterprise.

   Vai a Notebooks

2. Nel menu Regione, seleziona la regione contenente il blocco note.

3. Nella scheda I miei blocchi note, fai clic sul blocco note 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 attivate, viene visualizzata una finestra di dialogo Accedi.

   Il runtime predefinito ha le credenziali dell'utente finale abilitate per impostazione predefinita. 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 Dati Google Cloud... per concedere Colab Enterprise l'accesso alle credenziali utente.

      

   3. Fai clic su Continua.

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

Connettiti 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 assicurarti che il tuo account utente disponga delle autorizzazioni necessarie per connettersi a un runtime esistente in un blocco note Colab Enterprise, chiedi all'amministratore di concedere al tuo account utente il ruolo IAM Utente Colab Enterprise (roles/aiplatform.colabEnterpriseUser) nel progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso a progetti, cartelle e organizzazioni.

L'amministratore potrebbe anche assegnare al tuo account utente le autorizzazioni richieste tramite ruoli personalizzati o altri ruoli predefiniti.

Uno o più ruoli obbligatori includono dataform.repositories.list autorizzazione. 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 nel progetto utilizzando l'API Dataform o l'interfaccia a riga di comando (CLI) Dataform. Gli utenti non amministratori che utilizzano BigQuery Studio possono vedere solo le risorse di codice che hanno creato o che sono state condivise con loro.

Connettiti al runtime esistente

Per connetterti a un runtime esistente:

1. Nella console Google Cloud, vai alla pagina Notebook di Colab Enterprise.

   Vai a Notebooks

2. Nel menu Regione, seleziona la regione contenente il blocco note.

3. Nella scheda I miei quaderni, fai clic sul quaderno che vuoi aprire. Se non hai ancora creato un blocco note, crea un blocco note.

4. Nel blocco note, fai clic sulla freccia di espansione Opzioni di connessione aggiuntive. quindi seleziona Connetti a un runtime.
   

   Si apre la finestra di dialogo Connettiti al runtime 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 non sono presenti eventuali runtime nell'elenco, crea un runtime connettersi al runtime predefinito.

7. Fai clic su Connetti.

8. Se per il runtime sono abilitate le credenziali dell'utente finale, la prima volta che ti connetti a un runtime credenziali dell'utente finale attivate, viene visualizzata una finestra di dialogo Accedi.

   Per utilizzare un runtime che non ha accesso alle tue credenziali utente, creare un modello di runtime senza aver abilitato 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 Visualizza, modifica, configura ed elimina Dati Google Cloud... per concedere Colab Enterprise l'accesso alle credenziali utente.

      

   3. Fai clic su Continua.

Colab Enterprise si connette al runtime. Se il runtime non è in esecuzione, viene avviato Colab Enterprise il runtime e vi si connette.

Creare un runtime

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

Ruoli obbligatori

Per assicurarti che il tuo account utente disponga degli autorizzazioni per creare un runtime in Colab Enterprise, chiedi all'amministratore di concedere al tuo account utente la Amministratore Colab Enterprise (roles/aiplatform.colabEnterpriseAdmin) ruolo IAM per il progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso a progetti, cartelle e organizzazioni.

L'amministratore potrebbe anche essere in grado di fornire il tuo account utente le autorizzazioni richieste tramite la ruoli o altri ruoli predefiniti ruoli.

Uno o più dei ruoli richiesti includono l'autorizzazione dataform.repositories.list. Gli utenti a cui viene concessa l'autorizzazione dataform.repositories.list o Creatore di codice (roles/dataform.codeCreator) in un progetto può elencare degli asset di codice nel progetto utilizzando l'API Dataform o Interfaccia a riga di comando (CLI) Dataform. Gli utenti non amministratori che utilizzano BigQuery Studio possono vedere solo le risorse di codice che hanno creato o che sono state condivise con loro.

Crea un runtime e connettiti

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

1. Nella console Google Cloud, vai alla pagina Notebook di Colab Enterprise.

   Vai a Notebooks

2. Nel menu Regione, seleziona la regione contenente il blocco note.

3. Nella scheda I miei blocchi note, fai clic sul blocco note che vuoi aprire. Se non hai ancora creato un blocco note, crea un blocco note.

4. Nel blocco note, fai clic sulla freccia di espansione Opzioni di connessione aggiuntive. quindi seleziona Connetti a un runtime.
   

   Si apre la finestra di dialogo Connettiti al runtime 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, creazione un modello di runtime.

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

8. Fai clic su Connetti.

9. Se per il modello di runtime che hai selezionato sono abilitate le credenziali dell'utente finale, e che sia la prima volta che ti connetti a un runtime credenziali dell'utente finale attivate, 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 Dati Google Cloud... per concedere Colab Enterprise l'accesso alle credenziali utente.

      

   3. Fai clic su Continua.

Colab Enterprise avvia il runtime predefinito, e si connette.

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 di blocchi note

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 tua rete per 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.