Gestione delle condivisioni file di replica

Gestire le condivisioni di file replica rimuovendo le relazioni di replica per creare condivisioni di lettura/scrittura indipendenti che possano essere aggiornate ed eliminate separatamente.

Hai bisogno dei ruoli utente di amministratore o editor IAM per creare e gestire le repliche di condivisione file e la relazione di replica. Per un elenco di tali ruoli e azioni, vedi Ruoli IAM per la creazione e la gestione delle condivisioni file.

Informazioni sulla sincronizzazione della replica

La replica è un'operazione asincrona, che non è istantanea. Dopo ogni operazione di sincronizzazione, il sistema fornisce informazioni utili sull'ultimo processo di replica, come la data di inizio e di fine e il volume di dati trasferito. Visualizzando le informazioni di replica, è possibile visualizzare il tempo impiegato dall'ultima replica e calcolare la velocità di trasferimento. Vedere i valori dei dati trasferiti può aiutarti a stimare gli addebiti di trasferimento globali alla fine del periodo di fatturazione.

È possibile utilizzare le informazioni di sincronizzazione della replica per ottimizzare la pianificazione della replica. Può aiutare a bilanciare il costo e la frequenza con cui è necessario aggiornare i dati sulla replica per soddisfare l' obiettivo del punto di ripristinoNella pianificazione del disaster recovery, il momento in cui i dati vengono ripristinati, misurato in termini di tempo (secondi, minuti, ore) a partire dall'istanza recuperata fino al punto in cui si è verificato il disastro. . Può anche aiutare a determinare se il processo di replica è in pericolo di degrado.

Quando la quantità di dati da trasferire supera la quantità di dati che è possibile trasferire durante la finestra di replica con la velocità di trasferimento normale, il processo di replica non può essere completato e lo stato di replica diventa degraded. Se si verifica questa situazione, provare a modificare la frequenza di modifica sulla condivisione file e la frequenza di replica.

Il sistema interroga lo stato dell'ultima sincronizzazione ogni 15 minuti. Il risultato mostra i dati dell'ultima replica completata. Se una duplicazione è in corso quando la query viene eseguita, non viene visualizzata nella risposta. Una volta completata la replica, la query successiva aggiorna le informazioni sull'ultima sincronizzazione. È possibile prevedere un breve ritardo tra il completamento della replica e l'aggiornamento delle ultime informazioni di sincronizzazione nelle interfacce.

È possibile visualizzare informazioni sull'ultima operazione di duplicazione quando si visualizzano i dettagli della condivisione di origine o di replica. Per ulteriori informazioni, vedere Visualizzazione dei dettagli di una condivisione di file nella console.

È possibile visualizzare le informazioni sull'ultima operazione di replica quando si elencano i dettagli della condivisione di origine o di replica. Per ulteriori informazioni, vedi Visualizza i dettagli di una condivisione file dalla CLI.

Puoi richiamare in modo programmatico i dettagli dell'ultima sincronizzazione richiamando il metodo /shares in API VPC. Cerca la sezione latest_sync nella risposta API per vedere quando è stata avviata la replica (started_at), quando è terminata (completed_at) e quanti dati sono stati trasferiti (data_transferred). Per ulteriori informazioni, vedi Visualizza una singola condivisione file con l'API.

Inoltre, è possibile visualizzare le informazioni storiche della sincronizzazione di replica recente quando si utilizza IBM Cloud Logs. Quando si verifica la replica, il file service genera un messaggio di log regional-file.00002I, che include informazioni su quando si è verificata la replica e quanti dati sono stati trasferiti. Per ulteriori informazioni, vedi Registrazione per VPC.

Verifica della replica con l'API

È possibile utilizzare l'API per verificare che la replica sia riuscita, in sospeso o non riuscita. È possibile effettuare la richiesta GET /shares/{share_id} per vedere lo stato con l'ID condivisione delle condivisioni di origine o di replica.

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

Nella risposta, esaminare la proprietà latest_job. L'esempio mostra il failover della replica riuscito:

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

Per una suddivisione di replica, quando la condivisione di replica viene suddivisa dalla condivisione di origine, puoi visualizzare uno stato running per latest_job nella risposta.

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

Un'operazione di replica failover o split non può verificarsi se un'altra operazione viene eseguita sulla condivisione file, ad esempio l'espansione della dimensione. Puoi vedere un errore 409 nella risposta che indica il problema. Vedi il seguente esempio.

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

Rimozione della relazione di replica

È possibile terminare la replica rimuovendo la relazione di duplicazione tra la condivisione file di origine e la condivisione file di replica. L'operazione è denominata suddivisione delle condivisioni file. La rimozione della relazione di replica crea due condivisioni file indipendenti di lettura/scrittura. I dati non sono più sincronizzati tra loro. Puoi gestire separatamente ogni condivisione file, espandere la capacità e regolare gli IOPS e creare più repliche.

È inoltre possibile specificare che le condivisioni di file di origine e di replica siano suddivise se se un'operazione di failover non riesce.

La rimozione della relazione di duplicazione non può verificarsi quando viene eseguita un'altra operazione sulla condivisione file di origine o di replica (ad esempio, la dimensione della condivisione file viene espansa). L'operazione di divisione rimane in stato di attesa fino al completamento dell'altra operazione.

Quando si rimuove la relazione di replica, non è possibile annullare l'azione. Inoltre, i dati presenti sulla replica non vengono sincronizzati automaticamente con il file di origine prima della rimozione della relazione di replica.

Rimozione della relazione di replica nella console

Per rimuovere la relazione di replica nella console:

  1. Andare alla lista di tutte le condivisioni file. Dalla console IBM Cloud, fare clic sull'icona del menu di navigazione > icona VPC infrastruttura > Archiviazione > Condivisioni di archiviazione file.

  2. Fare clic sul nome di una condivisione file o di una condivisione file di replica per passare alla relativa pagina dei dettagli.

  3. Nella sezione Relazione di replica condivisione file, fare clic su Rimuovi relazione di replica. La rimozione della relazione di replica crea due condivisioni file indipendenti.

  4. Nella nuova finestra, fare clic su Scollega. I dati sulla replica non vengono sincronizzati automaticamente con la condivisione file di origine prima che la relazione di replica venga rimossa.

La pagina dei dettagli di condivisione file non indica alcuna relazione di replica.

Rimozione della relazione di replica dalla CLI

Prima di poter utilizzare la CLI, è necessario installare la CLI di “ IBM Cloud ” e il plug-in CLI per VPC. Per ulteriori informazioni, vedi i Prerequisiti della CLI.

  1. Individua la tua condivisione dalla CLI elencando le tue condivisioni file nella regione con il comando 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. Visualizzare i dettagli della condivisione file che si desidera modificare con il comando 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. Eseguire il comando ibmcloud is share-replica-split e specificare la condivisione del file di replica in base al relativo nome 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. Il risultato di questa operazione è due condivisioni file di lettura/scrittura indipendenti. Quando si elencano le condivisioni file nella regione, è possibile visualizzare none nella colonna di replica per le due condivisioni file.

    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

Per ulteriori informazioni relative alle opzioni del comando, consultare ibmcloud is share-replica-split.

Rimozione della relazione di replica con l'API

Effettuare una richiesta DELETE /shares/{replica_id}/source per rimuovere la relazione di replica. La suddivisione di una condivisione file rimuove la relazione di replica e crea due condivisioni file indipendenti. Dopo aver rimosso la relazione, non è possibile ristabilire la relazione. Una condivisione file non può essere suddivisa, se il lifecycle_state della condivisione file è updating o se sono in corso operazioni di replica.

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

Una risposta positiva indica che la richiesta di annullare l'associazione di una condivisione file di replica dalla relativa condivisione file di origine è stata accettata.

Rimozione della relazione di replica con Terraform

Utilizzare la risorsa ibm_is_share_replica_operations per suddividere le condivisioni di origine e di replica. La suddivisione di una condivisione file rimuove la relazione di replica e crea due condivisioni file indipendenti. Dopo aver rimosso la relazione, non è possibile ristabilire la relazione.

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

Per ulteriori informazioni sugli argomenti e gli attributi, vedi ibm_is_share_replica_operations.

Eliminazione delle condivisioni di file di replica e di origine

È possibile che si voglia eliminare la condivisione di file di replica per vari motivi. Una delle possibili ragioni è lo sblocco dell'eliminazione della condivisione di file di origine. Poiché la condivisione di file di replica è in replica attiva dalla condivisione di origine, la condivisione di file di replica deve essere separata dall'origine prima che la condivisione di file di origine possa essere eliminata. È possibile suddividere le quote in due modi:

  • Eseguire una suddivisione manuale, che rimuove la relazione di replica e crea due condivisioni file indipendenti di lettura/scrittura. Quindi, è possibile utilizzare o eliminare la condivisione di file di replica come si farebbe con una normale condivisione di file.

  • Eliminare la condivisione di file di replica direttamente dopo aver eliminato i suoi target di montaggio. Un processo split viene avviato automaticamente in background. Al termine dell'operazione di divisione, la condivisione di file di replica viene eliminata e anche la condivisione di origine può essere eliminata.

È possibile eliminare le condivisioni di file (sorgente o replica) nella console, dalla CLI, con l'API o con Terraform.