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:

  1. Rufen Sie in der Google Cloud -Console die Colab Enterprise-Seite Runtimes auf.

    Zu Laufzeiten

  2. Wählen Sie im Menü Region die Region aus, in der sich Ihre Laufzeit befindet.

  3. Wählen Sie die Laufzeit aus, die Sie starten möchten.

  4. 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
Bei erfolgreicher Ausführung enthält der Antworttext eine Operation-Instanz.

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
Bei erfolgreicher Ausführung enthält der Antworttext eine Operation-Instanz.

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:

  1. Rufen Sie in der Google Cloud Console die Colab Enterprise-Seite Meine Notebooks auf.

    Zu „Meine Notebooks“

  2. Wählen Sie im Menü Region die Region aus, in der sich Ihr Notebook befindet.

  3. Öffnen Sie das Notebook, das Sie von der Laufzeit trennen möchten.

  4. Klicken Sie in der Kopfzeilentoolbar auf Laufzeit > Sitzungen verwalten. Wenn die Kopfzeilen-Symbolleiste nicht angezeigt wird, klicken Sie auf  Sichtbarkeit des Headers aktivieren/deaktivieren.

  5. Klicken Sie im Bereich Aktive Sitzungen auf die Schaltfläche  Sitzung beenden.

  6. Klicken Sie auf Kündigen.

Verbindung mit einer Laufzeit wiederherstellen

So stellen Sie die Verbindung zu einer Laufzeit wieder her:

  1. Rufen Sie in der Google Cloud Console die Colab Enterprise-Seite Meine Notebooks auf.

    Zu „Meine Notebooks“

  2. Wählen Sie im Menü Region die Region aus, in der sich Ihr Notebook befindet.

  3. Öffnen Sie ein Notebook, das vor Kurzem von einer Laufzeit getrennt wurde.

  4. 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:

  1. Rufen Sie in der Google Cloud Console die Colab Enterprise-Seite Meine Notebooks auf.

    Zu „Meine Notebooks“

  2. Wählen Sie im Menü Region die Region aus, in der sich Ihr Notebook befindet.

  3. Öffnen Sie ein Notebook, das mit einer Laufzeit verbunden ist.

  4. Klicken Sie rechts oben im Notebook auf  Zusätzliche Verbindungsoptionen > Laufzeittyp ändern.

  5. 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:

  1. Rufen Sie in der Google Cloud -Console die Colab Enterprise-Seite Runtimes auf.

    Zu Laufzeiten

  2. Wählen Sie im Menü Region die Region aus, in der sich Ihre Laufzeit befindet.

  3. Wählen Sie die Laufzeit aus, die Sie löschen möchten.

  4. Klicken Sie auf  Löschen.

  5. 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
Bei erfolgreicher Ausführung enthält der Antworttext eine Operation-Instanz.

Weitere Informationen finden Sie in der Dokumentation zur notebookRuntimes.delete REST API.

Nächste Schritte