Laufzeit in Colab Enterprise erstellen

Auf dieser Seite erfahren Sie, wie Sie eine Laufzeit in Vertex AI 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 anhand einer Laufzeitvorlage erstellt, die Spezifikationen wie den Maschinentyp und die Laufwerkgröße enthält.

Weitere Informationen zu Laufzeiten finden Sie unter Laufzeiten und Laufzeitvorlagen.

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.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Make sure 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.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

6. Make sure that billing is enabled for your Google Cloud project.

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

   Enable the APIs

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihrem Nutzerkonto die IAM-Rolle Colab Enterprise Admin (roles/aiplatform.colabEnterpriseAdmin) für das Projekt zuzuweisen, damit Ihr Konto über die erforderlichen Berechtigungen zum Erstellen einer Laufzeit in Colab Enterprise verfügt. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Ihr Administrator kann Ihrem Nutzerkonto möglicherweise auch die erforderlichen Berechtigungen über benutzerdefinierte Rollen oder andere vordefinierte Rollen erteilen.

Mindestens eine der erforderlichen Rollen enthält die Berechtigung dataform.repositories.list. Nutzer, denen die Berechtigung dataform.repositories.list oder die Rolle Code-Ersteller (roles/dataform.codeCreator) in einem Projekt gewährt wurde, können die Namen von Code-Assets in diesem Projekt mit der Dataform API oder der Dataform-Befehlszeile verwenden. Nicht-Administratoren, die BigQuery Studio verwenden, sehen nur Code-Assets, die sie erstellt haben oder für sie freigegeben wurden.

Laufzeit erstellen

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

Console

So erstellen Sie eine Laufzeit:

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

   Laufzeiten aufrufen

2. Wählen Sie im Menü Region die Region aus, in der Sie die Laufzeit festlegen möchten. Diese muss sich in derselben Region befinden wie das Notebook, das es verwendet.

3. Klicken Sie auf  Laufzeit 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 Ihrer Laufzeit.
• RUNTIME_TEMPLATE_ID: die ID der Laufzeitvorlage. In der Laufzeitvorlage wird die Compute-Konfiguration der Laufzeit angegeben.
• PROJECT_ID: Ihre Projekt-ID.
• REGION: die Region, in der die Laufzeit ausgeführt werden soll.

Führen Sie folgenden Befehl aus:

Linux, macOS oder Cloud Shell

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

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

Windows (PowerShell)

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

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

Windows (cmd.exe)

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

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 Dokumentation zur gcloud CLI.

Laufzeit starten

Sie können die Google Cloud Console oder die gcloud CLI verwenden, um eine Laufzeit zu starten.

Console

So starten Sie eine Laufzeit:

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

   Laufzeiten aufrufen

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

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

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

Windows (PowerShell)

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

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

Windows (cmd.exe)

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

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 Dokumentation zur gcloud CLI.

Laufzeit löschen

Sie können eine Laufzeit mit der Google Cloud Console oder der gcloud CLI löschen.

Console

So löschen Sie eine Laufzeit:

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

   Laufzeiten aufrufen

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

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

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

Windows (PowerShell)

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

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

Windows (cmd.exe)

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

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 Dokumentation zur gcloud CLI.

Fehlerbehebung

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

Laufzeit konnte 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.

In Colab Enterprise wird das Compute Engine-Kontingent für Laufzeiten verwendet. Weitere Informationen finden Sie in der Übersicht über Kontingente und Limits für die Compute Engine.

Fordern Sie ein höheres Kontingent 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, das Problem zu beheben, indem Sie eine Laufzeit mit einer anderen Konfiguration des Maschinentyps verwenden oder es später noch einmal versuchen.

Es ist bereits eine Standardlaufzeit vorhanden

Der folgende Fehler tritt auf, wenn Sie versuchen, eine Laufzeit aus der Standardlaufzeitvorlage zu erstellen, die 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. Es kann nur eine Standardlaufzeit pro Nutzer, Projekt und Region geben. Wenn die Standardlaufzeit bereits vorhanden ist, kann in Colab Enterprise keine weitere Standardlaufzeit erstellt werden.

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, anhand derer die Standardlaufzeit generiert wird. Wenn Sie versuchen, eine Standardlaufzeit zu erstellen, ohne die erforderlichen Berechtigungen zum Erstellen einer Laufzeitvorlage zu haben, kann die Standardlaufzeit in Colab Enterprise nicht erstellt werden.

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

Nächste Schritte

• Weitere Informationen zu Laufzeiten und Laufzeitvorlagen.
• Stellen Sie eine Verbindung zur Laufzeit her.
• Weitere Informationen zum Erstellen einer Laufzeitvorlage