Créer une instance Filestore à l'aide de la gcloud CLI

Créer une instance Filestore à l'aide de la gcloud CLI

Ce guide de démarrage rapide vous montre comment être opérationnel rapidement avec Filestore en utilisant la Google Cloud CLI. Dans ce guide de démarrage rapide, vous allez apprendre à effectuer les opérations suivantes:

• Créer une instance Filestore
• Installez le partage de fichiers à partir de cette instance sur une machine virtuelle cliente Compute Engine.
• Créez un fichier sur le partage de fichiers installé.
• supprimer l'instance Filestore.

Avant de commencer

Connectez-vous à votre compte Google Cloud . Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de nos produits en conditions réelles. Les nouveaux clients bénéficient également de 300 $de crédits sans frais pour exécuter, tester et déployer des charges de travail.

Installez la Google Cloud CLI.

Si vous utilisez un fournisseur d'identité (IdP) externe, vous devez d'abord vous connecter à la gcloud CLI avec votre identité fédérée.

Pour initialiser la gcloud CLI, exécutez la commande suivante :

gcloud init

Créez ou sélectionnez un projet Google Cloud .

Rôles requis pour sélectionner ou créer un projet

• Sélectionnez un projet : la sélection d'un projet ne nécessite pas de rôle IAM spécifique. Vous pouvez sélectionner n'importe quel projet pour lequel un rôle vous a été attribué.
• Créer un projet : pour créer un projet, vous devez disposer du rôle Créateur de projet (roles/resourcemanager.projectCreator), qui contient l'autorisation resourcemanager.projects.create. Découvrez comment attribuer des rôles.

Remarque : Si vous ne comptez pas conserver les ressources créées dans cette procédure, créez un projet au lieu de sélectionner un projet existant. Après avoir suivi ces étapes, vous pouvez supprimer le projet. Cela entraîne la suppression de toutes les ressources qui lui sont associées.

• Créez un projet Google Cloud  :

  gcloud projects create PROJECT_ID

  Remplacez PROJECT_ID par le nom du projet Google Cloud que vous créez.

• Sélectionnez le projet Google Cloud que vous avez créé :

  gcloud config set project PROJECT_ID

  Remplacez PROJECT_ID par le nom de votre projet Google Cloud .

Si vous utilisez un projet existant pour ce guide, vérifiez que vous disposez des autorisations nécessaires pour suivre les instructions. Si vous avez créé un projet, vous disposez déjà des autorisations requises.

Vérifiez que la facturation est activée pour votre projet Google Cloud .

Activez l'API Filestore :

Rôles requis pour activer les API

Pour activer les API, vous avez besoin du rôle IAM Administrateur Service Usage (roles/serviceusage.serviceUsageAdmin), qui contient l'autorisation serviceusage.services.enable. Découvrez comment attribuer des rôles.

gcloud services enable file.googleapis.com

Installez la Google Cloud CLI.

Si vous utilisez un fournisseur d'identité (IdP) externe, vous devez d'abord vous connecter à la gcloud CLI avec votre identité fédérée.

Pour initialiser la gcloud CLI, exécutez la commande suivante :

gcloud init

Créez ou sélectionnez un projet Google Cloud .

Rôles requis pour sélectionner ou créer un projet

• Sélectionnez un projet : la sélection d'un projet ne nécessite pas de rôle IAM spécifique. Vous pouvez sélectionner n'importe quel projet pour lequel un rôle vous a été attribué.
• Créer un projet : pour créer un projet, vous devez disposer du rôle Créateur de projet (roles/resourcemanager.projectCreator), qui contient l'autorisation resourcemanager.projects.create. Découvrez comment attribuer des rôles.

Remarque : Si vous ne comptez pas conserver les ressources créées dans cette procédure, créez un projet au lieu de sélectionner un projet existant. Après avoir suivi ces étapes, vous pouvez supprimer le projet. Cela entraîne la suppression de toutes les ressources qui lui sont associées.

• Créez un projet Google Cloud  :

  gcloud projects create PROJECT_ID

  Remplacez PROJECT_ID par le nom du projet Google Cloud que vous créez.

• Sélectionnez le projet Google Cloud que vous avez créé :

  gcloud config set project PROJECT_ID

  Remplacez PROJECT_ID par le nom de votre projet Google Cloud .

Si vous utilisez un projet existant pour ce guide, vérifiez que vous disposez des autorisations nécessaires pour suivre les instructions. Si vous avez créé un projet, vous disposez déjà des autorisations requises.

Vérifiez que la facturation est activée pour votre projet Google Cloud .

Activez l'API Filestore :

Rôles requis pour activer les API

Pour activer les API, vous avez besoin du rôle IAM Administrateur Service Usage (roles/serviceusage.serviceUsageAdmin), qui contient l'autorisation serviceusage.services.enable. Découvrez comment attribuer des rôles.

gcloud services enable file.googleapis.com

Rôles requis

Pour obtenir les autorisations nécessaires pour suivre ce guide de démarrage rapide, demandez à votre administrateur de vous accorder les rôles IAM suivants sur votre projet :

• Créer et gérer des instances Filestore : Éditeur Cloud Filestore (roles/file.editor)
• Créer et gérer des instances Compute Engine : Administrateur d'instances Compute (v1) (roles/compute.instanceAdmin.v1)

Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Vous pouvez également obtenir les autorisations requises avec des rôles personnalisés ou d'autres rôles prédéfinis.

Une fois que vous avez terminé les tâches décrites dans ce document, vous pouvez éviter de continuer à payer des frais en supprimant les ressources que vous avez créées. Pour en savoir plus, consultez la section Effectuer un nettoyage.

Créer une VM Compute Engine

Linux

1. Créer une instance Compute Engine Configurez l'instance comme suit :
   • Nommez l'instance nfs-client.
   • Définissez le flag --zone sur us-central1-c.
   • Définissez l'indicateur --image-project sur debian-cloud.
   • Définissez l'indicateur --image-family sur debian-11.
   • Définissez le flag --tags sur http-server.

   gcloud compute instances create nfs-client --zone=us-central1-c --image-project=debian-cloud --image-family=debian-11 --tags=http-server

Windows

1. Créer une instance Compute Engine Configurez l'instance comme suit :
   • Nommez l'instance nfs-client.
   • Définissez le flag --zone sur us-central1-c.
   • Définissez l'indicateur --image-project sur windows-cloud.
   • Définissez l'indicateur --image-family sur windows-2012-r2.
   • Définissez le flag --tags sur http-server.

   gcloud compute instances create nfs-client --zone=us-central1-c --image-project=windows-cloud --image-family=windows-2012-r2 --tags=http-server

Créer une instance Filestore

Ce guide de démarrage rapide explique comment créer une instance dans le niveau de service régional avec des performances personnalisées activées. Pour en savoir plus sur la création d'instances, consultez Créer une instance.

1. créer une instance Filestore ; Pour la configurer, procédez comme suit :

   • Nommez l'instance nfs-server.
   • Définissez l'indicateur --region sur us-central1.
   • Définissez l'indicateur --tier sur REGIONAL.

   • Définissez le flag --performance sur max-iops-per-tb=17000.

     Remarque  : Une fois que vous avez activé les performances personnalisées pour une instance, vous ne pouvez plus les désactiver pour cette instance. Les instances dont les performances personnalisées sont activées sont facturées en fonction des IOPS achetés. Pour en savoir plus, consultez Configurer des performances personnalisées et Tarifs de Filestore.

   • Définissez le flag --file-share sur name="vol1",capacity=1TB.

   • Définissez l'indicateur --network sur name="default".

     gcloud filestore instances create nfs-server --region=us-central1 --tier=REGIONAL --performance=max-iops-per-tb=17000 --file-share=name="vol1",capacity=1TB --network=name="default"

2. Obtenez des informations sur l'instance Filestore que vous avez créée :

     gcloud filestore instances describe nfs-server --region=us-central1 

   La commande renvoie un résultat semblable au suivant :

       createTime: '2025-02-12T09:15:08.163246004Z'
       customPerformanceSupported: true
       fileShares:
        -capacityGb: '1024'
           name: vol1
       name: projects/yourproject/locations/us-central1/instances/nfs-server
       networks:
       -connectMode: DIRECT_PEERING
         ipAddresses:
          - 10.0.0.2
         network: default
         reservedIpRange: 10.0.0.2/26
       performanceConfig:
         iopsPerTb:
           maxIopsPerTb: '17000'
       performanceLimits:
         maxIops: '17000'
         maxReadIops: '17000'
         maxReadThroughputBps: '417792000'
         maxWriteIops: '5100'
         maxWriteThroughputBps: '139264000'
       protocol: NFS_V3
       state: READY
       tier: REGIONAL

Copiez l'adresse IP de l'instance à utiliser lors de l'installation du partage de fichiers. Dans le cadre de ce guide de démarrage rapide, nous utilisons l'adresse IP 10.0.0.2.

Installer le partage de fichiers Filestore sur l'instance nfs-client

Linux

1. Établissez une connexion SSH avec l'instance nfs-client :

   gcloud compute ssh nfs-client

1. Installez NFS en exécutant les commandes suivantes dans la fenêtre de terminal de nfs-client :

   sudo apt-get -y update &&
   sudo apt-get -y install nfs-common
   

2. Créez un répertoire d'installation sur l'instance nfs-client pour le partage de fichiers Filestore :

   sudo mkdir /mnt/test
   

3. Installez le partage de fichiers sur l'instance nfs-client avec la commande mount en spécifiant l'adresse IP de l'instance Filestore, le nom du partage de fichiers et le répertoire d'installation sur lequel effectuer l'installation :

   sudo mount MOUNT-POINT-DIRECTORY /mnt/test
   

   où :

   MOUNT-POINT-DIRECTORY correspond au chemin d'accès au répertoire dans lequel le partage de fichiers Filestore est installé. Par exemple : 10.0.0.2:/vol1

   Remarque : Pour obtenir des recommandations sur les options d'installation NFS, consultez Installer des partages de fichiers.

4. Facultatif : Vérifiez que le partage de fichiers Filestore est installé :

   df -h --type=nfs

5. Rendez le partage de fichiers accessible en modifiant les autorisations :

   sudo chmod go+rw /mnt/test
   

Important: Nous vous recommandons de définir des autorisations plus spécifiques dans un environnement de production. Pour plus d'informations, consultez la page Configurer l'accès sur un partage de fichiers.

Windows

Se connecter à l'instance nfs-client et ouvrir une invite de commande en tant qu'administrateur

1. Créez un compte et définissez un mot de passe initial pour l'instance nfs-client :

   gcloud compute reset-windows-password nfs-client
   

2. Configurez votre instance pour activer la connexion aux ports série :

   gcloud compute instances add-metadata nfs-client --metadata=serial-port-enable=1
   

3. Lancez une session interactive :

   gcloud compute connect-to-serial-port nfs-client --port=2
   

4. À l'invite SAC>, créez un nouveau canal :

   cmd
   

   Un canal intitulé Cmd0001 est créé.

5. Connectez-vous au canal :

   ch -sn Cmd0001
   

6. Saisissez le nom d'utilisateur et le mot de passe de l'instance nfs-client, puis laissez le champ Domain vide. Vous êtes connecté à l'interface Command Prompt de l'instance nfs-client.

Installer le client NFS

1. Dans le Command Prompt de nfs-client, passez à Windows PowerShell :

   powershell
   

2. Installez le client NFS :

   Install-WindowsFeature -Name NFS-Client
   

3. Redémarrez l'instance nfs-client lorsque vous y êtes invité :

   restart-computer
   

4. À l'invite SAC>, attendez que la notification suivante apparaisse :

   EVENT: The CMD command is now available.

   Exécutez ensuite les commandes cmd et ch -sn comme indiqué précédemment pour vous connecter et vous reconnecter à l'instance nfs-client.

Configurer l'ID utilisateur utilisé par le client NFS

1. Dans l'invite de commande, exécutez powershell pour passer à Windows PowerShell.

2. Dans PowerShell, exécutez les commandes suivantes pour créer deux nouvelles entrées de registre, AnonymousUid et AnonymousGid :

   New-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\ClientForNFS\CurrentVersion\Default" `
       -Name "AnonymousUid" -Value "0" -PropertyType DWORD
   
   New-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\ClientForNFS\CurrentVersion\Default" `
       -Name "AnonymousGid" -Value "0" -PropertyType DWORD
   

3. Redémarrez le service client NFS :

   nfsadmin client stop
   
   nfsadmin client start
   

Mapper le partage de fichiers vol1 à l'instance nfs-client

1. Quittez PowerShell :

   exit
   

2. À partir de Command Prompt, installez le partage de fichiers sur l'instance nfs-client avec la commande mount en spécifiant l'adresse IP de l'instance Filestore, le nom du partage de fichiers et la lettre de lecteur sur laquelle effectuer l'installation :

   mount -o mtype=hard 10.0.0.2:/vol1 z:
   

Créer un fichier sur le partage de fichiers installé

Linux

1. Dans la fenêtre de terminal nfs-client, créez un fichier nommé testfile en exécutant la commande suivante :

   echo 'This is a test' > /mnt/test/testfile
   

2. Vérifiez que le fichier a été créé en exécutant la commande suivante et en vérifiant que testfile se trouve dans le contenu de répertoire renvoyé :

   ls /mnt/test
   

Windows

1. Dans la fenêtre d'invite de commandes de l'instance nfs-client, créez un fichier nommé testfile :

   echo 'This is a test' > Z:\testfile
   

2. Vérifiez que le fichier a été créé en exécutant la commande suivante :

   dir Z:
   

   Vérifiez que testfile se trouve dans le contenu de répertoire renvoyé.

Effectuer un nettoyage

Pour éviter que les ressources utilisées dans cette démonstration soient facturées sur votre compte Google Cloud , supprimez le projet Google Cloud qui les contient.

Supprimer le projet Google Cloud

Attention : La suppression d'un projet aura les effets suivants :

• Tout le contenu du projet est supprimé. Si vous avez utilisé un projet existant pour les tâches décrites dans ce document et que vous le supprimez, vous supprimerez également tout autre travail effectué dans le projet.
• Les ID de projets personnalisés sont perdus. Lorsque vous avez créé ce projet, vous avez peut-être créé un ID de projet personnalisé que vous souhaitez utiliser à l'avenir. Pour conserver les URL qui utilisent l'ID de projet, telle qu'une URL appspot.com, supprimez les ressources sélectionnées dans le projet au lieu de supprimer l'ensemble du projet.

Si vous envisagez d'explorer plusieurs architectures, tutoriels et guides de démarrage rapide, réutiliser des projets peut vous aider à ne pas dépasser les limites de quotas des projets.

Supprimer un projet Google Cloud  :

gcloud projects delete PROJECT_ID

Supprimer l'instance Filestore

nfs-serverSupprimez l'instance.

gcloud filestore instances delete nfs-server --zone=us-central1-c

Supprimer l'instance Compute Engine

Supprimez l'instance :

gcloud compute instances delete nfs-client

Étapes suivantes

• Lisez la présentation de Filestore pour en savoir plus sur les principes de base de Filestore.
• Configurez vous-même une instance Filestore en suivant les instructions de Créer des instances.
• Lisez Contrôle d'accès pour découvrir comment contrôler l'accès aux opérations Filestore et aux ressources d'une instance.
• Découvrez comment copier des données vers ou depuis une instance Filestore.
• Découvrez comment transférer de grands ensembles de données de Cloud Storage vers Filestore.