Accéder aux fichiers et buckets Cloud Storage dans JupyterLab

Cette page explique comment installer un bucket Cloud Storage sur l'interface JupyterLab de votre instance Gemini Enterprise Agent Platform Workbench afin de pouvoir parcourir les fichiers stockés dans Cloud Storage. Vous pouvez également ouvrir et modifier des fichiers compatibles avec JupyterLab, tels que des fichiers texte et des fichiers de notebook (IPYNB).

Présentation

Les instances Agent Platform Workbench incluent une intégration de Cloud Storage qui vous permet d'installer un bucket Cloud Storage. Vous pouvez ainsi parcourir le contenu du bucket et utiliser des fichiers compatibles dans l'interface JupyterLab.

Vous pouvez accéder à tous les buckets et fichiers Cloud Storage auxquels votre instance a accès dans le même projet que votre instance Agent Platform Workbench.

Avant de commencer

  1. Connectez-vous à votre Google Cloud compte. 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 sans frais pour exécuter, tester et déployer des charges de travail.

  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 role (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 role (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.

Rôles requis

Pour obtenir les autorisations nécessaires pour installer un bucket Cloud Storage sur une instance Agent Platform Workbench, demandez à votre administrateur de vous accorder les rôles IAM suivants :

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

Vous pouvez également obtenir les autorisations requises avec des rôles personnalisés ou d'autres rôles prédéfinis.

Autorisation requise pour activer l'installation de l'espace de stockage partagé

Pour activer l'installation de l'espace de stockage partagé dans votre instance Agent Platform Workbench, demandez à votre administrateur d'accorder au compte de service de votre instance Agent Platform Workbench l'autorisation storage.buckets.list sur le projet.

L'autorisation storage.buckets.list est requise pour que le bouton Mount shared storage (Installer le stockage partagé) s'affiche dans l'interface JupyterLab de votre instance Agent Platform Workbench.

Créer un bucket et une instance Agent Platform Workbench

Vous devez avoir accès à au moins un bucket Cloud Storage dans le même projet que votre instance Agent Platform Workbench.
  1. Si vous devez créer un bucket Cloud Storage, consultez la page Créer un bucket.
  2. Si ce n'est pas déjà fait, créez une instance Agent Platform Workbench dans le même projet que votre bucket Cloud Storage.

Ouvrir JupyterLab

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

    Accéder à la page "Instances"

  2. À côté du nom de votre instance Agent Platform Workbench, cliquez sur Ouvrir JupyterLab.

    Votre instance Agent Platform Workbench ouvre JupyterLab.

Installer le bucket Cloud Storage

Pour installer un bucket Cloud Storage et y accéder, procédez comme suit :

  1. Dans JupyterLab, assurez-vous que l' onglet Explorateur de fichiers est sélectionné.

  2. Dans la barre latérale gauche, cliquez sur le bouton  Mount shared storage (Installer le stockage partagé). Si le bouton ne s'affiche pas, faites glisser le côté droit de la barre latérale pour la développer jusqu'à ce que le bouton apparaisse.

    Bouton "Mount shared storage" (Installer le stockage partagé) en haut à droite de la barre latérale gauche

  3. Dans le champ Nom du bucket, saisissez le nom du bucket Cloud Storage que vous souhaitez installer.

  4. Cliquez sur Mount (Installer).

  5. Votre bucket Cloud Storage s'affiche sous la forme d'un dossier dans l'onglet Explorateur de fichiers de la barre latérale gauche. Double-cliquez sur le dossier pour l'ouvrir et parcourir son contenu.

Résoudre les problèmes

Pour connaître les méthodes de diagnostic et de résolution des problèmes liés à l'installation d'un bucket Cloud Storage sur votre instance, consultez la page Résoudre les problèmes liés à Agent Platform Workbench.

Étape suivante