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:
-
Nella console Google Cloud , vai alla pagina Runtime di Colab Enterprise.
-
Nel menu Regione, seleziona la regione che contiene il runtime.
-
Seleziona il runtime che vuoi avviare.
-
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
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
Per saperne di più, consulta la documentazione dell'API REST di notebookRuntimes.stop
.
Disconnettersi da un runtime
Per disconnettersi da un runtime:
-
Nella console Google Cloud , vai alla pagina I miei blocchi note di Colab Enterprise.
-
Nel menu Regione, seleziona la regione che contiene il notebook.
-
Apri il notebook da cui vuoi disconnetterti dal runtime.
-
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.
-
Nel riquadro Sessioni attive, fai clic sul pulsante
Termina sessione. -
Fai clic su Termina.
Riconnettersi a un runtime
Per riconnetterti a un runtime:
-
Nella console Google Cloud , vai alla pagina I miei blocchi note di Colab Enterprise.
-
Nel menu Regione, seleziona la regione che contiene il notebook.
-
Apri un notebook che è stato disconnesso di recente da un runtime.
-
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:
-
Nella console Google Cloud , vai alla pagina I miei blocchi note di Colab Enterprise.
-
Nel menu Regione, seleziona la regione che contiene il notebook.
-
Apri un notebook connesso a un runtime.
-
Nell'angolo in alto a destra del blocco note, fai clic su > Cambia tipo di runtime.
Opzioni di connessione aggiuntive -
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:
-
Nella console Google Cloud , vai alla pagina Runtime di Colab Enterprise.
-
Nel menu Regione, seleziona la regione che contiene il runtime.
-
Seleziona il runtime che vuoi eliminare.
-
Fai clic su
Elimina -
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
Per saperne di più, consulta la documentazione dell'API REST di notebookRuntimes.delete
.
Passaggi successivi
- Scopri di più su runtime e modelli di runtime.
- Crea un modello di runtime.