管理实例复制

本指南介绍了如何使用 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 是您要用于副本的服务层级的名称。例如 REGIONAL。
- NETWORK 是您要用于副本的网络名称。例如 default。您必须使用与来源相同的网络。
- SHARE_NAME 是文件共享的名称。例如 vol1。
- CAPACITY 是您要为副本分配的大小（以 GiB 为单位）。例如 1024。容量必须大于或等于源实例的容量。
- PROJECT 是副本将驻留的项目的名称。例如 my-genomics-project。源和副本必须位于同一项目中。
- ACTIVE_LOCATION 是来源所在的位置。例如 us-east1。
- ACTIVE_NAME 是要复制的实例的名称。例如 my-genomics-instance。
- DESCRIPTION 是您要创建的副本实例的说明。例如 My genomics replica。
- REPLICA_LOCATION 是您希望副本所在的地理位置。例如 us-central1。
- REPLICA_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-project。
- LOCATION 是实例所在的地理位置。例如 us-west1-a。
- INSTANCE_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-project。
- LOCATION 是您要搜索的位置。如需搜索项目内任何位置的所有实例，请使用 -。

暂停复制

Google Cloud 控制台

在 Google Cloud 控制台中，前往 Filestore 实例页面。

转到实例
点击要使用的副本的实例 ID。
在说明部分，点击复制标签页。
在有效实例详情部分中，点击暂停复制
请先阅读提醒，然后再继续操作，点击暂停复制进行确认。

复制状态会更改为 Pausing。操作完成后，复制状态会更改为已暂停，并显示暂停副本的日期。

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-project。
LOCATION 是副本所在的位置。例如 us-west1-a。
REPLICA_NAME 是要暂停的实例的名称。例如 my-genomics-replica。

继续复制

Google Cloud 控制台

在 Google Cloud 控制台中，前往 Filestore 实例页面。

转到实例
点击要使用的副本的实例 ID。
在说明部分，点击复制标签页。
在有效实例详情部分中，点击恢复复制
请先阅读警告，然后在提供的字段中输入 resume 以进行确认。

复制状态会更改为正在恢复。操作完成后，复制状态会更改为就绪。

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-project。
LOCATION 是副本所在的位置。例如 us-west1-a。
REPLICA_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-project。
LOCATION 是副本所在的位置。例如 us-west1-a。
REPLICA_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-project。
- LOCATION 是实例所在的地理位置。例如 us-west1-a。
- INSTANCE_NAME 是要删除的实例的名称。例如 my-genomics-instance。

监控实例复制

Google Cloud 控制台

如需在 Cloud Monitoring 信息中心内查看 Filestore 实例复制指标，请按以下步骤操作：

在开始之前，请确保您拥有以下角色：
- Monitoring Viewer
- Monitoring Editor
如需了解如何授予对这些角色的访问权限，请参阅授予对 Cloud Monitoring 的访问权限。
在 Google Cloud 控制台中，前往 Metrics Explorer 页面：
进入 Metrics Explorer

如果您使用搜索栏查找此页面，请选择子标题为监控的结果。
点击选择指标可展开部分。
在按资源或指标名称过滤字段中，输入 filestore，然后选择 Filestore 实例可展开部分。
选择实例可展开部分，然后点击 RPO。
系统会显示 RPO 指标 times_since_last_replication。此指标会在复制数据完成初始同步后的几分钟内提供。

后续步骤

详细了解实例复制。
阅读实例复制参考文档。

管理实例复制 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

准备工作

创建实例副本

Google Cloud 控制台

gcloud

REST API

查看副本状态

Google Cloud 控制台

gcloud

REST API

列出项目中的所有副本

Google Cloud 控制台

gcloud

REST API

暂停复制

Google Cloud 控制台

gcloud

REST API

继续复制

Google Cloud 控制台

gcloud

REST API

中断复制并提升副本

Google Cloud 控制台

gcloud

REST API

删除副本实例

Google Cloud 控制台

gcloud

REST API

监控实例复制

Google Cloud 控制台

后续步骤

管理实例复制