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:
-
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, 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.
-
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 -
-
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 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.