Modifier les instances

Cette page explique comment modifier une instance Filestore à l'aide de la console Google Cloud ou de gcloud CLI.

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

  • Augmenter sa capacité
  • Diminuez la capacité des niveaux de service suivants :
    • Zonal
    • Régional
    • Entreprise
  • Configurer les performances (version GA de la liste d'autorisation)
  • Modifier sa description
  • Gérer les règles de contrôle des accès basées sur les adresses IP
  • Gérer les libellés

Pour en savoir plus sur le scaling de la capacité, consultez la section Scaling de la capacité.

Certaines spécifications, comme l'adresse IP de l'instance, sont immuables.

Instructions pour modifier une instance

Console Google Cloud

Pour modifier des instances Filestore à l'aide de la console Google Cloud, 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 la console Google Cloud, accédez à la page "Instances Filestore".

    Accéder à la page des 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 gcloud CLI, vous devez installer gcloud CLI ou utiliser Cloud Shell , intégré à la console Google Cloud:

Accédez à la console Google Cloud.

Commande gcloud pour modifier une instance

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 l'adresse IP, vous devez utiliser l'option --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 filestore instances update instance-id
    --[project="project-id"]
    --[location=location]
    --[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 Google 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
    
  • location est l'emplacement où se trouve l'instance Filestore. Pour les instances régionales et Enterprise, spécifiez une région. Pour toutes les autres instances, spécifiez une zone. 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 (GiB, par défaut) ou de téraoctets (TiB).

    Pour voir votre quota disponible, accédez à la page "Quotas" de la console Google Cloud:

    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. Seuls les niveaux de service suivants sont compatibles avec les paramètres de configuration des plages d'adresses IP qui se chevauchent :
      • Zonal
      • Régional
      • Entreprise
    • access-mode est le niveau d'accès à accorder aux clients 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 (TiB).

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

Étape suivante