Mengelola replikasi instance

Panduan ini menunjukkan cara mengonfigurasi replikasi instance untuk menyambungkan instance sumber dengan replika standby. Anda dapat menggunakan replikasi instance dalam skenario berikut:

  • Melindungi instance dari gangguan: Pertahankan instance failover lintas region yang terus diperbarui untuk pemulihan dari bencana.
  • Memigrasikan data: Promosikan replika standby untuk memigrasikan instance secara permanen ke lokasi baru dengan periode nonaktif minimal.
  • Menjalankan pengujian operasional: Jeda replikasi untuk memasang replika secara sementara dan menjalankan latihan disaster recovery terisolasi atau menguji workload tanpa memengaruhi instance utama Anda.

Sebelum memulai

Buat instance Filestore untuk digunakan sebagai instance sumber bagi replika Anda.

Mengaktifkan API

Aktifkan Filestore API.

Peran yang diperlukan untuk mengaktifkan API

Untuk mengaktifkan API, Anda memerlukan izin serviceusage.services.enable. Jika Anda membuat project, kemungkinan Anda sudah memiliki izin ini melalui peran Pemilik (roles/owner). Jika tidak, Anda bisa mendapatkan izin ini melalui peran Admin Penggunaan Layanan (roles/serviceusage.serviceUsageAdmin). Pelajari cara memberikan peran.

Mengaktifkan API

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk mengonfigurasi replikasi instance dan memantau replika, minta administrator untuk memberi Anda peran IAM berikut di project Anda:

Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Jika Anda membuat replika lintas project, Anda harus memiliki peran Cloud Filestore Editor (roles/file.editor) yang ditetapkan di project sumber dan replika. Peran ini mencakup izin file.instances.create, yang diperlukan di project sumber untuk membuat replika lintas project.

Membuat replika instance

Anda tidak dapat menggunakan konsol Google Cloud untuk membuat replika lintas project. Sebagai gantinya, gunakan gcloud CLI atau REST API.

Konsol Google Cloud

  1. Di konsol Google Cloud , buka halaman Instances Filestore.

    Buka Instances

  2. Klik ID Instance dari instance yang ingin Anda replikasi.

  3. Di halaman detail instance, klik tab Replikasi.

  4. Klik Buat replika.

  5. Verifikasi detail instance sumber, tinjau toleransi durasi kehilangan data yang didukung, lalu klik Berikutnya.

  6. Buat instance. Untuk mengetahui informasi selengkapnya, lihat Membuat instance. Pertimbangkan hal berikut:

    • Kapasitas yang ditentukan harus lebih besar dari atau sama dengan kapasitas instance sumber.
    • Tingkat layanan dan protokol Filestore harus sama untuk instance sumber dan replika.
    • Untuk solusi disaster recovery yang andal, sebaiknya pilih region yang berbeda untuk replika, bukan hanya zona yang berbeda.
  7. Klik Berikutnya.

  8. Tinjau detailnya, lalu klik Berikutnya.

  9. Klik Create.

  10. Tunggu hingga operasi selesai. Setelah proses selesai, replika akan tercantum di bagian instance sumber pada halaman Replications. Klik ID Instance replika untuk melihat detailnya.

gcloud

  1. Untuk membuat instance replika, jalankan perintah filestore instances create.

    gcloud filestore instances create INSTANCE_ID \
      --source-instance=projects/SOURCE_PROJECT_ID/locations/SOURCE_LOCATION/instances/SOURCE_INSTANCE_ID \
      --project=REPLICA_PROJECT_ID \
      --location=LOCATION \
      --network=name="NETWORK" \
      --tier=TIER \
      --file-share=name="FILE_SHARE_NAME",capacity=FILE_SHARE_SIZE \
    

Ganti kode berikut:

  • INSTANCE_ID dengan nama instance replika yang ingin Anda buat. Contoh, sample-replica.
  • SOURCE_PROJECT_ID dengan project ID Google Cloud project tempat instance sumber berada.
  • SOURCE_LOCATION dengan lokasi tempat instance sumber berada.
  • SOURCE_INSTANCE_ID dengan nama instance sumber yang ingin Anda buat replikanya. Contoh, sample-instance.
  • REPLICA_PROJECT_ID dengan project ID Google Cloud project tempat Anda ingin menempatkan instance replika.
  • LOCATION dengan lokasi tempat Anda ingin instance replika berada, seperti us-central1-a. Jika sumbernya berada di tingkat layanan zonal, Anda harus menentukan region dan zona untuk replika.
  • NETWORK dengan nama jaringan yang ingin Anda gunakan, seperti default.
  • TIER dengan tingkat layanan yang Anda butuhkan, misalnya,ZONAL. Tingkat dan rentang kapasitas harus cocok dengan instance 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

  1. Menginstal dan melakukan inisialisasi gcloud CLI, yang memungkinkan Anda membuat token akses untuk header Authorization.

  2. Untuk membuat replika instance, gunakan permintaan berikut:

    curl -s \
      --header "Authorization: Bearer $(gcloud auth print-access-token)" \
      --header "Content-Type: application/json" \
      --request POST \
      -d '{"tier": "TIER",
          "networks": { "network": "NETWORK" },
          "file_shares": {"name": "SHARE_NAME","capacity_gb": "CAPACITY"},
          "replication": {"replicas":[{"peer_instance": "projects/SOURCE_PROJECT_ID/locations/ACTIVE_LOCATION/instances/ACTIVE_NAME"}], "role":"standby"},
          "description": "DESCRIPTION" }' \
      "https://file.googleapis.com/v1/projects/REPLICA_PROJECT_ID/locations/REPLICA_LOCATION/instances?instanceId=REPLICA_INSTANCE_NAME"
    

    Ganti kode berikut:

    • 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.
    • REPLICA_PROJECT_ID adalah nama project tempat Anda ingin menempatkan replika. Contoh, sample-project.
    • SOURCE_PROJECT_ID adalah nama project tempat instance sumber Anda berada.
    • ACTIVE_LOCATION adalah lokasi tempat sumber berada. Contoh, us-east1.
    • ACTIVE_NAME adalah nama instance yang ingin Anda replikasi. Contoh, sample-instance.
    • DESCRIPTION adalah deskripsi instance replika yang ingin Anda buat. Contoh, A sample replica.
    • REPLICA_LOCATION adalah lokasi tempat Anda ingin replika berada. Contoh, us-central1.
    • REPLICA_INSTANCE_NAME adalah nama instance replika yang ingin Anda buat. Contoh, sample-replica.

Melihat status replika

Konsol Google Cloud

  1. Di konsol Google Cloud , buka halaman Replications Filestore.

Buka Replikasi

  1. Klik ID Instance replika untuk melihat detailnya.

gcloud

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

    gcloud filestore instances describe <var>INSTANCE_ID</var> \
       --project=<var>PROJECT_ID</var> \
      --location=<var>LOCATION</var> \
    

Ganti kode berikut:

  • 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 menampilkan instance replika yang dipromosikan ke instance reguler. Perhatikan bahwa replikasi tidak ditentukan karena belum aktif:

    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. Peran replikasi adalah 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

  1. Menginstal dan melakukan inisialisasi gcloud CLI, yang memungkinkan Anda membuat token akses untuk header Authorization.

  2. Untuk melihat status replika, gunakan permintaan berikut:

        curl -s \
        --header "Authorization: Bearer $(gcloud auth print-access-token)" \
        --header "Content-Type: application/json" \
        --request GET \
        "https://file.googleapis.com/v1/projects/<var>PROJECT</var>/locations/<var>LOCATION</var>/instances/<var>INSTANCE_NAME</var>"
    

    Ganti kode berikut:

    • PROJECT adalah nama project tempat instance Anda berada. Contoh, sample-project.
    • LOCATION adalah lokasi tempat instance Anda berada. Contoh, us-west1-a.
    • INSTANCE_NAME adalah nama instance yang ingin Anda lihat. Contoh, sample-instance.

Mencantumkan semua replika dalam project

Konsol Google Cloud

  1. Di konsol Google Cloud , buka halaman Replications Filestore.

    Buka Replikasi

Tabel mencantumkan instance sumber dengan replikanya. Klik ID Instance replika untuk melihat detailnya.

gcloud

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

    gcloud filestore instances list
      --project=PROJECT_ID \
    

    Ganti 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

  1. Menginstal dan melakukan inisialisasi gcloud CLI, yang memungkinkan Anda membuat token akses untuk header Authorization.

  2. Untuk mencantumkan replika dalam project tertentu, gunakan permintaan berikut:

    curl -s \
      --header "Authorization: Bearer $(gcloud auth print-access-token)" \
      --header "Content-Type: application/json" \
      --request GET \
      "https://file.googleapis.com/v1/projects/PROJECT/locations/LOCATION/instances"

    Ganti kode berikut:

    • PROJECT adalah nama project tempat instance Anda berada. Contoh, sample-project.
    • LOCATION adalah lokasi yang ingin Anda telusuri. Untuk menelusuri semua instance di lokasi mana pun dalam project, gunakan endpoint list.

Menjeda replikasi

Konsol Google Cloud

  1. Di konsol Google Cloud , buka halaman Instances Filestore.

    Buka Instances

  2. Klik ID Instance replika yang ingin Anda jeda.

  3. Di bagian Deskripsi, klik tab Replikasi.

  4. Di bagian Active instance details, klik Pause replication.

  5. 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.

gcloud

Untuk menjeda replika, jalankan perintah gcloud filestore instances pause-replica.

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

Ganti kode berikut:

  • 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

  1. Menginstal dan melakukan inisialisasi gcloud CLI, yang memungkinkan Anda membuat token akses untuk header Authorization.

  2. Untuk menjeda replika, gunakan permintaan berikut:

    curl -s \
      --header "Authorization: Bearer $(gcloud auth print-access-token)" \
      --header "Content-Type: application/json" \
      --request POST \
      -d '{}' \
      "https://file.googleapis.com/v1/projects/PROJECT/locations/LOCATION/instances/REPLICA_NAME:pauseReplica"

    Ganti kode berikut:

    • PROJECT adalah nama project tempat replika Anda berada. Misalnya, sample-project.
    • LOCATION adalah lokasi tempat replika berada. Contoh, us-west1-a.
    • REPLICA_NAME adalah nama instance yang ingin Anda jeda. Contoh, sample-replica.

Lanjutkan replikasi

Konsol Google Cloud

  1. Di konsol Google Cloud , buka halaman Instances Filestore.

    Buka Instances

  2. Klik ID instance replika yang ingin Anda gunakan.

  3. Di bagian Deskripsi, klik tab Replikasi.

  4. Di bagian Detail instance aktif, klik Lanjutkan replikasi.

  5. 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 \

Ganti kode berikut:

  • 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

  1. Menginstal dan melakukan inisialisasi gcloud CLI, yang memungkinkan Anda membuat token akses untuk header Authorization.

  2. Untuk melanjutkan replikasi, gunakan permintaan berikut:
curl -s \
      --header "Authorization: Bearer $(gcloud auth print-access-token)" \
      --header "Content-Type: application/json" \
      --request POST \
      -d '{}' \
      "https://file.googleapis.com/v1/projects/PROJECT/locations/LOCATION/instances/REPLICA_NAME:resumeReplica"

Ganti kode berikut:

  • PROJECT adalah nama project tempat replika Anda berada. Contoh, sample-project.
  • LOCATION adalah lokasi tempat replika berada. Contoh, us-west1-a.
  • REPLICA_NAME adalah nama instance yang ingin Anda lanjutkan. Contoh, sample-replica.

Memutus replikasi dan mempromosikan replika

Menghentikan replikasi antara instance aktif dan standby akan mempromosikan replika menjadi instance reguler. Operasi ini tidak dapat dibatalkan.

Konsol Google Cloud

  1. Di konsol Google Cloud , buka halaman Instances Filestore.

    Buka Instances

  2. Klik ID instance replika yang ingin Anda gunakan.

  3. Klik Hentikan replikasi.

  4. Masukkan ID Instance replika, lalu klik Hentikan replikasi.

  5. Tunggu hingga operasi selesai.

gcloud

Untuk mempromosikan instance replika, jalankan perintah gcloud filestore instances promote-replica.

  gcloud filestore instances promote-replica INSTANCE_ID 
--project=PROJECT_ID
--location=LOCATION

Ganti kode berikut:

  • 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

  1. Menginstal dan melakukan inisialisasi gcloud CLI, yang memungkinkan Anda membuat token akses untuk header Authorization.

  2. Untuk mempromosikan replika, gunakan permintaan berikut:

    curl -s \
      --header "Authorization: Bearer $(gcloud auth print-access-token)" \
      --header "Content-Type: application/json" \
      --request POST \
      -d '{}' \
      "https://file.googleapis.com/v1/projects/PROJECT/locations/LOCATION/instances/REPLICA_NAME:promoteReplica"

    Ganti kode berikut:

    • PROJECT adalah nama project tempat replika Anda berada. Contoh, sample-project.
    • LOCATION adalah lokasi tempat replika berada. Contoh, us-west1-a.
    • REPLICA_NAME adalah nama instance yang ingin Anda promosikan. Contoh, sample-replica.

Menghapus instance replika

Konsol Google Cloud

  1. 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.

  2. Klik ID instance dari instance yang ingin Anda hapus.

  3. Klik Hapus.

gcloud

  1. Untuk melihat daftar semua instance, termasuk replika, jalankan perintah instances list:

    gcloud filestore instances list
      --project=PROJECT_ID \
    

    Ganti PROJECT_ID dengan project ID project yang ingin Anda lihat.

  2. Salin detail instance yang ingin Anda hapus.

  3. Untuk menghapus instance replika, jalankan perintah filestore instances delete.

    gcloud filestore instances delete INSTANCE_ID \
      --location=LOCATION \
    

Ganti kode berikut:

  • 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

  1. Menginstal dan melakukan inisialisasi gcloud CLI, yang memungkinkan Anda membuat token akses untuk header Authorization.

  2. Untuk menghapus instance replika, gunakan permintaan berikut:

    curl -s \
      --header "Authorization: Bearer $(gcloud auth print-access-token)" \
      --header "Content-Type: application/json" \
      --request DELETE \
      "https://file.googleapis.com/v1/projects/PROJECT/locations/LOCATION/instances/INSTANCE_NAME"

    Ganti kode berikut:

    • PROJECT adalah nama project tempat instance Anda berada. Contoh, sample-project.
    • LOCATION adalah lokasi tempat instance Anda berada. Contoh, us-west1-a.
    • INSTANCE_NAME adalah nama instance yang ingin Anda hapus. Contoh, sample-instance.

Memantau replikasi instance

Konsol Google Cloud

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

  1. 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.

  2. Klik bagian yang dapat diluaskan Select a metric.

  3. Di kolom Filter menurut nama resource atau metrik, ketik filestore, lalu pilih bagian yang dapat diluaskan Instance Filestore.

  4. Pilih bagian yang dapat diluaskan Instance, lalu klik RPO.

  5. Metrik RPO times_since_last_replication ditampilkan. Metrik ini tersedia beberapa menit setelah sinkronisasi awal data yang direplikasi selesai.

Langkah berikutnya