Laufzeiten verwalten
Auf dieser Seite wird beschrieben, wie Sie eine Colab Enterprise-Laufzeitumgebung verwalten. Dazu gehören die folgenden Aufgaben:
- Starten Sie eine Laufzeit.
- Laufzeit beenden
- Verbindung zu einer Laufzeit trennen
- Stellen Sie die Verbindung zu einer Laufzeit wieder her.
- Ändern Sie die Laufzeit, mit der Sie verbunden sind.
- Laufzeit löschen
Erforderliche Rollen
Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle „Colab Enterprise User“ (roles/aiplatform.colabEnterpriseUser
) für das Projekt zuzuweisen, damit Sie die Berechtigungen erhalten, die Sie zum Verwalten einer Colab Enterprise-Laufzeit benötigen.
Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.
Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.
Laufzeit starten
Sie können eine Laufzeit mit der Google Cloud Console, der gcloud CLI oder der REST API starten.
Console
So starten Sie eine Laufzeit:
-
Rufen Sie in der Google Cloud -Console die Colab Enterprise-Seite Runtimes auf.
-
Wählen Sie im Menü Region die Region aus, in der sich Ihre Laufzeit befindet.
-
Wählen Sie die Laufzeit aus, die Sie starten möchten.
-
Klicken Sie auf Start.
gcloud
Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:
RUNTIME_ID
: die ID Ihrer Laufzeit.PROJECT_ID
: Ihre Projekt-ID.REGION
: die Region, in der sich die Laufzeit befindet.
Führen Sie folgenden Befehl aus:
Linux, macOS oder 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
Weitere Informationen zum Befehl zum Erstellen einer Laufzeitvorlage über die Befehlszeile finden Sie in der gcloud CLI-Dokumentation.
REST
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
REGION
: die Region, in der sich die Laufzeit befindet.PROJECT_ID
: Ihre Projekt-ID.RUNTIME_ID
: die ID Ihrer Laufzeit.
HTTP-Methode und URL:
POST https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimes/RUNTIME_ID:start
Senden Sie die Anfrage mithilfe einer der folgenden Optionen:
curl
Führen Sie folgenden Befehl aus:
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
Führen Sie folgenden Befehl aus:
$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
Weitere Informationen finden Sie in der Dokumentation zur notebookRuntimes.start
REST API.
Laufzeit beenden
Sie können eine Laufzeit mit der gcloud CLI oder der REST API beenden.
gcloud
Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:
RUNTIME_ID
: die ID Ihrer Laufzeit.PROJECT_ID
: Ihre Projekt-ID.REGION
: die Region, in der sich die Laufzeit befindet.
Führen Sie folgenden Befehl aus:
Linux, macOS oder 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
Weitere Informationen zum Befehl zum Beenden einer Laufzeit über die Befehlszeile finden Sie in der gcloud CLI-Dokumentation.
REST
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
REGION
: die Region, in der sich die Laufzeit befindet.PROJECT_ID
: Ihre Projekt-ID.RUNTIME_ID
: die ID Ihrer Laufzeit.
HTTP-Methode und URL:
POST https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimes/RUNTIME_ID:start
Senden Sie die Anfrage mithilfe einer der folgenden Optionen:
curl
Führen Sie folgenden Befehl aus:
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
Führen Sie folgenden Befehl aus:
$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
Weitere Informationen finden Sie in der Dokumentation zur notebookRuntimes.stop
REST API.
Verbindung zu einer Laufzeit trennen
So trennen Sie die Verbindung zu einer Laufzeit:
-
Rufen Sie in der Google Cloud Console die Colab Enterprise-Seite Meine Notebooks auf.
-
Wählen Sie im Menü Region die Region aus, in der sich Ihr Notebook befindet.
-
Öffnen Sie das Notebook, das Sie von der Laufzeit trennen möchten.
-
Klicken Sie in der Kopfzeilentoolbar auf Laufzeit > Sitzungen verwalten. Wenn die Kopfzeilen-Symbolleiste nicht angezeigt wird, klicken Sie auf Sichtbarkeit des Headers aktivieren/deaktivieren.
-
Klicken Sie im Bereich Aktive Sitzungen auf die Schaltfläche
Sitzung beenden. -
Klicken Sie auf Kündigen.
Verbindung mit einer Laufzeit wiederherstellen
So stellen Sie die Verbindung zu einer Laufzeit wieder her:
-
Rufen Sie in der Google Cloud Console die Colab Enterprise-Seite Meine Notebooks auf.
-
Wählen Sie im Menü Region die Region aus, in der sich Ihr Notebook befindet.
-
Öffnen Sie ein Notebook, das vor Kurzem von einer Laufzeit getrennt wurde.
-
Klicken Sie rechts oben im Notebook auf Erneut verbinden.
Wenn die Laufzeit, mit der das Notebook zuvor verbunden war, noch ausgeführt wird, stellt Colab Enterprise eine Verbindung zu ihr her. Wenn diese Laufzeit nicht mehr ausgeführt wird, wird eine Verbindung zur Standardlaufzeit hergestellt.
Laufzeit ändern
So ändern Sie die Laufzeit, mit der Sie verbunden sind:
-
Rufen Sie in der Google Cloud Console die Colab Enterprise-Seite Meine Notebooks auf.
-
Wählen Sie im Menü Region die Region aus, in der sich Ihr Notebook befindet.
-
Öffnen Sie ein Notebook, das mit einer Laufzeit verbunden ist.
-
Klicken Sie rechts oben im Notebook auf > Laufzeittyp ändern.
Zusätzliche Verbindungsoptionen -
Füllen Sie das Dialogfeld aus, um eine Verbindung zu einer Laufzeit herzustellen.
Laufzeit löschen
Sie können eine Laufzeit mit der Google Cloud Console, der gcloud CLI oder der REST API löschen.
Console
So löschen Sie eine Laufzeit:
-
Rufen Sie in der Google Cloud -Console die Colab Enterprise-Seite Runtimes auf.
-
Wählen Sie im Menü Region die Region aus, in der sich Ihre Laufzeit befindet.
-
Wählen Sie die Laufzeit aus, die Sie löschen möchten.
-
Klicken Sie auf
Löschen. -
Klicken Sie auf Bestätigen.
gcloud
Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:
RUNTIME_ID
: die ID Ihrer Laufzeit.PROJECT_ID
: Ihre Projekt-ID.REGION
: die Region, in der sich die Laufzeit befindet.
Führen Sie folgenden Befehl aus:
Linux, macOS oder 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
Weitere Informationen zum Befehl zum Erstellen einer Laufzeitvorlage über die Befehlszeile finden Sie in der gcloud CLI-Dokumentation.
REST
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
REGION
: die Region, in der sich die Laufzeit befindet.PROJECT_ID
: Ihre Projekt-ID.RUNTIME_ID
: die ID Ihrer Laufzeit.
HTTP-Methode und URL:
DELETE https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimes/RUNTIME_ID
Senden Sie die Anfrage mithilfe einer der folgenden Optionen:
curl
Führen Sie folgenden Befehl aus:
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
Führen Sie folgenden Befehl aus:
$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
Weitere Informationen finden Sie in der Dokumentation zur notebookRuntimes.delete
REST API.
Nächste Schritte
- Weitere Informationen zu Laufzeiten und Laufzeitvorlagen.
- Laufzeitvorlage erstellen.