Vertex AI Workbench est un environnement de développement unique pour l'ensemble du workflow de data science. Pour configurer un environnement de production de bout en bout basé sur un notebook, créez des instances JupyterLab avec des intégrations intégrées. Si vous ne connaissez pas Vertex AI, découvrez Vertex AI Workbench.
Cette page décrit le processus de gestion des notebooks JupyterLab dans Vertex AI Workbench, y compris la création et le partage de notebooks, ainsi que leur utilisation pour interagir avec les services Vertex AI. Cette page explique également comment supprimer et mettre à jour les instances JupyterLab qui hébergent vos notebooks.
Pour en savoir plus sur la sauvegarde et la restauration des données, consultez Créer une sauvegarde et restaurer des données de notebook.
Avant de commencer
Avant d'utiliser Vertex AI Workbench pour gérer des notebooks, vous devez disposer d'un projet prêt à exécuter les services Vertex AI. Pour en savoir plus, consultez Configurer un projet pour Vertex AI.
Pour obtenir les autorisations nécessaires pour gérer les ressources de notebook dans un espace de noms de projet, demandez à votre administrateur IAM de projet de vous accorder l'un des rôles suivants :
- Administrateur de notebooks Workbench (
workbench-notebooks-admin) : obtenez un accès en lecture et en écriture à toutes les ressources de notebook d'un projet. Vous avez besoin de ce rôle pour créer des notebooks JupyterLab. - Lecteur de notebooks Workbench (
workbench-notebooks-viewer) : obtenez un accès en lecture seule à toutes les ressources de notebook d'un projet. Vous avez besoin de ce rôle pour ouvrir des notebooks JupyterLab.
Pour en savoir plus sur ces rôles, consultez Préparer les autorisations IAM.
Créer un notebook JupyterLab
Cette section décrit la configuration d'une instance JupyterLab dans Vertex AI Workbench et la création d'un notebook JupyterLab dans l'instance.
Une fois les prérequis remplis, procédez comme suit pour configurer une instance JupyterLab et créer un notebook JupyterLab :
- Connectez-vous à la console GDC et sélectionnez votre projet.
- Dans le menu de navigation, cliquez sur Vertex AI > Workbench.
- Cliquez sur Nouveau notebook.
Sur la page Créer un notebook, saisissez des valeurs pour les champs suivants :
- Nom du notebook : saisissez le nom que vous souhaitez attribuer à votre notebook JupyterLab. Vertex AI Workbench utilise le nom que vous choisissez pour créer une URL permettant d'accéder à votre notebook.
- Environnement : sélectionnez une image Docker pour votre instance JupyterLab. Cette image fournit une base de référence pour le déploiement et les packages de machine learning (ML) classiques.
- Cluster : sélectionnez un cluster Kubernetes pour votre instance JupyterLab qui répond à vos exigences d'utilisation. Si aucun cluster Kubernetes n'est disponible, demandez à votre administrateur d'en ajouter un ou plusieurs.
- Processeurs / Mémoire : saisissez la quantité de processeurs et de RAM dont vous avez besoin pour vos charges de travail. Pour les charges de travail nécessitant une utilisation intensive du processeur, vous pouvez choisir plusieurs processeurs.
- GPU : sélectionnez le nombre de GPU dont vous avez besoin pour votre instance JupyterLab. Dans Distributed Cloud, un GPU est une tranche de GPU multi-instance (MIG) NVIDIA d'un GPU Tensor Core A100.
- Volume de l'espace de travail : saisissez la taille de stockage dont vous avez besoin en Go.
Cliquez sur Créer.
Vertex AI Workbench configure l'instance JupyterLab et crée votre notebook JupyterLab. Enregistrez l'URL du notebook pour y accéder ultérieurement.
Une fois que vous avez créé un notebook JupyterLab dans Vertex AI Workbench, ouvrez l'environnement de développement intégré (IDE) dans l'environnement JupyterLab. Pour en savoir plus, consultez Ouvrir un notebook JupyterLab.
Ouvrir un notebook JupyterLab
Saisissez l'URL d'un notebook JupyterLab dans un navigateur Web pour l'ouvrir. Si vous ne connaissez pas l'URL, procédez comme suit pour ouvrir le notebook :
- Connectez-vous à la console GDC et sélectionnez votre projet.
- Dans le menu de navigation, cliquez sur Vertex AI > Workbench.
- Recherchez le notebook JupyterLab que vous souhaitez ouvrir, puis cliquez sur Ouvrir JupyterLab pour ouvrir l'IDE de l'instance JupyterLab.
- Si vous êtes invité à vous authentifier, suivez les étapes d'authentification de votre fournisseur d'identité.
- Dans l'instance JupyterLab, ouvrez le notebook JupyterLab.
Partagez l'URL d'un notebook JupyterLab avec d'autres utilisateurs pour qu'ils puissent également l'ouvrir. L'utilisateur concerné doit disposer du rôle Lecteur de notebooks Workbench.
Utiliser les services Vertex AI à partir d'un notebook JupyterLab
Utilisez des bibliothèques clientes pour interagir avec un service Vertex AI à partir d'un notebook JupyterLab. Les bibliothèques clientes Vertex AI vous permettent d'effectuer des appels d'API par programmation vers n'importe quel service Vertex AI sur Distributed Cloud.
Procédez comme suit pour utiliser un service Vertex AI à partir d'un notebook JupyterLab :
- Activez l'API Vertex AI correspondante.
- Installez la bibliothèque cliente Vertex AI correspondante.
- Créez un notebook JupyterLab.
- Ouvrez le notebook JupyterLab et utilisez-le pour écrire du code avec les bibliothèques clientes Vertex AI. Par exemple, vous pouvez traduire du texte à l'aide de la bibliothèque cliente Vertex AI Translation.
Supprimer une instance JupyterLab
Procédez comme suit pour supprimer une instance JupyterLab :
- Connectez-vous à la console GDC et sélectionnez votre projet.
- Dans le menu de navigation, cliquez sur Vertex AI > Workbench.
- Recherchez le notebook associé à l'instance JupyterLab que vous souhaitez supprimer.
- Cochez la case du notebook JupyterLab.
- Cliquez sur Supprimer.
- Dans la boîte de dialogue Supprimer les notebooks, cliquez sur Supprimer.
Mettre à jour une instance JupyterLab
Une fois que votre opérateur d'infrastructure (IO) a mis à jour Distributed Cloud, vous pouvez mettre à jour vos instances JupyterLab.
Procédez comme suit pour chaque instance JupyterLab que vous souhaitez mettre à jour :
- Enregistrez les fichiers de l'instance JupyterLab que vous souhaitez conserver dans un bucket de stockage. Pour en savoir plus, consultez Importer et télécharger des objets de stockage dans des projets.
- Une fois la mise à jour effectuée, connectez-vous à la console GDC et sélectionnez votre projet.
- Configurez une nouvelle instance JupyterLab. Vertex AI Workbench crée une instance JupyterLab avec une nouvelle version de JupyterLab. Par exemple, la nouvelle instance JupyterLab contient des mises à jour de la bibliothèque cliente à partir de Distributed Cloud.
- Copiez les fichiers du bucket de stockage de l'instance JupyterLab obsolète vers la nouvelle instance JupyterLab.
Vous pouvez supprimer la version précédente de votre instance JupyterLab. Pour en savoir plus, consultez Supprimer une instance JupyterLab.