レプリカ・ファイル共有の作成

コンソール、CLI、API、またはTerraformを使用して、同じメトロリージョン内の別のゾーン、または同じ地理的エリア内の別のメトロリージョンに、レプリカファイル共有を作成します。

以下の表は、各ジオグラフィー内で相互に複製できるメトロ・リージョンを示しています。

この表は、各地理的地域で相互に複製可能な大都市圏を示しています。すべての地域は別個の列です。
アメリカ大陸	ヨーロッパ	アジア
ダラス（テキサス州） / `us-south` モントリオール / `ca-mon` サンパウロ / `br-sao` トロント / `ca-tor` ワシントンDC / `us-east`	-フランクフルト/ `eu-de` -ロンドン/ `eu-gb` -マドリッド/ `eu-es`	チェンナイ / `in-che` ムンバイ / `in-mum` 大阪 / `jp-osa` シドニー / `au-syd` 東京 / `jp-tok`

指定するソース・ファイル共有には、既に別のレプリカがあってはなりません。また、別の共有のレプリカであってはなりません。

別のリージョンにレプリカを作成する場合は、まずサービス間の許可を設定する必要があります。両方のファイル・サービス・インスタンスが同じアカウントに属している必要があります。アカウント間の複製はサポートされていません。詳細については、 File Storage for VPC のサービス間認可の確立を参照。

リージョン可用性を備えたファイル共有を作成すると、データはリージョン全体に自動的にレプリケートされるため、リージョン内でレプリケーションペアを設定する必要はありません。

コンソールでファイル共有にレプリケーションを追加する

すべてのファイル共有のリストまたはファイル共有の詳細ページから、ファイル共有のレプリカを作成できます。ソース・ファイル共有がまだない場合は、「コンソールでファイル共有とマウント・ターゲットを作成する」の説明に従ってプロビジョニングする。 VPCのファイルストレージ共有ページでファイル共有が「stable」と表示されたら、 「Actions」 アイコン Create replica 」をクリックします。

ファイル共有レプリカ作成ページで、ソース・ファイル共有の詳細を確認し、レプリカの詳細を入力します。

名前 - レプリカ共有に一意の名前を指定してください。
レプリカ・ロケーション-ジオグラフィーは事前選択されており、変更できません。「 ゾーン 」メニューを使用して、レプリカのゾーンを選択してください。メニューは地域ごとに分類されています。各地域ごとに、大都市圏がアルファベット順に一覧表示されています。地下鉄駅名の横にある矢印をクリックしてゾーンを展開し、ゾーンをクリックして選択してください。
リソース・グループ-リストからリソース・グループを選択します。
タグ-オプションで、ユーザー・タグを指定します。レプリカに適用するタグは、ソース共有のタグと同じであっても異なっていてもかまいません。
プロファイル-ソース・ファイル共有が前のリリースのプロファイルに基づいている場合でも、 dp2 プロファイルは事前選択されています。 IOPS の最大値を指定します。これにより、フェイルオーバーを実行した後にレプリカで取得するパフォーマンスが決まります。

マウント先 - 必要に応じて、レプリカ共有のマウント先を作成します。ここでマウント・ターゲットを作成しない場合は、このステップをスキップできます。それ以外の場合は、「作成」をクリックしてください。マウント・ターゲットは、ファイル共有ごとに VPC 1 つにつき 1 つ作成できます。共有のマウント・ターゲット・アクセス・モードに応じて、 「マウント・ターゲットの作成 (Create mount target)」 フォームの外観は異なります。

アクセスモードとしてセキュリティグループを選択した場合は、表2に記載されている情報を入力してください。このアクションにより、予約済み IP アドレスとのファイル共有を識別し、選択したセキュリティー・グループのルールを適用する仮想ネットワーク・インターフェースが作成され、マウント・ターゲットに接続されます。このマウント・ターゲットは、転送中の暗号化およびゾーン間マウントをサポートします。

マウント・ターゲットを作成するための値。
フィールド	値
詳細
マウント・ターゲット名	マウント先の名前を指定してください。名前は、小文字の英数字を最大63文字まで使用でき、ハイフン（-）を含めることができます。また、小文字のアルファベットで始まる必要があります。名前は必要に応じて後で編集できます。
ゾーン	ゾーンはファイル共有から継承されます (例: ダラス 2)。
VPC	使用可能な VPC を選択します。このリストには、選択したゾーンにサブネットを持つVPCのみが含まれます。
サブネット	リストからサブネットを選択します。
予約済み IP アドレス	マウント・ターゲットに必要です。後で IP アドレスを変更することはできません。ただし、マウント・ターゲットを削除して、異なる IP アドレスを持つ別のマウント・ターゲットを作成することができます。
予約方法	ファイル・サービスに IP アドレスを選択させることができます。予約済み IP は、マウント・ターゲットの作成後に可視になります。または、独自の IP を指定します。
自動解放	マウント・ターゲットを削除するときに IP アドレスを解放します。デフォルトでは有効です。
セキュリティー・グループ	VPC のデフォルト・セキュリティー・グループが選択されます。これを使用することも、リストから別のセキュリティー・グループを選択することもできます。

Deprecated アクセスモードとしてVPCを選択した場合は、マウントターゲットの名前を指定し、リストからVPCを選択します。このマウント・ターゲットを使用して、ファイル共有と同じゾーン内の選択された VPC の任意の仮想サーバー・インスタンスにファイル共有をマウントできます。ゾーン共通マウントはサポートされていません。

VPC アクセスモードは非推奨となっており、2027年5月6日にサポートが終了します。移行ガイドに従って、ソース共有のアクセス制御モードを security-group に更新する。

同期頻度-1 次ファイル共有からレプリカ共有に変更を同期する頻度を指定します。「頻度」では、以下のオプションのいずれかを選択し、開始時刻を設定してください：
- 15分ごと ：開始時刻の分を入力してください。
- 「 1時間ごと 」：開始時刻の分を入力してください。
- 毎日：開始時刻を協定世界時（UTC）で、HH:MMの形式で、00:00から23:59までの範囲で入力してください。
- 「毎週」：レプリケーションを実行する曜日を選択し、開始時刻をUTCでHH:MM形式（00:00～23:59の間）で入力してください。
- 毎月：レプリケーションを実行する日付（1～31）を入力し、開始時刻をUTCでHH:MM形式（00:00～23:59の間）で入力してください。
- Cron式 ： cron-spec 式を「 minute hour day month weekday 」という形式で入力してください。レプリケーションは、15分以上の間隔を空けてスケジュールする必要があります。たとえば、毎日UTC午後5時30分にレプリケーションを行うには、「 30 17 * * * 」と入力します。
暗号化 - レプリカは常に、ソース共有の暗号化設定を継承します。暗号化の種類を変更することはできません。ソース共有でプロバイダー管理の暗号化が使用されている場合、プロバイダー管理のタイルは表示されますが、選択することはできません。ソース共有でお客様暗号化お客様使用されている場合、暗号化の種類、キー名、キー管理サービスのインスタンス、キー ID などのキーの詳細情報は、読み取り専用として表示されます。
サイド・パネルで、見積もりコストを確認し、割引コード (ある場合) を適用します。
[ ファイル共有の作成 ] をクリックします。

まだ注文する準備ができていない場合、または価格設定情報を探しているだけの場合は、サイド・パネルに表示される情報を見積もりに追加できます。この機能がどのように機能するかについての詳細は、費用の見積もりをご覧ください。

CLI からファイル共有にレプリケーションを追加する

CLIを使用して、別のゾーンまたはリージョンにレプリカ共有を持つファイル共有を作成したり、既存のファイル共有にレプリカ共有を作成したりすることができます。

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

同じリージョン内にレプリカを持つゾーン型ファイル共有を同時に作成することができます。このアプローチは、レプリカが同一リージョン内に留まるゾーンシェアに対してのみサポートされています。地域をまたぐレプリカは、レプリカの初期化時にソース共有が安定した状態にある必要があるため、別の手順で作成する必要があります。

ibmcloud is share-create コマンドを使用して共有を作成する際、オプション'--replica-share-name、'--replica-share-profile、'--replica-share-cron-spec、--replica-share-zone に値を指定することで、同時にレプリカ共有を作成することができます。cron-specはレプリケーションの頻度を指定し、15分の頻度でデータをレプリケートするようにスケジュールすることができます。コマンド・オプションの詳細については、'ibmcloud is share-create を参照のこと。

以下の例では、 us-south-2 に共有 my-source-file-share が作成され、 us-south-1 にレプリカ・ファイル共有 my-replica-file-share が作成されます。この例では、ソース・ファイル共有にマウント・ターゲットが1つだけ作成されます。同じJSON構文に --replica-share-mount-targets オプションを付けて、レプリカ共有のマウントターゲットを作成することもできます。

ibmcloud is share-create --name my-source-file-share --zone us-south-2 --profile dp2 --size 1500 --iops 2000  --user-tags env:dev --mount-targets '[{"name":"my-source-mount-target","virtual_network_interface": {"name":"my-source-vni","subnet": {"id":"0717-c66032c9-048d-4c35-aa83-c932e24afdbb"}}}]' --replica-share-name my-replica-file-share --replica-share-profile dp2 --replica-share-cron-spec '55 09 * * *' --replica-share-zone us-south-1

Creating file share my-source-file-share under account Test Account as user test.user@ibm.com...
ID                                 r006-0a3444bc-df55-4c2e-aef4-f37a9a8d8262
Name                               my-source-file-share
CRN                                crn:v1:bluemix:public:is:us-south-2:a/a1234567::share:r006-0a3444bc-df55-4c2e-aef4-f37a9a8d8262
Lifecycle state                    pending
Access control mode                security_group
Accessor binding role              none
Allowed transit encryption modes   user_managed,none
Zone                               us-south-2
Profile                            dp2
Size(GB)                           1500
IOPS                               2000
User Tags                          env:dev
Encryption                         provider_managed
Mount Targets                      ID                                          Name
                                   r006-67799c85-09cf-4cfe-811d-effa10c99395   my-source-mount-target
Resource group                     ID                                 Name
                                   6edefe513d934fdd872e78ee6a8e73ef   defaults
Created                            2025-08-01T17:25:05+00:00
Replication share                  ID                                          Name                    Resource type
                                   r006-2068a709-8c18-4844-8c1d-42b83889dfb3   my-replica-file-share   share
Replication role                   source
Replication status                 none
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 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-a8d6af48-0c97-4c6b-bab1-fbefdc1e1e03   my-file-share           stable            us-south-2   dp2       10         defaults         none               none                    0                0
r006-aaf4bfe9-358c-4faa-a4ec-0b955090b940   my-file-share-2         stable            us-south-2   dp2       10         defaults         none               none                    0                0
r006-a60bfa90-a893-40ad-be34-28ab51a963f9   replica-dal-2           stable            us-south-2   dp2       10         defaults         replica            none                    0                0
r006-3f21e3c3-e12d-425f-ab77-810cabfde8df   source-dal-1            stable            us-south-1   dp2       10         defaults         source             none                    0                0
r006-455b601c-8fc1-4476-8771-4708c49c8ef7   my-replica-share-dal-1  stable            us-south-1   dp2       10         defaults         replica            none                    0                0
r006-4dadac27-cd17-42df-a5fe-1388705d33e0   my-source-share-dal-2   stable            us-south-2   dp2       10         defaults         source             none                    0                0

ibmcloud is share コマンドを使用して、ソースとして使用するファイル共有の詳細を表示します。同じリージョンにレプリカを作成するときに、共有の名前または ID を使用できます。別のリージョンにレプリカを作成する場合は、ソース・ファイル共有の CRN をメモします。

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)                     1000
IOPS                         1000
User Tags                    docs:test
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
Replication role             none
Replication status           none
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-create コマンドを実行してレプリカ・シェアを作成する。対象地域が正しくない場合は、 ibmcloud target -r REGION コマンドを使用して対象地域を切り替える。 --source-share-id オプションを使用して、ソース共有を ID または CRN で指定します。レプリカファイル共有が作成されるゾーンと、レプリカ共有のプロファイルを定義する値を指定します。 --replication-cron-spec オプションを使用して、cron式でレプリケーション・スケジュールを指定する。ソース・ファイル共有に user_managed 暗号化がある場合は、 --encryption-key-crn. --encryption-key-crn プロパティを指定してはならない。

ibmcloud is share-replica-create --name my-replica-share --zone us-south-3 --profile dp2 --replication-cron-spec '10 05 * * *' --source-share my-file-share

Creating replica file share my-replica-share under account Test Account as user test.user@ibm.com...
ID                               r006-6d1719da-f790-45cc-9f68-896fd5673a1a
Name                             my-replica-share
CRN                              crn:v1:bluemix:public:is:us-south-3:a/a1234567::share:r006-6d1719da-f790-45cc-9f68-896fd5673a1a
Lifecycle state                  pending
Access control mode              security_group
Accessor binding role            origin
Allowed transit encryption modes ipsec,none
Zone                             us-south-3
Profile                          dp2
Size(GB)                         1000
IOPS                             100
User Tags                        docs:test
Encryption                       provider_managed
Mount Targets                    ID                          Name
                                 No mounted targets found.
Resource group                   ID                                 Name
                                 db8e8d865a83e0aae03f25a492c5b39e   Default
Created                          2024-06-25T15:13:18+00:00
Latest job                       Job status   Job status reasons
                                 running      -
Replication cron spec            10 05 * * *
Replication role                 replica
Replication status               initializing
Replication status reasons       Status code   Status message
                                 -             -
Source share                     ID                                          Name            Resource type
                                 r006-b696742a-92ee-4f6a-bfd7-921d6ddf8fa6   my-file-share   share
Snapshot count                   0
Snapshot size                    0
Source snapshot                  -
Allowed Access Protocols         nfs4
Availability Mode                zonal
Bandwidth(Mbps)                  1
Storage Generation               1

API を使用してファイル共有にレプリケーションを追加する

以下のサンプル要求に示すように、 VPC API で /shares メソッドを呼び出すことによって、複製をプログラマチックにセットアップすることができます。

始める前に、まず API 環境をセットアップします。 VPC のファイル共有 API について詳しくは、『VPC の API リファレンス』を参照してください。

ファイル共有を作成する際、別のゾーンにもレプリカのファイル共有を作成するように指定することができます。 POST /shares 要求を行い、replica_share プロパティーを指定してレプリカ・ファイル共有を定義します。

以下の例では、ソース共有 source-share-001 のレプリカ test-replica-001 を作成します。ファイル共有の作成時にオプションとなるマウント先を、レプリカファイル共有とソースファイル共有に対して指定します。

curl -X POST\
"$vpc_api_endpoint/v1/shares?version=2023-08-08&generation=2"\
-H "Authorization: Bearer $iam_token"\
-d '{
    "name": "source-share-001",
    "profile":{"name":"dp2"},
    "size":100,
    "iops": 400,
    "mount-targets":[{"vpc":{"id":"08669c86-4c8a-4bfa-8ddc-37071f955c52"}],
    "zone":{"name":"us-south-1"},
    "replica_share":{
  	   "name": "test-replica-001",
      "profile":{"name":"dp2"},
      "replication_cron_spec":"0 */5 * * *",
      "zone":{"name":"us-south-3"},
      "mount_targets": [
        {"virtual_network_interface": {"subnet": {"id": "2302-ea5fe79f-52c3-4f05-86ae-9540a10489f5"}}},
        {"vpc": {"id": "7ec86020-1c6e-4889-b3f0-a15f2e50f87e"}}],
      "resource_group": {},
      "allowed_transit_encryption_modes": "ipsec",
      "user_tags": ["string"]}}]
      }
    "resource_group": {},
    "allowed_transit_encryption_modes": "ipsec",
    "user_tags": ["string"]
   }'

Terraform でのファイル共有への複製の追加

Terraform で ibm_is_share リソースを使用して、複製とのファイル共有を作成したり、複製を組み込むようにファイル共有を更新したりすることができます。

次の例では、 us-south-3 ゾーンにレプリカ共有を作成し、ID「 ibm_is_share.example.id 」で指定された親共有に関連付けます。

resource "ibm_is_share" "my-replica1" {
  zone                  = "us-south-3"
  source_share          = ibm_is_share.example.id
  name                  = "my-replica1"
  profile               = "dp2"
  replication_cron_spec = "0 */5 * * *"
}

以下の例では、 us-south-3 内のレプリカとのファイル共有を us-south-1 に作成します。

resource "ibm_is_share" "my-replica" {
  zone    = "us-south-1"
  size    = 220
  name    = "my-share"
  profile = "dp2"
  replica_share {
    name                  = "my-replica"
    replication_cron_spec = "0 */5 * * *"
    profile               = "dp2"
    zone                  = "us-south-3"
  }
}

レプリカ・ファイル共有の作成

レプリカ・ファイル共有の作成

コンソールでファイル共有にレプリケーションを追加する

CLI からファイル共有にレプリケーションを追加する

CLI からのレプリカとのファイル共有の作成

CLI から既存のファイル共有のレプリカを作成する

API を使用してファイル共有にレプリケーションを追加する

API を使用したレプリカとのファイル共有の作成

API を使用した既存のファイル共有のレプリカの作成

Terraform でのファイル共有への複製の追加

次のステップ