Mengelola replikasi instance

Panduan ini menunjukkan cara menggunakan replikasi instance Filestore.

Sebelum memulai

Selesaikan langkah-langkah penyiapan yang diperlukan untuk menggunakan Filestore. Kouta untuk instance bervariasi menurut project, region, dan tingkat. Pastikan Anda memiliki cukup banyak tugas untuk menyelesaikan tugas ini. Untuk mengetahui informasi selengkapnya, lihat Kuota atau Meminta penambahan kuota.
Jika Anda belum melakukannya, buat instance Filestore. Dalam konteks panduan ini, ini adalah instance sumber.

Catatan: Replikasi instance tersedia untuk tingkat layanan regional, zonal, dan enterprise.

Membuat replika instance

Konsol Google Cloud

Di konsol Google Cloud , buka halaman Instances Filestore.

Buka Instances
Klik ID instance dari instance yang ingin Anda replikasi.
Klik tab Replikasi.
Klik Buat replika.
Klik link dokumentasi untuk meninjau toleransi durasi kehilangan data (RPO) yang didukung, lalu klik Berikutnya.
Isi semua kolom wajib diisi dan kolom opsional sesuai kebutuhan.
- Kapasitas yang ditentukan harus lebih besar dari atau sama dengan sumber.
- Spesifikasi berikut harus cocok dengan instance sumber:
  - Tingkat layanan, termasuk rentang kapasitas
  - Protokol Filestore
- Untuk mengurangi risiko kehilangan data, sebaiknya pilih region dan zona yang unik untuk sumber.
Klik Berikutnya.
Tinjau detailnya, lalu klik Berikutnya.
Klik Create.
Tunggu hingga operasi selesai. Setelah selesai, replika akan dicantumkan di bagian instance sumber pada halaman Instances.
Klik ID instance replika untuk melihat detailnya.

gcloud

Anda dapat membuat instance replika dengan menjalankan perintah 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 \

Dengan:

INSTANCE_ID dengan nama instance yang ingin Anda buat, seperti my-replica.
SOURCE_INSTANCE dengan nama dan lokasi instance sumber yang ingin Anda buat replikanya. Contoh, projects/my-genomics-project/locations/us-east1-b/instances/my-genomics-instance.
PROJECT_ID dengan project ID Google Cloud project tempat instance sumber berada.
LOCATION dengan lokasi tempat Anda ingin menempatkan instance replika, seperti us-central1-a. Jika sumber berada di tingkat layanan zonal, Anda harus menentukan region dan zona untuk replika.
Ganti NETWORK dengan nama jaringan yang ingin Anda gunakan, seperti default.
TIER dengan tingkatan layanan yang Anda butuhkan, seperti ZONAL. Tingkatan dan rentang kapasitas harus cocok dengan sumber.
FILE_SHARE_NAME dengan nama yang Anda tentukan untuk berbagi file NFS yang ditampilkan dari instance, seperti vol1.
FILE_SHARE_SIZE dengan ukuran yang Anda inginkan untuk berbagi file, seperti 1.25TiB.

REST API

Instal dan lakukan inisialisasi gcloud CLI, yang memungkinkan Anda membuat token akses untuk header Authorization.

Gunakan cURL untuk memanggil 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"
```
Dengan:
- TIER adalah nama tingkat layanan yang ingin Anda gunakan untuk replika. Contoh, REGIONAL.
- NETWORK adalah nama jaringan yang ingin Anda gunakan untuk replika. Contoh, default. Anda harus menggunakan jaringan yang sama dengan sumber.
- SHARE_NAME adalah nama berbagi file. Contoh, vol1.
- CAPACITY adalah ukuran, dalam GiB, yang ingin Anda alokasikan untuk replika. Contoh, 1024. Kapasitas harus lebih besar daripada atau sama dengan kapasitas instance sumber.
- PROJECT adalah nama project tempat replika Anda akan berada. Contoh, my-genomics-project. Sumber dan replika harus berada di project yang sama.
- ACTIVE_LOCATION adalah lokasi tempat sumber berada. Contoh, us-east1.
- ACTIVE_NAME adalah nama instance yang ingin Anda replikasi. Contoh, my-genomics-instance.
- DESCRIPTION adalah deskripsi instance replika yang ingin Anda buat. Contoh, My genomics replica.
- REPLICA_LOCATION adalah lokasi tempat Anda ingin menempatkan replika. Contoh, us-central1.
- REPLICA_INSTANCE_NAME adalah nama instance replika yang ingin Anda buat. Contoh, my-genomics-replica.

Melihat status replika

Konsol Google Cloud

Di konsol Google Cloud , buka halaman Instances Filestore.

Buka Instances
Klik ID instance replika yang ingin Anda lihat.
Di bagian Deskripsi, klik tab Replikasi.
Di sini, Anda dapat melihat Status replika dan Titik sinkronisasi terakhir, stempel waktu saat salinan lengkap data Anda terakhir kali disalin ke replika.

gcloud

Untuk melihat informasi tentang instance tertentu, jalankan perintah instances describe:

gcloud filestore instances describe INSTANCE_ID \
    --project=PROJECT_ID \
    --location=LOCATION \

Dengan:

INSTANCE_ID dengan ID instance Filestore yang ingin Anda lihat, seperti genomics-instance.
PROJECT_ID dengan project ID Google Cloud project yang berisi instance Filestore.

LOCATION dengan lokasi tempat instance berada, seperti us-east1-b.

Respons terhadap perintah instances describe mirip dengan salah satu contoh berikut.

Contoh respons ini menunjukkan instance sumber dengan replikasi instance diaktifkan. Perhatikan bahwa peran yang ditentukan adalah 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

Contoh respons ini menunjukkan instance replika yang dipromosikan menjadi instance reguler. Perhatikan bahwa replikasi tidak ditentukan karena belum diaktifkan:

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

Contoh respons ini menunjukkan replika yang dipasangkan dengan instance aktif. Perhatikan bahwa peran tercantum sebagai 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

Instal dan lakukan inisialisasi gcloud CLI, yang memungkinkan Anda membuat token akses untuk header Authorization.

Gunakan cURL untuk memanggil 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"
```
Dengan:
- PROJECT adalah nama project tempat instance Anda berada. Contoh, my-genomics-project.
- LOCATION adalah lokasi tempat instance Anda berada. Contoh, us-west1-a.
- INSTANCE_NAME adalah nama instance yang ingin Anda lihat. Contoh, my-genomics-instance.

Mencantumkan semua replika dalam project

Konsol Google Cloud

Di konsol Google Cloud , buka halaman Instances Filestore.

Buka Instances

Replika tercantum di bagian instance sumber terkait.

gcloud

Untuk melihat daftar semua instance dalam project, jalankan perintah instances list:

gcloud filestore instances list
    --project=PROJECT-ID \

Dengan:

PROJECT-ID dengan project ID project yang ingin Anda lihat.

Respons akan menampilkan daftar instance dan replika, seperti berikut:

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

Instal dan lakukan inisialisasi gcloud CLI, yang memungkinkan Anda membuat token akses untuk header Authorization.

Gunakan cURL untuk memanggil 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"
```
Dengan:
- PROJECT adalah nama project tempat instance Anda berada. Contoh, my-genomics-project.
- LOCATION adalah lokasi yang ingin Anda telusuri. Untuk menelusuri semua instance di lokasi mana pun dalam project, gunakan -.

Menjeda replikasi

Konsol Google Cloud

Di konsol Google Cloud , buka halaman Instances Filestore.

Buka Instances
Klik ID instance replika yang ingin Anda gunakan.
Di bagian Deskripsi, klik tab Replikasi.
Di bagian Active instance details, klik Pause replication
Baca peringatan sebelum melanjutkan dan konfirmasi dengan mengklik Jeda replikasi.

Status replikasi akan berubah menjadi Menjeda. Setelah operasi selesai, Status Replikasi akan berubah menjadi Dijeda dan menampilkan tanggal saat replika dijeda.

gcloud

Anda dapat menjeda instance replika dengan menjalankan perintah gcloud filestore instances pause-replica.

  gcloud filestore instances pause-replica INSTANCE_ID \
      --project=PROJECT_ID \
      --location=LOCATION \

Dengan:

INSTANCE_ID dengan ID instance Filestore yang ingin Anda jeda, seperti my-replica.
PROJECT_ID dengan project ID Google Cloud project yang berisi instance Filestore.
LOCATION dengan lokasi tempat replika berada, seperti us-central1.

Jika berhasil diselesaikan, respons berikut atau yang serupa akan ditampilkan:

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

Instal dan lakukan inisialisasi gcloud CLI, yang memungkinkan Anda membuat token akses untuk header Authorization.

Gunakan cURL untuk memanggil 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"
```
Dengan:
- PROJECT adalah nama project tempat replika Anda berada. Contoh, my-genomics-project.
- LOCATION adalah lokasi tempat replika berada. Contoh, us-west1-a.
- REPLICA_NAME adalah nama instance yang ingin Anda jeda. Contoh, my-genomics-replica.

Melanjutkan replikasi

Konsol Google Cloud

Di konsol Google Cloud , buka halaman Instances Filestore.

Buka Instances
Klik ID instance replika yang ingin Anda gunakan.
Di bagian Deskripsi, klik tab Replikasi.
Di bagian Detail instance aktif, klik Lanjutkan replikasi
Baca peringatan sebelum melanjutkan dan konfirmasi dengan memasukkan resume di kolom yang disediakan.

Status replikasi akan berubah menjadi Melanjutkan. Setelah operasi selesai, Status Replikasi akan berubah menjadi Siap.

gcloud

Anda dapat melanjutkan instance replika dengan menjalankan perintah gcloud filestore instances resume-replica.

  gcloud filestore instances resume-replica INSTANCE_ID \
      --project=PROJECT_ID \
      --location=LOCATION \

Dengan:

Ganti INSTANCE_ID dengan ID instance replika Filestore yang ingin Anda lanjutkan, seperti my-replica.
PROJECT_ID dengan ID project Google Cloud project yang berisi instance replika Filestore.
LOCATION dengan lokasi tempat replika berada, seperti us-central1.

Jika berhasil diselesaikan, respons berikut atau yang serupa akan ditampilkan:

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

Instal dan lakukan inisialisasi gcloud CLI, yang memungkinkan Anda membuat token akses untuk header Authorization.

Gunakan cURL untuk memanggil 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"
```
Dengan:
- PROJECT adalah nama project tempat replika Anda berada. Contoh, my-genomics-project.
- LOCATION adalah lokasi tempat replika berada. Contoh, us-west1-a.
- REPLICA_NAME adalah nama instance yang ingin Anda lanjutkan. Contoh, my-genomics-replica.

Memutus replikasi dan mempromosikan replika

Di bagian ini, Anda akan menghentikan replikasi antara instance aktif dan siaga. Tindakan ini mempromosikan replika ke instance reguler.

Operasi ini tidak dapat diurungkan dan harus digunakan dengan hati-hati.
Setelah dipromosikan ke instance reguler, resource dapat dipasangkan dengan replika baru.
Pengembalian ke versi sebelumnya tidak otomatis. Setelah operasi untuk menghentikan replikasi selesai, administrator harus menghubungkan kembali aplikasi mereka ke instance sumber baru. Untuk mengetahui informasi selengkapnya, lihat Mempromosikan replika.

Konsol Google Cloud

Di konsol Google Cloud , buka halaman Instances Filestore.

Buka Instances
Klik ID instance replika yang ingin Anda gunakan.
Klik Hentikan replikasi.
Baca peringatan sebelum melanjutkan.

Menghentikan replikasi akan menghentikan sinkronisasi data secara permanen dan mengonversi instance aktif dan standby menjadi instance reguler. Perubahan yang dilakukan setelah titik sinkronisasi terakhir yang dicatat tidak akan direplikasi. Tindakan ini tidak dapat diurungkan.
Masukkan ID instance replika, lalu klik Hentikan replikasi.
Tunggu hingga operasi berhasil diselesaikan.

gcloud

Anda dapat mempromosikan instance replika dengan menjalankan perintah gcloud filestore instances promote-replica.

  gcloud filestore instances promote-replica INSTANCE-ID \
      --project=PROJECT-ID \
      --location=LOCATION \

Dengan:

INSTANCE_ID dengan ID instance Filestore yang ingin Anda promosikan, seperti my-replica.
PROJECT_ID dengan project ID Google Cloud project yang berisi instance Filestore.
LOCATION dengan lokasi tempat replika berada, seperti us-central1.

Jika berhasil diselesaikan, respons berikut atau yang serupa akan ditampilkan:

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

Instal dan lakukan inisialisasi gcloud CLI, yang memungkinkan Anda membuat token akses untuk header Authorization.

Gunakan cURL untuk memanggil 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"
```
Dengan:
- PROJECT adalah nama project tempat replika Anda berada. Contoh, my-genomics-project.
- LOCATION adalah lokasi tempat replika berada. Contoh, us-west1-a.
- REPLICA_NAME adalah nama instance yang ingin Anda promosikan. Contoh, my-genomics-replica.

Menghapus instance replika

Konsol Google Cloud

Di konsol Google Cloud , buka halaman instance Filestore.

Buka Instances

Replika tercantum di bagian instance sumber terkait. Jika Anda tidak melihat replika, lihat perintah gcloud untuk tugas ini.
Klik ID instance dari instance yang ingin Anda hapus.
Klik Hapus.

gcloud

Untuk melihat daftar semua instance, termasuk replika, dalam project, jalankan perintah instances list:
```
gcloud filestore instances list
    --project=PROJECT_ID \
```
Dengan:
- PROJECT_ID dengan project ID project yang ingin Anda lihat.
Salin detail instance yang ingin Anda hapus.
Anda dapat menghapus instance dengan menjalankan perintah filestore instances delete.
```
gcloud filestore instances delete INSTANCE_ID \
    --location=LOCATION \
```

Dengan:

INSTANCE_ID dengan ID instance Filestore yang ingin Anda hapus, seperti my-replica.
LOCATION dengan lokasi tempat replika berada, seperti us-central1-a.

REST API

Instal dan lakukan inisialisasi gcloud CLI, yang memungkinkan Anda membuat token akses untuk header Authorization.

Gunakan cURL untuk memanggil 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"
```
Dengan:
- PROJECT adalah nama project tempat instance Anda berada. Contoh, my-genomics-project.
- LOCATION adalah lokasi tempat instance Anda berada. Contoh, us-west1-a.
- INSTANCE_NAME adalah nama instance yang ingin Anda hapus. Contoh, my-genomics-instance.

Memantau replikasi instance

Konsol Google Cloud

Untuk melihat metrik replikasi instance Filestore di dasbor Cloud Monitoring, ikuti langkah-langkah berikut:

Sebelum memulai, pastikan Anda memiliki akses ke peran berikut:
- Penampil Pemantauan
- Monitoring Editor
Untuk melihat cara memberikan akses ke peran ini, lihat Memberikan akses ke Cloud Monitoring.
Di konsol Google Cloud , buka halaman Metrics explorer:
Buka Metrics explorer

Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Monitoring.
Klik bagian yang dapat diluaskan Select a metric.
Di kolom Filter menurut nama metrik atau resource, ketik filestore dan pilih bagian yang dapat diluaskan Instance Filestore.
Pilih bagian yang dapat diluaskan Instance, lalu klik RPO.
Metrik RPO times_since_last_replication ditampilkan. Metrik ini tersedia beberapa menit setelah sinkronisasi awal data yang direplikasi selesai.

Langkah berikutnya

Cari tahu lebih lanjut replikasi instance.
Baca Dokumentasi referensi replikasi instance.

Mengelola replikasi instance Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Sebelum memulai

Membuat replika instance

Konsol Google Cloud

gcloud

REST API

Melihat status replika

Konsol Google Cloud

gcloud

REST API

Mencantumkan semua replika dalam project

Konsol Google Cloud

gcloud

REST API

Menjeda replikasi

Konsol Google Cloud

gcloud

REST API

Melanjutkan replikasi

Konsol Google Cloud

gcloud

REST API

Memutus replikasi dan mempromosikan replika

Konsol Google Cloud

gcloud

REST API

Menghapus instance replika

Konsol Google Cloud

gcloud

REST API

Memantau replikasi instance

Konsol Google Cloud

Langkah berikutnya

Mengelola replikasi instance