Ausführung eines verwalteten Notebooks planen

Ausführung eines verwalteten Notebooks planen

Von Vertex AI Workbench verwaltete Notebooks wurden verworfen. Am 30. Januar 2025 wird die Unterstützung für verwaltete Notebooks eingestellt und die Möglichkeit zum Erstellen verwalteter Notebookinstanzen wird entfernt. Vorhandene Instanzen funktionieren weiterhin, aber Patches, Updates und Upgrades sind nicht verfügbar. Um Vertex AI Workbench weiterhin zu verwenden, empfehlen wir Ihnen, Ihre nutzerverwalteten Notebooks-Instanzen zu Vertex AI Workbench-Instanzen zu migrieren.

Auf dieser Seite wird erläutert, wie Sie mit dem verwalteten Vertex AI Workbench-Notebook Executor eine Python-Notebookdatei nach einem stündlichen Zeitplan ausführen.

Vorbereitung

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 Notebooks and Vertex AI 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 Notebooks and Vertex AI APIs.

   Enable the APIs

Erforderliche Rollen

Damit das Dienstkonto Ihrer Instanz die erforderlichen Berechtigungen für die Interaktion mit dem Vertex AI Workbench-Executor hat, bitten Sie Ihren Administrator, dem Dienstkonto Ihrer Instanz die folgenden IAM-Rollen für das Projekt zu erteilen:

• Notebooks Viewer (roles/notebooks.viewer)
• Vertex AI-Nutzer (roles/aiplatform.user)
• Storage Admin (roles/storage.admin)

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Ihr Administrator kann dem Dienstkonto Ihrer Instanz möglicherweise auch die erforderlichen Berechtigungen über benutzerdefinierte Rollen oder andere vordefinierte Rollen erteilen.

Verwaltete Notebookinstanz und Beispiel-Notebookdatei erstellen

1. Erstellen Sie eine verwaltete Notebookinstanz.

2. Öffnen Sie JupyterLab.

3. Öffnen Sie eine neue Notebookdatei.

4. Geben Sie in der ersten Zelle der Notebookdatei Folgendes ein:

   # Import datetime
   import datetime
   
   # Get the time and print it
   datetime.datetime.now()
   print(datetime.datetime.now())

5. Wählen Sie Datei > Notebook speichern aus, um sicherzustellen, dass Ihre Notebookdatei gespeichert wird.

Ausführung planen

1. Rufen Sie in der Google Cloud Console die Seite Verwaltete Notebooks auf.

   Zu "Verwaltete Notebooks"

2. Klicken Sie neben der verwalteten Notebookinstanz, die Sie verwenden möchten, auf JupyterLab öffnen.

   Ihre verwaltete Notebookinstanz öffnet JupyterLab.

3. Doppelklicken Sie im  Dateibrowser auf die Beispiel-Notebookdatei, um sie zu öffnen.

4. Klicken Sie auf die Schaltfläche Ausführen.

5. Wählen Sie im Dialogfeld Notebooks an Executor senden im Feld Typ die Option Zeitplanbasierte wiederkehrende Ausführungen aus.

   Standardmäßig führt der Executor Ihre Notebookdatei jede Stunde in der 00. Minute der Stunde aus.

6. Wählen Sie unter Erweiterte Optionen die Region aus, in der Sie das Notebook ausführen möchten.

7. Geben Sie im Feld Cloud Storage-Bucket einen Namen für den Bucket ein und klicken Sie dann auf Erstellen und auswählen. Der Executor speichert Ihre Notebookausgabe im Cloud Storage-Bucket.

8. Klicken Sie auf Senden.

   Ihre Notebookdatei wird nach dem von Ihnen festgelegten Zeitplan automatisch ausgeführt.

Hinweis: Wenn Ihre verwaltete Notebookinstanz heruntergefahren wird, führt der Executor Ihre Notebookdatei weiterhin nach Zeitplan aus.

Nach Abschluss der in diesem Dokument beschriebenen Aufgaben können Sie weitere Kosten vermeiden, indem Sie die erstellten Ressourcen löschen. Weitere Informationen finden Sie unter Bereinigen.

Ausgeführte Notebookdatei ansehen, teilen und importieren

Mit der JupyterLab-Oberfläche Ihrer verwalteten Notebookinstanz können Sie Ihre Notebookausgabe aufrufen, die Ergebnisse mit anderen teilen und die ausgeführte Notebookdatei in JupyterLab importieren.

Hinweis: Wenn Sie die Google Cloud Console zum Abrufen und Freigeben von Ausführungsergebnissen verwenden möchten, klicken Sie auf der Seite Ausführungen auf Ausführungen.

Ausführungsergebnisse anzeigen

1. Klicken Sie im Navigationsmenü von JupyterLab auf die Schaltfläche  Notebook Executor.

2. Klicken Sie auf den Tab Ausführungen.

3. Klicken Sie unter der Ausführung, die Sie sehen möchten, auf Ergebnis anzeigen.

   Executor öffnet Ihr Ergebnis in einem neuen Browsertab.

Ausführungsergebnisse teilen

1. Klicken Sie in der JupyterLab-Benutzeroberfläche Ihrer verwalteten Notebookinstanz im Navigationsmenü auf die Schaltfläche  Notebook Executor.

2. Klicken Sie auf den Tab Ausführungen.

3. Klicken Sie neben der Ausführung, die Sie teilen möchten, auf das Optionsmenü und wählen Sie Ausführungsergebnis teilen aus.

4. Folgen Sie der Anleitung im Dialogfeld, um Nutzern Zugriff auf das Ausführungsergebnis zu gewähren.

Ausgeführtes Notebook in JupyterLab importieren

1. Klicken Sie in der JupyterLab-Benutzeroberfläche Ihrer verwalteten Notebookinstanz im Navigationsmenü auf die Schaltfläche  Notebook Executor.

2. Klicken Sie auf den Tab Ausführungen.

3. Klicken Sie neben der Ausführung, die Sie importieren möchten, auf das Optionsmenü und wählen Sie Ausgeführtes Notebook importieren aus.

4. Wenn das Dialogfeld Kernel auswählen angezeigt wird, wählen Sie den Kernel aus, der das Notebook öffnen soll.

   Der Executor öffnet die ausgeführte Notebookdatei in JupyterLab und speichert diese Notebookdatei im JupyterLab-Dateibrowser in einem Ordner mit dem Namen imported_notebook_jobs.

Zeitplan ansehen oder löschen

Sie können Zeitpläne entweder mit der Google Cloud Console oder mit der JupyterLab-Benutzeroberfläche Ihrer verwalteten Notebookinstanz aufrufen und löschen.

Zeitplan ansehen

Rufen Sie einen Zeitplan auf, um die Häufigkeitseinstellungen des Zeitplans oder die fünf neuesten Ergebnisse der Ausführung der Notebookdatei zu sehen.

Console

1. Rufen Sie in der Google Cloud Console die Seite Zeitpläne auf.

   Zu "Zeitpläne"

2. Wählen Sie die Region aus, für die Sie Zeitpläne sehen möchten.

3. Klicken Sie für die Seite Zeitplandetails, die Sie öffnen möchten, auf den Namen des Zeitplans.

   Auf der Seite Zeitplandetails können Sie die letzten fünf Ausführungen des Zeitplans sehen.

4. Klicken Sie neben einem Ausführungsnamen auf Ergebnis anzeigen, um die ausgeführte Notebookdatei zu öffnen.

   Executor öffnet Ihr Ergebnis in einem neuen Browsertab.

JupyterLab

1. Klicken Sie in der JupyterLab-Benutzeroberfläche Ihrer verwalteten Notebookinstanz im Navigationsmenü auf die Schaltfläche  Notebook Executor.

2. Klicken Sie auf den Tab Zeitpläne.

3. Klicken Sie unter der Ausführung, die Sie aufrufen möchten, auf Neuestes Ausführungsergebnis anzeigen.

   Executor öffnet Ihr Ergebnis in einem neuen Browsertab.

Zeitplan löschen

Beim Löschen eines Zeitplans werden die Ausführungen, die mit diesem Zeitplan generiert wurden, nicht gelöscht.

Console

1. Rufen Sie in der Google Cloud Console die Seite Zeitpläne auf.

   Zu "Zeitpläne"

2. Wählen Sie die Region aus, die den Zeitplan enthält, den Sie löschen möchten.

3. Wählen Sie den Zeitplan aus, den Sie löschen möchten.

4. Klicken Sie auf  Löschen.

JupyterLab

1. Klicken Sie in der JupyterLab-Benutzeroberfläche Ihrer verwalteten Notebookinstanz im Navigationsmenü auf die Schaltfläche  Notebook Executor.

2. Klicken Sie auf den Tab Zeitpläne.

3. Klicken Sie am Ende des Zeitplannamens auf das Symbol „In neuem Tab öffnen“ . Die Seite Zeitplandetails für diesen Zeitplan wird in der Google Cloud Console geöffnet.

4. Klicken Sie auf  Löschen.

Bereinigen

Mit den folgenden Schritten vermeiden Sie, dass Ihrem Google Cloud-Konto die in dieser Anleitung verwendeten Ressourcen in Rechnung gestellt werden:

Instanz löschen

1. Rufen Sie in der Google Cloud Console die Seite Verwaltete Notebooks auf.

   Zu "Verwaltete Notebooks"

2. Wählen Sie die Region aus, in der sich Ihre Instanz befindet.

3. Wählen Sie die verwaltete Notebookinstanz aus, die Sie löschen möchten.

4. Klicken Sie auf  Löschen.

Projekt löschen

Wenn Sie Ressourcen außerhalb Ihrer verwalteten Notebookinstanz verwendet haben, z. B. den zum Erstellen eines Zeitplans erforderlichen Cloud Storage-Bucket, sollten Sie eventuell Ihr Projekt löschen, um zusätzliche Gebühren zu vermeiden.

Achtung: Das Löschen von Projekten hat folgende Auswirkungen:

• Alle Inhalte des Projekts werden gelöscht. Wenn Sie für die Aufgaben in diesem Dokument ein bereits bestehendes Projekt verwendet haben und dieses löschen, werden auch alle anderen im Rahmen des Projekts erstellten Daten gelöscht.
• Benutzerdefinierte Projekt-IDs gehen verloren. Beim Erstellen dieses Projekts haben Sie möglicherweise eine benutzerdefinierte Projekt-ID erstellt, die Sie weiterhin verwenden möchten. Damit die URLs, die die Projekt-ID nutzen, z. B. eine appspot.com-URL, erhalten bleiben, sollten Sie ausgewählte Ressourcen innerhalb des Projekts löschen, statt das gesamte Projekt.

Wenn Sie mehrere Architekturen, Anleitungen und Kurzanleitungen durcharbeiten möchten, können Sie die Überschreitung von Projektkontingenten verhindern, indem Sie Projekte wiederverwenden.

1. In the Google Cloud console, go to the Manage resources page.

   Go to Manage resources

2. In the project list, select the project that you want to delete, and then click Delete.
3. In the dialog, type the project ID, and then click Shut down to delete the project.

Nächste Schritte

• Weitere Informationen zum Erstellen einer verwalteten Notebookinstanz

Wenn Sie ein Beispiel für die Planung eines Notebooks als Teil eines umfassenderen Workflows sehen möchten, führen Sie das Jupyter-Notebook „Klassifizierungsmodell mit mehreren Klassen für die Anzeigenausrichtung trainieren“ in einer der folgenden Umgebungen aus:

In Colab öffnen | In Colab Enterprise öffnen | In nutzerverwalteten Vertex AI Workbench-Notebooks öffnen | Auf GitHub ansehen