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. À compter du 30 janvier 2025, les notebooks gérés ne seront plus pris en charge et il ne sera plus possible de créer des instances de notebooks gérés. Les instances existantes continueront de fonctionner, 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

1. Connectez-vous à votre compte Google Cloud. Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de nos produits en conditions réelles. Les nouveaux clients bénéficient également de 300 $ de crédits gratuits pour exécuter, tester et déployer des charges de travail.

2. Dans Google Cloud Console, sur la page de sélection du projet, sélectionnez ou créez un projet Google Cloud.

   Remarque : Si vous ne comptez pas conserver les ressources créées dans cette procédure, créez un projet au lieu de sélectionner un projet existant. Après avoir suivi ces étapes, vous pouvez supprimer le projet. Cela entraîne la suppression de toutes les ressources qui lui sont associées.

   Accéder au sélecteur de projet

3. Vérifiez que la facturation est activée pour votre projet Google Cloud.

4. Activer les API Notebooks and Vertex AI.

   Activer les API

5. Dans Google Cloud Console, sur la page de sélection du projet, sélectionnez ou créez un projet Google Cloud.

   Remarque : Si vous ne comptez pas conserver les ressources créées dans cette procédure, créez un projet au lieu de sélectionner un projet existant. Après avoir suivi ces étapes, vous pouvez supprimer le projet. Cela entraîne la suppression de toutes les ressources qui lui sont associées.

   Accéder au sélecteur de projet

6. Vérifiez que la facturation est activée pour votre projet Google Cloud.

7. Activer les API Notebooks and Vertex AI.

   Activer les API

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 :

• 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 section Gérer les accès.

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 Google Cloud Console, 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 un planning

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 sur cette page soient facturées sur votre compte Google Cloud, procédez comme suit :

Supprimer l'instance

1. Dans Google Cloud Console, 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 aura les effets suivants :

• Tout le contenu du projet est supprimé. Si vous avez utilisé un projet existant pour les tâches de ce document, lorsque vous le supprimez, vous supprimez é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. Dans la console Google Cloud, accédez à la page Gérer les ressources.

   Accéder à la page Gérer les ressources

2. Dans la liste des projets, sélectionnez le projet que vous souhaitez supprimer, puis cliquez sur Supprimer.
3. Dans la boîte de dialogue, saisissez l'ID du projet, puis cliquez sur Arrêter pour supprimer le projet.

Étapes suivantes

• Apprenez-en plus sur la création d'une instance de notebook géré.

Pour voir un exemple de planification de notebook pour une exécution dans le cadre d'un workflow plus complet, exécutez le notebook Jupyter "Entraîner un modèle de classification à classes multiples pour le ciblage d'annonces" dans l'un des environnements suivants :

Exécuter dans Colab | Exécuter dans Colab Enterprise | Ouvrir dans les notebooks gérés par l'utilisateur Vertex AI Workbench | Afficher sur GitHub