Halaman ini menunjukkan cara membuat instance Filestore menggunakan konsol Google Cloud atau Google Cloud CLI.
Petunjuk untuk membuat instance
Konsol Google Cloud
Sebelum memulai
Aktifkan Filestore API. Mungkin perlu waktu beberapa menit agar Filestore API muncul di daftar Service di bagian Quotas & System Limits.
Kuota untuk instance zona atau regional dimulai dari
0. Untuk menggunakan kapasitas ini, Anda harus membuat dan menerima persetujuan untuk permintaan penambahan kuota terlebih dahulu sebelum dapat membuat instance.Jika perlu membuat instance menggunakan tingkat SSD perusahaan atau skala tinggi, Anda harus menjalankan operasi secara langsung melalui Filestore API atau menggunakan
gcloud. Operasicreateini tidak didukung melalui konsol Google Cloud .Untuk mengetahui informasi selengkapnya, lihat Paket layanan.
Google Cloud petunjuk
Di konsol Google Cloud , buka halaman Instances Filestore.
Klik Create Instance.
Isi semua kolom wajib diisi dan kolom opsional sesuai kebutuhan berdasarkan petunjuk di bagian berikut pada halaman ini.
Klik Create.
gcloud
Sebelum memulai
Untuk menggunakan gcloud CLI, Anda harus menginstal gcloud CLI atau menggunakan Cloud Shell yang disertakan dalam konsol Google Cloud :
Aktifkan Filestore API. Mungkin perlu waktu beberapa menit agar Filestore API muncul di daftar Service di bagian Quotas & System Limits.
Perintah gcloud untuk membuat instance Filestore
Anda dapat membuat instance Filestore dengan menjalankan perintah filestore
instances create.
Kuota untuk instance bervariasi menurut project, region, dan paket. Untuk mengetahui informasi selengkapnya,
lihat Kuota atau Meminta penambahan kuota.
gcloud filestore instances create INSTANCE_ID \
[--project=PROJECT_ID] \
[--location=LOCATION] \
[--description=DESCRIPTION] \
[--performance=PERFORMANCE] \
--tier=TIER \
--file-share=name="FILE_SHARE_NAME",capacity=FILE_SHARE_SIZE \
--network=name="VPC-NETWORK",[connect-mode=CONNECT_MODE],[reserved-ip-range="RESERVED_IP_ADDRESS"] \
[--labels=KEY=VALUE,[KEY=VALUE,…]] \
[--kms-key=KMS_KEY] \
[--deletion-protection] \
[--deletion-protection-reason="PROTECTION_REASON"]
Dengan:
- INSTANCE_ID dengan ID instance Filestore yang ingin Anda buat. Lihat Memberi nama instance.
PROJECT_ID dengan project ID dari project Google Cloud yang berisi instance Filestore. Anda dapat melewati flag ini jika instance Filestore berada dalam project default
gcloud. Anda dapat menetapkan project default dengan menjalankan perintahconfig set project:gcloud config set project PROJECT_IDLOCATION dengan lokasi tempat Anda ingin instance Filestore berada. Lihat Memilih lokasi. Anda dapat melewati flag ini jika instance Filestore berada di lokasi default
gcloud. Anda dapat menetapkan lokasi default dengan menjalankan perintahconfig set filestore/zone:gcloud config set filestore/zone zoneUntuk paket regional atau enterprise, gunakan perintah
config set filestore/region:gcloud config set filestore/region regionDESCRIPTION Deskripsi instance Filestore.
PERFORMANCE jika Anda ingin menggunakan flag
--performanceuntuk mengonfigurasi performa kustom, gunakan salah satu opsi berikut:max-iops-per-tbmenentukan rasio IOPS per TiB yang menskalakan IOPS secara linear dengan kapasitas instance.max-iopsmenentukan rasio IOPS yang tidak menskalakan IOPS dengan kapasitas instance.
Formatnya adalah sebagai berikut:
--performance=max-iops-per-tb=17000Flag
--performancediperlukan saat membuat instance regional dengan kapasitas lebih rendah dari 1024 GiB. Untuk mengetahui informasi selengkapnya, lihat instance Filestore kapasitas kecil.TIER dengan tingkat layanan yang ingin Anda gunakan.
FILE_SHARE_NAME dengan nama yang Anda tentukan untuk berbagi file NFS yang disajikan dari instance. Lihat Memberi nama file yang dibagikan.
FILE_SHARE_SIZE dengan ukuran yang Anda inginkan untuk berbagi file. Lihat Mengalokasikan kapasitas.
VPC_NETWORK dengan nama jaringan Virtual Private Cloud (VPC) yang ingin Anda gunakan untuk instance. Lihat Memilih jaringan VPC. Jika ingin menentukan VPC Bersama dari project layanan, Anda harus menentukan nama jaringan yang sepenuhnya memenuhi syarat, yang dalam format
projects/HOST_PROJECT_ID/global/networks/SHARED_VPC_NAMEdan Anda harus menentukanconnect-mode=PRIVATE_SERVICE_ACCESS. Contoh:--network=name=projects/host/global/networks/shared-vpc-1,connect-mode=PRIVATE_SERVICE_ACCESSAnda tidak dapat menentukan jaringan lama untuk nilai VPC_NETWORK. Jika perlu, buat jaringan VPC baru untuk digunakan dengan mengikuti petunjuk di Membuat jaringan VPC mode otomatis baru.
CONNECT_MODE dengan
DIRECT_PEERINGatauPRIVATE_SERVICE_ACCESS. Jika Anda menentukan VPC Bersama sebagai jaringan, Anda juga harus menentukanPRIVATE_SERVICE_ACCESSsebagai mode koneksi.RESERVED_IP_ADDRESS dengan rentang alamat IP untuk instance Filestore. Jika Anda menentukan
connect-mode=PRIVATE_SERVICE_ACCESS, dan ingin menggunakan rentang alamat IP yang dicadangkan, Anda harus menentukan nama rentang alamat yang dialokasikan, bukan rentang CIDR. Lihat Mengonfigurasi alamat IP yang dicadangkan. Sebaiknya lewati flag ini agar Filestore dapat otomatis menemukan rentang alamat IP yang tersedia dan menetapkannya ke instance.KEY dengan label yang ingin Anda tambahkan. Menambahkan label tidak diperlukan saat membuat instance Filestore. Anda juga dapat menambahkan, menghapus, atau memperbarui label setelah membuat instance. Untuk mengetahui detailnya, lihat Mengelola label.
VALUE dengan nilai untuk label.
KMS_KEY adalah nama yang sepenuhnya memenuhi syarat dari kunci enkripsi Cloud Key Management Service yang ingin Anda gunakan saat ingin mengelola enkripsi data Anda sendiri. Formatnya terlihat seperti:
projects/KMS_PROJECT_ID/locations/REGION/keyRings/KEY_RING/cryptoKeys/KEYPROTECTION_REASON jika Anda memilih untuk menggunakan flag
--deletion-protection, Anda memiliki opsi untuk menambahkan catatan terkait setelan tersebut. Untuk menambahkan catatan, gunakan flag--deletion-protection-reasonopsional dan sertakan deskripsi justifikasi untuk setelan yang Anda pilih. Misalnya, "Semua data genomik harus mematuhi kebijakan organisasi saat ini". Untuk mengetahui informasi selengkapnya, lihat proteksi dari penghapusan.
Beri nama instance Anda
Perintah berikut membuat instance dengan karakteristik berikut:
- ID adalah
render1. - Project adalah
myproject. - Region adalah
us-central1. - Tingkatnya adalah
REGIONAL. - Performa menggunakan parameter
max-iops-per-tbdengan nilai17000. - Nama fileshare adalah
my_vol. - Ukuran berbagi file adalah 2 TiB.
- Jaringan VPC adalah
default. - Rentang alamat IP yang dicadangkan adalah
10.0.7.0/29. - Memberikan akses baca dan tulis dengan root squashed ke klien dengan alamat IP
10.0.2.0. - Proteksi dari penghapusan diaktifkan.
- Justifikasi untuk setelan proteksi dari penghapusan diberikan.
gcloud filestore instances create render1 \
--project=myproject \
--region=us-central1 \
--tier=REGIONAL \
--performance=max-iops-per-tb=17000 \
--network=name="default",reserved-ip-range="10.0.7.0/29" \
--flags-file=nfs-export-options.json \
--deletion-protection \
--deletion-protection-reason="All genomics data must adhere to current
organization policies."
Isi file nfs-export-options.json:
{
"--file-share":
{
"capacity": "2048",
"name": "my_vol",
"nfs-export-options": [
{
"access-mode": "READ_WRITE",
"ip-ranges": [
"10.0.0.0/29",
"10.2.0.0/29"
],
"squash-mode": "ROOT_SQUASH",
"anon_uid": 1003,
"anon_gid": 1003
},
{
"access-mode": "READ_ONLY",
"ip-ranges": [
"192.168.0.0/26"
],
"squash-mode": "NO_ROOT_SQUASH"
}
]
}
}
REST API
Menginstal dan melakukan inisialisasi gcloud CLI, yang memungkinkan Anda membuat token akses untuk header
Authorization.Gunakan
cURLuntuk memanggil Filestore API:curl --request POST \ 'https://file.googleapis.com/v1/projects/PROJECT/locations/LOCATION/instances?instanceId=NAME' \ --header "Authorization: Bearer $(gcloud auth print-access-token)" \ --header 'Accept: application/json' \ --header 'Content-Type: application/json' \ --data '{ "tier":"TIER", "networks":[ { "network":"NETWORK" } ], "performanceConfig": {"PERFORMANCE"} "fileShares":[ {"capacityGb":CAPACITY,"name":"SHARE_NAME"} ], "deletionProtectionEnabled": true, "deletionProtectionReason": "PROTECTION_REASON"}' \ --compressedDengan:
PROJECTadalah nama project tempat instance Anda akan berada. Contoh,my-genomics-project.LOCATIONadalah lokasi tempat instance akan berada. Misalnyaus-east1atauus-central1-a.NAMEadalah nama instance yang ingin Anda buat. Contoh,my-genomics-instance.TIERadalah nama paket layanan yang ingin Anda gunakan. Contoh,REGIONAL.PERFORMANCEadalah konfigurasi performa yang digunakan untuk menentukan setelan performa kustom.Anda hanya dapat menggunakan salah satu opsi yang disediakan.
PerformanceConfig.iopsPerTb.maxIopsPerTbmenentukan rasio IOPS per TiB yang menskalakan IOPS secara linear dengan kapasitas instance.PerformanceConfig.fixedIops.maxIopsmenentukan rasio IOPS tetap yang tidak menskalakan IOPS dengan kapasitas instance.
Formatnya adalah sebagai berikut:
"performanceConfig": { "iopsPerTb" : { "maxIopsPerTb":17000 } }NETWORKadalah nama jaringan yang ingin Anda gunakan. Contoh,default.CAPACITYadalah ukuran, dalam GiB, yang ingin Anda alokasikan untuk instance. Contoh,1024.SHARE_NAMEadalah nama fileshare. Contoh,vol1.PROTECTION_REASONjika Anda memilih untuk menggunakan flagdeletionProtectionEnabled, Anda memiliki opsi untuk menambahkan catatan terkait setelan tersebut. Untuk menambahkan catatan, gunakan flagdeletionProtectionReasonopsional dan sertakan deskripsi justifikasi untuk setelan yang Anda pilih. Misalnya, "Semua data genomik harus mematuhi kebijakan organisasi saat ini". Untuk mengetahui informasi selengkapnya, lihat proteksi dari penghapusan.
Memahami instance dan berbagi
Instance Filestore mewakili kapasitas penyimpanan fisik.
Berbagi mewakili bagian yang dialokasikan dari penyimpanan tersebut dengan titik akses unik dan individual.
Semua paket layanan menawarkan opsi penyimpanan dengan rasio berbagi ke instance 1:1. Atau, multishare Filestore untuk Google Kubernetes Engine (GKE), yang hanya tersedia untuk instance tingkat perusahaan, menawarkan akses ke beberapa pembagian pada satu instance.
Nama instance, atau ID instance, digunakan oleh administrator untuk mengelola instance. Nama berbagi file digunakan oleh klien untuk terhubung ke berbagi yang diekspor dari instance tersebut.
Beri nama instance Anda
Nama instance Filestore, atau ID instance, digunakan untuk mengidentifikasi instance dan digunakan dalam perintah gcloud. ID instance harus mematuhi elemen <label> dari RFC 1035.
Secara khusus, mereka harus:
- Terdiri dari 1-63 karakter.
- Diawali dengan huruf kecil.
- Terdiri dari tanda hubung, huruf kecil, atau angka.
- Diakhiri dengan huruf kecil atau angka.
ID instance harus unik di project dan zona Google Cloud tempatnya berada. Setelah instance dibuat, ID instance-nya tidak dapat diubah.
Konfigurasi tingkat layanan
Pilih paket layanan yang paling sesuai dengan kebutuhan Anda. Setelah instance dibuat, paket layanannya tidak dapat diubah. Untuk mengetahui deskripsi mendetail tentang kemampuan yang tersedia berdasarkan paket layanan, lihat Paket layanan.
Operasi Create untuk instance zonal, regional, dan enterprise dapat memerlukan waktu antara 15 menit hingga satu jam untuk diselesaikan, bergantung pada ukuran instance.
Kuota Filestore digunakan saat pembuatan instance dimulai, tetapi Anda tidak akan ditagih untuk instance tersebut selama waktu ini.
Alokasikan kapasitas
Alokasikan kapasitas sesuai jumlah yang Anda butuhkan saat membuat instance. Saat mendekati batas kapasitas, Anda dapat meningkatkan kapasitas sesuai kebutuhan tanpa memengaruhi runtime. Untuk mempelajari cara memantau kapasitas instance, lihat Memantau instance.
Di gcloud CLI, Anda dapat menentukan kapasitas dalam bilangan bulat menggunakan GiB atau TiB. Unit defaultnya adalah GiB.
Tabel berikut menunjukkan ukuran instance yang tersedia untuk setiap paket:
| Tingkat | Ukuran minimum | Ukuran maksimum | Ukuran langkah inkremental |
|---|---|---|---|
| Zonal | 1 TiB | 9,75 TiB | 256 GiB |
| Zonal | 10 TiB | 100 TiB | 2,5 TiB |
| Regional | 100 GiB | 10.239 GiB | 1 GiB |
| Regional | 10 TiB | 100 TiB | 2,5 TiB |
| HDD Dasar | 1 TiB | 63,9 TiB | 1 GiB |
| SSD Dasar | 2,5 TiB | 63,9 TiB | 1 GiB |
| Enterprise | 1 TiB | 10 TiB | 256 GiB |
Ukuran instance dapat berupa nilai gibibyte utuh atau setara tebibyte-nya yang berada di antara ukuran instance minimum dan maksimum serta dapat dibagi dengan ukuran langkah inkrementalnya. Misalnya, ukuran yang valid untuk instance tingkat zona dengan rentang kapasitas yang lebih tinggi mencakup 10 TiB, 12,5 TiB, dan 15 TiB.
Setelah dibuat, instance HDD dasar dan SSD dasar hanya dapat ditingkatkan ukurannya. Semua paket layanan lainnya dapat meningkatkan atau menurunkan kapasitas. Untuk mengetahui informasi selengkapnya, lihat Mengedit instance dan Menskalakan kapasitas.
Kuota kapasitas total
Setiap project dialokasikan kuota kapasitas terpisah, yang ditentukan berdasarkan region dan paket layanan. Batas kuota bervariasi menurut paket layanan.
Setelah mencapai batas kuota, Anda tidak akan dapat membuat instance Filestore lagi atau meningkatkan kapasitas instance yang ada. Untuk melihat kuota yang tersedia, buka halaman Quotas di konsol Google Cloud :
Untuk mengetahui informasi tentang cara meminta lebih banyak kuota, lihat Meminta penambahan kuota.
Mengonfigurasi performa
Performa instance bergantung pada paket layanan yang Anda pilih.
Paket regional dan zona
Untuk paket regional dan zona, performa kustom diaktifkan secara default saat menggunakan konsol Google Cloud , sehingga Anda dapat mengonfigurasi performa berdasarkan workload dan skala. Anda dapat menetapkan rasio IOPS per TiB yang memungkinkan IOPS instance diskalakan dengan kapasitas, atau nilai IOPS konstan yang tidak diskalakan dengan kapasitas, tetapi dapat disesuaikan kapan saja jika kapasitas berubah. Untuk mengetahui detail tentang batas, lihat batas performa kustom.
Membuat instance Regional dengan kapasitas lebih rendah dari 1024 GiB memerlukan performa kustom yang diaktifkan. Nilai IOPS minimum untuk instance ini adalah 2.000. Untuk mengetahui informasi selengkapnya, lihat instance Filestore kapasitas rendah.
Tingkat SSD dasar dan HDD dasar
- Untuk paket SSD dasar, jumlah IOPS bersifat konstan dan tidak berubah saat Anda mengubah setelan kapasitas.
- Untuk paket HDD dasar, batas performa berubah bergantung pada apakah kapasitas berada dalam rentang 1 TiB hingga 10 TiB atau dari 10 TiB hingga 63,9 TiB.
Untuk mengetahui informasi tambahan tentang batas dan setelan performa, lihat performa.
Menentukan rasio IOPS per TiB
Performa kustom memungkinkan Anda menentukan rasio di kolom IOPS per TiB, tempat performa diskalakan berdasarkan kapasitas.
Jika Anda ingin menggunakan IOPS tetap, hapus centang pada kotak Scale performance with capacity.
Dengan asumsi Anda telah menentukan nilai performa awal berikut:
- Kapasitas: 1 TiB
- IOPS per TiB: 6.000
- Performa (jika kotak centang Skalakan performa dengan kapasitas dicentang): 6.000 IOPS
Contoh berikut menunjukkan cara penskalaan performa berdasarkan setelan yang diubah:
- Meningkatkan IOPS per TiB menjadi 7.000 akan menyesuaikan Performance menjadi 7.000 IOPS.
- Meningkatkan Capacity menjadi 2 TiB akan menyesuaikan Performance menjadi 14.000 IOPS.
- Menurunkan Performance menjadi 8.000 IOPS akan menyesuaikan IOPS per TiB menjadi 4.000.
Menentukan jumlah IOPS tetap
Jika Anda menghapus centang pada kotak Scale performance with capacity, kolom Performance akan menentukan jumlah IOPS yang ingin Anda gunakan. Angka ini harus berada dalam rentang performa dan kelipatan 1.000.
Menetapkan jumlah IOPS tetap secara independen dari kapasitas memungkinkan penyesuaian performa. Namun, opsi ini mencegah penskalaan performa otomatis dengan perubahan kapasitas. Mengubah kapasitas mungkin memerlukan penyesuaian nilai performa, dan sebaliknya.
Misalnya, Anda menentukan nilai berikut:
- Kapasitas: 4 TiB
- Performa 40.000 IOPS
Pada tahap ini, Anda dapat meningkatkan performa hingga 68.000 IOPS, yang merupakan batas untuk kapasitas 4 TiB. Anda ingin meningkatkan performa menjadi 70.000 IOPS,yang berada di luar rentang performa untuk kapasitas 4 TiB. Untuk mempertahankan kompatibilitas, Anda harus meningkatkan kapasitas menjadi 4,25 TiB atau lebih tinggi agar berada dalam rentang performa.
Pilih lokasi
Lokasi mengacu pada Region dan Zona tempat instance Filestore berada. Untuk mendapatkan performa terbaik dan menghindari biaya jaringan lintas-regional, pastikan instance Filestore berada di region yang sama dengan VM Compute Engine yang perlu mengaksesnya.
Untuk mengetahui informasi selengkapnya tentang region dan zona, lihat Geografi dan region.
Memilih protokol sistem file
Pilih protokol sistem file yang sesuai dengan kebutuhan Anda. Filestore mendukung protokol NFSv3 dan NFSv4.1.
Menyiapkan koneksi
Pilih jenis stack IP jaringan dan jaringan VPC.
Memilih jenis stack IP jaringan
Pilih IPv4 atau IPv6 sebagai jenis stack IP jaringan Anda.
Pilih jaringan VPC
Jaringan yang Anda pilih untuk digunakan dengan Filestore dapat berupa jaringan VPC standar atau jaringan VPC Bersama.
Jaringan VPC
Jika menggunakan konsol Google Cloud , Anda harus menggunakan Private Service Connect yang memungkinkan konsumen mengakses layanan terkelola secara pribadi dari dalam jaringan VPC mereka. Private Service Connect mengharuskan konsumen menyediakan satu alamat IP internal di VPC-nya sendiri untuk membuat endpoint Private Service Connect, alih-alih mengalokasikan seluruh rentang alamat IP untuk memfasilitasi koneksi.
Untuk membuat endpoint Private Service Connect di jaringan target konsumen, Anda harus membuat kebijakan koneksi layanan di project Anda.
Untuk mengetahui informasi selengkapnya tentang cara menggunakan Private Service Connect, lihat Membuat instance Filestore dengan Private Service Connect.
Jaringan yang Anda pilih harus memiliki resource IP yang tersedia dan cukup untuk didedikasikan ke instance Filestore, jika tidak, instance akan gagal dibuat karena kehabisan alamat IP. Untuk mengetahui informasi selengkapnya, lihat Persyaratan resource IP dan jaringan.
Klien harus berada di jaringan yang sama dengan instance Filestore untuk mengakses file yang tersimpan pada instance tersebut. Setelah instance dibuat, pilihan jaringan ini tidak dapat diubah.
Jaringan VPC bersama
Sebelum Anda dapat membuat instance di jaringan VPC Bersama dalam project layanan, administrator jaringan harus mengaktifkan akses layanan pribadi untuk jaringan VPC Bersama terlebih dahulu. Jika Anda membuat instance di project host, akses layanan pribadi tidak diperlukan.
Jaringan VPC bersama ditampilkan di konsol Google Cloud dalam format:
projects/HOST_PROJECT_ID/global/networks/SHARED_VPC_NAME
Untuk mengetahui prosedur mendetail, lihat Membuat instance di jaringan VPC Bersama.
Penguncian file NFS
Jika aplikasi yang ingin Anda gunakan dengan instance Filestore memerlukan penguncian file NFS, Anda mungkin perlu membuka port yang digunakan oleh Filestore di jaringan yang Anda pilih, jika salah satu opsi berikut berlaku untuk kasus penggunaan Anda:
- Jaringan VPC selain jaringan default.
- Jaringan VPC default dengan aturan firewall yang diubah.
Pertimbangan ini hanya berlaku untuk instance Filestore yang menggunakan metode koneksi akses layanan pribadi atau peering langsung.
Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi aturan firewall.
Mengonfigurasi berbagi file
Berbagi file adalah direktori pada instance Filestore tempat semua file bersama disimpan. Ini juga merupakan hal yang Anda pasang atau petakan di VM klien.
Nama file share harus mematuhi hal berikut:
- Memiliki panjang antara 1-32 karakter untuk tingkat zona, regional, dan perusahaan, serta panjang 1-16 karakter untuk tingkat dasar.
- Diawali dengan huruf.
- Terdiri dari huruf besar atau kecil, angka, dan garis bawah.
- Diakhiri dengan huruf atau angka.
Mengonfigurasi kontrol akses berbasis IP
Secara default, instance Filestore memberikan akses baca dan tulis level root ke semua klien, termasuk VM Compute Engine dan cluster GKE, yang menggunakan project dan jaringan VPC Google Cloud yang sama. Jika ingin membatasi akses, Anda dapat melakukannya dengan membuat aturan yang memberikan tingkat akses tertentu kepada klien berdasarkan alamat IP mereka. Setelah aturan ditambahkan, semua alamat IP dan rentang yang tidak ditentukan dalam aturan akan dicabut aksesnya. Instance zonal, regional, dan enterprise mendukung setelan konfigurasi untuk rentang alamat IP yang tumpang-tindih. Untuk mengetahui informasi selengkapnya, lihat Izin yang tumpang tindih.
Tabel berikut menjelaskan hak istimewa setiap tingkat akses. Tingkat akses ini hanya digunakan di konsol Google Cloud . Di gcloud CLI dan API, Anda harus menentukan konfigurasi aturan secara langsung.
| Tingkat akses | Konfigurasi aturan | Deskripsi |
|---|---|---|
admin |
|
Klien dapat melihat dan mengubah semua file, folder, dan metadata sebagai pengguna root. Protokol ini juga dapat memberikan kepemilikan file atau folder dengan menetapkan uid dan gid, dan dengan demikian, memberikan akses kepada klien yang tidak memiliki akses tingkat root ke file share. |
admin-viewer |
|
Klien dapat melihat semua file, folder, dan metadata sebagai pengguna root, tetapi tidak dapat mengubahnya. |
editor |
|
Klien dapat melihat dan mengubah file, folder, dan metadata sesuai dengan uid dan gid yang ditetapkan. |
viewer |
|
Klien dapat melihat file, folder, dan metadata sesuai dengan uid dan gid yang ditetapkan. |
root-squash memetakan semua permintaan dari uid 0 dan gid 0 ke anon_uid dan
anon_gid, masing-masing. Konfigurasi ini menghapus akses tingkat root dari
klien yang mencoba mengakses berbagi file sebagai pengguna root.
Saat membuat aturan akses berbasis IP:
- Anda harus menentukan alamat atau rentang IP internal dan tingkat akses yang diberikan.
- Minimal satu aturan harus memberikan akses
adminpada saat pembuatan instance. Aturan ini dapat dihapus setelah instance dibuat. - Instance zonal, regional, dan enterprise mendukung setelan konfigurasi untuk rentang alamat IP yang tumpang-tindih. Instance paket dasar tidak didukung. Untuk mengetahui informasi selengkapnya, lihat Izin yang tumpang tindih.
Di konsol Google Cloud , Anda dapat membuat hingga 4 aturan berbeda (admin,
admin-viewer, editor, viewer) yang melibatkan hingga 64 alamat IP atau rentang yang berbeda.
Di gcloud CLI, Anda dapat mengonfigurasi hingga 64 alamat IP atau blok CIDR yang berbeda per instance Filestore di maksimal 10 aturan yang berbeda. Aturan didefinisikan sebagai kombinasi konfigurasi access-mode,
squash-mode, dan anon_uid/anon_gid. Kolom anon_uid dan anon_gid memiliki nilai default 65534 dan hanya dapat dikonfigurasi melalui API dan gcloud CLI.
Contoh
Berikut adalah contoh tiga aturan akses berbasis IP yang berbeda:
access-mode=READ_ONLY,squash-mode=ROOT_SQUASH,anon_uid=10000.access-mode=READ_WRITE,squash-mode=ROOT_SQUASH,anon_gid=150.access-mode=READ_WRITE,squash-mode=NO_ROOT_SQUASH.
Untuk membuat aturan kontrol akses berbasis IP menggunakan gcloud CLI, gunakan
flag --flags-file dengan
perintah instances create atau
instances update
dan arahkan ke file konfigurasi JSON. Misalnya, jika file konfigurasi JSON diberi nama nfs-export-options.json, flag-nya adalah:
--flags-file=nfs-export-options.json
Contoh file konfigurasi JSON:
{
"--file-share":
{
"capacity": "2048",
"name": "my_vol",
"nfs-export-options": [
{
"access-mode": "READ_WRITE",
"ip-ranges": [
"10.0.0.0/29",
"10.2.0.0/29"
],
"squash-mode": "ROOT_SQUASH",
"anon_uid": 1003,
"anon_gid": 1003
},
{
"access-mode": "READ_ONLY",
"ip-ranges": [
"192.168.0.0/26"
],
"squash-mode": "NO_ROOT_SQUASH"
}
]
}
}
- ip-ranges adalah alamat IP atau rentang yang akan diberi akses. Anda dapat menentukan beberapa alamat IP atau rentang dengan memisahkannya menggunakan koma. Hanya instance zona, regional, dan perusahaan yang mendukung setelan konfigurasi untuk rentang alamat IP yang tumpang-tindih. Untuk mengetahui informasi selengkapnya, lihat Izin yang tumpang-tindih.
- access-mode adalah tingkat akses yang akan diberikan kepada klien yang alamat IP-nya termasuk dalam ip-range. Nilainya dapat berupa
READ_WRITEatauREAD_ONLY. Nilai defaultnya adalahREAD_WRITE. - squash-mode dapat memiliki nilai
ROOT_SQUASHatauNO_ROOT_SQUASH.ROOT_SQUASHmenghapus akses level root ke klien yang alamat IP-nya berada dalam ip-range, sedangkanNO_ROOT_SQUASHmengaktifkan akses root. Nilai defaultnya adalahNO_ROOT_SQUASH. - anon_uid adalah nilai ID pengguna yang ingin Anda petakan ke
anon_uid. Nilai defaultnya adalah65534. - anon_gid adalah nilai ID grup yang ingin Anda petakan ke
anon_gid. Nilai defaultnya adalah65534.
Klien pada rentang non-RFC 1918
Jika Anda berencana menghubungkan klien non-RFC 1918 ke instance Filestore, Anda harus secara eksplisit memberi mereka akses ke instance Filestore menggunakan kontrol akses berbasis IP.
Kolom opsional
Bagian berikut menjelaskan kolom opsional.
Menambahkan deskripsi instance
Deskripsi instance memungkinkan Anda menulis deskripsi, catatan, atau petunjuk untuk diri sendiri dan pengguna lain. Misalnya, Anda dapat menyertakan informasi tentang:
- Jenis file yang disimpan dalam instance.
- Siapa yang memiliki akses ke instance.
- Petunjuk cara mendapatkan akses ke instance.
- Tujuan penggunaan instance.
Deskripsi instance dibatasi hingga 2.048 karakter. Tidak ada batasan pada karakter yang diizinkan. Setelah instance Filestore dibuat, Anda dapat memperbarui deskripsi instance-nya kapan saja sesuai kebutuhan. Untuk mengetahui informasi tentang cara memperbarui deskripsi instance, lihat Mengedit instance.
Menambahkan label
Label adalah pasangan nilai kunci yang dapat Anda gunakan untuk mengelompokkan instance terkait dan menyimpan metadata tentang instance. Anda dapat menambahkan, menghapus, atau mengubah label kapan saja. Untuk mengetahui informasi selengkapnya, lihat Mengelola label.
Mengonfigurasi rentang alamat IP yang dicadangkan
Setiap instance Filestore harus memiliki rentang alamat IP yang terkait dengannya. Rentang alamat IP RFC 1918 dan non-RFC 1918 (GA) didukung.
Setelah ditentukan, rentang alamat IP instance tidak dapat diubah.
Pengguna dianjurkan untuk mengizinkan Filestore menentukan rentang alamat IP kosong secara otomatis dan menetapkannya ke instance. Saat memilih rentang Anda sendiri, pertimbangkan persyaratan resource IP Filestore berikut:
Harus menggunakan notasi CIDR.
Harus berupa rentang subnet VPC yang valid.
Instance dasar memerlukan ukuran blok 29. Misalnya,
10.123.123.0/29.Instance zona, regional, dan perusahaan memerlukan ukuran blok 26. Contoh,
172.16.123.0/26Rentang alamat IP tidak boleh tumpang-tindih dengan hal berikut:
Subnet yang ada di jaringan VPC yang digunakan instance Filestore.
Subnet yang ada di jaringan VPC yang di-peering dengan subnet yang digunakan instance Filestore. Untuk mengetahui detailnya, lihat Subnet yang tumpang-tindih pada saat peering.
Rentang alamat IP yang ditetapkan ke instance Filestore lain yang ada di jaringan tersebut.
Rentang alamat
172.17.0.0/16dicadangkan untuk komponen Filestore internal. Akibatnya, batasan berikut berlaku:Klien dalam rentang ini tidak dapat dihubungkan ke instance Filestore.
Instance Filestore tidak dapat dibuat dalam rentang IP ini. Untuk mengetahui informasi selengkapnya, lihat Masalah umum.
Harus ada setidaknya satu koneksi Peering Jaringan VPC atau akses layanan pribadi per VPC.
Anda dapat melihat rentang alamat IP untuk subnet jaringan Anda dengan membuka halaman jaringan VPC di konsol Google Cloud :
Anda bisa mendapatkan rentang alamat IP yang dicadangkan untuk instance Filestore apa pun di halaman instance Filestore di konsolGoogle Cloud :
Jika Anda ingin menggunakan akses layanan pribadi dan menentukan rentang alamat IP yang dicadangkan, Anda harus menentukan nama rentang alamat yang dialokasikan untuk koneksi. Jika Anda tidak menentukan nama rentang, Filestore akan otomatis menggunakan salah satu rentang yang dialokasikan yang terkait dengan koneksi akses layanan pribadi.
Menggunakan kunci enkripsi yang dikelola pelanggan
Secara default, Google Cloud otomatis mengenkripsi data saat dalam penyimpanan menggunakan kunci enkripsi yang dikelola oleh Google. Jika Anda memerlukan kontrol lebih besar atas kunci yang melindungi data, Anda dapat menggunakan kunci enkripsi yang dikelola pelanggan (CMEK) untuk Filestore. Untuk mengetahui detailnya, lihat Mengenkripsi data dengan kunci enkripsi yang dikelola pelanggan.
Mengaktifkan proteksi dari penghapusan
Tetapkan setelan proteksi dari penghapusan instance. Secara default, setelan ini dinonaktifkan. Untuk mengetahui informasi selengkapnya, lihat proteksi dari penghapusan.
Menambahkan deskripsi setelan proteksi dari penghapusan
Tambahkan deskripsi justifikasi di balik setelan proteksi dari penghapusan yang Anda pilih. Untuk mengetahui informasi selengkapnya, lihat proteksi dari penghapusan.
Langkah berikutnya
- Pelajari cara mengonfigurasi instance untuk digunakan dengan protokol NFSv4.1.
- Pelajari cara menghubungkan instance ke klien:
- Pasang fitur berbagi file Filestore di instance VM Compute Engine.
- Mengakses instance Filestore dengan driver CSI Filestore.
- Gunakan instance Filestore sebagai datastore eksternal untuk host VMware ESXi di Google Cloud VMware Engine.
- Memasang fitur berbagi file di klien jarak jauh.
- Memasang instance Filestore ke layanan Cloud Run untuk berbagi data di antara container dan layanan.
- Lihat cara mengambil detail instance, seperti alamat IP instance, sehingga Anda dapat mengakses berbagi file Filestore dari klien.
- Memecahkan masalah pembuatan instance terkait Filestore.
- Pelajari lebih lanjut jaringan dan subnet VPC.
- Pelajari lebih lanjut persyaratan jaringan dan resource IP untuk Filestore.