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 associer une instance Filestore à 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 savoir comment spécifier 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 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 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 à l'étape 2.

Ouvrez la console IAM.
Sélectionnez l'onglet Afficher par compte principal, puis saisissez Name:Compute Engine default service account dans le champ Filtre.
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 Présentation des comptes de service. Pour en savoir plus sur les rôles IAM, consultez 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 à utiliser pour installer une instance Filestore sur un Cloud TPU sont différentes si vous utilisez un seul Cloud TPU ou une tranche 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.

      (vm)$ 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 NFS.

      (vm)$ sudo mkdir -p mount-dir \
        && sudo chmod ugo+rw mount-dir

Recherchez l'adresse IP de Filestore.

      (vm)$ gcloud filestore instances describe filestore-instance-name \
        --location filestore-region

Installez l'instance Filestore sur votre VM Cloud TPU dans votre répertoire d'installation. Remplacez filestore-ip, file-share-name et mount-dir par l'adresse IP FileStore, le nom du partage de fichiers et le répertoire d'installation.
```
      (vm)$ sudo mount filestore-ip:file-share-name mount-dir
    
```

Installer une instance Filestore sur une tranche Cloud TPU

Les tranches 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 flags --worker=all et --command pour exécuter les commandes sur toutes les VM Cloud TPU en même temps.

Installez le package nfs-common sur toutes les VM Cloud TPU de votre tranche.

        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 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 && sudo chmod ugo+rw mount-dir"

Recherchez l'adresse IP de l'instance Filestore.

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

Installez l'instance Filestore sur votre tranche Cloud TPU. Remplacez filestore-ip, file-share-name et mount-dir par l'adresse IP FileStore, le nom du partage de fichiers et le répertoire d'installation.

      gcloud compute tpus tpu-vm ssh your-tpu-name \
        --project=your-gcp-project \
          --zone=your-zone \
          --worker=all \
          --command="sudo mount filestore-ip:file-share-name mount-dir"

Écrire des données dans une instance Filestore

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