レプリカ・ファイル共有の管理
レプリカファイル共有を管理するには、レプリケーションの関連付けを解除して、個別に更新や削除が可能な独立した読み取り専用/書き込み可能な共有を作成します。
ファイル共有レプリカおよび複製関係を作成および管理するには、管理者または編集者の 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_job の running 状況を確認できます。
"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を調整したり、レプリカを追加したりすることができます。
また、 フェイルオーバー 操作が失敗した場合に、ソースおよびレプリカのファイル共有を分割するように指定することもできます。
ソースまたはレプリカのファイル共有に対して別の操作(たとえば、ファイル共有の容量拡張など)が実行されている間は、レプリケーション関係の削除を行うことはできません。 スプリット操作は、もう一方の操作が完了するまでペンディング状態のままである。
複製関係を削除すると、アクションを元に戻すことはできません。 また、レプリカ上のデータは、レプリケーション関係が削除される前に、ソースファイルと自動的に同期されることはありません。
コンソールでレプリケーション関係を削除する
コンソールでレプリケーション関係を削除するには:
-
すべてのファイル共有のリストにアクセスします。 IBM Cloud コンソールから、 ナビゲーション メニュー
> インフラストラクチャ
> ストレージ > ファイル ストレージ共有をクリックします。
-
ファイル共有またはレプリカ・ファイル共有の名前をクリックして、その詳細ページに移動します。
-
ファイル共有複製関係 セクションで、複製関係の削除をクリックします。 複製関係を削除すると、2 つの独立したファイル共有が作成されます。
-
新しいウィンドウで、「 リンクを解除 」をクリックします。 レプリカ上のデータは、レプリケーション関係が削除されるまでは、ソースのファイル共有と自動的に同期されません。
ファイル共有の詳細ページには、レプリケーション関係がないことが示されています。
CLI からの複製関係の削除
CLI を使用する前に、IBM Cloud CLI および VPC CLI プラグインをインストールする必要があります。 詳しくは、CLI の前提条件を参照してください。
-
ibmcloud is sharesコマンドを使用してリージョン内のファイル共有をリストすることにより、CLI から共有を見つけます。ibmcloud is sharesListing 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 -
ibmcloud is shareコマンドを使用して、変更するファイル共有の詳細を表示します。ibmcloud is share my-file-shareGetting 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 -
ibmcloud is share-replica-splitコマンドを実行し、名前または ID でレプリカ・ファイル共有を指定します。ibmcloud is share-replica-split r006-6d1719da-f790-45cc-9f68-896fd5673a1aThis 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. -
この操作の結果、2つの独立した読み取り/書き込み可能なファイル共有が作成されます。 領域内のファイル共有をリストすると、2 つのファイル共有の複製列に
noneが表示されます。ibmcloud is sharesListing 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_state が updating の場合、またはレプリカ操作が進行中の場合、ファイル共有を分割することはできません。
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プロセスはバックグラウンドで自動的に開始されます。 分割操作の終了後、レプリカファイル共有は削除され、ソース共有も削除できます。
ファイル共有(ソースまたはレプリカ)の削除は、 コンソール、 CLI、 API、 Terraformから 行うことができます。