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

Gestiona los recursos compartidos de archivos replicados eliminando las relaciones de replicación para crear recursos compartidos independientes de lectura y escritura que se puedan actualizar y eliminar por separado.

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.

Comprobación de la replicación mediante la API

Puedes utilizar la API para comprobar si 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: Bearer $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 detener 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 cada recurso compartido de archivos por separado, ampliar la capacidad y ajustar las IOPS, así como crear más réplicas.

También puedes especificar que los recursos compartidos de los archivos de origen y réplica se dividan si una operación de conmutación por error no se lleva a cabo con éxito.

No es posible eliminar la relación de replicación mientras se esté realizando otra operación en el recurso compartido de archivos de origen o de réplica (por ejemplo, si 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:

Ir a la lista de todas las comparticiones de archivos. Desde la consola IBM Cloud, haga clic en el del menú de navegación > de infraestructura > Almacenamiento > Recursos compartidos de almacenamiento de archivos.
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.
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.
En la nueva ventana, haz clic en « Desvincular ». Los datos de la réplica no se sincronizan automáticamente con el recurso compartido de origen hasta que se elimine la relación de replicación.

La página de detalles del recurso compartido de archivos indica que no existe ninguna 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.

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

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              -
Allowed Access Protocols     nfs4
Availability Mode            zonal
Bandwidth(Mbps)              1
Storage Generation           1

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.

El resultado de esta operación son dos recursos compartidos de archivos independientes con permisos de lectura y escritura. 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: Bearer $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.

Eliminación de archivos compartidos de réplica y origen

Puede que quieras eliminar tu réplica de archivos compartidos por varias razones. Una de las posibles razones es desbloquear la eliminación del recurso compartido de archivos de origen. Dado que el recurso compartido de archivos de réplica se encuentra en replicación activa desde el recurso compartido de origen, es necesario separar el recurso compartido de archivos de réplica del de origen antes de poder eliminar este último. Puedes dividir las acciones de dos maneras:

Realiza una división manual, lo que elimina la relación de replicación y crea dos recursos compartidos de archivos independientes, con acceso de lectura y escritura. A continuación, puede utilizar o eliminar el recurso compartido de archivos de réplica como utilizaría o eliminaría un recurso compartido de archivos normal.
Elimine el recurso compartido de archivos de réplica directamente después de eliminar sus destinos de montaje. Un proceso de split se inicia automáticamente en segundo plano. Una vez finalizada la operación de división, se elimina el recurso compartido de archivos de réplica y también se puede eliminar el recurso compartido de origen.

Puede eliminar recursos compartidos de archivos (origen o réplica) en la consola, desde la CLI, con la API o Terraform.