Notebookausführung planen

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.

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

    Enable the APIs

    5.

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

    Enable the APIs

    8.

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 IAM-Rolle "Notebook-Betrachter" (roles/notebooks.viewer) für das Projekt zu erteilen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierte Rolle enthält die Berechtigungen, die für die Interaktion mit dem Vertex AI Workbench-Executor erforderlich sind. Erweitern Sie den Abschnitt Erforderliche Berechtigungen, um die erforderlichen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind für die Interaktion mit dem Vertex AI Workbench-Executor erforderlich.

  • So listen Sie Ausführungen auf: notebooks.executions.list

Ihr Administrator kann dem Dienstkonto Ihrer Instanz möglicherweise auch diese Berechtigungen mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erteilen.

Instanz und Beispiel-Notebookdatei erstellen

  1. Instanz erstellen

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

    Zur Seite „VM-Instanzen“

  2. Klicken Sie neben dem Namen Ihrer Instanz auf JupyterLab öffnen.

    Ihre Vertex AI Workbench-Instanz ö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. Geben Sie unter Erweiterte Optionen 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.

  7. Klicken Sie auf Senden.

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

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 Instanz können Sie Ihre Notebookausgabe aufrufen, die Ergebnisse mit anderen teilen und die ausgeführte Notebookdatei in JupyterLab importieren.

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.

    Der Executor öffnet Ihr Ergebnis in einem neuen Browsertab.

Ausführungsergebnisse teilen

  1. Klicken Sie in der JupyterLab-Benutzeroberfläche Ihrer Instanz 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 Instanz 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 Instanz 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. Klicken Sie für den Zeitplan, den Sie aufrufen möchten, auf den Namen des Zeitplans.

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

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

    Der Executor öffnet Ihr Ergebnis in einem neuen Browsertab.

JupyterLab

  1. Klicken Sie in der JupyterLab-Benutzeroberfläche Ihrer Instanz 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.

    Der 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 den Zeitplan aus, den Sie löschen möchten.

  3. Klicken Sie auf  Löschen.

JupyterLab

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

  2. Klicken Sie auf den Tab Zeitpläne.

  3. Klicken Sie auf den Namen des Zeitplans. 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 Instanzen auf.

    Zur Seite „VM-Instanzen“

  2. Wählen Sie die Instanz aus, die Sie löschen möchten.

  3. Klicken Sie auf  Löschen.

Projekt löschen

Wenn Sie Ressourcen außerhalb Ihrer verwalteten Instanz 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.

  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