Installer une instance Filestore sur des VM Cloud TPU

Filestore est un stockage en réseau (NAS) entièrement géré pour Compute Engine. Filestore offre une compatibilité native avec les applications d'entreprise existantes et prend en charge tous les clients compatibles avec NFSv3.

Avant de commencer

Pour monter une instance Filestore sur votre VM Cloud TPU, vous devez ajouter un rôle Filestore (éditeur ou lecteur Filestore Cloud) au compte de service associé à votre VM Cloud TPU. Si vous ne spécifiez pas de compte de service personnalisé lorsque vous créez une VM Cloud TPU, votre VM Cloud TPU utilise le compte de service Compute Engine par défaut. Pour savoir comment spécifier un compte de service lors de la création d'une VM Cloud TPU, consultez la section Configurer l'environnement Cloud TPU. Pour en savoir plus sur la création d'un compte de service, consultez la section Créer des comptes de service.

Ajouter le rôle "Éditeur Filestore" à un compte de service

Les instructions suivantes vous expliquent comment ajouter le rôle "Éditeur Cloud Filestore" au compte de service par défaut de Compute Engine. Vous pouvez suivre ces instructions pour ajouter le rôle Éditeur Cloud Filestore à n'importe quel compte de service. À l'étape 2, vous pouvez rechercher et utiliser un compte de service personnalisé au lieu du compte de service Compute Engine par défaut.

  1. Ouvrez la console IAM.

  2. Sélectionnez l'onglet Afficher par comptes principaux, puis saisissez Name:Compute Engine default service account dans le champ Filtre.

  3. Cliquez sur  à côté du compte de service. La console IAM affiche une boîte de dialogue listant les rôles attribués au compte de service Compute Engine par défaut.

  4. Cliquez sur  pour ajouter un autre rôle.

  5. Développez le menu déroulant Sélectionner un rôle, saisissez Filestore dans le filtre, puis sélectionnez Éditeur Cloud Filestore.

  6. Cliquez sur Enregistrer pour fermer la boîte de dialogue. Vous avez ajouté le rôle "Éditeur Filestore" au compte de service Compute Engine par défaut.

Pour en savoir plus sur les comptes de service, consultez la section Présentation des comptes de service. Pour en savoir plus sur les rôles IAM, consultez la page Rôles et autorisations.

Créer une instance Filestore

Créez une instance Filestore en suivant les instructions de la section Créer des instances Filestore.

Installer une instance Filestore sur une VM Cloud TPU

Les commandes que vous utilisez pour monter une instance Filestore sur un Cloud TPU dépendent de l'utilisation d'un seul Cloud TPU ou d'une tranche de pod Cloud TPU.

Installer une instance Filestore sur une seule VM Cloud TPU

  1. Connectez-vous à votre VM Cloud TPU à l'aide de SSH. 
          gcloud compute tpus tpu-vm ssh your-tpu-name \
        --zone=your-zone
  2. Installez le package nfs-common. 
          sudo apt-get update --allow-releaseinfo-change \
        && sudo apt-get -y update \
        && sudo apt-get -y install nfs-common
  3. Créer un répertoire dans lequel installer NFS 
          sudo mkdir -p mount-dir \
        && sudo chmod ugo+rw mount-dir
  4. Recherchez l'adresse IP de Filestore. 
          gcloud filestore instances describe filestore-instance-name \ 
        --region filestore-region
  5. Installez l'instance Filestore sur votre VM Cloud TPU dans votre répertoire d'installation. 
          sudo mount filestore-ip:file-share-name mount-dir-name

Installer une instance Filestore sur une tranche de pod Cloud TPU

Les tranches de pod Cloud TPU sont composées de deux VM Cloud TPU ou plus. Les commandes suivantes utilisent la commande gcloud compute tpus tpu-vm ssh avec les options --worker=all et --command pour exécuter les commandes sur toutes les VM Cloud TPU en même temps.

  1. Installez le package nfs-common sur toutes les VM Cloud TPU de votre tranche de pod. 
            gcloud compute tpus tpu-vm ssh your-tpu-name \
          --project=your-gcp-project \
          --zone=your-zone \
          --worker=all \
          --command="sudo apt-get update --allow-releaseinfo-change && sudo apt-get -y update && sudo apt-get -y install nfs-common"
  2. Créez un répertoire dans lequel installer l'instance Filestore. Remplacez mount-dir-name par le nom de répertoire de votre choix. 
          gcloud compute tpus tpu-vm ssh your-tpu-name \
        --project=your-gcp-project \
          --zone=your-zone \
          --worker=all \
          --command="sudo mkdir -p mount-dir-name && sudo chmod ugo+rw mount-dir-name"
  3. Recherchez l'adresse IP de l'instance Filestore. 
          gcloud filestore instances describe filestore-instance-name \ 
        --region filestore-region
  4. Installez l'instance Filestore sur votre VM Cloud TPU. Remplacez les éléments suivants: 
          sudo mount filestore-ip:file-share-name mount-dir

Écrire des données dans une instance Filestore

Assurez-vous d'accorder à Linux des autorisations de lecture et d'écriture sur le répertoire dans lequel vous montez l'instance Filestore. Vous pouvez utiliser le répertoire comme vous le feriez avec votre système de fichiers local.