IBM Cloud Docs
Gestión de las comparticiones de archivos de réplica

Gestión de las comparticiones de archivos de réplica

Gestione comparticiones de archivos de réplica eliminando la relación de réplica para crear dos comparticiones de archivos independientes. La compartición del archivo de réplica pasa a ser de lectura/escritura, y puede actualizarla y suprimirla.

Necesita los roles de usuario de IAM de administrador o editor para poder crear y gestionar las réplicas de compartición de archivos y la relación de réplica. Para ver una lista de estos roles y acciones, consulte Roles de IAM para crear y gestionar comparticiones de archivos.

Información de sincronización de réplica

La réplica es una operación asíncrona, que no es instantánea. Después de cada operación de sincronización, el sistema proporciona información útil sobre el último proceso de réplica, como por ejemplo la fecha de inicio y finalización, y el volumen de datos transferido. Al ver la información de réplica, puede ver cuánto tiempo ha tardado la última réplica y calcular la velocidad de transferencia. Ver los valores de datos transferidos puede ayudarle a estimar los cargos de transferencia global al final del periodo de facturación.

Puede utilizar la información de sincronización de réplica para ajustar la planificación de réplica. Puede ayudarle a equilibrar el coste y la frecuencia con la que necesita que se renueven los datos en la réplica para satisfacer el objetivo de punto de recuperaciónEn la planificación de la recuperación de desastres, el momento en el que se restauran los datos medido en tiempo (segundos, minutos, horas) empezando en la instancia recuperada y terminando en el punto del desastre. . También puede ayudar a determinar si el proceso de réplica está en peligro de degradación.

Cuando la cantidad de datos que se van a transferir supera la cantidad de datos que se pueden transferir durante la ventana de réplica con la velocidad de transferencia normal, el proceso de réplica no se puede completar y el estado de réplica pasa a ser degraded. Si se produce esta situación, intente ajustar la tasa de cambio en la compartición de archivos y la frecuencia de réplica.

El sistema consulta el estado de la última sincronización cada 15 minutos. El resultado muestra los datos de la última réplica que se ha completado. Si una réplica está en curso cuando se ejecuta la consulta, no se muestra en la respuesta. Una vez completada la réplica, la siguiente consulta actualiza la última información de sincronización. Puede esperar un breve retraso entre la finalización de la replicación y el momento en que se actualiza la última información de sincronización en las interfaces.

Puede ver información sobre la última operación de réplica cuando vea los detalles de la unidad compartida de origen o réplica. Para obtener más información, consulte Ver detalles de un recurso compartido de archivos en la consola.

Puede ver información sobre la última operación de réplica cuando lista los detalles de la unidad compartida de origen o réplica. Para obtener más información, consulte Ver detalles de una compartición de archivos desde la CLI.

Puede recuperar mediante programación los detalles de la última sincronización llamando al método /shares en la API de VPC. Busque la sección latest_sync en la respuesta de la API para ver cuándo se ha iniciado la réplica (started_at), cuándo ha finalizado (completed_at) y cuántos datos se han transferido (data_transferred). Para obtener más información, consulte Ver una sola compartición de archivo con la API.

Además, puede ver la información histórica de la sincronización de replicación reciente si utiliza IBM Cloud Logs. Cuando se produce la réplica, el servicio de archivos genera un mensaje de registro de regional-file.00002I, que incluye información sobre cuándo se ha producido la réplica y cuántos datos se han transferido. Para obtener más información, consulte Registro para VPC.

Verificación de la replicación con la API

Puede utilizar la API para verificar que la replicación se ha realizado correctamente, está pendiente o ha fallado. Puede realizar la solicitud GET /shares/{share_id} para ver el estado con el ID de compartición del origen o las comparticiones de réplica.

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

En la respuesta, consulte la propiedad latest_job. El ejemplo muestra que la migración tras error de réplica ha sido satisfactoria:

  "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"
  }

Para una división de réplica, cuando la compartición de réplica se está dividiendo de la compartición de origen, puede ver un estado running para latest_job en la respuesta.

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

Una operación de réplica failover o split no se puede producir si se está realizando cualquier otra operación en la compartición de archivos, como por ejemplo expandir el tamaño. Puede ver un error 409 en la respuesta que indica el problema. Vea el ejemplo siguiente.

"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"

Eliminación de la relación de réplica

Puede finalizar la replicación eliminando la relación de replicación entre el recurso compartido de archivos de origen y el recurso compartido de archivos de réplica. La operación se denomina división de las comparticiones de archivo. La eliminación de la relación de réplica crea dos comparticiones de archivos independientes de lectura/escritura. Los datos ya no se sincronizan entre ellos. Puedes gestionar por separado cada archivo compartido, ampliar la capacidad y ajustar las IOPS, y crear más réplicas.

También puede especificar que los archivos compartidos de origen y réplica se dividan si una operación de conmutación por error no tiene éxito.

La eliminación de la relación de replicación no puede producirse cuando se está realizando otra operación en el recurso compartido de archivos de origen o de réplica (por ejemplo, se está ampliando el tamaño del recurso compartido de archivos). La operación de división permanece en estado pendiente hasta que finaliza la otra operación.

Cuando elimina la relación de réplica, no puede deshacer la acción. Además, los datos de la réplica no se sincronizan automáticamente con el archivo de origen antes de eliminar la relación de replicación.

Eliminación de la relación de replicación en la consola

Para eliminar la relación de replicación en la consola:

  1. Ir a la lista de todas las comparticiones de archivos. Desde la consola IBM Cloud, haga clic en el ícono del menú de navegación > ícono de VPC de infraestructura > Almacenamiento > Recursos compartidos de almacenamiento de archivos.

  2. Pulse el nombre de una compartición de archivos o de una compartición de archivos de réplica para ir a su página de detalles.

  3. En la sección Relación de réplica de compartición de archivos, pulse Eliminar relación de réplica. La eliminación de la relación de réplica crea dos comparticiones de archivos independientes.

  4. En la nueva ventana, haga clic en Desvincular. Los datos de la réplica no se sincronizan automáticamente con el archivo compartido de origen antes de eliminar la relación de replicación.

La página de detalles del recurso compartido de archivos indica que no hay relación de replicación.

Eliminación de la relación de réplica de la CLI

Para poder utilizar la CLI, debe instalar la CLI de IBM Cloud y el plugin de la CLI de VPC. Para obtener más información, consulte los Requisitos previos de la CLI.

  1. Localice la compartición desde la CLI listando las compartición de archivos en la región con el mandato 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. Vea los detalles de la compartición de archivos que desea modificar con el mandato 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              -
    
  3. Ejecute el mandato ibmcloud is share-replica-split y especifique la compartición de archivos de réplica por su nombre o 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. El resultado de esta operación son dos archivos compartidos de lectura/escritura independientes. Cuando lista las comparticiones de archivos en la región, puede ver none en la columna de réplica para las dos comparticiones de archivos.

    $ 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
    

Para obtener más información sobre las opciones de mandato, consulte ibmcloud is share-replica-split.

Eliminación de la relación de réplica con la API

Realice una solicitud de DELETE /shares/{replica_id}/source para eliminar la relación de réplica. La división de una compartición de archivos elimina la relación de réplica y crea dos comparticiones de archivo independientes. Después de eliminar la relación, no puede restablecerla. Una compartición de archivos no se puede dividir, si el lifecycle_state de la compartición de archivos es updating o si las operaciones de réplica están en curso.

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

Una respuesta satisfactoria indica que se ha aceptado la solicitud de desasociar una compartición de archivos de réplica de su compartición de archivos de origen.

Eliminación de la relación de réplica con Terraform

Utilice el recurso ibm_is_share_replica_operations para dividir las comparticiones de origen y réplica. La división de una compartición de archivos elimina la relación de réplica y crea dos comparticiones de archivo independientes. Después de eliminar la relación, no puede restablecerla.

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

Para obtener más información sobre los argumentos y atributos, consulte ibm_is_share_replica_operations.

Supresión de una compartición de archivos de réplica

El proceso para suprimir una compartición de archivos de réplica es similar al de suprimir una compartición de archivos de origen. Por ejemplo, debe suprimir destinos de montaje para la compartición antes de suprimirla. Dado que el recurso compartido de archivos de réplica está en replicación activa desde el recurso compartido de origen, el recurso compartido de archivos de réplica debe dividirse del origen antes de la eliminación. Puede dividir las comparticiones de dos maneras:

  • Realice una división manual, que elimina la relación de replicación y crea dos recursos compartidos de lectura/escritura independientes. A continuación, puede eliminar el destino de montaje y el recurso compartido de archivos de réplica como un recurso compartido de archivos normal.

  • Suprima la compartición de archivos de réplica directamente después de suprimir los destinos de montaje. Un proceso de split se inicia automáticamente en segundo plano. Una vez finalizada la operación de división, se suprime la compartición de archivos de réplica.

Puede utilizar la interfaz de usuarioCLIAPITerraform para suprimir una compartición de archivos.