Installer une instance Filestore sur des VM Cloud TPU

Filestore est un espace de 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 installer une instance Filestore sur votre VM Cloud TPU, vous devez ajouter un rôle Filestore (Éditeur Cloud Filestore ou Lecteur Cloud Filestore) 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, celle-ci utilise le compte de service Compute Engine par défaut. Pour en savoir plus sur la spécification d'un compte de service lors de la création d'une VM Cloud TPU, consultez Configurer l'environnement Cloud TPU. Pour en savoir plus sur la création d'un compte de service, consultez la page Créer des comptes de service.

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

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

Ouvrez la console IAM.
Sélectionnez l'onglet Afficher par compte principal et saisissez Name:Compute Engine default service account dans le champ Filtrer.
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.
Cliquez sur pour ajouter un autre rôle.
Développez le menu déroulant Sélectionner un rôle, saisissez Filestore dans le filtre, puis sélectionnez Éditeur Cloud Filestore.
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 page 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 installer une instance Filestore sur un Cloud TPU varient selon que vous utilisez une seule tranche de pod Cloud TPU ou une tranche de pod Cloud TPU.

Installer une instance Filestore sur une seule VM Cloud TPU

Connectez-vous à votre VM Cloud TPU à l'aide de SSH.

      gcloud compute tpus tpu-vm ssh your-tpu-name \
        --zone=your-zone

Installez le package nfs-common.

      sudo apt-get update --allow-releaseinfo-change \
        && sudo apt-get -y update \
        && sudo apt-get -y install nfs-common

Créer un répertoire dans lequel installer NFS

      sudo mkdir -p mount-dir \
        && sudo chmod ugo+rw mount-dir

Recherchez l'adresse IP de Filestore.

      gcloud filestore instances describe filestore-instance-name \
        --region filestore-region

Installez une 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 d'au moins deux VM Cloud TPU. Les commandes suivantes utilisent la commande gcloud compute tpus tpu-vm ssh avec les options --worker=all et --command pour les exécuter simultanément sur toutes les VM Cloud TPU.

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"

Créez un répertoire dans lequel installer l'instance Filestore. Remplacez mount-dir-name par un 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"

Recherchez l'adresse IP de l'instance Filestore.

      gcloud filestore instances describe filestore-instance-name \
        --region filestore-region

installer une 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

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