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

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

Install the 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

Create or select a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

• Create a Google Cloud project:

  gcloud projects create PROJECT_ID

  Replace PROJECT_ID with a name for the Google Cloud project you are creating.

• Select the Google Cloud project that you created:

  gcloud config set project PROJECT_ID

  Replace PROJECT_ID with your Google Cloud project name.

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.

Verify that billing is enabled for your Google Cloud project.

Enable the Filestore API:

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

gcloud services enable file.googleapis.com

Install the 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

Create or select a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

• Create a Google Cloud project:

  gcloud projects create PROJECT_ID

  Replace PROJECT_ID with a name for the Google Cloud project you are creating.

• Select the Google Cloud project that you created:

  gcloud config set project PROJECT_ID

  Replace PROJECT_ID with your Google Cloud project name.

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.

Verify that billing is enabled for your Google Cloud project.

Enable the Filestore API:

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

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. Create a Compute Engine instance. Configure the instance as follows:
   • Name the instance nfs-client.
   • Définissez le flag --zone sur us-central1-c.
   • Définissez le flag --image-project sur debian-cloud.
   • Définissez le flag --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. Create a Compute Engine instance. Configure the instance as follows:
   • Name the instance nfs-client.
   • Définissez le flag --zone sur us-central1-c.
   • Définissez le flag --image-project sur windows-cloud.
   • Définissez le flag --image-family sur windows-2012-r2.
   • Définissez le flag --tags sur http-server,http-server,.

   gcloud compute instances create nfs-client --zone=us-central1-c --image-project=windows-cloud --image-family=windows-2012-r2 --tags=http-server,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. Establish an SSH connection to the nfs-client instance:

   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 entraîne les effets décrits ci-dessous :

• 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.

Delete a Google Cloud project:

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.