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

Ce guide de démarrage rapide explique comment commencer rapidement à utiliser Filestore avec 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

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

  2. Installez la Google Cloud CLI.

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

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

    gcloud init

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

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

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

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

  8. Activez l'API Filestore si ce n'est pas déjà fait :

    Rôles requis pour activer les API

    Pour activer les API, vous devez disposer de l'autorisation serviceusage.services.enable. Si vous avez créé le projet, vous disposez probablement déjà de cette autorisation grâce au rôle Propriétaire (roles/owner). Sinon, vous pouvez obtenir cette autorisation grâce au rôle Administrateur Service Usage (roles/serviceusage.serviceUsageAdmin). Découvrez comment attribuer des rôles. 

    gcloud services enable file.googleapis.com

  9. Installez la Google Cloud CLI.

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

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

    gcloud init

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

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

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

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

  15. Activez l'API Filestore si ce n'est pas déjà fait :

    Rôles requis pour activer les API

    Pour activer les API, vous devez disposer de l'autorisation serviceusage.services.enable. Si vous avez créé le projet, vous disposez probablement déjà de cette autorisation grâce au rôle Propriétaire (roles/owner). Sinon, vous pouvez obtenir cette autorisation grâce au rôle Administrateur Service Usage (roles/serviceusage.serviceUsageAdmin). Découvrez comment attribuer des rôles. 

    gcloud services enable file.googleapis.com
    16.

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 :

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.

    • 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

Notez l'adresse IP de l'instance pour l'utiliser lors du montage 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 à 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 :

    sudo mount MOUNT-POINT-DIRECTORY /mnt/test

    où :

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

  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

Windows

Connectez-vous à l'instance nfs-client et ouvrez 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 :