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é parfaite 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, ajoutez 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 Créer des comptes de service.

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

Cette section explique comment ajouter le rôle Éditeur Cloud Filestore au compte de service Compute Engine par défaut. Suivez ces instructions pour ajouter le rôle Éditeur Cloud Filestore à n'importe quel compte de service. À l'étape 2, recherchez et utilisez un compte de service personnalisé au lieu du compte de service Compute Engine par défaut.

  1. Accédez à la console IAM.

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

  3. Cliquez sur Modifier à 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 Ajouter pour ajouter un autre rôle.

  5. Développez le menu 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 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 permettant d'installer une instance Filestore sur une VM Cloud TPU varient selon que vous utilisez une seule VM Cloud TPU ou une tranche 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 ssh TPU_NAME \
  --zone=ZONE

    Remplacez les espaces réservés suivants :

    • TPU_NAME : nom de votre VM TPU.
    • ZONE : zone de votre VM TPU.

  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éez un répertoire pour installer NFS.

    sudo mkdir -p MOUNT_DIR \
  && sudo chmod ugo+rw MOUNT_DIR

    Remplacez l'espace réservé suivant :

    • MOUNT_DIR : répertoire dans lequel vous souhaitez installer l'instance Filestore.

  4. Recherchez l'adresse IP de Filestore.

    gcloud filestore instances describe FILESTORE_INSTANCE_NAME \
  --location FILESTORE_REGION

    Remplacez les espaces réservés suivants :

    • FILESTORE_INSTANCE_NAME : nom de votre instance Filestore.
    • FILESTORE_REGION : région de votre instance Filestore.

  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

    Remplacez les espaces réservés suivants :

    • FILESTORE_IP : adresse IP de votre instance Filestore.
    • FILE_SHARE_NAME : nom du partage de fichiers sur votre instance Filestore.
    • MOUNT_DIR : répertoire dans lequel vous souhaitez installer l'instance Filestore.

Installer une instance Filestore sur une tranche Cloud TPU

Les tranches Cloud TPU sont provisionnées en tant que groupes d'instances gérés (MIG) Compute Engine. Étant donné que les MIG répartissent les VM sur la capacité de calcul, utilisez un script de démarrage associé à votre modèle d'instance pour installer une instance Filestore sur toutes les machines de votre tranche. Cela garantit que l'installation est automatiquement disponible chaque fois que des instances sont créées ou automatiquement réparées.

  1. Recherchez l'adresse IP de votre instance Filestore.

    gcloud filestore instances describe FILESTORE_INSTANCE_NAME \
  --location FILESTORE_REGION

    Remplacez les espaces réservés suivants :

    • FILESTORE_INSTANCE_NAME : nom de votre instance Filestore.
    • FILESTORE_REGION : région de votre instance Filestore.

  2. Créez un script de démarrage. Le script installe le package nfs-common, crée le répertoire d'installation et associe l'instance Filestore. Enregistrez le code suivant dans un fichier local nommé mount-filestore.sh.

    #!/bin/bash
sudo apt-get update --allow-releaseinfo-change && sudo apt-get -y update && sudo apt-get -y install nfs-common
sudo mkdir -p MOUNT_DIR
sudo chmod ugo+rw MOUNT_DIR
sudo mount FILESTORE_IP:FILE_SHARE_NAME MOUNT_DIR

    Remplacez les espaces réservés suivants :

    • FILESTORE_IP : adresse IP de votre instance Filestore.
    • FILE_SHARE_NAME : nom du partage de fichiers sur votre instance Filestore.
    • MOUNT_DIR : répertoire dans lequel vous souhaitez installer l'instance Filestore.

  3. Appliquez le script de démarrage à votre modèle d'instance. Lorsque vous créez le modèle d'instance pour votre MIG, utilisez l'indicateur --metadata-from-file pour fournir votre script.

    gcloud compute instance-templates create INSTANCE_TEMPLATE_NAME \
  --metadata-from-file=startup-script=mount-filestore.sh \
  ...

    Remplacez l'espace réservé suivant :

    • INSTANCE_TEMPLATE_NAME : nom de votre modèle d'instance.

Écrire des données dans une instance Filestore

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