Creare un runtime in Colab Enterprise

Questa pagina mostra come creare, avviare ed eliminare un ambiente di runtime in Vertex AI.

Puoi creare un runtime per eseguire il codice in un runtime con una configurazione diversa da quella predefinita. I runtime vengono creati in base a un modello di runtime, che include specifiche come il tipo di macchina e le dimensioni del disco.

Per scoprire di più sui runtime, consulta Runtime e modelli di runtime.

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

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.

Creare un runtime

Per creare un runtime, puoi utilizzare la console Google Cloud o Google Cloud CLI.

Console

Per creare un runtime:

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

   Vai a Runtime

2. Nel menu Regione, seleziona la regione in cui vuoi il runtime. Deve trovarsi nella stessa regione del notebook che lo utilizza.

3. Fai clic su  Crea runtime.

   Viene visualizzata la finestra di dialogo Crea runtime di Vertex AI.

4. Nel menu Modello di runtime, seleziona un modello di runtime. Se non sono elencati modelli di runtime, crea un modello di runtime.

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

6. Fai clic su Crea.

Per impostazione predefinita, quando crei un runtime, disponi automaticamente delle autorizzazioni necessarie per avviarlo ed eliminarlo.

gcloud

Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:

• DISPLAY_NAME: il nome visualizzato per il runtime.
• RUNTIME_TEMPLATE_ID: l'ID del modello di runtime. Il modello di runtime specifica la configurazione di calcolo del runtime.
• PROJECT_ID: il tuo ID progetto.
• REGION: la regione in cui vuoi il runtime.

Esegui il seguente comando:

Linux, macOS o Cloud Shell

Nota: assicurati di aver inizializzato Google Cloud CLI con l'autenticazione e un progetto eseguendo gcloud init; oppure gcloud auth login e gcloud config set project.

gcloud colab runtimes create --display-name="DISPLAY_NAME" \
    --runtime-template=RUNTIME_TEMPLATE_ID \
    --project=PROJECT_ID \
    --region=REGION

Windows (PowerShell)

Nota: assicurati di aver inizializzato Google Cloud CLI con l'autenticazione e un progetto eseguendo gcloud init; oppure gcloud auth login e gcloud config set project.

gcloud colab runtimes create --display-name="DISPLAY_NAME" `
    --runtime-template=RUNTIME_TEMPLATE_ID `
    --project=PROJECT_ID `
    --region=REGION

Windows (cmd.exe)

Nota: assicurati di aver inizializzato Google Cloud CLI con l'autenticazione e un progetto eseguendo gcloud init; oppure gcloud auth login e gcloud config set project.

gcloud colab runtimes create --display-name="DISPLAY_NAME" ^
    --runtime-template=RUNTIME_TEMPLATE_ID ^
    --project=PROJECT_ID ^
    --region=REGION

Per impostazione predefinita, quando crei un runtime, disponi automaticamente delle autorizzazioni necessarie per avviarlo ed eliminarlo.

Per ulteriori informazioni sul comando per creare un modello di runtime dalla riga di comando, consulta la documentazione della CLI gcloud.

Avvia un runtime

Per avviare un runtime, puoi utilizzare la console Google Cloud o lgcloud CLI.

Console

Per avviare un runtime:

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

   Vai a Runtime

2. Nel menu Regione, seleziona la regione che contiene il runtime.

3. Seleziona il runtime che vuoi avviare.

4. Fai clic su Avvia.

gcloud

Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:

• RUNTIME_ID: l'ID della runtime.
• PROJECT_ID: il tuo ID progetto.
• REGION: la regione in cui si trova il runtime.

Esegui il seguente comando:

Linux, macOS o Cloud Shell

Nota: assicurati di aver inizializzato Google Cloud CLI con l'autenticazione e un progetto eseguendo gcloud init; oppure gcloud auth login e gcloud config set project.

gcloud colab runtimes start RUNTIME_ID \
    --project=PROJECT_ID \
    --region=REGION

Windows (PowerShell)

Nota: assicurati di aver inizializzato Google Cloud CLI con l'autenticazione e un progetto eseguendo gcloud init; oppure gcloud auth login e gcloud config set project.

gcloud colab runtimes start RUNTIME_ID `
    --project=PROJECT_ID `
    --region=REGION

Windows (cmd.exe)

Nota: assicurati di aver inizializzato Google Cloud CLI con l'autenticazione e un progetto eseguendo gcloud init; oppure gcloud auth login e gcloud config set project.

gcloud colab runtimes start RUNTIME_ID ^
    --project=PROJECT_ID ^
    --region=REGION

Per ulteriori informazioni sul comando per creare un modello di runtime dalla riga di comando, consulta la documentazione della CLI gcloud.

Eliminare un runtime

Per eliminare un runtime, puoi utilizzare la console Google Cloud o la gcloud CLI.

Console

Per eliminare un runtime:

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

   Vai a Runtime

2. Nel menu Regione, seleziona la regione contenente il runtime.

3. Seleziona il runtime che vuoi eliminare.

4. Fai clic su  Elimina

5. Fai clic su Conferma.

gcloud

Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:

• RUNTIME_ID: l'ID della runtime.
• PROJECT_ID: il tuo ID progetto.
• REGION: la regione in cui si trova il runtime.

Esegui il seguente comando:

Linux, macOS o Cloud Shell

Nota: assicurati di aver inizializzato Google Cloud CLI con l'autenticazione e un progetto eseguendo gcloud init; oppure gcloud auth login e gcloud config set project.

gcloud colab runtimes delete RUNTIME_ID \
    --project=PROJECT_ID \
    --region=REGION

Windows (PowerShell)

Nota: assicurati di aver inizializzato Google Cloud CLI con l'autenticazione e un progetto eseguendo gcloud init; oppure gcloud auth login e gcloud config set project.

gcloud colab runtimes delete RUNTIME_ID `
    --project=PROJECT_ID `
    --region=REGION

Windows (cmd.exe)

Nota: assicurati di aver inizializzato Google Cloud CLI con l'autenticazione e un progetto eseguendo gcloud init; oppure gcloud auth login e gcloud config set project.

gcloud colab runtimes delete RUNTIME_ID ^
    --project=PROJECT_ID ^
    --region=REGION

Per ulteriori informazioni sul comando per creare un modello di runtime dalla riga di comando, consulta la documentazione della CLI gcloud.

Risoluzione dei problemi

Questa sezione mostra come risolvere i problemi relativi alla creazione di runtime in Colab Enterprise.

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:

Quota insufficiente

Se non riesci a creare un runtime, potresti aver superato la quota di runtime di Compute Engine.

Colab Enterprise utilizza la quota di Compute Engine per i runtime. Per ulteriori informazioni, consulta la panoramica delle quote e dei limiti di Compute Engine.

Per risolvere il problema, richiedi un limite di quota più alto.

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ò esserci 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.
• Connettiti al runtime.
• Scopri come creare un modello di runtime.