Se connecter aux buckets Cloud Storage

Cette page présente Cloud Storage, une solution de stockage des données de machine learning et des résultats d'entraînement, et explique comment accorder à votre Cloud TPU l'accès aux objets de données sur Cloud Storage.

Avant de commencer

Vous avez besoin d'un compte de service Cloud TPU pour accéder à un bucket Cloud Storage.

  1. Créez un compte de service Cloud TPU pour votre projet.

    gcloud beta services identity create --service tpu.googleapis.com --project $PROJECT_ID

    La commande renvoie un compte de service Cloud TPU au format suivant :

    service-PROJECT_NUMBER@cloud-tpu.iam.gserviceaccount.com

  2. Suivez les instructions du Guide de démarrage rapide pour Cloud TPU ou du document Créer et supprimer des TPU pour configurer votre projet Google Cloud et créer vos VM Cloud TPU et ressources TPU.

Écrire des données dans Cloud Storage

Console

  1. Accédez à la page Cloud Storage de la console Google Cloud.

    Accéder à la page Cloud Storage

  2. Créez un bucket en spécifiant les options suivantes :

    • Un nom unique de votre choix
    • Classe de stockage par défaut : Standard
    • Emplacement : us-central1

CLI

  1. Exécutez la commande gcloud storage buckets create pour créer un bucket Cloud Storage :

    gcloud storage buckets create gs://bucket-name --location region

    où :

    • region est la région dans laquelle vous avez créé le Cloud TPU. Pour en savoir plus sur les régions et la disponibilité des TPU, consultez la section Régions et zones TPU.

    • bucket-name est le nom du bucket que vous souhaitez créer.

  2. Exécutez la commande gcloud storage cp pour écrire des fichiers dans le bucket Cloud Storage :

    gcloud storage cp -r local-data-dir gs://bucket-name

    où local-data-dir est un chemin d'accès local à vos données. Par exemple :$HOME/your-data

Donner à la ressource Cloud TPU l'accès à Cloud Storage

Vous devez accorder à votre Cloud TPU un accès en lecture et en écriture à vos objets Cloud Storage. Pour ce faire, vous devez attribuer l'accès requis au compte de service Cloud TPU utilisé par Cloud TPU. Suivez ces étapes pour trouver le compte de service Cloud TPU et accorder l'accès nécessaire :

Autoriser le compte de service Cloud TPU

Utiliser des listes de contrôle d'accès détaillées pour Cloud TPU (solution recommandée)

Si vous stockez des données d'entraînement sur Cloud Storage, le compte de service Cloud TPU doit disposer d'autorisations en lecture et en écriture sur le bucket.

Console

  1. Accédez à la page du navigateur Cloud Storage pour afficher les buckets que vous possédez.

    Accéder au navigateur Cloud Storage

  2. Accédez à l'objet dont vous souhaitez modifier la liste de contrôle d'accès.

  3. Sélectionnez l'onglet Permissions.

  4. Sélectionnez Add pour ajouter une autorisation et saisissez le nom complet du compte de service dans la zone de modification New Principals.

  5. Si vous effectuez des opérations de lecture à partir de ce bucket, vous devez autoriser le compte de service TPU à lire des données à partir de cette ressource. Pour ce faire, attribuez le rôle Storage Legacy > Storage Legacy Bucket Reader au compte de service.

  6. Si vous effectuez des opérations d'écriture dans ce bucket, vous devez autoriser le compte de service TPU à écrire des données dans cette ressource. Pour ce faire, attribuez le rôle Storage Legacy > Storage Legacy Bucket Writer au compte de service.

CLI

  1. Si vous effectuez des opérations de lecture à partir de ce bucket, octroyez une autorisation de lecture au compte de service Cloud TPU :

     gcloud storage buckets add-iam-policy-binding gs://bucket-name --member=serviceAccount:service-account --role=roles/storage.objectViewer

  2. Si vous effectuez des opérations d'écriture dans ce bucket, octroyez une autorisation d'écriture au compte de service Cloud TPU :

     gcloud storage buckets add-iam-policy-binding gs://bucket-name --member=serviceAccount:service-account --role=roles/storage.objectCreator

Utiliser des autorisations IAM pour Cloud TPU (solution alternative)

Si vous souhaitez accorder des autorisations plus larges au lieu d'accorder explicitement l'accès à chaque bucket, vous pouvez attribuer le rôle IAM (Identity and Access Management) "Administrateur de l'espace de stockage" au compte de service Cloud TPU.

  1. Accéder à IAM

  2. Cliquez sur le bouton +Ajouter pour ajouter des comptes principaux au projet.

  3. Saisissez le nom du compte de service Cloud TPU dans la zone de texte Comptes principaux.

  4. Cliquez sur la liste déroulante Rôles.

  5. Activez les rôles suivants :

    • Projet > Lecteur

    • Cloud Storage > Administrateur de l'espace de stockage

Cloud Storage FUSE

Cloud Storage FUSE vous permet d'installer et d'accéder aux buckets Cloud Storage en tant que systèmes de fichiers locaux. Cela permet aux applications de lire et d'écrire des objets dans votre bucket à l'aide d'une sémantique de système de fichiers standard.

Consultez la documentation de Cloud Storage FUSE pour en savoir plus sur le fonctionnement de Cloud Storage FUSE et sur la correspondance des opérations Cloud Storage FUSE avec les opérations Cloud Storage. Pour en savoir plus sur l'utilisation de Cloud Storage FUSE, par exemple pour installer la CLI gcsfuse et installer des buckets, consultez GitHub.

Étape suivante