Gestisci runtime

Questa pagina descrive come gestire un runtime Colab Enterprise, incluse le seguenti attività:

  • Avvia un runtime.
  • Interrompere un runtime.
  • Disconnettersi da un runtime.
  • Riconnettiti a un runtime.
  • Modifica il runtime a cui sei connesso.
  • Eliminare un runtime.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per gestire un runtime 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.

Avvia un runtime

Per avviare un runtime, puoi utilizzare la console Google Cloud , gcloud CLI o l'API REST.

Console

Per avviare un runtime:

  1. Nella console Google Cloud , vai alla pagina 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, apporta le seguenti sostituzioni:

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

Esegui questo comando:

Linux, macOS o Cloud Shell

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

Windows (PowerShell)

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

Windows (cmd.exe)

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 di gcloud CLI.

REST

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

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

Metodo HTTP e URL:

POST https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimes/RUNTIME_ID:start

Per inviare la richiesta, scegli una di queste opzioni:

curl

Esegui questo comando:

curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d "" \
"https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimes/RUNTIME_ID:start"

PowerShell

Esegui questo comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
-Method POST `
-Headers $headers `
-Uri "https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimes/RUNTIME_ID:start" | Select-Object -Expand Content
In caso di esito positivo, il corpo della risposta contiene un'istanza di Operation.

Per saperne di più, consulta la documentazione dell'API REST di notebookRuntimes.start.

Interrompere un runtime

Per arrestare un runtime, puoi utilizzare gcloud CLI o l'API REST.

gcloud

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

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

Esegui questo comando:

Linux, macOS o Cloud Shell

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

Windows (PowerShell)

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

Windows (cmd.exe)

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

Per saperne di più sul comando per arrestare un runtime dalla riga di comando, consulta la documentazione della CLI gcloud.

REST

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

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

Metodo HTTP e URL:

POST https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimes/RUNTIME_ID:start

Per inviare la richiesta, scegli una di queste opzioni:

curl

Esegui questo comando:

curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d "" \
"https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimes/RUNTIME_ID:start"

PowerShell

Esegui questo comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
-Method POST `
-Headers $headers `
-Uri "https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimes/RUNTIME_ID:start" | Select-Object -Expand Content
In caso di esito positivo, il corpo della risposta contiene un'istanza di Operation.

Per saperne di più, consulta la documentazione dell'API REST di notebookRuntimes.stop.

Disconnettersi da un runtime

Per disconnettersi da un runtime:

  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. Apri il notebook da cui vuoi disconnetterti dal runtime.

  4. Nella barra degli strumenti dell'intestazione, fai clic su Runtime > Gestisci sessioni. Se non vedi la barra degli strumenti dell'intestazione, fai clic su  Attiva/disattiva visualizzazione intestazione.

  5. Nel riquadro Sessioni attive, fai clic sul pulsante  Termina sessione.

  6. Fai clic su Termina.

Riconnettersi a un runtime

Per riconnetterti a un runtime:

  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. Apri un notebook che è stato disconnesso di recente da un runtime.

  4. Nell'angolo in alto a destra del blocco note, fai clic su Riconnetti.

    Se il runtime a cui era precedentemente connesso il notebook è ancora in esecuzione, Colab Enterprise si connette. Se questo runtime non è più in esecuzione, si connette al runtime predefinito.

Modificare il runtime

Per cambiare il runtime a cui sei connesso:

  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. Apri un notebook connesso a un runtime.

  4. Nell'angolo in alto a destra del blocco note, fai clic su  Opzioni di connessione aggiuntive > Cambia tipo di runtime.

  5. Completa la finestra di dialogo per connetterti a un runtime.

Eliminare un runtime

Per eliminare un runtime, puoi utilizzare la console Google Cloud , gcloud CLI o l'API REST.

Console

Per eliminare una durata:

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

    Vai a Runtime

  2. Nel menu Regione, seleziona la regione che contiene 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, apporta le seguenti sostituzioni:

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

Esegui questo comando:

Linux, macOS o Cloud Shell

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

Windows (PowerShell)

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

Windows (cmd.exe)

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 di gcloud CLI.

REST

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

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

Metodo HTTP e URL:

DELETE https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimes/RUNTIME_ID

Per inviare la richiesta, scegli una di queste opzioni:

curl

Esegui questo comando:

curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimes/RUNTIME_ID"

PowerShell

Esegui questo comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
-Method DELETE `
-Headers $headers `
-Uri "https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimes/RUNTIME_ID" | Select-Object -Expand Content
In caso di esito positivo, il corpo della risposta contiene un'istanza di Operation.

Per saperne di più, consulta la documentazione dell'API REST di notebookRuntimes.delete.

Passaggi successivi