Modifier des instances

Cette page explique comment modifier une instance Filestore à l'aide de Cloud Console ou de l'outil gcloud.

Une fois créée, vous pouvez modifier une instance Filestore comme suit :

  • Augmenter sa capacité
  • Réduire sa capacité (instances de disques SSD de grande échelle uniquement).
  • Modifier sa description.
  • Gérer les règles de contrôle des accès basées sur les adresses IP
  • Gérez les libellés. (Pour plus d'informations, voir Gérer les libellés).

Scaling de la capacité

Lorsque vous utilisez Filestore, nous vous recommandons de surveiller l'utilisation de vos instances Filestore afin de pouvoir ajuster la capacité selon vos besoins. Par exemple, si vous remarquez qu'une instance de niveau d'évolutivité élevée n'a plus besoin de toute sa capacité allouée, vous pouvez envisager de la réduire. De même, si vous remarquez que votre capacité est saturée, vous pouvez augmenter la capacité afin d'empêcher le mauvais fonctionnement de vos applications. Vous devez également ajouter de la capacité si le système de fichiers manque d'inodes. Pour vérifier si c'est le cas, exécutez la commande suivante à partir de la VM cliente:

df -i

La commande renvoie un résultat semblable au suivant :

Filesystem           Inodes  IUsed      IFree  IUse%  Mounted on
10.0.0.2:/vol1    134217728     13  134217715     1%  /mnt/test

Chaque fichier stocké sur le partage de fichiers consomme un inode. Si le système de fichiers manque d'inodes, vous ne pourrez pas stocker d'autres fichiers sur le partage de fichiers, même si vous n'avez pas atteint la capacité maximale allouée. Le seul moyen d'ajouter des inodes consiste à ajouter de la capacité. Toutefois, l'obtention du nombre maximal de nœuds est très rare et ne pose problème que si vous devez stocker un grand nombre de très petits fichiers.

Différences de comportement en matière de scaling par niveau de service

Les instances de niveau de base ne peuvent être mises à l'échelle que par incréments de GB ou ses multiples. Les instances de haut niveau peuvent être augmentées ou réduites que par incréments de 10 TB ou de ses multiples. Le scaling d'une instance n'affecte pas sa disponibilité et peut être effectué lorsque l'instance est en cours d'utilisation. Le tableau suivant montre comment la capacité de partage de fichiers peut être adaptée en fonction du niveau de service:

Niveau de service Disque HDD de base Disque SSD de base SSD à grande échelle
Sens du scaling À la hausse uniquement À la hausse uniquement À la hausse et à la baisse
Incrément de scaling 1GB 1GB 10TB
Capacité minimale 1TB 2.5TB 60TB
Capacité maximale 63.9TB 63.9TB 320TB

En outre, les instances de niveau SSD à grande échelle nécessitent beaucoup plus de temps pour effectuer une opération de scaling que les instances HDD et SSD de base. Le scaling de la capacité d'une instance à grande échelle nécessite entre 26 et 48 heures, tandis que le scaling à la baisse nécessite plus de 20 heures. Le temps réel requis varie en fonction de la quantité de données stockées dans l'instance et de la charge sur la VM cliente. Pour vous assurer que vos instances ne sont pas à court de capacité, effectuez ces opérations à l'avance.

Lorsqu'une opération de scaling a lieu, vous ne pouvez pas l'annuler, ni apporter d'autres modifications à l'instance. Toutefois, les opérations de lecture et d'écriture ne sont pas interrompues. Vous ne pouvez pas non plus procéder au scaling d'une instance SSD à grande échelle à un niveau de capacité inférieur à celui nécessaire pour stocker ses données et métadonnées de fichier existantes. Toute tentative de désactivation entraîne une erreur.

Instructions pour modifier une instance

Cloud Console

Pour modifier des instances Filestore à l'aide de Cloud Console, accédez à la page Modifier l'instance, dans laquelle vous pouvez modifier la description de l'instance, gérer les règles de contrôle des accès basé sur les adresses IP et procéder au scaling des performances du partage de fichiers :

  1. Dans Cloud Console, accédez à la page "Instances Filestore" :

    Accéder à la page Instances Filestore

  2. Cliquez sur l'ID de l'instance à modifier.

  3. Sur la page Détails de l'instance, cliquez sur Modifier pour accéder à la page Modifier l'instance.

  4. Modifiez la description de l'instance, les règles de contrôle des accès basé sur l'adresse IP et la capacité selon vos besoins. Pour en savoir plus, consultez la section Créer des instances.

  5. Cliquez sur Save.

gcloud

Avant de commencer

Pour utiliser l'outil gcloud, vous devez installer le SDK Cloud ou utiliser Cloud Shell , intégré à Cloud Console :

Accéder à Cloud Console

Commande gcloud pour modifier une instance Filestore

Vous pouvez modifier une instance Filestore en exécutant la commande instances update. Si vous devez mettre à jour les règles de configuration pour le contrôle des accès basé sur IP, vous devez utiliser la commande gcloud beta instances update avec l'indicateur --flags-file et spécifier un fichier de configuration JSON. Si vous choisissez cette méthode, vous n'avez pas besoin d'utiliser l'indicateur --file-share, car il est déjà inclus dans le fichier de configuration json:

 gcloud [beta] filestore instances update instance-id
     --[project="project-id"]
     --[zone=zone]
     --[file-share=name="file-share-name",capacity=file-share-size]
     --[description="instance-description"]
     --[flags-file=file-name.json]

où :

  • instance-id est l'ID de l'instance Filestore que vous souhaitez modifier.
  • project-id est l'ID du projet Cloud contenant l'instance Filestore. Vous pouvez ignorer cette option si l'instance Filestore se trouve dans le projet par défaut gcloud. Vous pouvez définir le projet par défaut en exécutant la commande suivante :

     gcloud config set project project-id
    
  • zone est la zone où se trouve l'instance Filestore. Exécutez la commande gcloud filestore zones list pour obtenir la liste des zones compatibles. Vous pouvez ignorer cette option si l'instance Filestore se trouve dans la zone par défaut gcloud. Vous pouvez définir la zone par défaut en exécutant la commande suivante :

     gcloud config set filestore/zone zone
    
  • {file-share-name est le nom du partage de fichiers diffusé à partir de l'instance Filestore. Les noms de partage de fichiers ne peuvent pas être modifiés après la création de l'instance.

  • file-share-size correspond à la nouvelle taille voulue pour le partage de fichiers. Vous pouvez exprimer la taille du partage de fichiers sous la forme d'un nombre entier de gigaoctets (GB, par défaut) ou de téraoctets (TB).

    Pour afficher votre quota disponible, accédez à la page "Quotas" de Cloud Console :

    Accéder à la page Quotas

  • instance-description correspond à la description facultative de l'instance Filestore.

  • file-name est le nom du fichier de configuration json pour le contrôle des accès basé sur les adresses IP.

    Exemple de fichier de configuration json :

     {
    "--file-share":
      {
        "capacity": "4096",
        "name": "my_vol",
        "nfs-export-options": [
          {
            "access-mode": "READ_WRITE",
            "ip-ranges": [
              "10.0.0.0",
              "10.2.0.0"
            ],
            "squash-mode": "ROOT_SQUASH",
            "anon_uid": 1003,
            "anon_gid": 1003
          },
           {
            "access-mode": "READ_ONLY",
            "ip-ranges": [
              "10.0.1.0/28"
            ],
            "squash-mode": "NO_ROOT_SQUASH"
          }
        ],
      }
    }
    

    où :

    • ip-ranges est l'adresse IP ou la plage à laquelle accorder l'accès. Vous pouvez spécifier plusieurs adresses IP ou plages en les séparant par une virgule. Example : 10.0.1.0,10.0.2.0,...
    • access-mode est le niveau d'accès à accorder au(x) client(s) dont l'adresse IP est comprise dans la plage d'adresses IP (ip-range). Il peut correspondre aux valeurs READ_WRITE ou READ_ONLY. La valeur par défaut est READ_WRITE.
    • Les valeurs ROOT_SQUASH ou NO_ROOT_SQUASH peuvent être définies pour squash-mode. ROOT_SQUASH supprime l'accès au niveau racine pour le(s) client(s) dont l'adresse IP appartient à la plage ip-range, tandis que NO_ROOT_SQUASH active l'accès root. La valeur par défaut est NO_ROOT_SQUASH.
    • anon_uid est la valeur de l'ID utilisateur que vous souhaitez mapper sur anon_uid. La valeur par défaut est 65534.
    • anon_gid est la valeur de l'ID de groupe que vous souhaitez mapper sur anon_gid. La valeur par défaut est 65534.
Exemple

L'exemple suivant met à jour l'instance nfs-server en augmentant la taille du partage de fichiers à 3 To (TB).

 gcloud beta filestore instances update nfs-server --zone=us-central1-c --file-share=name="vol1",capacity=3TB

Étape suivante