管理執行個體複製作業

本指南說明如何使用 Filestore 執行個體複寫功能。

事前準備

完成使用 Filestore 的設定步驟。執行個體的配額會因專案、區域和層級而異。請確認您有足夠的權限完成這些工作。詳情請參閱「配額」或「要求增加配額」。
如果尚未建立 Filestore 執行個體，請先建立。在本指南中，這就是來源執行個體。

注意： 區域、可用區和企業服務層級支援執行個體複製功能。

建立執行個體副本

Google Cloud 控制台

前往 Google Cloud 控制台的 Filestore「Instances」(執行個體) 頁面。

前往「Instances」(執行個體)
找出要複製的執行個體，然後按一下該執行個體的「Instance ID」(執行個體 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「Instances」(執行個體) 頁面。

前往「Instances」(執行個體)
找出要查看的副本，然後按一下該副本的「Instance ID」(執行個體 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 專案 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「Instances」(執行個體) 頁面。

前往「Instances」(執行個體)

備用資源會列在相關聯的來源執行個體下方。

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「Instances」(執行個體) 頁面。

前往「Instances」(執行個體)
找出要使用的副本，然後按一下其執行個體 ID。
在「說明」部分中，按一下「複寫」分頁標籤。
在「Active instance details」(使用中執行個體詳細資料) 部分，按一下「Pause replication」(暫停複製)。
請先詳閱警示訊息，然後按一下「暫停複製」確認。

複製狀態會變更為「暫停」。作業完成後，「複製狀態」會變更為「已暫停」，並顯示副本暫停的日期。

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 替換為 Google Cloud 包含 Filestore 執行個體的專案 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「Instances」(執行個體) 頁面。

前往「Instances」(執行個體)
找出要使用的副本，然後按一下其執行個體 ID。
在「說明」部分中，按一下「複寫」分頁標籤。
在「Active instance details」(有效執行個體詳細資料) 部分，按一下「Resume replication」(繼續複製)。
請先閱讀警示訊息，然後在提供的欄位中輸入 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-project。
- LOCATION 是副本所在位置。例如：us-west1-a。
- REPLICA_NAME 是要繼續執行的執行個體名稱。例如：my-genomics-replica。

中斷複製作業並升級備用資源

在本節中，您將中斷作用中和待命執行個體之間的複製作業。這項動作會將副本升級為一般執行個體。

這項操作無法復原，請務必謹慎使用。
升級為一般例項後，資源即可與新的副本配對。
回復不會自動進行。中斷複製作業完成後，管理員必須將應用程式重新連線至新的來源執行個體。詳情請參閱「升級副本」。

Google Cloud 控制台

前往 Google Cloud 控制台的 Filestore「Instances」(執行個體) 頁面。

前往「Instances」(執行個體)
找出要使用的副本，然後按一下其執行個體 ID。
按一下「中斷複製作業」。
請先詳閱警示訊息，再繼續操作。

中斷複製作業會永久停止資料同步處理作業，並將已啟用的執行個體和待命執行個體轉換為一般執行個體。系統不會複製上次記錄的同步點之後所做的任何變更。這個動作無法復原。
輸入副本的執行個體 ID，然後按一下「Break replication」(中斷複製)。
等待作業順利完成。

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 替換為 Google Cloud 包含 Filestore 執行個體的專案 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 執行個體頁面。

前往「Instances」(執行個體)

備用資源會列在相關聯的來源執行個體下方。如果沒有看到副本，請參閱這項工作的 gcloud 指令。
找出您要刪除的執行個體，按一下該執行個體的「Instance ID」(執行個體 ID)。
按一下「Delete」(刪除)。

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 編輯者
如要瞭解如何授予這些角色的存取權，請參閱「授予 Cloud Monitoring 存取權」。
前往 Google Cloud 控制台的「Metrics Explorer」頁面：
前往 Metrics Explorer

如果您是使用搜尋列尋找這個頁面，請選取子標題為「Monitoring」的結果。
按一下「選取指標」可展開的部分。
在「依據資源或指標名稱篩選」欄位中，輸入 filestore，然後選取「Filestore Instance」(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 控制台

後續步驟

管理執行個體複製作業