Laufzeit erstellen

Auf dieser Seite erfahren Sie, wie Sie eine Laufzeit in Colab Enterprise erstellen, starten und löschen.

Sie können eine Laufzeit erstellen, um Code in einer Laufzeit mit einer anderen Konfiguration als der Standardkonfiguration auszuführen. Laufzeiten werden auf der Grundlage einer Laufzeitvorlage erstellt, die Spezifikationen wie Maschinentyp und Laufwerkgröße enthält.

Weitere Informationen zu Laufzeiten

Hinweise

  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.

    Go to project selector

  3. Verify 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.

    Go to project selector

  6. Verify that billing is enabled for your Google Cloud project.

  7. Enable the Vertex AI, Dataform, and Compute Engine APIs.

    Enable the APIs

    8.

    Erforderliche Rollen

    Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle „Colab Enterprise Admin“ (roles/aiplatform.colabEnterpriseAdmin) für das Projekt zuzuweisen, damit Sie über die erforderlichen Berechtigungen zum Erstellen einer Laufzeit in Colab Enterprise verfügen. 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 erstellen

    Sie können eine Laufzeit mit der Google Cloud Console, der Google Cloud CLI oder Terraform erstellen.

    Console

    So erstellen 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 Sie Ihre Laufzeitumgebung haben möchten. Diese muss sich in derselben Region befinden wie das Notebook, das es verwendet.

    3. Klicken Sie auf  Erstellen.

      Das Dialogfeld Vertex AI-Laufzeit erstellen wird angezeigt.

    4. Wählen Sie im Menü Laufzeitvorlage eine Laufzeitvorlage aus. Wenn keine Laufzeitvorlagen aufgeführt sind, erstellen Sie eine Laufzeitvorlage.

    5. Geben Sie im Feld Laufzeitname einen Namen für die Laufzeit ein.

    6. Klicken Sie auf Erstellen.

    Wenn Sie eine Laufzeit erstellen, haben Sie standardmäßig automatisch die erforderlichen Berechtigungen zum Starten und Löschen dieser Laufzeit.

    gcloud

    Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:

    • DISPLAY_NAME: Der Anzeigename für Ihre Laufzeit.
    • RUNTIME_TEMPLATE_ID: die ID der Laufzeitvorlage. Im Laufzeit-Template wird die Rechenkonfiguration Ihrer Laufzeit angegeben.
    • PROJECT_ID: Ihre Projekt-ID.
    • REGION: die Region, in der sich Ihre Laufzeit befinden soll.

    Führen Sie folgenden Befehl aus:

    Linux, macOS oder Cloud Shell

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

    Windows (PowerShell)

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

    Windows (cmd.exe)

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

    Wenn Sie eine Laufzeit erstellen, haben Sie standardmäßig automatisch die erforderlichen Berechtigungen zum Starten und Löschen dieser Laufzeit.

    Weitere Informationen zum Befehl zum Erstellen einer Laufzeitvorlage über die Befehlszeile finden Sie in der gcloud CLI-Dokumentation.

    Terraform

    Informationen zum Anwenden oder Entfernen einer Terraform-Konfiguration finden Sie unter Grundlegende Terraform-Befehle. Weitere Informationen finden Sie in der Anbieterreferenzdokumentation zu Terraform.

    Im folgenden Beispiel wird die Terraform-Ressource google_colab_runtime verwendet, um eine Colab Enterprise-Laufzeit zu erstellen. 

    resource "google_colab_runtime_template" "my_template" {
  name        = "{{index $.Vars "runtime_name"}}"
  display_name = "Runtime template full"
  location    = "us-central1"
  description = "Full runtime template"
  machine_spec {
    machine_type     = "n1-standard-2"
    accelerator_type = "NVIDIA_TESLA_T4"
    accelerator_count = "1"
  }

  data_persistent_disk_spec {
    disk_type    = "pd-standard"
    disk_size_gb = 200
  }

  network_spec {
    enable_internet_access = true
  }

  labels = {
    k = "val"
  }

  idle_shutdown_config {
    idle_timeout = "3600s"
  }

  euc_config {
    euc_disabled = true
  }

  shielded_vm_config {
    enable_secure_boot = true
  }

  network_tags = ["abc", "def"]

  encryption_spec {
    kms_key_name = "{{index $.Vars "key_name"}}"
  }
}

resource "google_colab_runtime" "{{$.PrimaryResourceId}}" {
  name = "{{index $.Vars "runtime_name"}}"
  location = "us-central1" 

  notebook_runtime_template_ref {
    notebook_runtime_template = google_colab_runtime_template.my_template.id
  }

  display_name = "Runtime full"
  runtime_user = "gterraformtestuser@gmail.com"
  description = "Full runtime"

  desired_state = "ACTIVE"

  auto_upgrade = true

  depends_on = [
    google_colab_runtime_template.my_template
  ]
}

    Fehlerbehebung

    In diesem Abschnitt erfahren Sie, wie Sie Probleme beim Erstellen von Runtimes in Colab Enterprise beheben.

    Laufzeit kann nicht erstellt werden

    Dieses Problem tritt auf, wenn Sie keine Laufzeit erstellen können. Siehe auch Standardlaufzeit kann nicht erstellt werden. Die häufigsten Ursachen sind:

    Unzureichendes Kontingent

    Wenn Sie keine Laufzeit erstellen können, haben Sie möglicherweise Ihr Compute Engine-Laufzeitkontingent überschritten.

    Für Laufzeiten in Colab Enterprise wird das Compute Engine-Kontingent verwendet. Weitere Informationen finden Sie in der Übersicht zu Compute Engine-Kontingenten und ‑Limits.

    Fordern Sie eine Kontingentanpassung an, um dieses Problem zu beheben.

    Nicht verfügbare Ressourcen

    Der folgende Fehler tritt auf, wenn Sie versuchen, eine Laufzeit zu erstellen.

    No available zone found for runtime RUNTIME_ID
for machine type MACHINE_TYPE
with accelerator type: ACCELERATOR. Please try again later.

    Dieser Fehler tritt auf, wenn in der Region Ihres Notebooks keine Ressourcen für die Konfiguration Ihres Maschinentyps verfügbar sind.

    Versuchen Sie Folgendes, um das Problem zu beheben:

    • Erstellen Sie eine Laufzeit in einer anderen Region.
    • Erstellen Sie eine Laufzeitvorlage mit einer anderen Maschinentypkonfiguration und dann eine Laufzeit basierend auf der neuen Laufzeitvorlage.

    Standardlaufzeit ist bereits vorhanden

    Der folgende Fehler tritt auf, wenn Sie versuchen, eine Laufzeit aus der Standardlaufzeitvorlage zu erstellen, wenn die Standardlaufzeit bereits vorhanden ist. 

    Failed to create runtime

One click runtime already exists.

    Wenn Sie versuchen, eine Laufzeit aus einer Standardlaufzeitvorlage zu erstellen, versucht Colab Enterprise, eine Standardlaufzeit zu erstellen. Pro Nutzer, Projekt und Region kann nur eine Standardlaufzeit vorhanden sein. Wenn die Standardlaufzeit bereits vorhanden ist, kann Colab Enterprise keine weitere Standardlaufzeit erstellen.

    Um dieses Problem zu beheben, stellen Sie eine Verbindung zur vorhandenen Standardlaufzeit her oder erstellen Sie eine Laufzeit aus einer nicht standardmäßigen Laufzeitvorlage.

    Standardlaufzeit kann nicht erstellt werden

    Wenn in Colab Enterprise eine Standardlaufzeit erstellt wird, wird zuerst eine Standardlaufzeitvorlage erstellt, die zum Generieren der Standardlaufzeit verwendet wird. Wenn Sie versuchen, eine Standardlaufzeit ohne die Berechtigungen zu erstellen, die zum Erstellen einer Laufzeitvorlage erforderlich sind, kann Colab Enterprise die Standardlaufzeit nicht erstellen.

    Bitten Sie Ihren Administrator, Ihnen eine Rolle mit der Berechtigung aiplatform.notebookRuntimeTemplates.create zuzuweisen, um dieses Problem zu beheben.

    Nächste Schritte