Mit einer Laufzeit verbinden

Auf dieser Seite wird beschrieben, wie Sie in Colab Enterprise eine Verbindung zu einer Laufzeit herstellen.

Wenn Sie Code in Ihrem Notebook ausführen möchten, müssen Sie eine Verbindung zu einer Laufzeit herstellen. Eine Laufzeit ist eine Compute-Ressource, die Ihren Code ausführt.

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

    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

  8. Verbindung über verschiedene Methoden herstellen

    Auf dieser Seite wird beschrieben, wie Sie mit folgenden Methoden eine Verbindung zu einer Laufzeit herstellen:

    Standardlaufzeit verwenden

    In diesem Abschnitt wird beschrieben, wie Sie eine Verbindung zur Standardlaufzeit herstellen.

    Erforderliche Rollen

    Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle „Colab Enterprise User“ (roles/aiplatform.colabEnterpriseUser) für das Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Herstellen einer Verbindung zur Standardlaufzeit in einem Colab Enterprise-Notebook 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.

    Verbindung zur Standardlaufzeit herstellen

    Wenn Sie Code in einem Notebook zum ersten Mal ausführen, stellt Colab Enterprise automatisch eine Verbindung zur Standardlaufzeit her, sofern Sie keine andere Laufzeit angeben.

    So stellen Sie eine Verbindung zur Standardlaufzeit her, ohne Code auszuführen:

    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. Klicken Sie auf das Notebook, das Sie öffnen möchten. Wenn Sie noch kein Notebook erstellt haben, erstellen Sie ein Notebook.

    4. Klicken Sie in Ihrem Notebook auf Verbinden.

    5. Wenn Sie zum ersten Mal eine Verbindung mit einer Laufzeit herstellen, in der Endnutzeranmeldedaten aktiviert sind, wird ein Dialogfeld Anmelden angezeigt.

      Führen Sie die folgenden Schritte aus, um Colab Enterprise Zugriff auf Ihre Nutzeranmeldedaten zu gewähren:

      1. Klicken Sie im Dialogfeld Anmelden auf Ihr Nutzerkonto.

      2. Wählen Sie Ihre Google Cloud -Daten aufrufen, bearbeiten, konfigurieren und löschen... aus, um Colab Enterprise Zugriff auf Ihre Nutzeranmeldedaten zu gewähren.

        Klicken Sie auf das Kästchen neben einer Anweisung mit dem Text: „Google Cloud-Daten abrufen, bearbeiten, konfigurieren und löschen sowie die E-Mail-Adresse Ihres Google-Kontos abrufen“.
      3. Klicken Sie auf Weiter.

    Colab Enterprise stellt eine Verbindung zur Standardlaufzeit her. Wird die Standardlaufzeit nicht ausgeführt, startet Colab Enterprise die Standardlaufzeit und stellt dann eine Verbindung zu ihr her.

    Mit einer vorhandenen Laufzeit verbinden

    In diesem Abschnitt wird beschrieben, wie Sie über das Dialogfeld Mit Vertex AI-Laufzeit verbinden eine Verbindung zu einer vorhandenen Laufzeit herstellen.

    Erforderliche Rollen

    Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle „Colab Enterprise User“ (roles/aiplatform.colabEnterpriseUser) für das Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Herstellen einer Verbindung zu einer vorhandenen Laufzeit in einem Colab Enterprise-Notebook 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.

    Mit der vorhandenen Laufzeit verbinden

    So stellen Sie eine Verbindung zu einer vorhandenen Laufzeit 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. Klicken Sie auf das Notebook, das Sie öffnen möchten. Wenn Sie noch kein Notebook erstellt haben, erstellen Sie ein Notebook.

    4. Klicken Sie im Notebook auf den Erweiterungspfeil Zusätzliche Verbindungsoptionen und wählen Sie dann Mit einer Laufzeit verbinden aus.

      Das Dialogfeld Mit Vertex AI-Laufzeit verbinden wird geöffnet.

    5. Wählen Sie unter Laufzeit auswählen Verbindung mit einer vorhandenen Laufzeit herstellen aus.

    6. Wählen Sie unter Vorhandene Laufzeitoption auswählen die Laufzeit aus, mit der Sie eine Verbindung herstellen möchten. Wenn die Liste keine Laufzeiten enthält, erstellen Sie eine Laufzeit oder stellen eine Verbindung zur Standardlaufzeit her.

    7. Klicken Sie auf Verbinden.

    8. Wenn in Ihrer Laufzeit Endnutzeranmeldedaten aktiviert sind und Sie zum ersten Mal eine Verbindung mit einer Laufzeit herstellen, in der Endnutzeranmeldedaten aktiviert sind, wird ein Dialogfeld Anmelden angezeigt.

      Führen Sie die folgenden Schritte aus, um Colab Enterprise Zugriff auf Ihre Nutzeranmeldedaten zu gewähren:

      1. Klicken Sie im Dialogfeld Anmelden auf Ihr Nutzerkonto.

      2. Wählen Sie Ihre Google Cloud -Daten aufrufen, bearbeiten, konfigurieren und löschen... aus, um Colab Enterprise Zugriff auf Ihre Nutzeranmeldedaten zu gewähren.

        Klicken Sie auf das Kästchen neben einer Anweisung mit dem Text: „Google Cloud-Daten abrufen, bearbeiten, konfigurieren und löschen sowie die E-Mail-Adresse Ihres Google-Kontos abrufen“.
      3. Klicken Sie auf Weiter.

    Colab Enterprise stellt eine Verbindung zur Laufzeit her. Wird die Laufzeit nicht ausgeführt, startet Colab Enterprise die Laufzeit und stellt dann eine Verbindung zu ihr her.

    Laufzeit erstellen

    In diesem Abschnitt wird beschrieben, wie Sie eine Laufzeit erstellen und über das Dialogfeld Mit Vertex AI-Laufzeit verbinden eine Verbindung zu ihr herstellen. Alternativ können Sie Laufzeit über den Tab Laufzeiten erstellen.

    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 und Verbindung herstellen

    So erstellen Sie eine Laufzeit und stellen über das Dialogfeld Mit Vertex AI-Laufzeit verbinden eine Verbindung zu ihr 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. Klicken Sie auf das Notebook, das Sie öffnen möchten. Wenn Sie noch kein Notebook erstellt haben, erstellen Sie ein Notebook.

    4. Klicken Sie im Notebook auf den Erweiterungspfeil Zusätzliche Verbindungsoptionen und wählen Sie dann Mit einer Laufzeit verbinden aus.

      Das Dialogfeld Mit Vertex AI-Laufzeit verbinden wird geöffnet.

    5. Wählen Sie unter Laufzeit auswählen Neue Laufzeit erstellen aus.

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

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

    8. Klicken Sie auf Verbinden.

    9. Wenn in der ausgewählten Laufzeitvorlage Endnutzeranmeldedaten aktiviert sind und Sie zum ersten Mal eine Verbindung mit einer Laufzeit herstellen, in der Endnutzeranmeldedaten aktiviert sind, wird ein Dialogfeld Anmelden angezeigt.

      Führen Sie die folgenden Schritte aus, um Colab Enterprise Zugriff auf Ihre Nutzeranmeldedaten zu gewähren:

      1. Klicken Sie im Dialogfeld Anmelden auf Ihr Nutzerkonto.

      2. Wählen Sie Ihre Google Cloud -Daten aufrufen, bearbeiten, konfigurieren und löschen... aus, um Colab Enterprise Zugriff auf Ihre Nutzeranmeldedaten zu gewähren.

        Klicken Sie auf das Kästchen neben einer Anweisung mit dem Text: „Google Cloud-Daten abrufen, bearbeiten, konfigurieren und löschen sowie die E-Mail-Adresse Ihres Google-Kontos abrufen“.
      3. Klicken Sie auf Weiter.

    Colab Enterprise startet die Standardlaufzeit und stellt dann eine Verbindung zu ihr her.

    Zu einer Standardlaufzeit mit GPUs wechseln

    Wenn Ihr Administrator Standardlaufzeiten mit GPU aktiviert hat oder Ihr Nutzerkonto die Berechtigung aiplatform.notebookRuntimeTemplates.create hat, können Sie nach der Verbindung mit der Standardlaufzeit zu einer Laufzeit mit GPUs wechseln.

    Klicken Sie in Ihrem Notebook auf Zur GPU wechseln.

    Informationen zum Aktivieren von Standardlaufzeiten mit GPUs finden Sie unter Standardlaufzeiten mit GPUs aktivieren.

    Laufzeitverwaltung

    Wenn Sie eine Laufzeit erstellen, haben Sie standardmäßig die erforderlichen Berechtigungen, um sie zu löschen (aiplatform.googleapis.com/notebookRuntimes.delete) und zu starten (aiplatform.googleapis.com/notebookRuntimes.start).

    Informationen zum Verwalten der Laufzeit, einschließlich zum Löschen, Starten oder Trennen der Verbindung zur Laufzeit, finden Sie unter Laufzeiten verwalten.

    Fehlerbehebung

    In diesem Abschnitt erfahren Sie, wie Sie Probleme mit der Verbindung zu Runtimes in Colab Enterprise beheben.

    Verbindung zu einer Laufzeit kann nicht hergestellt werden

    Dieses Problem kann verschiedene Ursachen haben. Weitere Informationen finden Sie unter Verbindung zu einer Standardlaufzeit kann nicht hergestellt werden. Die häufigsten Ursachen sind:

    Browser blockiert Cookies von Drittanbietern

    Der von Ihnen verwendete Browser blockiert ein Drittanbieter-Cookie, das von Colab Enterprise verwendet wird, um eine HTTPS-Verbindung zur Laufzeit herzustellen.

    Zur Behebung dieses Problems konfigurieren Sie Ihre Browsereinstellungen so, dass das Drittanbieter-Cookie DATALAB_TUNNEL_TOKEN aus der Domain *.aiplatform-notebook.googleusercontent.com zugelassen wird.

    Netzwerk blockiert ausgehenden Traffic zu Notebookdomains

    Die Firewallregeln Ihres Netzwerks blockieren ausgehenden Datenverkehr an *.aiplatform-notebook.cloud.google.com oder *aiplatform.googleapis.com.

    Zur Behebung dieses Problems konfigurieren Sie die Firewallregeln Ihres Netzwerks so, dass ausgehender Traffic zu *.aiplatform-notebook.cloud.google.com und *aiplatform.googleapis.com zugelassen wird.

    Verbindung zu einer Standardlaufzeit kann nicht hergestellt werden

    Der folgende Fehler tritt auf, wenn Sie versuchen, eine Verbindung zu einer Standardlaufzeit herzustellen, aber keine Standardlaufzeitvorlage vorhanden ist.

    Failed to connect to runtime
    

    Wenn Sie eine Verbindung zu einer Standardlaufzeit herstellen, die noch nicht erstellt wurde, erstellt Colab Enterprise zuerst eine Standardlaufzeitvorlage und verwendet diese dann, um die Standardlaufzeit zu generieren. Wenn Sie jedoch nicht die erforderlichen Berechtigungen zum Erstellen einer Laufzeitvorlage haben, kann Colab Enterprise weder die Standardlaufzeitvorlage noch die Standardlaufzeit erstellen.

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

    Notebook stellt nur langsam eine Verbindung zur Laufzeit her

    Einige Minuten nach dem Starten einer Verbindung zu einer Laufzeit wird die Meldung Connecting immer noch rechts oben im Notebook angezeigt und Colab Enterprise hat noch keine Verbindung zur Laufzeit hergestellt.

    Warten Sie einige Minuten, um dieses Problem zu beheben. Colab Enterprise stellt noch eine Verbindung zu einer Laufzeit her. Die Verbindung zu einer Laufzeit, die noch nicht ausgeführt wird, kann einige Minuten dauern, da Vertex AI eine neue VM-Instanz zuweist.

    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:

    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