レプリカ・ファイル共有の管理

レプリカファイル共有を管理するには、レプリケーションの関連付けを解除して、個別に更新や削除が可能な独立した読み取り専用/書き込み可能な共有を作成します。

ファイル共有レプリカおよび複製関係を作成および管理するには、管理者または編集者の IAM ユーザー役割が必要です。 これらの役割とアクションのリストについては、ファイル共有を作成および管理するための IAM 役割を参照してください。

複製同期情報

複製は非同期操作であり、瞬間的ではありません。 各同期操作の後、システムは、最後の複製プロセスに関する有用な情報 (開始日と終了日、転送されたデータ・ボリュームなど) を提供します。 複製情報を表示することにより、最後の複製にかかった時間を確認し、転送速度を計算することができます。 転送されたデータの値を確認することで、請求期間の終了時にグローバルな転送料金を見積もることができます。

複製同期情報を使用して、複製スケジュールを微調整することができます。 これは、 リカバリー・ポイント目標災害復旧計画において、データが復旧するまでの時間は、復旧時点から災害発生時点までを秒、分、時間で測定した時間である。 を満たすためにレプリカ上でデータをリフレッシュする必要があるコストと頻度のバランスを取るのに役立ちます。 また、複製プロセスが低下の危険性があるかどうかを判別するのにも役立ちます。

転送されるデータの量が、通常の転送速度で複製ウィンドウ中に転送できるデータの量を超えると、複製プロセスは完了できず、複製状況は degraded になります。 この状態が発生した場合は、ファイル共有の変更率と複製頻度を調整してみてください。

システムは15分ごとに最後の同期ステータスを照会する。 結果には、最後に完了した複製のデータが表示されます。 照会の実行時に複製が進行中の場合、応答には表示されません。 複製が完了すると、次の照会によって最後の同期情報が更新されます。 レプリケーションが完了してから、最後の同期情報がインターフェイスで更新されるまでの間に、短い遅延が発生することが予想されます。

ソースまたはレプリカ共有のいずれかの詳細を表示すると、最後の複製操作に関する情報が表示されます。 詳細については、 コンソールでファイル共有の詳細を表示するを 参照してください。

ソースまたはレプリカ共有のいずれかの詳細をリストすると、最後の複製操作に関する情報が表示されます。 詳しくは、 CLI からのファイル共有の詳細の表示 を参照してください。

VPC API/shares メソッドを呼び出すことにより、最終同期の詳細をプログラマチックに取得できます。 API 応答の latest_sync セクションを探して、複製がいつ開始されたか (started_at)、いつ終了したか (completed_at)、および転送されたデータの量 (data_transferred) を確認します。 詳しくは、 API を使用した単一ファイル共有の表示 を参照してください。

また、 IBM Cloud Logs を使用すると、最近のレプリケーション同期の履歴情報を表示できます。 複製が行われると、ファイル・サービスは regional-file.00002I ログ・メッセージを生成します。このメッセージには、複製がいつ行われたか、および転送されたデータの量に関する情報が含まれます。 詳しくは、 VPC のロギング を参照してください。

API を使用したレプリケーションの確認

API を使用すると、レプリケーションが成功したか、保留中か、あるいは失敗したかを確認できます。 GET /shares/{share_id} 要求を行うと、ソース共有またはレプリカ共有の共有 ID を使用して状況を確認できます。

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

応答で、 latest_job プロパティーを調べます。 以下の例は、複製フェイルオーバーが成功したことを示しています。

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

複製分割の場合、複製共有がソース共有から分割されているときに、応答で latest_jobrunning 状況を確認できます。

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

ファイル共有に対して他の操作 (拡張サイズなど) が実行されている場合、複製 failover または split 操作は実行できません。 問題を示す 409 エラーが応答に表示されます。 以下の例を参照してください。

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

複製関係の削除

ソースのファイル共有とレプリカのファイル共有間のレプリケーション関係を削除することで、レプリケーションを終了させることができます。 この操作は、ファイル共有 分割 と呼ばれます。 複製関係を削除すると、2 つの独立した読み取り/書き込みファイル共有が作成されます。 データは、それらの間で同期されなくなります。 各ファイル共有を個別に管理したり、容量を拡張したり、IOPSを調整したり、レプリカを追加したりすることができます。

また、 フェイルオーバー 操作が失敗した場合に、ソースおよびレプリカのファイル共有を分割するように指定することもできます。

ソースまたはレプリカのファイル共有に対して別の操作(たとえば、ファイル共有の容量拡張など)が実行されている間は、レプリケーション関係の削除を行うことはできません。 スプリット操作は、もう一方の操作が完了するまでペンディング状態のままである。

複製関係を削除すると、アクションを元に戻すことはできません。 また、レプリカ上のデータは、レプリケーション関係が削除される前に、ソースファイルと自動的に同期されることはありません。

コンソールでレプリケーション関係を削除する

コンソールでレプリケーション関係を削除するには:

  1. すべてのファイル共有のリストにアクセスします。 IBM Cloud コンソールから、 ナビゲーション メニューアイコン> インフラストラクチャVPC アイコン> ストレージ > ファイル ストレージ共有をクリックします。

  2. ファイル共有またはレプリカ・ファイル共有の名前をクリックして、その詳細ページに移動します。

  3. ファイル共有複製関係 セクションで、複製関係の削除をクリックします。 複製関係を削除すると、2 つの独立したファイル共有が作成されます。

  4. 新しいウィンドウで、「 リンクを解除 」をクリックします。 レプリカ上のデータは、レプリケーション関係が削除されるまでは、ソースのファイル共有と自動的に同期されません。

ファイル共有の詳細ページには、レプリケーション関係がないことが示されています。

CLI からの複製関係の削除

CLI を使用する前に、IBM Cloud CLI および VPC CLI プラグインをインストールする必要があります。 詳しくは、CLI の前提条件を参照してください。

  1. ibmcloud is shares コマンドを使用してリージョン内のファイル共有をリストすることにより、CLI から共有を見つけます。

    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. 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. ibmcloud is share-replica-split コマンドを実行し、名前または 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. この操作の結果、2つの独立した読み取り/書き込み可能なファイル共有が作成されます。 領域内のファイル共有をリストすると、2 つのファイル共有の複製列に none が表示されます。

    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
    

コマンド・オプションについて詳しくは、「 ibmcloud is share-replica-split」を参照してください。

API を使用した複製関係の削除

DELETE /shares/{replica_id}/source 要求を行って、複製関係を削除します。 ファイル共有を分割すると、複製関係が削除され、2 つの独立したファイル共有が作成されます。 関係を削除した後は、関係を再確立できません。 ファイル共有の lifecycle_stateupdating の場合、またはレプリカ操作が進行中の場合、ファイル共有を分割することはできません。

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

正常な応答は、ソース・ファイル共有からレプリカ・ファイル共有の関連付けを解除する要求が受け入れられたことを示します。

Terraform との複製関係の削除

ibm_is_share_replica_operations リソースを使用して、ソース共有とレプリカ共有を分割します。 ファイル共有を分割すると、複製関係が削除され、2 つの独立したファイル共有が作成されます。 関係を削除した後は、関係を再確立できません。

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

引数および属性について詳しくは、 ibm_is_share_replica_operationsを参照してください。

レプリカとソースファイル共有の削除

様々な理由でレプリカファイル共有を削除したい場合があります。 考えられる理由の1つは、ソースファイル共有の削除のブロックを解除することである。 レプリカファイル共有はソース共有からアクティブなレプリケーションが行われているため、ソースファイル共有を削除するには、まずレプリカファイル共有をソースから切り離す必要があります。 株式の分割には、次の2つの方法があります:

  • 手動分割を実行します。これにより、レプリケーション関係が解除され、2つの独立した読み取り/書き込み可能なファイル共有が作成されます。 その後、通常のファイル共有と同様に、レプリカファイル共有を使用または削除することができます。

  • マウントターゲットを削除した後、レプリカファイル共有を直接削除する。 split プロセスはバックグラウンドで自動的に開始されます。 分割操作の終了後、レプリカファイル共有は削除され、ソース共有も削除できます。

ファイル共有(ソースまたはレプリカ)の削除は、 コンソールCLIAPITerraformから 行うことができます。