Sauvegarder et restaurer des fichiers à l'aide de Cloud Storage

Cette page explique comment utiliser Cloud Storage pour sauvegarder et restaurer des fichiers sur votre instance Gemini Enterprise Agent Platform Workbench.

Présentation

Ce guide décrit deux façons d'utiliser Cloud Storage pour vous aider à sauvegarder et à restaurer des fichiers sur 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.

Installer un bucket Cloud Storage

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.

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 situé 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 vous ne l'avez 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 File Browser (Explorateur de fichiers) est sélectionné.

  2. Dans la barre latérale de 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 l'agrandir jusqu'à ce qu'il apparaisse.

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

  3. Dans le champ Bucket name (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.

Exporter des fichiers vers Cloud Storage et les restaurer

Cette section explique comment exporter des fichiers vers Cloud Storage et restaurer des fichiers situés dans un bucket Cloud Storage.

Exporter vers Cloud Storage

  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.

  3. Dans JupyterLab, assurez-vous que l' onglet File Browser (Explorateur de fichiers) est sélectionné.

  4. Dans la barre latérale de gauche, cliquez sur le bouton  Export to GCS (Exporter vers GCS). Si le bouton ne s'affiche pas, faites glisser le côté droit de la barre latérale pour l'agrandir jusqu'à ce qu'il apparaisse.

  5. Dans la boîte de dialogue Provide export location (Indiquer l'emplacement d'exportation), saisissez le nom d'un bucket Cloud Storage vers lequel vous souhaitez exporter des fichiers. Si vous devez créer un bucket Cloud Storage, consultez Créer un bucket.

    Agent Platform Workbench ouvre un notebook qui inclut le code permettant d'exporter les fichiers de votre instance vers Cloud Storage.

  6. Exécutez le code dans cette cellule.

Restaurer des fichiers à partir de Cloud Storage

Pour restaurer un fichier sur votre instance Agent Platform Workbench, vous pouvez utiliser gcloud storage cp pour le copier.

Exécutez le code suivant dans une cellule de l'un des notebooks de votre instance :

!gcloud storage cp URI /home/jupyter/FILE_NAME

Remplacez les éléments suivants :

  • URI : URI gsutil du fichier que vous souhaitez copier, par exemple : gs://BUCKET_NAME/ZONE/INSTANCE_ID/FILE_NAME
  • FILE_NAME : nom du fichier à copier

Pour en savoir plus, consultez Télécharger l'objet à partir de votre bucket.

Étape suivante