Gestion des partages de fichiers de réplique

Gérez les partages de fichiers répliqués en supprimant les relations de réplication afin de créer des partages en lecture/écriture indépendants pouvant être mis à jour et supprimés séparément.

Vous devez disposer des rôles utilisateur IAM Administrateur ou Editeur pour créer et gérer des répliques de partage de fichiers et les relations de réplication. Pour obtenir la liste de ces rôles et actions, voir Rôles IAM pour la création et la gestion des partages de fichiers.

Informations de synchronisation de réplication

La réplication est une opération asynchrone qui n'est pas instantanée. Après chaque opération de synchronisation, le système fournit des informations utiles sur le dernier processus de réplication, telles que les dates de début et de fin et le volume de données transféré. En affichant les informations de réplication, vous pouvez voir la durée de la dernière réplication et calculer la vitesse de transfert. L'affichage des valeurs de données transférées peut vous aider à estimer les frais de transfert globaux à la fin de la période de facturation.

Vous pouvez utiliser les informations de synchronisation de réplication pour optimiser votre planification de réplication. Il peut vous aider à équilibrer le coût et la fréquence à laquelle vous avez besoin que les données soient actualisées sur la réplique pour répondre à votre objectif de point de repriseDans la planification de la reprise après sinistre, le délai de restauration des données est mesuré en temps (secondes, minutes, heures) à partir de l'instance récupérée et jusqu'au point du sinistre. . Il peut également aider à déterminer si le processus de réplication est en danger de dégradation.

Lorsque la quantité de données à transférer dépasse la quantité de données pouvant être transférée pendant la fenêtre de réplication avec la vitesse de transfert normale, le processus de réplication ne peut pas se terminer et le statut de réplication passe à degraded. Si cette situation se produit, essayez d'ajuster le taux de modification sur le partage de fichiers et la fréquence de réplication.

Le système demande l'état de la dernière synchronisation toutes les 15 minutes. Le résultat affiche les données de la dernière réplication terminée. Si une réplication est en cours lors de l'exécution de la requête, elle ne s'affiche pas dans la réponse. Une fois la réplication terminée, la requête suivante met à jour les dernières informations de synchronisation. Vous pouvez vous attendre à un court délai entre la fin de la réplication et le moment où les dernières informations de synchronisation sont mises à jour dans les interfaces.

Vous pouvez afficher des informations sur la dernière opération de réplication lorsque vous affichez les détails du partage de la source ou de la réplique. Pour plus d'informations, voir Afficher les détails d'un partage de fichiers dans la console.

Vous pouvez afficher des informations sur la dernière opération de réplication lorsque vous répertoriez les détails du partage de la source ou de la réplique. Pour plus d'informations, voir Afficher les détails d'un partage de fichiers à partir de l'interface de ligne de commande.

Vous pouvez extraire à l'aide d'un programme les détails de la dernière synchronisation en appelant la méthode /shares dans l'API VPC. Recherchez la section latest_sync dans la réponse de l'API pour savoir quand la réplication a démarré (started_at), quand elle s'est terminée (completed_at) et quelle quantité de données a été transférée (data_transferred). Pour plus d'informations, voir Affichage d'un partage de fichiers unique avec l'API.

En outre, vous pouvez consulter les informations historiques de la dernière synchronisation de la réplication lorsque vous utilisez IBM Cloud Logs. Lorsque la réplication se produit, le service de fichiers génère un message de journal regional-file.00002I, qui inclut des informations sur la date de la réplication et la quantité de données transférées. Pour plus d'informations, voir Journalisation pour VPC.

Vérification de la réplication à l'aide de l'API

Vous pouvez utiliser l'API pour vérifier si la réplication a réussi, est en attente ou a échoué. Vous pouvez effectuer la demande GET /shares/{share_id} pour afficher le statut avec l'ID de partage de la source ou les partages de réplique.

curl -X GET \
"$vpc_api_endpoint/v1/shares/$share_id?version=2023-08-08&generation=2"\
-H "Authorization: Bearer $iam_token"

Dans la réponse, examinez la propriété latest_job. L'exemple montre que la reprise en ligne de la réplication a abouti:

  "created_at": "2023-08-08T23:31:59Z",
  "crn": "crn:[...]",
  "encryption": "provider_managed",
  "href": "$vpc_api_endpoint/v1/shares/199d78ec-b971-4a5c-a904-8f37ae710c63",
  "id": "199d78ec-b971-4a5c-a904-8f37ae710c63",
  "iops": 3000,
  "lifecycle_state": "stable",
  "name": "share-name1",
  .
  .
  .
  "latest_job": {
      "status": "succeeded",
      "status_reason": {
          "code": "",
          "message": "",
          "more_info": ""
      },
      "type": "replication_failover"
  }

Pour une division de réplication, lorsque le partage de réplique est fractionné à partir du partage source, vous pouvez voir un statut running pour latest_job dans la réponse.

"latest_job": {
    "status": "running",
     "status_reason": {
          "code": "",
          "message": "",
         "more_info": ""
    },
    "type": "replication_split"
},

Une opération de réplication failover ou split ne peut pas se produire si une autre opération est en cours d'exécution sur le partage de fichiers, telle que l'extension de la taille. Vous pouvez voir une erreur 409 dans la réponse qui indique le problème. Consultez l'exemple suivant.

"errors": [
    {
        "code": "share_operation_pending",
          "message": "An operation 'replication_failover' is pending on file share, request to 'replication_split' cannot be accepted.",
          "more_info": "Before sending another request wait for the current operation to complete and try again."
     }
],
"trace": "4634eee2-0a9b-43b7-b35e-8885cc258500"

Suppression de la relation de réplication

Vous pouvez mettre fin à la réplication en supprimant la relation de réplication entre le partage de fichiers source et le partage de fichiers répliqué. L'opération est appelée fractionnement des partages de fichiers. La suppression de la relation de réplication crée deux partages de fichiers indépendants en mode lecture/écriture. Les données ne sont plus synchronisées entre elles. Vous pouvez gérer chaque partage de fichiers individuellement, augmenter la capacité et ajuster le nombre d'IOPS, ainsi que créer davantage de répliques.

Vous pouvez également spécifier que les partages de fichiers source et réplique soient séparés si une opération de basculement échoue.

La suppression de la relation de réplication n'est pas possible lorsqu'une autre opération est en cours sur le partage de fichiers source ou répliqué (par exemple, lorsque la taille du partage de fichiers est en cours d'augmentation). L'opération de fractionnement reste en attente jusqu'à ce que l'autre opération se termine.

Lorsque vous supprimez la relation de réplication, cette action est irréversible. De plus, les données de la réplique ne sont pas synchronisées automatiquement avec le fichier source avant la suppression de la relation de réplication.

Suppression de la relation de réplication dans la console

Pour supprimer la relation de réplication dans la console :

  1. Accédez à la liste de tous les partages de fichiers. Dans la console IBM Cloud, cliquez sur l'icône de menu Navigation > Infrastructure VPC > Stockage > Partages de stockage de fichiers.

  2. Cliquez sur le nom d'un partage de fichiers ou d'un partage de fichiers de réplique pour accéder à la page de détails correspondante.

  3. Dans la section Relation de réplication de partage de fichiers, cliquez sur Supprimer la relation de réplication. La suppression de la relation de réplication crée deux partages de fichiers indépendants.

  4. Dans la nouvelle fenêtre, cliquez sur « Supprimer le lien ». Les données de la réplique ne sont pas synchronisées automatiquement avec le partage de fichiers source avant la suppression de la relation de réplication.

La page de détails du partage de fichiers indique qu'il n'y a pas de relation de réplication.

Retrait de la relation de réplication de l'interface de ligne de commande

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.

  1. Localisez votre partage à 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-2a10af45-de9e-4894-8e9e-fd01a25ec529   my-replica-file-share   stable            us-south-1   dp2       101        Default         replica            none                    0                0
r006-74634ace-43bd-4983-a22b-47b1c9662794   my-source-file-share    stable            us-south-2   dp2       101        Default         source             none                    1                1
r006-b1707390-3825-41eb-a5bb-1161f77f8a58   my-vpc-file-share       stable            us-south-2   dp2       1000       Default         none               none                    0                0
r006-b696742a-92ee-4f6a-bfd7-921d6ddf8fa6   my-file-share           stable            us-south-2   dp2       1500       Default         none               none                    0                0

  2. Affichez les détails du partage de fichiers que vous souhaitez modifier à l'aide de la commande ibmcloud is share.

    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)                     1500
IOPS                         2000
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
Latest job                   Job status   Job status reasons
                             succeeded    -

Replication share            ID                                          Name               Resource type
                             r006-6d1719da-f790-45cc-9f68-896fd5673a1a   my-replica-share   share

Replication role             source
Replication status           active
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. Exécutez la commande ibmcloud is share-replica-split et indiquez le partage de fichiers de réplique par son nom ou son ID.

    ibmcloud is share-replica-split r006-6d1719da-f790-45cc-9f68-896fd5673a1a

    This will disassociate a replica file share r006-6d1719da-f790-45cc-9f68-896fd5673a1a from its source file share and cannot be undone. Continue [y/N] ?> y
The request to disassociate a replica file share r006-6d1719da-f790-45cc-9f68-896fd5673a1a from its source file share was accepted, under account Test Accouont as user test.user@ibm.com...
OK
Replica File share r006-6d1719da-f790-45cc-9f68-896fd5673a1a is disassociated.

  4. Cette opération aboutit à la création de deux partages de fichiers indépendants en lecture-écriture. Lorsque vous répertoriez les partages de fichiers dans la région, vous pouvez voir none dans la colonne de réplication pour les deux partages de fichiers.

    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
r006-dc6a644d-c7da-4c91-acf0-d66b47fc8516   my-replica-file-share   stable            us-south-1   dp2       1500       Default          replica
r006-e4acfa9b-88b0-4f90-9320-537e6fa3482a   my-source-file-share    stable            us-south-2   dp2       1500       Default          source
r006-6d1719da-f790-45cc-9f68-896fd5673a1a   my-replica-share        stable            us-south-3   dp2       1500       Default          none
r006-925214bc-ded5-4626-9d8e-bc4e2e579232   my-new-file-share       stable            us-south-2   dp2       500        Default          none
r006-b1707390-3825-41eb-a5bb-1161f77f8a58   my-vpc-file-share       stable            us-south-2   dp2       1000       Default          none
r006-b696742a-92ee-4f6a-bfd7-921d6ddf8fa6   my-file-share           stable            us-south-2   dp2       1500       Default          none

Pour plus d'informations sur les options de commande, voir ibmcloud is share-replica-split.

Suppression de la relation de réplication avec l'API

Effectuez une demande DELETE /shares/{replica_id}/source pour supprimer la relation de réplication. La division d'un partage de fichiers supprime la relation de réplication et crée deux partages de fichiers indépendants. Après avoir supprimé la relation, vous ne pourrez plus la rétablir. Un partage de fichiers ne peut pas être fractionné si le lifecycle_state du partage de fichiers est updating ou si des opérations de réplique sont en cours.

curl -X DELETE \
"$vpc_api_endpoint/v1/shares/{replica_share_id}/source?version=2023-08-08&generation=2"\
-H "Authorization: Bearer $iam_token"\

Une réponse concluante indique que la demande de dissociation d'un partage de fichiers de réplique à partir du partage de fichiers source associé a été acceptée.

Suppression de la relation de réplication avec Terraform

Utilisez la ressource ibm_is_share_replica_operations pour fractionner les partages de source et de réplique. La division d'un partage de fichiers supprime la relation de réplication et crée deux partages de fichiers indépendants. Après avoir supprimé la relation, vous ne pourrez plus la rétablir.

resource "ibm_is_share_replica_operations" "test" {
  share_replica = ibm_is_share.replica.id
  split_share = true
}

Pour plus d'informations sur les arguments et les attributs, voir ibm_is_share_replica_operations.

Suppression des répliques et des partages de fichiers source

Il se peut que vous souhaitiez supprimer votre réplique de partage de fichiers pour diverses raisons. L'une des raisons possibles est de débloquer la suppression du partage de fichiers source. Le partage de fichiers répliqué étant en cours de réplication active à partir du partage source, il doit être dissocié de ce dernier avant que le partage source puisse être supprimé. Vous pouvez diviser les actions de deux façons :

  • Effectuez une scission manuelle, qui supprime la relation de réplication et crée deux partages de fichiers indépendants, en lecture et en écriture. Ensuite, vous pouvez utiliser ou supprimer le partage de fichiers réplique comme vous le feriez pour un partage de fichiers normal.

  • Supprimez le partage de fichiers répliqué directement après avoir supprimé ses cibles de montage. Un processus split est automatiquement lancé en arrière-plan. Une fois l'opération de fractionnement terminée, le partage de fichiers de la réplique est supprimé et le partage de la source peut l'être également.

Vous pouvez supprimer des partages de fichiers (source ou réplique) dans la console, à partir de la CLI, avec l'API ou Terraform.