Mit einer Laufzeit verbinden

Mit einer Laufzeit verbinden

Auf dieser Seite erfahren Sie, 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.

   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

Verbindung über verschiedene Methoden herstellen

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

• Standardlaufzeit verwenden
• Mit einer vorhandenen Laufzeit verbinden
• Laufzeit erstellen

Standardlaufzeit verwenden

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

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihrem Nutzerkonto die IAM-Rolle „Colab Enterprise User“ (roles/aiplatform.colabEnterpriseUser) für das Projekt zuzuweisen, um sicherzugehen, dass Ihr Nutzerkonto über die erforderlichen Berechtigungen zur Verbindung mit der Standardlaufzeit in einem Colab Enterprise-Notebook 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.

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 nicht eine 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 Notizen“

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

3. Klicken Sie auf das Notizbuch, 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.

   In der Standardlaufzeit sind Endnutzeranmeldedaten standardmäßig aktiviert. Wenn Sie eine Laufzeit verwenden möchten, die keinen Zugriff auf Ihre Nutzeranmeldedaten hat, erstellen Sie eine Laufzeitvorlage ohne aktivierte Endnutzeranmeldedaten.

   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 Google Cloud -Daten abrufen, bearbeiten, konfigurieren und löschen... aus, um Colab Enterprise Zugriff auf Ihre Nutzeranmeldedaten zu gewähren.

      

   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, Ihrem Nutzerkonto die IAM-Rolle „Colab Enterprise User“ (roles/aiplatform.colabEnterpriseUser) für das Projekt zuzuweisen, um sicherzugehen, dass Ihr Nutzerkonto über die erforderlichen Berechtigungen zur Verbindung mit einer vorhandenen Laufzeit in einem Colab Enterprise-Notebook 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.

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 Notizen“

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

3. Klicken Sie auf das Notizbuch, 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.

   Wenn Sie eine Laufzeit verwenden möchten, die keinen Zugriff auf Ihre Nutzeranmeldedaten hat, erstellen Sie eine Laufzeitvorlage ohne aktivierte Endnutzeranmeldedaten.

   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 Google Cloud -Daten abrufen, bearbeiten, konfigurieren und löschen... aus, um Colab Enterprise Zugriff auf Ihre Nutzeranmeldedaten zu gewähren.

      

   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, 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 und eine Verbindung dazu 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 Notizen“

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

3. Klicken Sie auf das Notizbuch, 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.

   Wenn Sie eine Laufzeit verwenden möchten, die keinen Zugriff auf Ihre Nutzeranmeldedaten hat, erstellen Sie eine Laufzeitvorlage ohne aktivierte Endnutzeranmeldedaten.

   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 Google Cloud -Daten abrufen, bearbeiten, konfigurieren und löschen... aus, um Colab Enterprise Zugriff auf Ihre Nutzeranmeldedaten zu gewähren.

      

   3. Klicken Sie auf Weiter.

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

Laufzeitverwaltung

Wenn Sie eine Laufzeit erstellen, haben Sie standardmäßig automatisch die erforderlichen Berechtigungen zum Löschen (aiplatform.googleapis.com/notebookRuntimes.delete) und Starten (aiplatform.googleapis.com/notebookRuntimes.start) dieser Laufzeit.

Fehlerbehebung

In diesem Abschnitt erfahren Sie, wie Sie Probleme beim Verbinden mit Laufzeiten in Colab Enterprise beheben.

Verbindung zu einer Laufzeit nicht möglich

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

Browser blockiert Cookies von Drittanbietern

Der von Ihnen verwendete Browser blockiert ein Drittanbieter-Cookie, das Colab Enterprise verwendet, 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 nicht möglich

Der folgende Fehler tritt auf, wenn Sie versuchen, eine Verbindung zu einer Standardlaufzeit herzustellen, für die 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 zu gewähren, um dieses Problem zu beheben.

Notebook stellt langsam eine Verbindung zur Laufzeit her

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

Warten Sie einige Minuten, um das Problem zu beheben. Colab Enterprise stellt weiterhin eine Verbindung zu einer Laufzeit her. Das Herstellen einer Verbindung zu einer Laufzeit, die noch nicht ausgeführt wird, kann einige Minuten dauern, da Vertex AI eine neue VM-Instanz (virtuelle Maschine) zuweist.

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:

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 für die Konfiguration Ihres Maschinentyps in der Region Ihres Notebooks keine Ressourcen 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 Colab Enterprise die Standardlaufzeit nicht erstellen.

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

Nächste Schritte

• Weitere Informationen zu Laufzeiten und Laufzeitvorlagen.
• Laufzeitvorlage erstellen.