Créer une instance

Cette page explique comment créer une instance Filestore avec la console Google Cloud ou gcloud CLI.

Instructions pour créer une instance

gcloud filestore instances create instance-id \
    [--project=project-id] \
    [--location=location] \
    --tier=tier \
    --file-share=name="file-share-name",capacity=file-share-size \
    --network=name="vpc-network",[connect-mode=connect-mode],[reserved-ip-range="reserved-ip-address"]
    [--labels=key=value,[key=value,…]]
    [--kms-key=kms-key]

gcloud filestore instances create render1 \
  --project=myproject \
  --zone=us-central1-c \
  --tier=BASIC_HDD \
  --network=name="default",reserved-ip-range="10.0.7.0/29"
  --flags-file=nfs-export-options.json

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

Comprendre les instances et les partages

Une instance Filestore représente la capacité de stockage physique.

Un partage représente une partie allouée de cet espace de stockage avec un point d'accès individuel et unique.

Tous les niveaux de service proposent des options de stockage avec un ratio partage/instance de 1:1. Sinon, le multipartage Filestore pour GKE, disponible uniquement pour les instances de niveau entreprise, permet d'accéder à plusieurs partages sur une seule instance.

Les noms, ou ID d'instance, sont utilisés par les administrateurs pour gérer les instances. Les noms des partages de fichiers permettent aux clients de se connecter aux partages exportés à partir de ces instances.

Nommer l'instance

Le nom de votre instance Filestore, ou ID d'instance, permet d'identifier l'instance, et est utilisé dans les commandes gcloud. Les ID d'instance doivent respecter l'élément <label> de la norme RFC 1035. Plus précisément, ils doivent :

• comporter entre 1 et 63 caractères ;
• commencer par une lettre minuscule ;
• se composer de tirets, de lettres minuscules ou de chiffres ;
• terminer par des lettres minuscules ou des chiffres.

L'ID d'instance doit être unique dans le projet et la zone Google Cloud dans lesquels il se trouve. Une fois l'instance créée, son ID ne peut plus être modifié.

Sélectionner un niveau de service

Sélectionnez le niveau de service qui correspond le mieux à vos besoins. Une fois qu'une instance est créée, son niveau de service ne peut plus être modifié. Le tableau suivant récapitule les fonctionnalités disponibles par niveau de service:

Les opérations Create pour les instances zonales, régionales et d'entreprise peuvent prendre entre 15 minutes et une heure, en fonction de la taille de l'instance.

Le quota Filestore est utilisé au démarrage de la création de l'instance, mais l'instance ne vous est pas facturée pendant cette période.

Performances

Le tableau suivant fournit une comparaison plus détaillée des performances entre les niveaux de service:

Pour en savoir plus sur les performances, consultez la section Performances.

Pour obtenir une description plus détaillée des fonctionnalités disponibles par niveau de service, consultez la section Niveaux de service.

Allocation de la capacité

Allouez de la capacité au volume dont vous avez besoin lorsque vous créez l'instance. À mesure que vous approchez de votre limite de capacité, vous pouvez procéder au scaling à la hausse selon vos besoins sans affecter l'environnement d'exécution. Pour savoir comment surveiller la capacité de vos instances, consultez la page Surveiller les instances.

Dans la gcloud CLI, vous pouvez spécifier la capacité en nombres entiers à l'aide de GiB ou de TiB. L'unité par défaut est GiB.

Le tableau suivant indique les tailles d'instance disponibles pour chaque niveau :

La taille des instances peut correspondre à n'importe quelle valeur entière en gibioctets ou à son équivalent en tébioctet, comprise entre la taille minimale et maximale de l'instance, et qui est divisible par sa taille de pas incrémentielle. Par exemple, les tailles valides pour les instances de niveau zonal offrant une plage de capacité supérieure sont 10 Tio, 12, 5 Tio et 15 Tio.

Une fois créées, la taille des instances de base ne peut qu'augmenter. Tous les autres niveaux de service peuvent effectuer un scaling à la hausse ou à la baisse en termes de capacité. Pour en savoir plus, consultez Modifier des instances et Adapter la capacité.

Quota de la capacité totale

Chaque projet se voit attribuer un quota de capacité distinct, défini par la région et le niveau de service. Les limites de quota varient selon le niveau de service.

Une fois que vous avez atteint votre limite de quota, vous ne pouvez plus créer d'autres instances Filestore ni augmenter la capacité de vos instances existantes. Pour connaître le quota disponible, accédez à la page Quotas de la console Google Cloud:

Accéder à la page Quotas

Pour en savoir plus sur la demande d'augmentation de quota, consultez la section Demander une augmentation de quota.

Attribuez un nom au partage de fichiers

Un partage de fichiers est le répertoire d'une instance Filestore où sont stockés tous les fichiers partagés. C'est également l'élément que vous installez ou mappez sur la VM cliente.

Le nom du partage de fichiers doit respecter les conditions suivantes :

• Il doit comporter entre 1 et 32 caractères pour les niveaux zonal, régional et entreprise, et entre 1 et 16 caractères pour les niveaux de base.
• Commencer par une lettre
• Comporter des lettres majuscules ou minuscules, des chiffres et des traits de soulignement
• Il doit se terminer par une lettre ou un chiffre.

Sélectionner le réseau VPC

Le réseau que vous choisissez d'utiliser avec Filestore peut être un réseau VPC standard ou un réseau VPC partagé. Dans les deux cas, le réseau que vous choisissez doit disposer de suffisamment de ressources IP disponibles pour être dédié à l'instance Filestore. Sinon, la création de l'instance ne pourra pas être effectuée.

Les clients doivent se trouver sur le même réseau que l'instance Filestore pour pouvoir accéder aux fichiers stockés sur cette instance. Une fois l'instance créée, le réseau sélectionné ne peut plus être modifié.

Réseau VPC partagé

Avant de pouvoir créer une instance sur unRéseau VPC partagé dans un projet de service, l'administrateur réseau doit d'abord activer l'accès privé aux services pour le réseau VPC partagé. Si vous créez l'instance dans le projet hôte, l'accès privé aux services n'est pas nécessaire.

Les réseaux VPC partagés sont affichés dans la console Google Cloud au format suivant:

projects/HOST_PROJECT_ID/global/networks/SHARED_VPC_NAME

Pour connaître les procédures détaillées, consultez la section Créer une instance sur un réseau VPC partagé.

Verrouillage des fichiers NFS

Si les applications que vous prévoyez d'utiliser avec cette instance Filestore nécessitent un verrouillage de fichier NFS et que vous choisissez l'une des options suivantes, vous devrez peut-être ouvrir les ports utilisés par Filestore dans le réseau de votre choix:

• Réseau VPC autre que le réseau par défaut.
• Réseau VPC par défaut avec des règles de pare-feu modifiées.

Pour en savoir plus, consultez la section Configurer des règles de pare-feu.

Sélectionner un emplacement

L'emplacement fait référence à la région et à la zone où se trouve l'instance Filestore. Pour optimiser les performances et éviter les frais de mise en réseau interrégional, assurez-vous que l'instance Filestore se trouve dans la même région que les VM Compute Engine qui doivent y accéder.

Pour en savoir plus sur les régions et les zones, consultez la section Zones géographiques et régions.

Configurer le contrôle des accès basé sur les adresses IP

Par défaut, une instance Filestore accorde un accès en lecture et en écriture au niveau racine à tous les clients, y compris les VM Compute Engine et les clusters GKE, qui partagent le même projet Google Cloud et le même réseau VPC. Si vous souhaitez limiter l'accès, vous pouvez créer des règles qui accordent des niveaux d'accès spécifiques aux clients en fonction de leur adresse IP. Une fois les règles ajoutées, toutes les adresses IP et plages non spécifiées dans une règle sont révoquées. Les instances zonales, régionales et d'entreprise sont compatibles avec les paramètres de configuration des plages d'adresses IP qui se chevauchent. Pour en savoir plus, consultez la section Chevauchement d'autorisations.

Le tableau suivant décrit les droits de chaque niveau d'accès. Ces niveaux d'accès ne sont utilisés que dans la console Google Cloud. Dans la gcloud CLI et l'API, vous devez spécifier les configurations de règles directement.

root-squash mappe toutes les requêtes de uid 0 et gid 0 à anon_uid et anon_gid, respectivement. Cela supprime l'accès au niveau racine des clients qui tentent d'accéder au partage de fichiers en tant qu'utilisateur racine.

Lorsque vous créez des règles d'accès basées sur l'adresse IP:

• Vous devez spécifier une adresse IP interne ou une plage d'adresses IP internes, ainsi que le niveau d'accès accordé.
• Au moins une règle doit accorder l'accès admin au moment de la création de l'instance. Cette règle peut être supprimée une fois l'instance créée.
• Les instances zonales, régionales et d'entreprise sont compatibles avec les paramètres de configuration des plages d'adresses IP qui se chevauchent. Les instances de niveau de base ne sont pas compatibles. Pour en savoir plus, consultez la section Chevauchement d'autorisations.

Dans la console Google Cloud, vous pouvez créer jusqu'à quatre règles différentes (admin, admin-viewer, editor, viewer) impliquant jusqu'à 64 adresses IP ou plages d'adresses IP différentes.

Dans la gcloud CLI, vous pouvez configurer jusqu'à 64 adresses IP ou blocs CIDR différents par instance Filestore avec un maximum de 10 règles différentes. Une règle est définie comme la combinaison des configurations access-mode, squash-mode et anon_uid/anon_gid. Les champs anon_uid et anon_gid ont des valeurs par défaut de 65534 et ne peuvent être configurés que via l'API et gcloud CLI.

Exemple

Voici un exemple de trois règles d'accès basées sur les adresses IP différentes :

• access-mode=READ_ONLY, squash-mode=ROOT_SQUASH, anon_uid=10000.
• access-mode=READ_WRITE, squash-mode=ROOT_SQUASH, anon_gid=150.
• access-mode=READ_WRITE, squash-mode=NO_ROOT_SQUASH.

Pour créer des règles de contrôle des accès basées sur l'adresse IP à l'aide de la gcloud CLI, utilisez l'option --flags-file avec les commandes instances create ou instances update, et faites-la pointer vers un fichier de configuration JSON. Par exemple, si le fichier de configuration JSON s'appelle nfs-export-options.json, l'option est la suivante:

--flags-file=nfs-export-options.json

Exemple de fichier de configuration JSON:

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

• ip-ranges est l'adresse IP ou la plage à laquelle accorder l'accès. Vous pouvez spécifier plusieurs adresses ou plages IP en les séparant par une virgule. Seules les instances zonales, régionales et d'entreprise sont compatibles avec les paramètres de configuration des plages d'adresses IP qui se chevauchent. Pour en savoir plus, consultez la section Chevauchement d'autorisations.
• 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.

Clients situés sur des plages non-RFC 1918

Si vous envisagez de connecter des clients non-RFC 1918 à votre instance Filestore, vous devez leur accorder explicitement l'accès à l'instance Filestore à l'aide du contrôle des accès basé sur l'adresse IP.

Champs facultatifs

Les sections suivantes décrivent les champs facultatifs.

Ajouter une description d'instance

La description d'une instance vous permet de rédiger des descriptions, des notes ou des instructions pour vous-même et pour les autres utilisateurs. Par exemple, vous pouvez inclure des informations sur les éléments suivants:

• Types de fichiers stockés dans l'instance.
• Personnes ayant accès à l'instance.
• Instructions concernant l'accès à l'instance
• Utilisation de l'instance.

Les descriptions d'instances sont limitées à 2 048 caractères. Aucune restriction n'est imposée sur les caractères autorisés. Une fois qu'une instance Filestore est créée, vous pouvez mettre à jour sa description à tout moment. Pour en savoir plus sur la mise à jour des descriptions d'instances, consultez la page Modifier des instances.

Ajouter des étiquettes

Les étiquettes sont des paires valeur/clé que vous pouvez utiliser pour regrouper des instances associées et stocker des métadonnées sur une instance. Vous pouvez ajouter, supprimer ou modifier des libellés à tout moment. Pour en savoir plus, consultez Gérer les étiquettes.

Configurer une plage d'adresses IP réservée

Chaque instance Filestore doit avoir une plage d'adresses IP associée. Les plages d'adresses IP RFC 1918 et non-RFC 1918 (GA) sont acceptées.

Une fois spécifiée, la plage d'adresses IP d'une instance est immuable.

Les utilisateurs sont encouragés à laisser Filestore déterminer automatiquement une plage d'adresses IP libre et l'attribuer à l'instance. Lorsque vous sélectionnez votre propre plage, tenez compte des exigences suivantes en termes de ressources IP Filestore:

• Veuillez utiliser le format CIDR.

• Doit être une plage de sous-réseau VPC valide.

• Les instances de base nécessitent une taille de bloc de 29. Par exemple, 10.123.123.0/29.

• Les instances zonales, régionales et d'entreprise nécessitent une taille de bloc de 26. (par exemple, 172.16.123.0/26)

• La plage d'adresses IP ne doit pas chevaucher les éléments suivants:

  • Sous-réseaux existants du réseau VPC utilisés par l'instance Filestore.

  • Sous-réseaux existants d'un réseau VPC appairé à celui utilisé par l'instance Filestore. Pour en savoir plus, consultez la section Chevauchement de sous-réseaux au moment de l'appairage.

  • Plages d'adresses IP attribuées à toutes les autres instances Filestore existantes de ce réseau.

  • La plage d'adresses 172.17.0.0/16 est réservée aux composants Filestore internes. Par conséquent, les limites suivantes s'appliquent :

    • Les clients de cette plage ne peuvent pas être connectés aux instances Filestore.

    • Impossible de créer des instances Filestore dans cette plage d'adresses IP. Pour en savoir plus, consultez la section Problèmes connus.

• Il doit y avoir au moins un appairage de réseaux VPC ou au moins une connexion d'accès aux services privés par VPC.

Vous pouvez afficher les plages d'adresses IP des sous-réseaux de votre réseau en accédant à la page "Réseaux VPC" de la console Google Cloud:

Accéder à la page Réseaux VPC

Vous pouvez obtenir la plage d'adresses IP réservée à une instance Filestore sur la page des instances Filestore de la console Google Cloud:

Accéder à la page des instances Filestore

Si vous souhaitez utiliser l'accès privé aux services et spécifier une plage d'adresses IP réservées, vous devez spécifier le nom d'une plage d'adresses allouée pour la connexion. Si vous ne spécifiez pas de nom de plage, Filestore utilise automatiquement l'une des plages allouées associées à la connexion d'accès privé aux services.

Utiliser une clé de chiffrement gérée par le client

Par défaut, Google Cloud chiffre automatiquement les données au repos à l'aide de clés de chiffrement gérées par Google. Si vous avez besoin de mieux contrôler les clés qui protègent vos données, vous pouvez utiliser des clés de chiffrement gérées par le client (CMEK) pour Filestore. Pour en savoir plus, consultez Chiffrer des données avec des clés de chiffrement gérées par le client.

Étapes suivantes

• Découvrez comment configurer une instance pour l'utiliser avec le protocole NFSv4.1.
• Découvrez comment connecter des instances aux clients :
  • Installez le partage de fichiers Filestore sur une instance de VM Compute Engine.
  • Accédez aux instances Filestore avec le pilote CSI Filestore.
  • Utilisez des instances Filestore en tant que datastores externes pour les hôtes VMware ESXi dans VMware Engine.
  • Installer des partages de fichiers sur des clients distants
  • Installez une instance Filestore sur un service Cloud Run pour partager des données entre des conteneurs et des services.
• Découvrez comment récupérer les détails d'une instance, tels que son adresse IP, afin d'accéder au partage de fichiers Filestore depuis les clients.
• Résolvez les problèmes de création d'instances liés à Filestore.
• En savoir plus sur les réseaux et sous-réseaux du cloud privé virtuel (VPC)
• En savoir plus sur les exigences en termes de mise en réseau et de ressources IP pour Filestore