Panduan ini menunjukkan cara menggunakan replikasi instance Filestore.
Sebelum memulai
Sebelum memulai, selesaikan langkah-langkah penyiapan yang diperlukan untuk menggunakan Filestore.
Kuota untuk instance bervariasi menurut project, region, dan tingkat. Pastikan Anda memiliki cukup waktu 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.
Membuat replika untuk instance
Google Cloud console
Di Google Cloud console, buka halaman instance Filestore.
Klik ID instance instance yang ingin Anda replikasi.
Di bagian Description, klik tab Replications.
Klik Buat replika.
Klik link dokumentasi untuk meninjau toleransi durasi kehilangan data (RPO) yang didukung, lalu klik Berikutnya.
Masukkan 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, pengguna sangat disarankan untuk memilih region dan zona yang unik untuk sumber.
Klik Berikutnya.
Tinjau detailnya, lalu klik Berikutnya.
Klik Create.
Tunggu hingga operasi selesai. Setelah selesai, replika akan tercantum di bagian instance sumber di halaman Instance.
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=SOURCE-INSTANCE \ --project=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 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 instance replika berada, seperti
us-central1-a
. Jika sumber berada di tingkat layanan zona, Anda harus menentukan region dan zona untuk replika. - NETWORK dengan nama jaringan yang ingin Anda gunakan, seperti
default
. Sumber dan replika harus menggunakan jaringan yang sama. - TIER dengan tingkat layanan yang Anda
butuhkan, seperti
ZONAL
. Tingkat dan rentang kapasitas harus cocok dengan sumber. - FILE-SHARE-NAME dengan nama yang Anda tentukan untuk berbagi file NFS
yang ditayangkan dari instance, seperti
vol1
. - FILE-SHARE-SIZE dengan ukuran yang Anda inginkan untuk berbagi file, seperti
1.25TB
. Kapasitas harus lebih besar dari atau sama dengan sumber dan, jika berlaku, rentang kapasitas yang sama.
REST API
Menginstal dan melakukan 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 keterangan:
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 file share. Contoh,vol1
.CAPACITY
adalah ukuran, dalam GiB, yang ingin Anda alokasikan untuk replika. Contoh,1024
. Kapasitas harus lebih besar atau sama dengan kapasitas instance sumber.PROJECT
adalah nama project tempat replika Anda akan berada. Contoh,my-genomics-project
. Sumber dan replika harus berada dalam project yang sama.ACTIVE_LOCATION
adalah lokasi tempat sumber berada. Contoh,us-east1
.ACTIVE_NAME
adalah nama instance yang ingin Anda replikasikan. 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 instance
Google Cloud console
Di Google Cloud console, buka halaman instance Filestore.
Klik ID instance replika yang ingin Anda lihat.
Di bagian Description, klik tab Replications.
Di sini Anda dapat melihat Status replika dan Titik sinkronisasi terakhir, stempel waktu terakhir kali salinan lengkap data Anda 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 \
Ganti kode berikut:
- INSTANCE-ID dengan ID instance 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 replika instance yang 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 ke 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 disambungkan 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
Menginstal dan melakukan 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 keterangan:
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 instance dalam project
Google Cloud console
Di Google Cloud console, buka halaman instance Filestore.
Buka halaman instance Filestore
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 \
Ganti kode berikut:
- PROJECT-ID dengan project ID project yang ingin Anda lihat.
Respons akan menampilkan sesuatu yang mirip dengan berikut ini:
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
Menginstal dan melakukan 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 keterangan:
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-
.
Memutus replikasi dan mempromosikan replika
Di bagian ini, Anda akan menghentikan replika antara instance aktif dan standby. Tindakan ini akan mempromosikan replika ke instance reguler.
Operasi ini tidak dapat diurungkan dan harus digunakan dengan hati-hati.
Setelah dipromosikan ke instance reguler, resource dapat disambungkan dengan replika baru.
Failback tidak otomatis. Setelah operasi untuk menghentikan replikasi selesai, administrator harus menghubungkan kembali aplikasi mereka ke instance sumber baru. Untuk informasi selengkapnya, lihat Mempromosikan replika.
Google Cloud console
Di Google Cloud console, buka halaman instance Filestore.
Klik ID instance replika yang ingin Anda gunakan.
Klik Hentikan replikasi.
Baca pemberitahuan sebelum melanjutkan.
Menghentikan replikasi akan menghentikan sinkronisasi data secara permanen dan mengonversi instance aktif dan standby menjadi instance reguler. Setiap perubahan yang dilakukan setelah titik sinkronisasi terakhir yang dicatat tidak akan direplikasi. Tindakan ini tidak dapat dibatalkan.
Masukkan ID instance replika, lalu klik Hentikan replika.
Tunggu hingga operasi berhasil selesai.
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 \
Ganti kode berikut:
- INSTANCE-ID dengan instance 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
Menginstal dan melakukan 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 keterangan:
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
Google Cloud console
Di Google Cloud console, buka halaman instance Filestore.
Buka halaman instance Filestore
Replika tercantum di bagian instance sumber terkait. Jika Anda tidak melihat replika, lihat perintah
gcloud
untuk tugas ini.Klik ID instance yang ingin Anda hapus.
Klik Hapus.
gcloud
Untuk melihat daftar semua instance dalam project, jalankan perintah
instances list
:gcloud filestore instances list --project=PROJECT-ID \
Ganti kode berikut:
- PROJECT-ID dengan project ID project yang ingin Anda lihat.
Salin detail instance yang ingin dihapus.
Anda dapat menghapus instance dengan menjalankan perintah
filestore instances delete
.gcloud filestore instances delete INSTANCE-ID \ --location=LOCATION \
Ganti kode berikut:
- INSTANCE-ID dengan ID instance instance Filestore yang ingin Anda hapus, seperti
my-replica
. - LOCATION dengan lokasi tempat replika berada, seperti
us-central1-a
.
REST API
Menginstal dan melakukan 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 keterangan:
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
Google Cloud console
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 leaderboard Metrics explorer:
Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Monitoring.
Klik bagian Select a metric yang dapat diluaskan.
Di kolom Filter menurut nama resource atau metrik, ketik
filestore
dan pilih bagian Filestore Instance yang dapat diluaskan.Pilih bagian Instance yang dapat diluaskan, lalu klik RPO.
Metrik RPO
time_since_last_replication
ditampilkan. Metrik ini akan tersedia beberapa menit setelah sinkronisasi awal data yang direplikasi selesai.