Création de partages de fichiers de réplique

Créez des partages de fichiers répliqués dans une autre zone au sein de la même région métropolitaine ou dans une autre région métropolitaine au sein de la même zone géographique à l'aide de la console, de l'interface de ligne de commande (CLI), de l'API ou de Terraform.

Le tableau suivant indique les régions métropolitaines qui peuvent se répliquer les unes avec les autres dans chaque zone géographique.

Ce tableau montre les régions métropolitaines qui peuvent se reproduire les unes les autres dans chaque géographie. Chaque zone géographique est une colonne distincte.
Amériques Europe Asie
  • Dallas, TX / us-south
  • Montréal / ca-mon
  • Sao Paulo / br-sao
  • Toronto / ca-tor
  • Washington, DC / us-east
 -Francfort / eu-de
-Londres / eu-gb
-Madrid / eu-es
  • Chennai / in-che
  • Mumbai / in-mum
  • Osaka / jp-osa
  • Sydney / au-syd
  • Tokyo / jp-tok

Le partage de fichiers source spécifié ne doit pas avoir déjà une autre réplique et ne doit pas être une réplique d'un autre partage.

Si vous souhaitez créer une réplique dans une autre région, vous devez d'abord établir des autorisations de service à service. Les deux instances de service de fichiers doivent appartenir au même compte. La réplication entre comptes n'est pas prise en charge. Pour plus d'informations, voir Établir des autorisations de service à service pour File Storage for VPC.

Lorsque vous créez des partages de fichiers avec disponibilité régionale, les données sont automatiquement répliquées dans toute la région; vous n'avez donc pas besoin de configurer de paires de réplication au sein de la région.

Ajouter la réplication à un partage de fichiers dans la console

Vous pouvez créer une réplique de votre partage de fichiers à partir de la liste de tous les partages de fichiers ou de la page des détails du partage de fichiers. Si vous ne disposez pas encore d'un partage de fichiers source, provisionnez-en un comme décrit dans la section Créer un partage de fichiers et monter la cible dans la console. Lorsque le partage de fichiers apparaît comme « stable » sur la page Partages de stockage de fichiers pour VPC, cliquez sur l'icône Actions Icône Actions et cliquez sur Créer une réplique.

Sur la page de création de réplique de partage de fichiers, passez en revue les détails du partage de fichiers source et renseignez les détails de la réplique.

  1. Nom : attribuez un nom unique au partage de réplique.

  2. Emplacement de la réplique-La zone géographique est présélectionnée et ne peut pas être modifiée. Utilisez le menu Zone pour sélectionner la zone de la réplique. Le menu est organisé par zone géographique. Sous chaque zone géographique, les agglomérations sont classées par ordre alphabétique. Cliquez sur la flèche située à côté du nom d'un métro pour afficher ses zones, puis cliquez sur une zone pour la sélectionner.

  3. Groupe de ressources-Sélectionnez le groupe de ressources dans la liste.

  4. Balises-Si vous le souhaitez, spécifiez des balises utilisateur. Les balises que vous appliquez à la réplique peuvent être identiques ou différentes des balises du partage source.

  5. Profil-Le profil dp2 est présélectionné, même si le partage de fichiers source est basé sur un profil d'une édition précédente. Indiquez la valeur maximale pour les E-S/s. Il détermine les performances que vous obtenez sur la réplique après avoir effectué une reprise en ligne.

  6. Cibles de montage - Vous pouvez, si vous le souhaitez, créer une cible de montage pour le partage de la réplique. Vous pouvez ignorer cette étape si vous ne souhaitez pas créer de cible de montage maintenant. Sinon, cliquez sur Créer. Vous pouvez créer une cible de montage par VPC et partage de fichiers. En fonction du mode d'accès à la cible de montage du partage, le formulaire Créer une cible de montage est différent.

    • Si vous avez sélectionné le groupe de sécurité comme mode d'accès, saisissez les informations décrites dans le tableau 2. Cette action crée et connecte une interface de réseau virtuel à votre cible de montage qui identifie le partage de fichiers avec une adresse IP réservée et applique les règles du groupe de sécurité sélectionné. Cette cible de montage prend en charge le chiffrement en transit et le montage entre zones.
    Valeurs pour la création d'une cible de montage.
    Zone Valeur
    Détails
    Nom de la cible de montage Spécifiez un nom de cible de montage. Le nom peut comporter jusqu'à 63 caractères alphanumériques en minuscules, y compris le trait d'union (-), et doit commencer par une lettre minuscule. Vous pouvez ensuite modifier le nom si vous le souhaitez.
    Zone La zone est héritée du partage de fichiers (par exemple, Dallas 2).
    VPC Sélectionnez un VPC disponible. La liste ne comprend que les VPC disposant d'un sous-réseau dans la zone sélectionnée.
    Sous-réseau Sélectionnez un sous-réseau dans la liste.
    Adresse IP réservée Obligatoire pour la cible de montage. L'adresse IP ne peut pas être modifiée par la suite. Toutefois, vous pouvez supprimer la cible de montage et en créer une autre avec une adresse IP différente.
    Méthode de réservation Vous pouvez demander au service de fichiers de sélectionner une adresse IP pour vous. L'adresse IP réservée devient visible après la création de la cible de montage. Vous pouvez également spécifier votre propre adresse IP.
    Libération auto Libère l'adresse IP lorsque vous supprimez la cible de montage. Activée par défaut.
    Groupes de sécurité Le groupe de sécurité par défaut du VPC est sélectionné. Vous pouvez l'utiliser ou sélectionner un autre groupe de sécurité dans la liste.
    • Obsolète Si vous avez sélectionné VPC comme mode d'accès, donnez un nom à la cible de montage et sélectionnez un VPC dans la liste. Cette cible de montage peut être utilisée pour monter le partage de fichiers sur n'importe quelle instance de serveur virtuel du VPC sélectionné dans la même zone que le partage de fichiers. Le montage interzone n'est pas pris en charge.

    Le mode d'accès VPC est obsolète et ne sera plus pris en charge à compter du 6 mai 2027. Suivez le guide de migration pour mettre à jour le mode de contrôle d'accès du partage source à security-group.

  7. Fréquence de synchronisation-Indiquez la fréquence à laquelle vous souhaitez synchroniser les modifications du partage de fichiers principal vers le partage de répliques. Pour la fréquence, sélectionnez l'une des options suivantes et configurez l'heure de début :

    • Toutes les 15 minutes: saisissez la valeur en minutes correspondant à l'heure de début.
    • Par heure: saisissez la valeur en minutes correspondant à l'heure de début.
    • Quotidien: saisissez l'heure de début en temps universel coordonné (UTC) au format HH:MM, comprise entre 00:00 et 23:59.
    • Hebdomadaire: sélectionnez le ou les jours de la semaine où la réplication doit s'exécuter, puis saisissez l'heure de début en UTC au format HH:MM, comprise entre 00:00 et 23:59.
    • Mensuel: indiquez le jour du mois où la réplication s'exécute (1 à 31), puis indiquez l'heure de début en UTC au format HH:MM, comprise entre 00:00 et 23:59.
    • Expression Cron: saisissez une cron-spec expression au format minute hour day month weekday. La réplication doit être planifiée à des intervalles d'au moins 15 minutes. Par exemple, pour effectuer une réplication tous les jours à 17 h 30 UTC, saisissez 30 17 * * *.

  8. Chiffrement - La réplique hérite toujours des paramètres de chiffrement du partage source. Le type de chiffrement ne peut pas être modifié. Si le partage source utilise un chiffrement géré par le fournisseur, la vignette Géré par le fournisseur s'affiche mais ne peut pas être sélectionnée. Si le partage source utilise un chiffrement géré par le client, les détails relatifs à la clé s'affichent en lecture seule, notamment le type de chiffrement, le nom de la clé, l'instance du service de gestion des clés et l'ID de la clé.

  9. Dans le panneau latéral, passez en revue votre coût estimé et appliquez un code de remise, si vous en avez un.

  10. Cliquez sur Créer un partage de fichiers.

Si vous n'êtes pas encore prêt à commander ou si vous cherchez simplement des informations de tarification, vous pouvez ajouter les informations que vous voyez dans le panneau latéral à une estimation. Pour plus d'informations sur le fonctionnement de cette fonction, voir Estimation des coûts.

Ajout d'une réplication à un partage de fichiers à partir de l'interface de ligne de commande (CLI)

Vous pouvez utiliser l'interface CLI pour créer un partage de fichiers avec un partage réplique dans une autre zone ou région, ou pour créer un partage réplique pour un partage de fichiers existant.

Avant de pouvoir utiliser l'interface de ligne de commande, vous devez installer l'interface de ligne de commande d'IBM Cloud et le plug-in de l'interface de ligne de commande du VPC. Pour plus d'informations, reportez-vous à la rubrique Configuration requise pour l'interface de ligne de commande.

Création d'un partage de fichiers avec une réplique à partir de l'interface de ligne de commande

Vous pouvez créer simultanément un partage de fichiers par zone avec une réplique située dans la même région. Cette approche n'est prise en charge que pour les parts zonales dont les répliques restent dans la même région. Les répliques interrégionales doivent être créées lors d'une étape distincte, car elles nécessitent que le partage source soit dans un état stable au moment de l'initialisation de la réplique.

Lorsque vous utilisez la commande 'ibmcloud is share-create pour créer votre partage, vous pouvez créer un partage réplique en même temps en spécifiant des valeurs pour les options '--replica-share-name, '--replica-share-profile, '--replica-share-cron-spec,--replica-share-zone' . L'option cron spécifie la fréquence de réplication, et vous pouvez planifier la réplication de vos données jusqu'à une fréquence de 15 minutes. Pour plus d'informations sur les options de la commande, voir 'ibmcloud is share-create.

Dans l'exemple suivant, un partage my-source-file-share est créé dans us-south-2 avec un partage de fichiers réplique my-replica-file-share dans us-south-1. Dans cet exemple, une seule cible de montage est créée pour le partage de fichiers source. Vous pouvez également créer une cible de montage pour le partage de la réplique en utilisant la même syntaxe JSON avec l'option --replica-share-mount-targets.

ibmcloud is share-create --name my-source-file-share --zone us-south-2 --profile dp2 --size 1500 --iops 2000  --user-tags env:dev --mount-targets '[{"name":"my-source-mount-target","virtual_network_interface": {"name":"my-source-vni","subnet": {"id":"0717-c66032c9-048d-4c35-aa83-c932e24afdbb"}}}]' --replica-share-name my-replica-file-share --replica-share-profile dp2 --replica-share-cron-spec '55 09 * * *' --replica-share-zone us-south-1

Creating file share my-source-file-share under account Test Account as user test.user@ibm.com...
ID                                 r006-0a3444bc-df55-4c2e-aef4-f37a9a8d8262
Name                               my-source-file-share
CRN                                crn:v1:bluemix:public:is:us-south-2:a/a1234567::share:r006-0a3444bc-df55-4c2e-aef4-f37a9a8d8262
Lifecycle state                    pending
Access control mode                security_group
Accessor binding role              none
Allowed transit encryption modes   user_managed,none
Zone                               us-south-2
Profile                            dp2
Size(GB)                           1500
IOPS                               2000
User Tags                          env:dev
Encryption                         provider_managed
Mount Targets                      ID                                          Name
                                   r006-67799c85-09cf-4cfe-811d-effa10c99395   my-source-mount-target
Resource group                     ID                                 Name
                                   6edefe513d934fdd872e78ee6a8e73ef   defaults
Created                            2025-08-01T17:25:05+00:00
Replication share                  ID                                          Name                    Resource type
                                   r006-2068a709-8c18-4844-8c1d-42b83889dfb3   my-replica-file-share   share
Replication role                   source
Replication status                 none
Replication status reasons         Status code   Status message
                                   -             -
Snapshot count                     0
Snapshot size                      0
Source snapshot                    -
Allowed Access Protocols           nfs4
Availability Mode                  zonal
Bandwidth(Mbps)                    1
Storage Generation                 1

Création d'une réplique d'un partage de fichiers existant à partir de l'interface de ligne de commande (CLI)

Vous pouvez créer une réplique d'un partage de fichiers existant dans la même région ou dans une autre région de la même zone géographique.

  1. Localisez votre partage de fichiers source à partir de l'interface de ligne de commande en répertoriant vos partages de fichiers dans la région à l'aide de la commande ibmcloud is shares.

    ibmcloud is shares

    Listing shares in all resource groups and region us-south under account Test Account as user test.user@ibm.com...
ID                                          Name                    Lifecycle state   Zone         Profile   Size(GB)   Resource group   Replication role   Accessor binding role   Snapshot count   Snapshot size
r006-a8d6af48-0c97-4c6b-bab1-fbefdc1e1e03   my-file-share           stable            us-south-2   dp2       10         defaults         none               none                    0                0
r006-aaf4bfe9-358c-4faa-a4ec-0b955090b940   my-file-share-2         stable            us-south-2   dp2       10         defaults         none               none                    0                0
r006-a60bfa90-a893-40ad-be34-28ab51a963f9   replica-dal-2           stable            us-south-2   dp2       10         defaults         replica            none                    0                0
r006-3f21e3c3-e12d-425f-ab77-810cabfde8df   source-dal-1            stable            us-south-1   dp2       10         defaults         source             none                    0                0
r006-455b601c-8fc1-4476-8771-4708c49c8ef7   my-replica-share-dal-1  stable            us-south-1   dp2       10         defaults         replica            none                    0                0
r006-4dadac27-cd17-42df-a5fe-1388705d33e0   my-source-share-dal-2   stable            us-south-2   dp2       10         defaults         source             none                    0                0

  2. Affichez les détails du partage de fichiers que vous souhaitez utiliser comme source avec la commande ibmcloud is share. Vous pouvez utiliser le nom ou l'ID du partage lorsque vous créez une réplique dans la même région. Si vous créez la réplique dans une autre région, notez le CRN du partage de fichiers source.

    ibmcloud is share my-file-share

    Getting file share my-file-share under account Test Account as user test.user@ibm.com...
ID                           r006-b696742a-92ee-4f6a-bfd7-921d6ddf8fa6
Name                         my-file-share
CRN                          crn:v1:bluemix:public:is:us-south-2:a/a1234567::share:r006-b696742a-92ee-4f6a-bfd7-921d6ddf8fa6
Lifecycle state              stable
Access control mode          security_group
Accessor binding role        none
Zone                         us-south-2
Profile                      dp2
Size(GB)                     1000
IOPS                         1000
User Tags                    docs:test
Encryption                   provider_managed
Mount Targets                ID                                          Name
                             r006-dd497561-c7c9-4dfb-af0a-c84eeee78b61   my-cli-share-mount-target-1
Resource group               ID                                 Name
                             db8e8d865a83e0aae03f25a492c5b39e   Default
Created                      2023-10-18T22:15:15+00:00
Replication role             none
Replication status           none
Replication status reasons   Status code   Status message
                             -             -
Snapshot count               0
Snapshot size                0
Source snapshot              -
Allowed Access Protocols     nfs4
Availability Mode            zonal
Bandwidth(Mbps)              1
Storage Generation           1

  3. Créez un partage de réplique en exécutant la commande ibmcloud is share-replica-create dans la région cible. Si vous ne ciblez pas la bonne région, utilisez la commande ibmcloud target -r REGION pour changer de région cible. Spécifiez le partage de la source par ID ou CRN en utilisant l'option --source-share-id. Fournissez des valeurs pour définir la zone dans laquelle le partage de fichiers répliqué va être créé, et le profil du partage répliqué. Spécifiez la planification de la réplication avec une expression cron en utilisant l'option --replication-cron-spec. Si le partage de fichiers source est crypté à l'adresse user_managed, vous devez fournir l'adresse --encryption-key-crn. La propriété --encryption-key-crn ne doit pas être spécifiée autrement.

    ibmcloud is share-replica-create --name my-replica-share --zone us-south-3 --profile dp2 --replication-cron-spec '10 05 * * *' --source-share my-file-share

    Creating replica file share my-replica-share under account Test Account as user test.user@ibm.com...
ID                               r006-6d1719da-f790-45cc-9f68-896fd5673a1a
Name                             my-replica-share
CRN                              crn:v1:bluemix:public:is:us-south-3:a/a1234567::share:r006-6d1719da-f790-45cc-9f68-896fd5673a1a
Lifecycle state                  pending
Access control mode              security_group
Accessor binding role            origin
Allowed transit encryption modes ipsec,none
Zone                             us-south-3
Profile                          dp2
Size(GB)                         1000
IOPS                             100
User Tags                        docs:test
Encryption                       provider_managed
Mount Targets                    ID                          Name
                                 No mounted targets found.
Resource group                   ID                                 Name
                                 db8e8d865a83e0aae03f25a492c5b39e   Default
Created                          2024-06-25T15:13:18+00:00
Latest job                       Job status   Job status reasons
                                 running      -
Replication cron spec            10 05 * * *
Replication role                 replica
Replication status               initializing
Replication status reasons       Status code   Status message
                                 -             -
Source share                     ID                                          Name            Resource type
                                 r006-b696742a-92ee-4f6a-bfd7-921d6ddf8fa6   my-file-share   share
Snapshot count                   0
Snapshot size                    0
Source snapshot                  -
Allowed Access Protocols         nfs4
Availability Mode                zonal
Bandwidth(Mbps)                  1
Storage Generation               1

Ajouter la réplication à un partage de fichiers à l'aide de l'API

Vous pouvez configurer la réplication à l'aide d'un programme en appelant la méthode /shares dans l'API VPC, comme illustré dans les exemples de demande suivants.

Avant de commencer, configurez d'abord l'environnement de l'API. Pour plus d'informations sur l'API VPC, voir les informations de référence de l'API VPC.

Création d'un partage de fichiers avec une réplique à l'aide de l'API

Vous pouvez créer simultanément un partage de fichiers par zone avec une réplique située dans la même région. Cette approche n'est prise en charge que pour les parts zonales dont les répliques restent dans la même région. Les répliques interrégionales doivent être créées lors d'une étape distincte, car elles nécessitent que le partage source soit dans un état stable au moment de l'initialisation de la réplique.

Lorsque vous créez un partage de fichiers, vous pouvez spécifier qu'un partage de fichiers répliqué soit également créé dans une autre zone. Effectuez une demande POST /shares et spécifiez la propriété replica_share pour définir le partage de fichiers de réplique.

L'exemple suivant crée la réplique test-replica-001 pour le partage de source source-share-001. Les cibles de montage, qui sont facultatives lors de la création d'un partage de fichiers, sont spécifiées pour le partage de fichiers répliqué et le partage de fichiers source.

curl -X POST\
"$vpc_api_endpoint/v1/shares?version=2023-08-08&generation=2"\
-H "Authorization: Bearer $iam_token"\
-d '{
    "name": "source-share-001",
    "profile":{"name":"dp2"},
    "size":100,
    "iops": 400,
    "mount-targets":[{"vpc":{"id":"08669c86-4c8a-4bfa-8ddc-37071f955c52"}],
    "zone":{"name":"us-south-1"},
    "replica_share":{
  	   "name": "test-replica-001",
      "profile":{"name":"dp2"},
      "replication_cron_spec":"0 */5 * * *",
      "zone":{"name":"us-south-3"},
      "mount_targets": [
        {"virtual_network_interface": {"subnet": {"id": "2302-ea5fe79f-52c3-4f05-86ae-9540a10489f5"}}},
        {"vpc": {"id": "7ec86020-1c6e-4889-b3f0-a15f2e50f87e"}}],
      "resource_group": {},
      "allowed_transit_encryption_modes": "ipsec",
      "user_tags": ["string"]}}]
      }
    "resource_group": {},
    "allowed_transit_encryption_modes": "ipsec",
    "user_tags": ["string"]
   }'

Création d'une réplique pour un partage de fichiers existant avec l'API

Pour activer la réplication sur un partage de fichiers existant, vous devez créer un partage répliqué dans une autre zone. Dans la demande POST /shares, indiquez le nom et le profil du partage de la réplique et indiquez le source_share par son nom, son ID ou son nom de ressource de cloud. Les autres propriétés requises sont zone, et replication_cron_spec, qui définissent le calendrier de réplication. Vous pouvez programmer la réplication de vos données jusqu'à une fréquence de 15 minutes.

Ajout de la réplication au partage de fichiers avec Terraform

Vous pouvez utiliser la ressource ibm_is_share dans Terraform pour créer un partage de fichiers avec la réplication ou mettre à jour un partage de fichiers pour inclure la réplication.

L'exemple suivant crée un partage répliqué dans la zone us-south-3 et l'associe au partage parent identifié par l'ID ibm_is_share.example.id.

resource "ibm_is_share" "my-replica1" {
  zone                  = "us-south-3"
  source_share          = ibm_is_share.example.id
  name                  = "my-replica1"
  profile               = "dp2"
  replication_cron_spec = "0 */5 * * *"
}

L'exemple suivant crée un partage de fichiers dans us-south-1 avec une réplique dans us-south-3.

resource "ibm_is_share" "my-replica" {
  zone    = "us-south-1"
  size    = 220
  name    = "my-share"
  profile = "dp2"
  replica_share {
    name                  = "my-replica"
    replication_cron_spec = "0 */5 * * *"
    profile               = "dp2"
    zone                  = "us-south-3"
  }
}

Etapes suivantes