Planifier l'exécution d'un notebook géré

Planifier l'exécution d'un notebook géré

Les notebooks gérés Vertex AI Workbench sont obsolètes. Depuis le 14 avril 2025, ils ne sont plus pris en charge et il n'est plus possible de créer des instances de notebooks gérés. Les instances existantes continueront de fonctionner jusqu'au 30 mars 2026, mais les correctifs, mises à jour et mises à niveau ne seront plus disponibles. Pour continuer à utiliser Vertex AI Workbench, nous vous recommandons de migrer vos instances de notebooks gérés vers des instances Vertex AI Workbench.

Cette page explique comment utiliser l'exécuteur de notebooks gérés Vertex AI Workbench pour exécuter un fichier notebook Python à intervalles réguliers.

Avant de commencer

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.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

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

Verify that billing is enabled for your Google Cloud project.

Enable the Notebooks and Vertex AI APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

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

Verify that billing is enabled for your Google Cloud project.

Enable the Notebooks and Vertex AI APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

Rôles requis

Pour vous assurer que le compte de service de votre instance dispose des autorisations nécessaires pour interagir avec l'exécuteur Vertex AI Workbench, demandez à votre administrateur d'accorder au compte de service de votre instance le rôle IAM suivant sur le projet :

Important : Vous devez accorder ces rôles au compte de service de votre instance, et non à votre compte utilisateur. Si vous ne les accordez pas au bon compte principal, vous risquez de rencontrer des erreurs d'autorisation.
• Lecteur de Notebooks (roles/notebooks.viewer)
• Utilisateur Vertex AI (roles/aiplatform.user)
• Administrateur de l'espace de stockage (roles/storage.admin)

Pour en savoir plus sur l'attribution de rôles, consultez la page Gérer l'accès aux projets, aux dossiers et aux organisations.

Votre administrateur peut également attribuer au compte de service de votre instance les autorisations requises à l'aide de rôles personnalisés ou d'autres rôles prédéfinis.

Créer une instance de notebook géré et un exemple de fichier notebook

1. Créez une instance de notebooks gérés.

2. Ouvrez JupyterLab.

3. Ouvrez un nouveau fichier notebook.

4. Dans la première cellule du fichier notebook, saisissez ce qui suit :

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

5. Pour vous assurer que votre fichier notebook est enregistré, sélectionnez Fichier > Enregistrer le notebook.

Planifier une exécution

1. Dans la console Google Cloud , accédez à la page Notebooks gérés.

   Accéder à la page "Notebooks gérés"

2. En regard de l'instance de notebook géré que vous souhaitez utiliser, cliquez sur Open JupyterLab (Ouvrir JupyterLab).

   Votre instance de notebooks gérés ouvre JupyterLab.

3. Dans l'explorateur de fichiers , double-cliquez sur l'exemple de fichier notebook pour l'ouvrir.

4. Cliquez sur le bouton  Exécuter.

5. Dans le champ Type de la boîte de dialogue Envoyer les notebooks à l'exécuteur, sélectionnez Exécutions récurrentes basées sur la planification.

   Par défaut, l'exécuteur exécute votre fichier notebook toutes les heures à la minute 00 de l'heure.

6. Dans Options avancées, sélectionnez la région dans laquelle vous souhaitez exécuter votre notebook.

7. Dans le champ Bucket Cloud Storage, saisissez un nom pour votre bucket, puis cliquez sur Créer et sélectionner. L'exécuteur stocke la sortie de votre notebook dans ce bucket Cloud Storage.

8. Cliquez sur Envoyer.

   Votre fichier notebook s'exécute automatiquement selon la planification que vous avez définie.

Remarque : Si votre instance de notebooks gérés est arrêtée, l'exécuteur continue d'exécuter votre fichier notebook selon le calendrier défini.

Une fois que vous avez terminé les tâches décrites dans ce document, vous pouvez éviter de continuer à payer des frais en supprimant les ressources que vous avez créées. Pour en savoir plus, consultez la section Effectuer un nettoyage.

Afficher, partager et importer un fichier notebook exécuté

L'interface JupyterLab de votre instance de notebooks gérés vous permet d'afficher les résultats de votre notebook, de les partager avec d'autres utilisateurs et d'importer le fichier du notebook exécuté dans JupyterLab.

Remarque : Pour afficher et partager les résultats des exécutions à l'aide de la console Google Cloud , sur la page Exécutions, cliquez sur Exécutions.

Afficher les résultats d'exécution

1. Dans le menu de navigation de JupyterLab, cliquez sur le bouton  Exécuteur de notebooks.

2. Cliquez sur l'onglet Exécutions.

3. Sous l'exécution que vous souhaitez afficher, cliquez sur Afficher le résultat.

   L'exécuteur ouvre votre résultat dans un nouvel onglet du navigateur.

Partager les résultats d'exécution

1. Dans l'interface utilisateur de JupyterLab de votre instance de notebooks gérés, cliquez sur le bouton  Exécuteur de notebooks dans le menu de navigation.

2. Cliquez sur l'onglet Exécutions.

3. À côté de l'exécution que vous souhaitez partager, cliquez sur le menu des options , puis sélectionnez Partager le résultat de l'exécution.

4. Suivez les instructions de la boîte de dialogue pour autoriser les utilisateurs à accéder au résultat d'exécution.

Importer le notebook exécuté dans JupyterLab

1. Dans l'interface utilisateur de JupyterLab de votre instance de notebooks gérés, cliquez sur le bouton  Exécuteur de notebooks dans le menu de navigation.

2. Cliquez sur l'onglet Exécutions.

3. À côté de l'exécution que vous souhaitez importer, cliquez sur le menu des options , puis sélectionnez Importer le notebook exécuté.

4. Si la boîte de dialogue Sélectionner le noyau s'affiche, sélectionnez le noyau auquel vous souhaitez ouvrir le notebook.

   L'exécuteur ouvre le fichier notebook exécuté dans JupyterLab et le stocke dans l'explorateur de fichiers JupyterLab dans un dossier nommé imported_notebook_jobs.

Afficher ou supprimer une planification

Vous pouvez afficher et supprimer des planifications à l'aide de la console Google Cloud ou de l'interface utilisateur JupyterLab de votre instance de notebooks gérés.

Afficher une planification

Affichez une planification pour afficher ses paramètres de fréquence ou pour afficher les cinq résultats les plus récents de l'exécution du fichier de notebook.

Console

1. Dans la console Google Cloud , accédez à la page Planifications.

   Accéder aux planifications

2. Sélectionnez la région dans laquelle vous souhaitez afficher les planifications.

3. Pour la page Détails de la planification que vous souhaitez ouvrir, cliquez sur son nom.

   Sur la page Détails de la planification, vous pouvez afficher les cinq dernières exécutions de la planification.

4. À côté d'un nom d'exécution, cliquez sur Afficher le résultat pour ouvrir le fichier notebook exécuté.

   L'exécuteur ouvre votre résultat dans un nouvel onglet du navigateur.

JupyterLab

1. Dans l'interface utilisateur de JupyterLab de votre instance de notebooks gérés, cliquez sur le bouton  Exécuteur de notebooks dans le menu de navigation.

2. Cliquez sur l'onglet Planifications.

3. Sous l'exécution que vous souhaitez afficher, cliquez sur Afficher le résultat de la dernière exécution.

   L'exécuteur ouvre votre résultat dans un nouvel onglet du navigateur.

Supprimer une programmation

La suppression d'une planification ne supprime pas les exécutions générées à partir de celle-ci.

Console

1. Dans la console Google Cloud , accédez à la page Planifications.

   Accéder aux planifications

2. Sélectionnez la région qui contient la planification que vous souhaitez supprimer.

3. Sélectionnez la planification que vous souhaitez supprimer.

4. Cliquez sur  Supprimer.

JupyterLab

1. Dans l'interface utilisateur de JupyterLab de votre instance de notebooks gérés, cliquez sur le bouton  Exécuteur de notebooks dans le menu de navigation.

2. Cliquez sur l'onglet Planifications.

3. À la fin du nom de la planification, cliquez sur l'icône  Ouvrir dans un nouvel onglet. La page Détails de la planification s'ouvre dans la console Google Cloud .

4. Cliquez sur  Supprimer.

Effectuer un nettoyage

Pour éviter que les ressources utilisées dans cette démonstration soient facturées sur votre compte Google Cloud , procédez comme suit :

Supprimer l'instance

1. Dans la console Google Cloud , accédez à la page Notebooks gérés.

   Accéder à la page "Notebooks gérés"

2. Sélectionnez la région qui contient votre instance.

3. Sélectionnez l'instance de notebooks gérés que vous souhaitez supprimer.

4. Cliquez sur  Supprimer.

Supprimer le projet

Si vous avez utilisé des ressources en dehors de votre instance de notebook géré, telles que le bucket Cloud Storage requis pour créer une planification, vous pouvez supprimer votre projet afin d'éviter que des frais supplémentaires ne soient facturés.

Attention : La suppression d'un projet entraîne les effets décrits ci-dessous :

• Tout le contenu du projet est supprimé. Si vous avez utilisé un projet existant pour les tâches décrites dans ce document et que vous le supprimez, vous supprimerez également tout autre travail effectué dans le projet.
• Les ID de projets personnalisés sont perdus. Lorsque vous avez créé ce projet, vous avez peut-être créé un ID de projet personnalisé que vous souhaitez utiliser à l'avenir. Pour conserver les URL qui utilisent l'ID de projet, telle qu'une URL appspot.com, supprimez les ressources sélectionnées dans le projet au lieu de supprimer l'ensemble du projet.

Si vous envisagez d'explorer plusieurs architectures, tutoriels et guides de démarrage rapide, réutiliser des projets peut vous aider à ne pas dépasser les limites de quotas des projets.

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.

Étapes suivantes

• Les instances de notebooks gérés Vertex AI Workbench sont obsolètes. Pour planifier l'exécution d'un notebook dans une instance Vertex AI Workbench, consultez Planifier l'exécution d'un notebook.