Créer une instance de notebooks gérés à l'aide de la console Google Cloud

Découvrez comment créer une instance de notebooks gérés Vertex AI Workbench et ouvrir JupyterLab à l'aide de la console Google Cloud . Cette page explique également comment arrêter, démarrer, réinitialiser ou supprimer une instance de notebooks gérés.

Avant de commencer

  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.

    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.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. Enable the Notebooks API.

    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 API

  5. 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.

    Go to project selector

  6. Verify that billing is enabled for your Google Cloud project.

  7. Enable the Notebooks API.

    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 API

  8. Créer une instance

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

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

    2. Cliquez sur  Créer.

    3. Dans le champ Nom de la fenêtre Créer une instance, saisissez my-instance.

    4. Cliquez sur Créer.

    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.

    Ouvrir JupyterLab

    Une fois l'instance créée, Vertex AI Workbench la démarre automatiquement. Lorsque l'instance est prête à l'emploi, Vertex AI Workbench active automatiquement un lien Ouvrir JupyterLab.

    1. À côté du nom de votre instance de notebooks gérés, cliquez sur Ouvrir JupyterLab.

    2. Dans la boîte de dialogue Authentifier votre notebook géré, cliquez sur le bouton pour obtenir un code d'authentification.

    3. Choisissez un compte, puis cliquez sur Autoriser. Copiez le code d'authentification.

    4. Dans la boîte de dialogue Authentifier votre notebook géré, collez le code d'authentification, puis cliquez sur Authentifier.

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

    Ouvrir un nouveau fichier notebook

    1. Sélectionnez Fichier > Nouveau > Notebook.

    2. Dans la boîte de dialogue Sélectionner le noyau, sélectionnez Python, puis cliquez sur Sélectionner.

      Le nouveau fichier notebook s'ouvre.

    Modifier le noyau

    Vous pouvez modifier le noyau du fichier notebook JupyterLab à partir du menu ou dans le fichier.

    1. Dans JupyterLab, dans le menu Noyau, cliquez sur Modifier le noyau.

    2. Dans la boîte de dialogue Sélectionner le noyau, sélectionnez un autre noyau à utiliser.

    3. Cliquez sur Sélectionner.

    Dans le fichier

    1. Dans le fichier notebook JupyterLab, cliquez sur le nom du noyau.

      Le noyau actuel.

    2. Dans la boîte de dialogue Sélectionner le noyau, sélectionnez un autre noyau à utiliser.

    3. Cliquez sur Sélectionner.

    Arrêter votre 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 l'instance que vous souhaitez arrêter.

    3. Cliquez sur  Arrêter.

    Démarrer 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 l'instance que vous souhaitez démarrer.

    3. Cliquez sur  Démarrer.

    Réinitialiser votre instance

    La réinitialisation forcée d'une instance efface le contenu de la mémoire de votre instance et rétablit l'état initial de l'instance. Pour en savoir plus sur le fonctionnement de la réinitialisation d'une instance, consultez Réinitialiser une 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 l'instance à réinitialiser.

    3. Cliquez sur Réinitialiser, puis à nouveau sur Réinitialiser pour confirmer.

    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 :

    Si vous avez créé un projet pour apprendre à utiliser les notebooks gérés Vertex AI Workbench et que vous n'en avez plus besoin, supprimez-le.

    Si vous avez utilisé un projet Google Cloud existant, supprimez les ressources que vous avez créées pour éviter que des frais ne soient facturés sur votre compte :

    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 ligne contenant l'instance à supprimer.

    3. Cliquez sur  Supprimer. (Selon la taille de votre fenêtre, le bouton Supprimer peut se trouver dans le menu d'options .)

    4. Pour confirmer l'opération, cliquez sur Supprimer.

    Étapes suivantes

    • Essayez l'un des tutoriels inclus dans votre nouvelle instance de notebooks gérés. Dans l'explorateur de fichiers  JupyterLab, ouvrez le dossier tutorials, puis l'un des fichiers notebook.

      Dossier "tutorials" dans l'explorateur de fichiers JupyterLab.

    • Consultez la Présentation des notebooks gérés.