このガイドでは、Filestore インスタンス レプリケーションを使用する方法について説明します。
始める前に
Filestore の使用に必要な設定手順を完了します。インスタンスの割り当ては、プロジェクト、リージョンと階層によって異なります。これらのタスクを完了するのに十分な容量があることを確認してください。詳細については、割り当てまたは割り当ての増加をリクエストするをご覧ください。
Filestore インスタンスをまだ作成していない場合は作成します。このガイドでは、これがソース インスタンスです。
インスタンス レプリカを作成する
Google Cloud コンソール
Google Cloud コンソールで、Filestore の [インスタンス] ページに移動します。
複製するインスタンスのインスタンス ID をクリックします。
[レプリケーション] タブをクリックします。
[レプリカを作成する] をクリックします。
ドキュメントのリンクをクリックして、サポートされている目標復旧時点（RPO）を確認し、[次へ] をクリックします。
必要に応じて、すべての必須フィールドとオプション フィールドに入力します。
- 指定する容量は、ソースの容量以上である必要があります。
- 次の仕様は、ソース インスタンスと一致している必要があります。
- サービス階層（容量の範囲を含む）
- Filestore プロトコル
- データ損失のリスクを軽減するため、ソースに固有のリージョンとゾーンを選択することをおすすめします。
[次へ] をクリックします。
詳細を確認して [次へ] をクリックします。
[作成] をクリックします。
オペレーションが完了するのを待ちます。完了すると、レプリカが [インスタンス] ページのソース インスタンスの下に表示されます。
レプリカのインスタンス ID をクリックして、詳細を表示します。
gcloud
filestore instances createコマンドを実行して、レプリカ インスタンスを作成します。gcloud filestore instances create INSTANCE_ID \ --source-instance=projects/PROJECT_ID/locations/LOCATION/instances/SOURCE_INSTANCE \ --project=PROJECT_ID \ --location=LOCATION \ --network=name="NETWORK" \ --tier=TIER \ --file-share=name="FILE_SHARE_NAME",capacity=FILE_SHARE_SIZE \
ここで
- INSTANCE_ID は、作成するインスタンスの名前（
my-replicaなど）に置き換えます。 - SOURCE_INSTANCE は、レプリカを作成するソース インスタンスの名前とロケーションに置き換えます。例:
projects/my-genomics-project/locations/us-east1-b/instances/my-genomics-instance - PROJECT_ID: ソース インスタンスが配置されている Google Cloud プロジェクトのプロジェクト ID。
- LOCATION は、レプリカ インスタンスを配置するロケーション（
us-central1-aなど）に置き換えます。ソースがゾーンサービス階層にある場合は、レプリカのリージョンとゾーンの両方を指定する必要があります。 - NETWORK は、使用するネットワークの名前（
defaultなど）に置き換えます。 - TIER は、必要なサービス階層（
ZONALなど）に置き換えます。階層と容量範囲は移行元と一致している必要があります。 - FILE_SHARE_NAME は、インスタンスから提供される NFS ファイル共有に指定する名前（
vol1など）。 - FILE_SHARE_SIZE は、ファイル共有に使用するサイズ（
1.25TiBなど）に置き換えます。
REST API
gcloud CLI のインストールと初期化を行います。これにより、
Authorizationヘッダーのアクセス トークンを生成できます。cURLを使用 して、Filestore API を呼び出します。curl -s \ --header "Authorization: Bearer $(gcloud auth print-access-token)" \ --header "Content-Type: application/json" \ -d '{"tier": "TIER", "networks": { "network": "NETWORK" }, "file_shares": {"name": "SHARE_NAME","capacity_gb": "CAPACITY"}, "replication": {"replicas":[{"peer_instance": "projects/PROJECT/locations/ACTIVE_LOCATION/instances/ACTIVE_NAME"}], "role":"standby"}, "description": "DESCRIPTION" }' \ "https://file.googleapis.com/v1beta1/projects/PROJECT/locations/REPLICA_LOCATION/instances?instanceId=REPLICA_INSTANCE_NAME"ここで
TIERは、レプリカに使用するサービス階層の名前に置き換えます。例:REGIONALNETWORKは、レプリカに使用するネットワークの名前です。例:defaultソースと同じネットワークを使用する必要があります。SHARE_NAMEはファイル共有の名前です。 （例:vol1）です。CAPACITYは、レプリカに割り当てるサイズ（GiB 単位）です。例:1024容量は、ソース インスタンスの容量以上である必要があります。PROJECTは、レプリカが存在するプロジェクトの名前です。例:my-genomics-projectソースとレプリカは同じプロジェクトに存在する必要があります。ACTIVE_LOCATIONは、ソースが存在するロケーションです。例:us-east1ACTIVE_NAMEは、複製するインスタンスの名前です。例:my-genomics-instanceDESCRIPTIONは、作成するレプリカ インスタンスの説明です。例:My genomics replicaREPLICA_LOCATIONは、レプリカを配置するロケーションです。例:us-central1REPLICA_INSTANCE_NAMEは、作成するレプリカ インスタンスの名前です。例:my-genomics-replica
レプリカのステータスを表示する
Google Cloud コンソール
Google Cloud コンソールで、Filestore の [インスタンス] ページに移動します。
表示するレプリカのインスタンス ID をクリックします。
[説明] セクションで、[レプリケーション] タブをクリックします。
ここでは、レプリカのステータスと最終同期ポイント（データの完全コピーがレプリカにコピーされた最終日時のタイムスタンプ）を確認できます。
gcloud
特定のインスタンスに関する情報を表示するには、
instances describeコマンドを実行します。gcloud filestore instances describe INSTANCE_ID \ --project=PROJECT_ID \ --location=LOCATION \
ここで
- INSTANCE_ID は、表示する Filestore インスタンスのインスタンス ID（
genomics-instanceなど）に置き換えます。 - PROJECT_ID は、Filestore インスタンスを含む Google Cloud プロジェクトのプロジェクト ID に置き換えます。
LOCATION は、インスタンスが存在するロケーション（
us-east1-bなど）に置き換えます。instances describeコマンドに対するレスポンスは、次のいずれかの例のようになります。このレスポンスの例は、インスタンス レプリケーションが有効になっているソース インスタンスを示しています。指定されているロールが
ACTIVEであることに注目してください。createTime: '2024-06-17T22:17:26.475900265Z' fileShares: - capacityGb: '1024' name: vol1 name: projects/genomics-project/locations/us-east1-b/instances/genomics-instance-source networks: - connectMode: DIRECT_PEERING ipAddresses: - 172.27.220.2 modes: - MODE_IPV4 network: default reservedIpRange: 172.27.220.0/26 replication: replicas: - peerInstance: projects/genomics-project/locations/us-central1-a/instances/genomics-instance-replica state: READY role: ACTIVE state: READY tier: ZONALこのレスポンスの例は、通常のインスタンスにプロモートされたレプリカ インスタンスを示しています。レプリケーションはまだ有効になっていないため、指定されていません。
createTime: '2024-06-20T17:11:56.048062134Z' fileShares: - capacityGb: '1024' name: vol1 name: projects/genomics-project/locations/us-west2-a/instances/genomics-instance-replica networks: - connectMode: DIRECT_PEERING ipAddresses: - 10.155.90.194 network: default reservedIpRange: 10.155.90.192/26 satisfiesPzi: true state: READY tier: ZONALこのレスポンスの例は、アクティブ インスタンスとペア設定されたレプリカを示しています。ロールが
STANDBYとして表示されていることに注目してください。createTime: '2024-06-21T04:15:21.721579074Z' fileShares: - capacityGb: '1280' name: vol1 name: projects/genomics-project/locations/us-west1-a/instances/genomics-replica networks: - connectMode: DIRECT_PEERING ipAddresses: - 10.153.44.194 network: default reservedIpRange: 10.153.44.192/26 replication: replicas: - peerInstance: projects/genomics-project/locations/us-west2-a/instances/genomics-instance state: READY role: STANDBY satisfiesPzi: true state: READY tier: ZONAL
REST API
gcloud CLI のインストールと初期化を行います。これにより、
Authorizationヘッダーのアクセス トークンを生成できます。cURLを使用 して、Filestore API を呼び出します。curl -s \ --header "Authorization: Bearer $(gcloud auth print-access-token)" \ --header "Content-Type: application/json" \ GET "https://file.googleapis.com/v1beta1/projects/PROJECT/locations/LOCATION/instances/INSTANCE_NAME"
ここで
PROJECTは、インスタンスが配置されているプロジェクトの名前です。例:my-genomics-projectLOCATIONは、インスタンスが存在するロケーションです。例:us-west1-aINSTANCE_NAMEは、表示するインスタンスの名前です。例:my-genomics-instance
プロジェクト内のすべてのレプリカを一覧表示する
Google Cloud コンソール
Google Cloud コンソールで、Filestore の [インスタンス] ページに移動します。
レプリカは、関連付けられたソース インスタンスの下に表示されます。
gcloud
instances listコマンドを実行して、プロジェクト内のすべてのインスタンスのリストを表示するには:gcloud filestore instances list --project=PROJECT-ID \ここで
- PROJECT-ID: 表示するプロジェクトのプロジェクト ID。
レスポンスは、次のようなインスタンスとレプリカのリストを返します。
INSTANCE_NAME LOCATION TIER CAPACITY_GB FILE_SHARE_NAME IP_ADDRESS STATE CREATE_TIME genomics-source-1 us-east1-b ZONAL 1024 vol1 172.27.220.2 READY 2024-06-17T22:17:26 genomics-source-1-replica us-west1-a ZONAL 1024 vol1 10.142.57.194 READY 2024-06-17T23:47:19
REST API
gcloud CLI のインストールと初期化を行います。これにより、
Authorizationヘッダーのアクセス トークンを生成できます。cURLを使用 して、Filestore API を呼び出します。curl -s \ --header "Authorization: Bearer $(gcloud auth print-access-token)" \ --header "Content-Type: application/json" \ GET "https://file.googleapis.com/v1/projects/PROJECT/locations/LOCATION/instances"
ここで
PROJECTは、インスタンスが配置されているプロジェクトの名前です。例:my-genomics-projectLOCATIONは、検索するロケーションです。プロジェクト内の任意のロケーションにあるすべてのインスタンスを検索するには、-を使用します。
レプリケーションの一時停止
Google Cloud コンソール
Google Cloud コンソールで、Filestore の [インスタンス] ページに移動します。
使用するレプリカのインスタンス ID をクリックします。
[説明] セクションで、[レプリケーション] タブをクリックします。
[アクティブ インスタンスの詳細] セクションで、[レプリケーションを一時停止] をクリックします。
続行する前にアラートを読み、[レプリケーションを一時停止] をクリックして確認します。
レプリケーションのステータスが [一時停止中] に変わります。オペレーションが完了すると、[Replication Status] が [Paused] に変わり、レプリカが一時停止された日付が表示されます。
gcloud
gcloud filestore instances pause-replica コマンドを実行して、レプリカ インスタンスを一時停止できます。
gcloud filestore instances pause-replica INSTANCE_ID \
--project=PROJECT_ID \
--location=LOCATION \
ここで
- INSTANCE_ID は、一時停止する Filestore インスタンスのインスタンス ID（
my-replicaなど）に置き換えます。 - PROJECT_ID は、Filestore インスタンスを含む Google Cloud プロジェクトのプロジェクト ID に置き換えます。
- LOCATION は、レプリカが存在するロケーション（
us-central1など）に置き換えます。
正常に完了すると、次のようなレスポンスが返されます。
createTime: '2025-12-22T14:03:33.727531128Z'
customPerformanceSupported: true
description: Replica of active, us-east1-b
fileShares:
- capacityGb: '1024'
name: share
name: projects/genomics-project/locations/us-west2-a/instances/my-replica
networks:
- connectMode: DIRECT_PEERING
ipAddresses:
- 10.229.150.130
modes:
- MODE_IPV4
network: default
reservedIpRange: 10.229.150.128/26
performanceLimits:
maxIops: '12000'
maxReadIops: '12000'
maxReadThroughputBps: '125829120'
maxWriteIops: '4000'
maxWriteThroughputBps: '104857600'
protocol: NFS_V3
replication:
replicas:
- peerInstance: projects/genomics-project/locations/us-east1-b/instances/my-source
state: PAUSED
stateUpdateTime: '2025-12-22T14:24:27.558413891Z'
role: STANDBY
state: READY
tier: REGIONAL
REST API
gcloud CLI のインストールと初期化を行います。これにより、
Authorizationヘッダーのアクセス トークンを生成できます。cURLを使用 して、Filestore API を呼び出します。curl -s \ --header "Authorization: Bearer $(gcloud auth print-access-token)" \ --header "Content-Type: application/json" \ -d '{}' "https://file.googleapis.com/v1beta1/projects/PROJECT/locations/LOCATION/instances/REPLICA_NAME:pauseReplica"ここで
PROJECTは、レプリカが配置されているプロジェクトの名前です。例:my-genomics-projectLOCATIONは、レプリカが存在するロケーションです。例:us-west1-aREPLICA_NAMEは、一時停止するインスタンスの名前です。例:my-genomics-replica
レプリケーションを再開
Google Cloud コンソール
Google Cloud コンソールで、Filestore の [インスタンス] ページに移動します。
使用するレプリカのインスタンス ID をクリックします。
[説明] セクションで、[レプリケーション] タブをクリックします。
[アクティブ インスタンスの詳細] セクションで、[レプリケーションを再開] をクリックします。
続行する前にアラートを読み、指定されたフィールドに「
resume」と入力して確認します。
レプリケーションのステータスが [再開中] に変わります。オペレーションが完了すると、[Replication Status] が [Ready] に変わります。
gcloud
gcloud filestore instances resume-replica コマンドを実行して、レプリカ インスタンスを再開します。
gcloud filestore instances resume-replica INSTANCE_ID \
--project=PROJECT_ID \
--location=LOCATION \
ここで
- INSTANCE_ID は、再開する Filestore レプリカ インスタンスのインスタンス ID（
my-replicaなど）に置き換えます。 - PROJECT_ID は、Filestore レプリカ インスタンスを含む Google Cloud プロジェクトのプロジェクト ID に置き換えます。
- LOCATION は、レプリカが存在するロケーション（
us-central1など）に置き換えます。
正常に完了すると、次のようなレスポンスが返されます。
createTime: '2025-12-22T14:03:33.727531128Z'
customPerformanceSupported: true
description: Replica of active, us-central1
fileShares:
- capacityGb: '1024'
name: share
name: projects/genomics-project/locations/us-central1/instances/my-replica
networks:
- connectMode: DIRECT_PEERING
ipAddresses:
- 10.229.150.130
modes:
- MODE_IPV4
network: default
reservedIpRange: 10.229.150.128/26
performanceLimits:
maxIops: '12000'
maxReadIops: '12000'
maxReadThroughputBps: '125829120'
maxWriteIops: '4000'
maxWriteThroughputBps: '104857600'
protocol: NFS_V3
replication:
replicas:
- peerInstance: projects/genomics-project/locations/us-central1/instances/my-source
state: READY
stateUpdateTime: '2025-12-22T14:24:27.558413891Z'
role: STANDBY
state: READY
tier: REGIONAL
REST API
gcloud CLI のインストールと初期化を行います。これにより、
Authorizationヘッダーのアクセス トークンを生成できます。cURLを使用 して、Filestore API を呼び出します。curl -s \ --header "Authorization: Bearer $(gcloud auth print-access-token)" \ --header "Content-Type: application/json" \ -d '{}' "https://file.googleapis.com/v1beta1/projects/PROJECT/locations/LOCATION/instances/REPLICA_NAME:resumeReplica"ここで
PROJECTは、レプリカが配置されているプロジェクトの名前です。例:my-genomics-projectLOCATIONは、レプリカが存在するロケーションです。例:us-west1-aREPLICA_NAMEは、再開するインスタンスの名前です。例:my-genomics-replica
レプリケーションを分割してレプリカをプロモートする
このセクションでは、アクティブ インスタンスとスタンバイ インスタンス間のレプリケーションを分割します。このアクションにより、レプリカが通常のインスタンスにプロモートします。
この操作は元に戻せません。慎重に使用してください。
通常のインスタンスにプロモートすると、リソースを新しいレプリカとペアリングできます。
フェイルバックは自動で行われません。レプリケーションを分割する操作が完了したら、管理者はアプリケーションを新しいソース インスタンスに再接続する必要があります。詳細については、レプリカをプロモートするをご覧ください。
Google Cloud コンソール
Google Cloud コンソールで、Filestore の [インスタンス] ページに移動します。
使用するレプリカのインスタンス ID をクリックします。
[レプリケーションを分割] をクリックします。
続行する前にアラートをお読みください。
レプリケーションの中断により、データの同期が永続的に停止され、アクティブ インスタンスとスタンバイ インスタンスの両方が通常のインスタンスに変換されます。最後に記録された同期ポイント以降に行われた変更はレプリケートされません。この操作は取り消せません。
レプリカのインスタンス ID を入力し、[レプリケーションを分割] をクリックします。
操作が正常に完了するのを待ちます。
gcloud
gcloud filestore instances promote-replica コマンドを実行して、レプリカ インスタンスをプロモートします。
gcloud filestore instances promote-replica INSTANCE-ID \
--project=PROJECT-ID \
--location=LOCATION \
ここで
- INSTANCE_ID は、プロモートする Filestore インスタンスのインスタンス ID（
my-replicaなど）に置き換えます。 - PROJECT_ID は、Filestore インスタンスを含む Google Cloud プロジェクトのプロジェクト ID に置き換えます。
- LOCATION は、レプリカが存在するロケーション（
us-central1など）に置き換えます。
正常に完了すると、次のようなレスポンスが返されます。
capacityGb: '1024'
capacityStepSizeGb: '256'
createTime: '2024-06-20T17:11:56.048062134Z'
fileShares:
- capacityGb: '1024'
name: vol1
maxCapacityGb: '9984'
maxShareCount: '1'
name: projects/genomics-project/locations/us-west2-a/instances/my-replica
networks:
- connectMode: DIRECT_PEERING
ipAddresses:
- 10.155.90.194
network: default
reservedIpRange: 10.155.90.192/26
protocol: NFS_V3
replication:
replicas:
- lastActiveSyncTime: '2024-06-21T00:13:23Z'
peerInstance: projects/genomics-project/locations/us-east1-b/instances/my-source
role: STANDBY
satisfiesPzi: true
state: PROMOTING
tier: ZONAL
REST API
gcloud CLI のインストールと初期化を行います。これにより、
Authorizationヘッダーのアクセス トークンを生成できます。cURLを使用 して、Filestore API を呼び出します。curl -s \ --header "Authorization: Bearer $(gcloud auth print-access-token)" \ --header "Content-Type: application/json" \ -d '{}' "https://file.googleapis.com/v1beta1/projects/PROJECT/locations/LOCATION/instances/REPLICA_NAME:promoteReplica"ここで
PROJECTは、レプリカが配置されているプロジェクトの名前です。例:my-genomics-projectLOCATIONは、レプリカが存在するロケーションです。例:us-west1-aREPLICA_NAMEは、プロモートするインスタンスの名前です。例:my-genomics-replica
レプリカ インスタンスを削除する
Google Cloud コンソール
Google Cloud コンソールで、Filestore インスタンス ページに移動します。
レプリカは、関連付けられたソース インスタンスの下に表示されます。レプリカが表示されない場合は、このタスクの
gcloudコマンドをご覧ください。削除するインスタンスのインスタンス ID をクリックします。
[削除] をクリックします。
gcloud
プロジェクト内のすべてのインスタンス（レプリカを含む）のリストを表示するには、
instances listコマンドを実行します。gcloud filestore instances list --project=PROJECT_ID \ここで
- PROJECT_ID: 表示するプロジェクトのプロジェクト ID。
削除するインスタンスの詳細をコピーします。
インスタンスを削除するには、
filestore instances deleteコマンドを実行します。gcloud filestore instances delete INSTANCE_ID \ --location=LOCATION \
ここで
- INSTANCE_ID は、削除する Filestore インスタンスのインスタンス ID（
my-replicaなど）に置き換えます。 - LOCATION は、レプリカが存在するロケーション（
us-central1-aなど）に置き換えます。
REST API
gcloud CLI のインストールと初期化を行います。これにより、
Authorizationヘッダーのアクセス トークンを生成できます。cURLを使用 して、Filestore API を呼び出します。curl -s \ --header "Authorization: Bearer $(gcloud auth print-access-token)" \ --header "Content-Type: application/json" \ --request DELETE "https://file.googleapis.com/v1beta1/projects/PROJECT/locations/LOCATION/instances/INSTANCE_NAME"
ここで
PROJECTは、インスタンスが配置されているプロジェクトの名前です。例:my-genomics-projectLOCATIONは、インスタンスが存在するロケーションです。例:us-west1-aINSTANCE_NAMEは、削除するインスタンスの名前です。例:my-genomics-instance
インスタンスのレプリケーションをモニタリングする
Google Cloud コンソール
Cloud Monitoring ダッシュボードで Filestore インスタンスのレプリケーション指標を表示するには、次の手順に従います。
開始する前に、次のロールにアクセスできることを確認してください。
- モニタリング閲覧者
- モニタリング編集者
これらのロールへのアクセス権を付与する方法については、Cloud Monitoring へのアクセス権を付与するをご覧ください。
-
Google Cloud コンソールで leaderboard Metrics explorer のページに移動します。
検索バーを使用してこのページを検索する場合は、小見出しが [Monitoring] である結果を選択します。
[指標を選択] 展開セクションをクリックします。
[リソース名または指標名でフィルタ] フィールドに「
filestore」と入力し、開くことができる [Filestore インスタンス] セクションを選択します。[インスタンス] セクションを開き、[RPO] をクリックします。
RPO 指標
times_since_last_replicationが表示されます。この指標は、複製データの初期同期が完了してから数分後に使用可能になります。
次のステップ
- インスタンス レプリケーションの詳細を確認する。
- インスタンス レプリケーションのリファレンス ドキュメントを読む。