Verbindung zu einer Laufzeit in Colab Enterprise herstellen

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

Wenn Sie Code in Ihrem Notebook ausführen möchten, müssen Sie eine Verbindung zu einer Laufzeit herstellen. Eine Laufzeit ist eine Computing-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

Mithilfe verschiedener Methoden verbinden

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.

Eine oder mehrere der erforderlichen Rollen enthalten 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 zum ersten Mal in einem Notebook ausführen, stellt Colab Enterprise automatisch eine Verbindung zur Standardlaufzeit her, es sei denn, Sie geben eine andere an.

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

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

   Zu "Notebooks"

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

3. Klicken Sie auf dem Tab Meine Notebooks 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.

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

Eine oder mehrere der erforderlichen Rollen enthalten 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 Notebooks auf.

   Zu "Notebooks"

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

3. Klicken Sie auf dem Tab Meine Notebooks 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.

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

Eine oder mehrere der erforderlichen Rollen enthalten 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 Verbindung zu ihr 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 Notebooks auf.

   Zu "Notebooks"

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

3. Klicken Sie auf dem Tab Meine Notebooks 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.

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

Fehlerbehebung

In diesem Abschnitt wird beschrieben, wie Sie Probleme beim Herstellen einer Verbindung zu Laufzeiten in Colab Enterprise beheben.

Verbindung zu einer Laufzeit nicht möglich

Dieses Problem tritt aus verschiedenen Gründen auf. 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.

Nächste Schritte

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