Connettiti a un runtime

Connettiti a un runtime

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

Per eseguire il codice nel tuo 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

Eseguire la connessione utilizzando diversi metodi

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 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 assegnare al tuo account utente le autorizzazioni richieste tramite 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 Creator 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 predefinito

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

Per connetterti al runtime predefinito senza eseguire codice:

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

   Vai a I miei quaderni

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

3. 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 i tuoi Google Cloud dati per concedere a Colab Enterprise 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 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ù dei ruoli richiesti includono l'autorizzazione dataform.repositories.list. Gli utenti a cui è stata concessa l'autorizzazione dataform.repositories.list o il ruolo Creator 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 I miei notebook di Colab Enterprise.

   Vai a I miei quaderni

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

3. Fai clic sul blocco note 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, quindi seleziona Connetti a un runtime.
   

   Viene visualizzata 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, crealo o connettiti al runtime predefinito.

7. Fai clic su Connetti.

8. Se il runtime ha le credenziali dell'utente finale abilitate e è la prima volta che ti colleghi 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 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.

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 delle autorizzazioni necessarie per creare un runtime in Colab Enterprise, chiedi all'amministratore di concedere al tuo account utente il ruolo IAM Amministratore di Colab Enterprise (roles/aiplatform.colabEnterpriseAdmin) 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ù dei ruoli richiesti includono l'autorizzazione dataform.repositories.list. Gli utenti a cui è stata concessa l'autorizzazione dataform.repositories.list o il ruolo Creator 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.

Crea un runtime e connettiti

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

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

   Vai a I miei quaderni

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

3. Fai clic sul blocco note 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, quindi seleziona Connetti a un runtime.
   

   Viene visualizzata 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, crea un modello di runtime.

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

8. Fai clic su Connetti.

9. Se nel modello di runtime selezionato sono attivate le credenziali dell'utente finale e se è la prima volta che ti connetti a un runtime con le 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 i tuoi Google Cloud dati per concedere a Colab Enterprise 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).

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 cookie di terze parti DATALAB_TUNNEL_TOKEN del dominio *.aiplatform-notebook.googleusercontent.com.

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

Le regole del 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 del 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 si tenta di connettersi 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 è stato ancora creato, Colab Enterprise crea innanzitutto un modello di runtime predefinito, che poi 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 è lento a connettersi al runtime

Pochi 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 ambiente di runtime predefinito. Le cause più comuni sono:

Risorse non disponibili

Quando provi a creare un runtime, si verifica il seguente errore.

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 un runtime con una configurazione del tipo di macchina diversa o riprova in un secondo momento.

Il runtime predefinito esiste già

Il seguente errore si verifica quando si tenta 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 provi a creare un runtime da un modello di runtime predefinito, Colab Enterprise versucht di creare un runtime predefinito. Può essere presente un solo runtime predefinito per utente, progetto e regione. Se il runtime predefinito esiste già, Colab Enterprise non è in grado di creare un altro runtime predefinito.

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