Anda dapat membuat dan mengelola instance cache dengan Rapid Cache untuk mengurangi latensi dan mengoptimalkan akses data untuk objek yang disimpan di Cloud Storage. Solusi caching ini membantu meningkatkan performa aplikasi Anda dengan mempercepat pengambilan data.
Halaman ini menunjukkan cara membuat dan mengelola instance cache dengan Rapid Cache. Untuk mengetahui informasi tentang cara menggunakan dan mengelola operasi yang berjalan lama yang dimulai dari operasi cache asinkron Rapid Cache, lihat Menggunakan operasi yang berjalan lama.
Sebelum menggunakan Rapid Cache, tinjau Batasan dan pembatasan.
Sebelum memulai
Sebelum Anda mulai membuat dan mengelola cache, selesaikan bagian berikut.
Mendapatkan peran yang diperlukan
Untuk mendapatkan izin yang
diperlukan guna membuat dan mengelola cache Rapid Cache,
minta administrator untuk memberi Anda
peran IAM Storage Admin (roles/storage.admin) di bucket tempat Anda ingin membuat cache.
Peran bawaan ini berisi izin yang diperlukan untuk membuat dan mengelola cache Rapid Cache. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:
Izin yang diperlukan
Izin berikut diperlukan untuk membuat dan mengelola cache Rapid Cache:
-
storage.anywhereCaches.create(diperlukan untuk membuat cache) -
storage.anywhereCaches.disable(diperlukan untuk menonaktifkan cache) -
storage.anywhereCaches.get(diperlukan untuk mendapatkan cache) -
storage.anywhereCaches.list(diperlukan untuk mencantumkan cache) -
storage.anywhereCaches.resume(diperlukan untuk melanjutkan cache) -
storage.anywhereCaches.update(diperlukan untuk mengupdate cache) -
storage.managedFolders.create(hanya diperlukan untuk mengaktifkan perilaku penyerapan saat penulisan untuk cache) -
storage.managedFolders.update(hanya diperlukan untuk memperbarui perilaku penyerapan saat penulisan cache)
Anda juga bisa mendapatkan izin ini dengan peran khusus.
Untuk mengetahui informasi tentang cara memberikan peran pada bucket, lihat Menetapkan dan mengelola kebijakan IAM pada bucket.
Untuk mengelola operasi yang berjalan lama yang dimulai dari metode Rapid Cache, Anda mungkin memerlukan peran dan izin tambahan. Lihat peran yang diperlukan untuk operasi yang berjalan lama untuk mempelajari lebih lanjut.
Memahami setelan penyerapan saat penulisan
Saat membuat atau memperbarui cache, Anda dapat mengaktifkan cache secara opsional untuk menyerap data saat data ditulis ke bucket. Kemampuan ini dikenal sebagai "ingest-on-write". Jika Anda berencana mengaktifkan penyerapan saat penulisan menggunakan JSON API, sebaiknya pahami terlebih dahulu perilaku setelan yang dikonfigurasi yang digunakan untuk penyerapan saat penulisan.
Membuat cache
Konsol
Membuat cache untuk bucket yang ada
- Di konsol Cloud de Confiance , buka halaman Buckets Cloud Storage.
Dalam daftar bucket, klik nama bucket yang datanya ingin Anda cache.
Di halaman Bucket details, klik tab Configuration.
Di bagian Rapid Cache, klik Configure cache.
Halaman Configure cache akan muncul untuk bucket Anda.
Di bagian Cache regions, klik region yang berisi zona tempat Anda ingin membuat cache.
Di bagian Cache zones, pilih zona tempat Anda ingin membuat cache. Untuk setiap cache yang Anda buat di zona, selesaikan langkah-langkah berikut (opsional):
Opsional: Anda dapat menetapkan Time to Live (TTL) kustom yang menentukan kapan data dikeluarkan dari cache sejak pembacaan terakhirnya. Secara default, TTL cache ditetapkan ke satu hari.
Untuk menetapkan TTL kustom:
Di kolom Time to live, tentukan nilai durasi (misalnya:
48) dan satuan waktu (misalnya:hours).Klik Simpan konfigurasi.
Opsional: Anda dapat mengaktifkan cache untuk menyerap data saat penulisan, selain menyerap data saat pembacaan pertama. Secara default, cache hanya dikonfigurasi untuk menyerap data pada pembacaan pertama.
Untuk mengaktifkan cache agar menyerap data saat penulisan:
Di kolom Ingestion criteria, klik Edit cache ingestion criteria edit.
Halaman Set ingestion criteria akan muncul.
Centang kotak Ingest data on write.
Untuk mengaktifkan penyerapan saat penulisan untuk semua objek yang baru ditulis ke bucket, klik Entire bucket.
Untuk mengaktifkan penyerapan saat penulisan hanya untuk objek yang baru ditulis yang memiliki awalan tertentu dalam namanya, klik Selected folders, lalu masukkan awalan nama objek. Awalan nama objek juga disebut sebagai "jalur folder".
Anda dapat memasukkan beberapa awalan nama objek dengan mengklik Tambahkan add.
Untuk menghapus awalan, klik Hapus item delete.
Klik Done.
Klik Simpan konfigurasi.
Pada dialog yang muncul, klik Konfirmasi.
Tab Operations di halaman Bucket details akan terbuka, yang menampilkan status tugas operasi pembuatan cache Anda.
Membuat cache untuk bucket baru
Untuk membuat cache sebagai bagian dari pembuatan bucket baru, ikuti petunjuk di bagian Membuat bucket baru.
Untuk melihat status cache bucket dari halaman Buckets list:
- Di konsol Cloud de Confiance , buka halaman Buckets Cloud Storage.
Klik ikon View Column (), pilih Cache, lalu klik OK.
Command line
Gunakan perintah gcloud storage buckets anywhere-caches create.
gcloud storage buckets anywhere-caches create gs://BUCKET_NAME CACHE_ZONE \ [--ttl=TTL] [--enable-ingest-on-write]
Ganti:
BUCKET_NAMEdengan nama bucket yang ingin Anda cache datanya. Contoh,my-bucket.CACHE_ZONEdengan zona tempat cache akan berjalan. Contoh,us-east1-b.Untuk membuat beberapa cache sekaligus, Anda dapat menentukan beberapa zona. Contoh,
us-east1-b us-east1-c us-east1-dTTL(opsional) dengan time to live (TTL) data dalam cache. Nilai dapat berkisar antara 1 hari dan 7 hari, inklusif. Nilai dapat dinyatakan dalam detik, menit, jam, dan hari. Misalnya:86400sselama 86.400 detik1440mselama 1.440 menit24hselama 24 jam1dselama 1 hari
Jika tidak ditentukan, setelan defaultnya adalah
86400s(1 hari).
Untuk mengonfigurasi cache agar menyerap data saat data ditulis ke bucket, tentukan flag --enable-ingest-on-write opsional. Flag ini memungkinkan cache menyerap semua objek saat ditulis ke bucket.
Jika berhasil, perintah tersebut akan menampilkan ID operasi yang berjalan lama yang terkait dengan operasi AnywhereCache Create. Anda dapat mendapatkan detail tentang operasi yang berjalan lama atau membatalkan operasi yang berjalan lama untuk menghentikan operasi AnywhereCaches Create sebelum selesai.
Library klien
C++
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage C++ API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.
Sebelum menjalankan contoh kode, tetapkan variabel
lingkungan GOOGLE_CLOUD_UNIVERSE_DOMAIN ke s3nsapis.fr.
Java
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Java API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.
Sebelum menjalankan contoh kode, tetapkan variabel
lingkungan GOOGLE_CLOUD_UNIVERSE_DOMAIN ke s3nsapis.fr.
Rust
Terraform
Lihat
dokumentasi Terraform google_storage_anywhere_cache untuk
mengetahui detail tentang cara menggunakan Rapid Cache dengan Terraform.
REST API
JSON API
Menginstal dan melakukan inisialisasi gcloud CLI, yang memungkinkan Anda membuat token akses untuk header
Authorization.Buat file JSON yang berisi informasi berikut:
{ "zone": "ZONE", "ttl": "TIME_TO_LIVE", "ingestOnWrite": INGEST_SETTING }Ganti:
ZONEdengan zona tempat cache akan berjalan. Contoh,us-east1-b.TIME_TO_LIVEdengan time to live (TTL) data dalam cache. Nilai harus dinyatakan dalam detik (misalnya:172800suntuk 172.800 detik, yang setara dengan 2 hari).Nilai minimumnya adalah
86400s(1 hari) dan nilai maksimumnya adalah604800s(7 hari). Jika tidak ditentukan, setelan defaultnya adalah86400s.INGEST_SETTINGdengantrueataufalseuntuk menentukan apakah cache akan menyerap data saat penulisan atau tidak.Jika ditetapkan ke
true, penyerapan saat penulisan akan diaktifkan untuk semua objek yang ditulis ke bucket. Jika ditetapkan kefalse, penyerapan saat penulisan dapat diaktifkan secara selektif untuk objek yang ditulis di bawah awalan, atau dapat dinonaktifkan untuk seluruh bucket.Untuk mempelajari setelan yang digunakan untuk mengonfigurasi pengaktifan penyerapan saat penulisan, lihat persyaratan untuk mengaktifkan penyerapan saat penulisan.
Untuk mengaktifkan penyerapan saat penulisan di tingkat bucket atau di tingkat awalan, atau untuk menonaktifkan penyerapan saat penulisan sepenuhnya, gunakan salah satu rangkaian petunjuk berikut.
Mengaktifkan penyerapan saat penulisan untuk bucket
Untuk mengaktifkan penyerapan saat penulisan untuk semua objek yang ditulis ke bucket, tetapkan nilai
INGEST_SETTINGSketrue.Selesaikan permintaan cache Anda dengan mengikuti langkah 3.
Mengaktifkan penyerapan saat penulisan secara selektif untuk objek di bawah awalan
Tetapkan nilai
INGEST_SETTINGSkefalse.Selesaikan permintaan cache Anda dengan mengikuti langkah 3.
Buat folder terkelola yang menggunakan awalan sebagai nama, jika folder terkelola belum ada.
Kirim permintaan
PATCHfolder terkelola yang menyertakan konfigurasirapidCacheConfig. Tetapkan nilai kolom dalam konfigurasi menggunakan panduan dalam Memahami cara menggunakan penyerapan saat penulisan.
Untuk mengetahui petunjuk mendetail tentang cara menggunakan konfigurasi
rapidCacheConfig, lihat Memperbarui penyerapan saat penulisan di folder terkelola.Membuat cache tanpa mengaktifkan penyerapan saat penulisan
Tetapkan nilai
INGEST_SETTINGSkefalse.Selesaikan permintaan cache Anda dengan mengikuti langkah 3.
Gunakan
cURLuntuk memanggil JSON API dengan permintaan untuk membuat cache:curl -X POST --data-binary @JSON_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://storage.s3nsapis.fr/storage/v1/b/BUCKET_NAME/anywhereCaches"Ganti:
JSON_FILE_NAMEdengan nama file JSON yang Anda buat di Langkah 2.BUCKET_NAMEdengan nama bucket yang datanya ingin Anda simpan dalam cache. Contoh,my-bucket.
Jika berhasil, operasi akan menampilkan google.longrunning.Operation.
Anda dapat mendapatkan detail tentang operasi yang berjalan lama atau
membatalkan operasi yang berjalan lama untuk menghentikan operasi Create AnywhereCaches
sebelum selesai.
Melihat cache
Konsol
- Di konsol Cloud de Confiance , buka halaman Buckets Cloud Storage.
Dalam daftar bucket, klik nama bucket yang terkait dengan cache yang ingin Anda lihat.
Di halaman Bucket details, klik tab Configuration.
Di bagian Rapid Cache, klik Edit di samping kolom Cache.
Di halaman Edit configuration yang muncul, pilih region untuk melihat semua cache dalam zona region tersebut.
Di panel Cache zones, Anda dapat melihat detail tentang setiap cache yang tersedia.
Command line
Gunakan perintah gcloud storage buckets anywhere-caches describe.
gcloud storage buckets anywhere-caches describe CACHE_ID
Ganti:
CACHE_IDdengan ID instance cache, yang dirumuskan sebagaiBUCKET_NAME/CACHE_ZONE. Contoh,my-bucket/us-east1-b.
Gunakan flag raw opsional untuk menampilkan respons API mentah, bukan respons API standar.
Jika berhasil, perintah akan menampilkan resource AnywhereCache.
Library klien
C++
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage C++ API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.
Sebelum menjalankan contoh kode, tetapkan variabel
lingkungan GOOGLE_CLOUD_UNIVERSE_DOMAIN ke s3nsapis.fr.
Java
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Java API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.
Sebelum menjalankan contoh kode, tetapkan variabel
lingkungan GOOGLE_CLOUD_UNIVERSE_DOMAIN ke s3nsapis.fr.
Rust
Terraform
Lihat
dokumentasi Terraform google_storage_anywhere_cache untuk
mengetahui detail tentang cara menggunakan Rapid Cache dengan Terraform.
REST API
JSON API
Menginstal dan melakukan inisialisasi gcloud CLI, yang memungkinkan Anda membuat token akses untuk header
Authorization.Gunakan
cURLuntuk memanggil JSON API dengan permintaan untuk mendapatkan cache:curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.s3nsapis.fr/storage/v1/b/BUCKET_NAME/anywhereCaches/RAPID_CACHE_ID"
Ganti:
BUCKET_NAMEdengan nama bucket yang terkait dengan cache yang ingin Anda ambil. Contoh,my-bucket.RAPID_CACHE_IDdengan zona tempat cache berada. Contoh,us-east1-b.
Jika berhasil, operasi ini akan menampilkan resource AnywhereCache.
Cache daftar
Konsol
- Di konsol Cloud de Confiance , buka halaman Buckets Cloud Storage.
Dalam daftar bucket, klik nama bucket yang terkait dengan cache yang ingin Anda lihat.
Di halaman Bucket details, klik tab Configuration.
Di bagian Rapid Cache, klik Edit di samping kolom Cache.
Di halaman Edit configuration yang muncul, pilih region untuk melihat semua cache dalam zona region tersebut.
Semua cache yang tersedia untuk zona dalam region akan muncul di panel Cache zones.
Command line
Gunakan perintah gcloud storage buckets anywhere-caches list.
gcloud storage buckets anywhere-caches list gs://BUCKET_NAME
Ganti:
BUCKET_NAMEdengan nama bucket yang terkait dengan cache yang ingin Anda cantumkan. Contoh,my-bucket.
Jika berhasil, perintah akan menampilkan daftar resource AnywhereCache.
Anda dapat menggunakan flag --raw secara opsional untuk menampilkan respons API mentah, bukan respons standar. Untuk mengetahui informasi selengkapnya tentang cara mengontrol perilaku listingan, seperti memberi nomor halaman pada hasil, lihat dokumentasi gcloud storage ls.
Library klien
C++
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage C++ API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.
Sebelum menjalankan contoh kode, tetapkan variabel
lingkungan GOOGLE_CLOUD_UNIVERSE_DOMAIN ke s3nsapis.fr.
Java
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Java API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.
Sebelum menjalankan contoh kode, tetapkan variabel
lingkungan GOOGLE_CLOUD_UNIVERSE_DOMAIN ke s3nsapis.fr.
Rust
Terraform
Lihat
dokumentasi Terraform google_storage_anywhere_cache untuk
mengetahui detail tentang cara menggunakan Rapid Cache dengan Terraform.
REST API
JSON API
Menginstal dan melakukan inisialisasi gcloud CLI, yang memungkinkan Anda membuat token akses untuk header
Authorization.Gunakan
cURLuntuk memanggil JSON API dengan permintaan untuk mencantumkan cache:curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.s3nsapis.fr/storage/v1/b/BUCKET_NAME/anywhereCaches"
Ganti:
BUCKET_NAMEdengan nama bucket yang terkait dengan cache yang ingin Anda ambil. Contoh,my-bucket.
Saat mencantumkan beberapa cache, Anda dapat memberi nomor halaman pada hasil.
Jika berhasil, operasi ini akan menampilkan daftar resource AnywhereCache. Untuk mengetahui detail tentang struktur respons ini, lihat respons dalam dokumentasi Daftar AnywhereCaches.
Memperbarui cache
Konsol
- Di konsol Cloud de Confiance , buka halaman Buckets Cloud Storage.
Dalam daftar bucket, klik nama bucket yang terkait dengan cache yang ingin Anda perbarui.
Di halaman Bucket details, klik tab Configuration.
Di bagian Rapid Cache, klik Manage caches.
Di panel Manage caches, klik Edit or create caches.
Di halaman Edit configuration yang muncul, perbarui properti cache:
Untuk memperbarui TTL cache, temukan kolom Time to live, lalu tentukan durasi waktu dan pilih unit waktu (misalnya, minutes).
Untuk mengonfigurasi perilaku ingest-on-write cache, termasuk apakah semua objek yang ditulis di-cache atau hanya objek tertentu yang ditulis di bawah awalan yang di-cache:
Temukan kolom Ingestion criteria, lalu klik Edit cache ingestion criteria.
Di panel Set ingestion criteria:
Untuk mengaktifkan atau menonaktifkan penyerapan saat penulisan, centang atau hapus centang pada kotak Ingest data on write, lalu klik Done.
Untuk memperbarui cache agar menyerap semua objek dalam bucket saat penulisan, pastikan kotak centang Ingest data on write dipilih, lalu pilih Entire bucket. Kemudian, klik Selesai.
Untuk memperbarui cache agar hanya menyerap objek yang berisi awalan yang ditentukan dalam namanya, pastikan kotak centang Ingest data on write dicentang, lalu pilih Selected folders.
Untuk menentukan awalan, masukkan satu atau beberapa awalan di kolom jalur folder, lalu klik Done.
Untuk menghapus awalan, klik Hapus item di samping awalan.
Di halaman Edit configuration, klik Save.
Pada dialog yang muncul, klik Konfirmasi.
Command line
Gunakan perintah gcloud storage buckets anywhere-caches update.
gcloud storage buckets anywhere-caches update CACHE_ID \ [--ttl=TTL] [--[no-]enable-ingest-on-write]
Ganti:
CACHE_IDdengan ID instance cache, yang dirumuskan sebagaiBUCKET_NAME/CACHE_ZONE. Contoh,my-bucket/us-east1-b.Untuk memperbarui beberapa cache sekaligus, Anda dapat menentukan beberapa ID. Misalnya,
my-bucket/us-east1-b my-bucket/us-east1-c.TTL(opsional) dengan time to live (TTL) data dalam cache. Nilai dapat berkisar antara 1 hari dan 7 hari, inklusif. Nilai dapat dinyatakan dalam detik, menit, jam, dan hari. Misalnya:86400sselama 86.400 detik1440mselama 1.440 menit24hselama 24 jam1dselama 1 hari
Untuk mengonfigurasi cache agar menyerap data saat data ditulis ke bucket, tentukan flag --enable-ingest-on-write. Flag ini memungkinkan cache menyerap semua objek saat ditulis ke bucket. Untuk menonaktifkan cache agar tidak menyerap data saat penulisan, tentukan flag --no-enable-ingest-on-write.
Jika berhasil, perintah akan menampilkan ID operasi yang berjalan lama dan mentah yang terkait dengan operasi Update AnywhereCache. Anda dapat mendapatkan detail tentang operasi yang berjalan lama.
Library klien
C++
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage C++ API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.
Sebelum menjalankan contoh kode, tetapkan variabel
lingkungan GOOGLE_CLOUD_UNIVERSE_DOMAIN ke s3nsapis.fr.
Java
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Java API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.
Sebelum menjalankan contoh kode, tetapkan variabel
lingkungan GOOGLE_CLOUD_UNIVERSE_DOMAIN ke s3nsapis.fr.
Rust
Terraform
Lihat
dokumentasi Terraform google_storage_anywhere_cache untuk
mengetahui detail tentang cara menggunakan Rapid Cache dengan Terraform.
REST API
JSON API
Menginstal dan melakukan inisialisasi gcloud CLI, yang memungkinkan Anda membuat token akses untuk header
Authorization.Buat file JSON yang menyertakan perubahan pada properti cache yang ingin Anda perbarui.
{ "ttl": "TIME_TO_LIVE", "ingestOnWrite": INGEST_SETTING }Ganti:
TIME_TO_LIVEdengan TTL data di cache. Nilai dapat berkisar antara 1 hari dan 7 hari, inklusif. Nilai dapat dinyatakan dalam detik, menit, jam, dan hari. Contoh:86400sselama 86.400 detik1440mselama 1.440 menit24hselama 24 jam1dselama 1 hari
INGEST_SETTINGdengantrueataufalseuntuk menentukan apakah cache menyerap data saat penulisan atau tidak.Jika ditetapkan ke
true, penyerapan saat penulisan akan diaktifkan untuk semua objek yang ditulis ke bucket. Jika ditetapkan kefalse, penyerapan saat penulisan dapat diaktifkan secara selektif untuk objek yang ditulis di bawah awalan, atau dapat dinonaktifkan sepenuhnya.Untuk mempelajari setelan yang digunakan untuk mengonfigurasi pengaktifan penyerapan saat penulisan di tingkat bucket atau awalan, lihat Memahami cara mengaktifkan penyerapan saat penulisan.
Untuk mengaktifkan penyerapan saat penulisan di tingkat bucket atau di tingkat awalan, atau untuk menonaktifkan penyerapan saat penulisan sepenuhnya, gunakan salah satu rangkaian petunjuk berikut.
Mengaktifkan penyerapan saat penulisan untuk bucket
Untuk mengaktifkan penyerapan saat penulisan untuk semua objek yang ditulis ke bucket, tetapkan nilai
INGEST_SETTINGSketrue.Selesaikan permintaan cache Anda dengan mengikuti langkah 3.
Jika penyerapan saat penulisan sebelumnya diaktifkan untuk awalan, folder terkelola dengan konfigurasi
rapidCacheConfigakan ada. Buat permintaanPATCHfolder terkelola yang menetapkan petapoliciesdalam konfigurasirapidCacheConfigkenull.
Untuk mengetahui petunjuk mendetail tentang cara menggunakan konfigurasi
rapidCacheConfig, lihat Memperbarui penyerapan saat penulisan di folder terkelola.Mengaktifkan penyerapan saat penulisan secara selektif untuk objek di bawah awalan
Tetapkan nilai
INGEST_SETTINGSkefalse.Selesaikan permintaan cache Anda dengan mengikuti langkah 3.
Buat folder terkelola yang menggunakan awalan sebagai nama, jika folder terkelola belum ada.
Kirim permintaan
PATCHfolder terkelola yang menyertakan konfigurasirapidCacheConfig. Tetapkan nilai kolom dalam konfigurasi menggunakan panduan dalam setelan dan perilaku penyerapan saat penulisan.
Peta
policiesdari konfigurasirapidCacheConfigdapat berisi satu atau beberapa ID cache (misalnya,us-east1-adanus-east1-b). Untuk mengaktifkan penyerapan saat penulisan untuk cache tertentu, tetapkan setelaningestOnWritecache individual keenabled. Untuk menonaktifkan penyerapan saat penulisan untuk cache tertentu, tetapkan setelaningestOnWritecache individual keunspecified. Baca dengan cermat tentang pewarisan penyerapan saat penulisan untuk memahami bagaimana kebijakan penyerapan saat penulisan cache dapat terpengaruh saat setelaningestOnWriteuntuk cache ditetapkan keunspecified.Untuk mengetahui petunjuk mendetail tentang cara menggunakan konfigurasi
rapidCacheConfig, lihat Memperbarui penyerapan saat penulisan di folder terkelola.Menonaktifkan penyerapan saat penulisan
Tetapkan nilai
INGEST_SETTINGSkefalse. Setelan ini menonaktifkan penyerapan saat penulisan di tingkat bucket.Selesaikan permintaan cache Anda dengan mengikuti langkah 3.
Untuk menonaktifkan penyerapan saat penulisan di tingkat awalan, temukan folder terkelola tempat penyerapan saat penulisan di tingkat awalan dikonfigurasi. Buat permintaan
PATCHfolder terkelola yang menetapkan petapoliciesdalam konfigurasirapidCacheConfigkenull. Atau, hapus konfigurasirapidCacheConfigdari resource folder terkelola dalam permintaanPATCH.
Untuk mengetahui petunjuk mendetail tentang cara menggunakan konfigurasi
rapidCacheConfig, lihat Memperbarui penyerapan saat penulisan di folder terkelola.
Contoh berikut memperbarui TTL cache menjadi 2 hari dan mengaktifkan penyerapan saat penulisan untuk semua objek yang ditulis ke bucket:
{ "ttl": "172800s", "ingestOnWrite": true }Untuk menerapkan properti baru, gunakan
cURLuntuk memanggil JSON API dengan permintaan untuk memperbarui cache:curl -X PATCH --data-binary @JSON_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://storage.s3nsapis.fr/storage/v1/b/BUCKET_NAME/anywhereCaches/RAPID_CACHE_ID"Ganti:
JSON_FILE_NAMEdengan nama file JSON yang Anda buat di Langkah 2.BUCKET_NAMEdengan nama bucket yang terkait dengan cache yang ingin Anda perbarui. Contoh,my-bucket.RAPID_CACHE_IDdengan ID cache. Contoh,us-east1-b.
Jika berhasil, operasi akan menampilkan google.longrunning.Operation.
Anda bisa mendapatkan detail tentang operasi yang berjalan lama.
Melanjutkan cache
Konsol
Untuk melanjutkan cache yang telah dijeda atau dinonaktifkan, selesaikan petunjuk berikut:
- Di konsol Cloud de Confiance , buka halaman Buckets Cloud Storage.
Dalam daftar bucket, klik nama bucket yang terkait dengan cache yang ingin Anda lanjutkan.
Di halaman Bucket details, klik tab Configuration.
Di bagian Rapid Cache, klik Manage caches.
Di panel Manage caches, klik ikon Resume cache ().
Klik Close.
Command line
Gunakan perintah gcloud storage buckets anywhere-caches resume.
gcloud storage buckets anywhere-caches resume CACHE_ID
Ganti:
CACHE_IDdengan ID instance cache, yang dirumuskan sebagaiBUCKET_NAME/CACHE_ZONE. Contoh,my-bucket/us-east1-b.Untuk melanjutkan beberapa cache sekaligus, Anda dapat menentukan beberapa ID. Misalnya,
my-bucket/us-east1-b my-bucket/us-east1-c.
Jika berhasil, perintah akan menampilkan resource AnywhereCache yang diformat.
Library klien
C++
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage C++ API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.
Sebelum menjalankan contoh kode, tetapkan variabel
lingkungan GOOGLE_CLOUD_UNIVERSE_DOMAIN ke s3nsapis.fr.
Java
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Java API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.
Sebelum menjalankan contoh kode, tetapkan variabel
lingkungan GOOGLE_CLOUD_UNIVERSE_DOMAIN ke s3nsapis.fr.
Rust
Terraform
Lihat
dokumentasi Terraform google_storage_anywhere_cache untuk
mengetahui detail tentang cara menggunakan Rapid Cache dengan Terraform.
REST API
JSON API
Menginstal dan melakukan inisialisasi gcloud CLI, yang memungkinkan Anda membuat token akses untuk header
Authorization.Gunakan
cURLuntuk memanggil JSON API dengan permintaan untuk melanjutkan cache:curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.s3nsapis.fr/storage/v1/b/BUCKET_NAME/anywhereCaches/RAPID_CACHE_ID/resume"
Ganti:
BUCKET_NAMEdengan nama bucket yang terkait dengan cache yang ingin Anda lanjutkan. Contoh,my-bucket.RAPID_CACHE_IDdengan ID cache. Contoh,us-east1-b.
Jika berhasil, operasi akan menampilkan resource AnywhereCache yang diformat.
Menonaktifkan cache
Konsol
- Di konsol Cloud de Confiance , buka halaman Buckets Cloud Storage.
Dalam daftar bucket, klik nama bucket yang terkait dengan cache yang ingin Anda nonaktifkan.
Di halaman Bucket details, klik tab Configuration.
Di bagian Rapid Cache, klik Manage caches.
Di panel Manage caches, klik ikon Disable cache ().
Pada dialog yang muncul, klik Konfirmasi.
Klik Close.
Command line
Gunakan perintah gcloud storage buckets anywhere-caches disable.
gcloud storage buckets anywhere-caches disable CACHE_ID
Ganti:
CACHE_IDdengan ID instance cache, yang dirumuskan sebagaiBUCKET_NAME/CACHE_ZONE. Contoh,my-bucket/us-east1-b.Untuk menonaktifkan beberapa cache sekaligus, Anda dapat menentukan beberapa ID. Misalnya,
my-bucket/us-east1-b my-bucket/us-east1-c.
Jika berhasil, perintah akan menampilkan resource AnywhereCache yang diformat.
Library klien
C++
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage C++ API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.
Sebelum menjalankan contoh kode, tetapkan variabel
lingkungan GOOGLE_CLOUD_UNIVERSE_DOMAIN ke s3nsapis.fr.
Java
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Java API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.
Sebelum menjalankan contoh kode, tetapkan variabel
lingkungan GOOGLE_CLOUD_UNIVERSE_DOMAIN ke s3nsapis.fr.
Rust
Terraform
Lihat
dokumentasi Terraform google_storage_anywhere_cache untuk
mengetahui detail tentang cara menggunakan Rapid Cache dengan Terraform.
REST API
JSON API
Menginstal dan melakukan inisialisasi gcloud CLI, yang memungkinkan Anda membuat token akses untuk header
Authorization.Gunakan
cURLuntuk memanggil JSON API dengan permintaan untuk menonaktifkan cache:curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.s3nsapis.fr/storage/v1/b/BUCKET_NAME/anywhereCaches/RAPID_CACHE_ID/disable"
Ganti:
BUCKET_NAMEdengan nama bucket yang terkait dengan cache yang ingin Anda nonaktifkan. Contoh,my-bucket.RAPID_CACHE_IDdengan ID cache. Contoh,us-east1-b.
Jika berhasil, perintah akan menampilkan resource AnywhereCache yang diformat.
Memantau performa cache
Bagian Cloud Storage di konsol Cloud de Confiance menyediakan diagram pemantauan yang memungkinkan Anda melacak performa cache menggunakan metrik. Diagram pemantauan ini juga dapat dilihat menggunakan Cloud Monitoring.
Diagram yang tersedia
| Diagram | Tingkat hierarki resource | Deskripsi |
|---|---|---|
| Rasio penghapusan byte | Bucket | Tingkat byte yang dihapus dari cache, diambil sampelnya setiap jam. Data ini diperbarui lebih dari sekali dalam satu jam untuk memberikan waktu bagi pascapemrosesan data. |
| Rasio penghapusan byte | Project | Tingkat byte yang dikeluarkan dari semua cache bucket, yang diambil sampelnya setiap jam. Data ini diperbarui lebih dari sekali dalam satu jam untuk memberikan waktu pemrosesan data pasca-pembaruan. |
| Byte dalam cache | Bucket | Jumlah byte dalam cache, yang diambil sampelnya setiap jam. Data ini diperbarui lebih dari sekali dalam satu jam untuk memberikan waktu bagi pascapemrosesan data. |
| Byte dalam cache | Project | Jumlah byte di semua cache bucket, yang diambil sampelnya setiap jam. Data ini diperbarui lebih dari sekali dalam satu jam untuk memberikan waktu bagi pascapemrosesan data. |
| Manfaat throughput cache | Project | Tingkat kuota bandwidth transfer data untuk region, dual-region, atau multi-region, penggunaan kuota, dan throughput tambahan yang disajikan oleh cache. Throughput tambahan yang disajikan oleh cache tidak dihitung dalam kuota. Oleh karena itu, penggunaan cache memungkinkan project melampaui throughput yang diizinkan oleh kuota. |
| Operasi rasio hit | Bucket | Persentase operasi cache yang menyajikan data yang diminta dari cache relatif terhadap total operasi yang memenuhi syarat cache, yang diambil sampelnya setiap 60 detik. Jika pembacaan sepenuhnya ditampilkan dari cache, operasi tersebut dihitung sebagai hit. Jika pembacaan tidak ditampilkan dari cache atau hanya ditampilkan sebagian dari cache, operasi akan dihitung sebagai cache miss. |
| Operasi rasio hit | Project | Persentase operasi cache yang menyajikan data yang diminta dari semua cache untuk bucket dibandingkan dengan total operasi yang memenuhi syarat cache, yang diambil sampelnya selama 60 detik. Jika pembacaan sepenuhnya ditampilkan dari cache, operasi akan dihitung sebagai hit. Jika pembacaan tidak ditampilkan dari cache atau hanya ditampilkan sebagian dari cache, operasi akan dihitung sebagai cache miss. |
| Byte rasio hit | Bucket | Persentase byte yang disajikan dari cache relatif terhadap total byte yang memenuhi syarat cache, yang diambil sampelnya setiap 60 detik. |
| Byte rasio hit | Project | Persentase byte yang disajikan dari semua cache untuk bucket relatif terhadap total byte yang memenuhi syarat cache, yang diambil sampelnya setiap 60 detik. |
| Byte mentah kecepatan penyerapan | Bucket | Tingkat byte mentah yang diserap ke dalam setiap cache, diambil sampelnya setiap 60 detik. Semua byte yang diserap, termasuk byte yang tidak dapat ditagih, digunakan dalam menghitung nilai metrik ini. Metrik ini dilaporkan secara real time. |
| Byte mentah kecepatan penyerapan | Project | Tingkat byte mentah yang diserap ke semua cache bucket, diambil sampelnya setiap 60 detik. Semua byte yang diserap, termasuk byte yang tidak dapat ditagih, digunakan dalam menghitung nilai metrik ini. Metrik ini dilaporkan secara real time. |
| Throughput - Cache ditemukan | Bucket | Throughput yang disajikan dari cache, diambil sampelnya setiap 60 detik. |
| Throughput - Cache ditemukan | Project | Throughput yang disajikan dari semua cache untuk bucket, diambil sampelnya setiap 60 detik. |
| Throughput - Cache tidak ditemukan | Bucket | Throughput yang tidak disajikan dari cache, diambil sampelnya setiap 60 detik. |
| Throughput - Cache tidak ditemukan | Project | Throughput yang tidak disajikan dari cache bucket mana pun, diambil sampelnya setiap 60 detik. |
Mengakses diagram
Diagram pemantauan mengambil data untuk masing-masing bucket atau untuk semua bucket dalam sebuah project. Tingkat hierarki resource yang dicakup oleh diagram menentukan tempat Anda dapat mengakses diagram tersebut.
Mengakses diagram tingkat bucket
- Di konsol Cloud de Confiance , buka halaman Buckets Cloud Storage.
Dalam daftar bucket, klik nama bucket yang ingin Anda lihat diagram pemantauannya.
Di halaman Bucket details, klik tab Observability.
Di menu navigasi, pilih Rapid Cache.
Diagram pemantauan ditampilkan.
Mengakses diagram level project
- Di konsol Cloud de Confiance , buka halaman Buckets Cloud Storage.
Di panel navigasi Cloud Storage, klik Monitoring.
Di panel menu, klik Rapid Cache.
Diagram pemantauan ditampilkan.
Menggunakan operasi yang berjalan lama
Jika berhasil dijalankan, operasi AnywhereCaches Create dan Update akan memulai operasi yang berjalan lama. Anda bisa mendapatkan dan mencantumkan operasi yang berjalan lama untuk melihat detail dan status operasi AnywhereCaches yang mendasarinya, atau membatalkan operasi yang berjalan lama untuk membatalkan operasi AnywhereCaches yang mendasarinya saat sedang berlangsung.
Untuk mengetahui petunjuk tentang cara menggunakan operasi yang berjalan lama untuk Rapid Cache, lihat Menggunakan operasi yang berjalan lama.
Contoh berikut menunjukkan operasi yang berjalan lama yang dimulai dari operasi AnywhereCaches Create:
done: false kind: storage#operation metadata: '@type': type.googleapis.com/google.storage.control.v2.CreateAnywhereCacheMetadata anywhereCacheId: us-central1-c zone: us-central1-c ttl: 172800s commonMetadata: createTime: '2023-12-14T20:52:00.032Z' progressPercent: -1 requestedCancellation: false type: create-anywhere-cache updateTime: '2023-12-14T20:52:00.032Z' name: projects/_/buckets/my-bucket/operations/AULf_KhQxxsWRSn56wv4jfmn3pOu_dKTz9FoYx6S0EzMw5ssR0cXIiorCvHRwqxZnQmWj9jnGpKb3Y6iCD3XM9KLc8EHBm7uig selfLink: https://www.googleapis.com/storage/v1/b/my-bucket/operations/AULf_KhQxxsWRSn56wv4jfmn3pOu_dKTz9FoYx6S0EzMw5ssR0cXIiorCvHRwqxZnQmWj9jnGpKb3Y6iCD3XM9KLc8EHBm7uig
Upaya coba lagi
API AnywhereCaches asinkron bersifat idempoten secara default. Artinya, Anda dapat mencoba kembali panggilan API AnywhereCaches asinkron dengan aman tanpa khawatir akan mengubah resource secara tidak sengaja.
Misalnya, Anda melakukan operasi AnywhereCaches Create untuk membuat
cache di us-central1-a, yang berhasil. Jika Anda melakukan operasi AnywhereCaches Create berikutnya menggunakan zona yang sama dan berhasil, permintaan tersebut akan menampilkan operasi yang berjalan lama yang sama dengan permintaan sebelumnya. Perhatikan bahwa perilaku ini hanya terjadi jika Anda menyertakan request_id sebagai bagian dari permintaan pembuatan cache. Jika request_id tidak disertakan, Anda akan mendapatkan error ANYWHERE_CACHE_ALREADY_EXISTS saat mencoba membuat cache yang sudah ada. Untuk mengetahui informasi tentang cara menyertakan request_id, lihat
Identifikasi permintaan.
Langkah berikutnya
Dapatkan rekomendasi tentang bucket dan zona yang akan dibuat cache-nya.