Rekam jepret
Rekam jepret adalah subset bernama yang tidak dapat diubah dari nilai kunci penyimpanan App Configuration. Nilai kunci yang membentuk rekam jepret dipilih selama waktu pembuatan melalui penggunaan filter kunci dan label. Setelah rekam jepret dibuat, nilai kunci di dalamnya dijamin tidak berubah.
Gambaran umum singkat tersedia dalam video ini, menyoroti tiga alasan rekam jepret dapat membantu Anda.
Menyebarkan dengan aman dengan rekam jepret
Rekam jepret dirancang untuk menyebarkan perubahan konfigurasi dengan aman. Menyebarkan perubahan konfigurasi yang salah ke lingkungan yang sedang berjalan dapat menyebabkan masalah seperti gangguan layanan dan kehilangan data. Untuk menghindari masalah tersebut, penting untuk dapat memeriksa perubahan konfigurasi sebelum pindah ke lingkungan produksi. Jika masalah seperti itu terjadi, penting untuk dapat mengembalikan perubahan konfigurasi yang salah untuk memulihkan layanan. Rekam jepret dibuat untuk mengelola skenario ini.
Perubahan konfigurasi harus disebarkan dengan cara yang terkontrol dan konsisten. Pengembang dapat menggunakan rekam jepret untuk melakukan peluncuran terkontrol. Satu-satunya perubahan yang diperlukan dalam aplikasi untuk memulai peluncuran terkontrol adalah memperbarui nama rekam jepret yang dirujuk aplikasi. Saat aplikasi bergerak ke produksi, ada jaminan bahwa konfigurasi dalam rekam jepret yang direferensikan tetap tidak berubah. Jaminan ini terhadap setiap perubahan rekam jepret melindungi dari pengaturan yang tidak terduga yang masuk ke produksi. Kekekalan dan kemudahan referensi rekam jepret memudahkan untuk memastikan bahwa serangkaian perubahan konfigurasi yang tepat diluncurkan dengan aman.
Skenario untuk menggunakan rekam jepret
Peluncuran terkontrol: Rekam jepret sangat cocok untuk mendukung peluncuran terkontrol karena sifatnya yang tidak dapat diubah. Ketika pengembang menggunakan rekam jepret untuk konfigurasi, mereka dapat yakin bahwa konfigurasi tetap tidak berubah saat rilis berlangsung melalui fase peluncuran yang berbeda.
Konfigurasi Last Known Good (LKG): Rekam jepret dapat digunakan untuk mendukung praktik penyebaran yang aman untuk Konfigurasi. Dengan rekam jepret, pengembang dapat memastikan bahwa konfigurasi Last known Good (LKG) tersedia untuk pemutaran kembali jika ada masalah selama penyebaran.
Penerapan versi konfigurasi: Rekam jepret dapat digunakan untuk membuat riwayat versi pengaturan konfigurasi untuk disinkronkan dengan versi rilis. Pengaturan yang diambil di setiap rekam jepret dapat dibandingkan dengan mengidentifikasi perubahan antar versi.
Audit: Rekam jepret dapat digunakan untuk tujuan audit dan kepatuhan. Pengembang dapat mempertahankan catatan perubahan konfigurasi di antara rilis dengan menggunakan rekam jepret untuk rilis.
Lingkungan pengujian dan Penahapan: Rekam jepret dapat digunakan untuk membuat lingkungan pengujian dan penahapan yang konsisten. Pengembang dapat memastikan bahwa konfigurasi yang sama digunakan di berbagai lingkungan, dengan menggunakan rekam jepret yang sama, yang dapat membantu penelusuran kesalahan dan pengujian.
Komposisi Konfigurasi Klien yang Disederhanakan: Biasanya, klien App Configuration memerlukan subset nilai kunci dari instans App Configuration. Untuk mendapatkan kumpulan nilai kunci yang diperlukan, mereka harus memiliki logika kueri yang ditulis dalam kode. Karena dukungan Snapshot menyediakan filter selama waktu pembuatan, ini membantu menyederhanakan komposisi klien karena klien sekarang dapat merujuk ke kumpulan nilai kunci yang mereka butuhkan berdasarkan nama.
Operasi rekam jepret
Karena rekam jepret adalah entitas yang tidak dapat diubah, rekam jepret hanya dapat dibuat dan diarsipkan. Penghapusan, penghapusan menyeluruh, atau pengeditan tidak dimungkinkan.
Buat rekam jepret: Rekam jepret dapat dibuat dengan menentukan filter kunci dan label untuk mengambil nilai kunci yang diperlukan dari instans App Configuration. Nilai kunci yang difilter disimpan sebagai rekam jepret dengan nama yang disediakan selama pembuatan.
Rekam jepret arsip: Pengarsipan rekam jepret menempatkannya dalam keadaan diarsipkan. Saat rekam jepret diarsipkan, rekam jepret masih berfungsi penuh. Saat rekam jepret diarsipkan, waktu kedaluwarsa diatur berdasarkan periode retensi yang dikonfigurasi selama pembuatan rekam jepret. Jika rekam jepret tetap dalam status diarsipkan hingga waktu kedaluwarsa, rekam jepret secara otomatis menghilang dari sistem ketika waktu kedaluwarsa berlalu. Arsip digunakan untuk phasing out snapshot yang tidak lagi digunakan.
Memulihkan rekam jepret: Memulihkan rekam jepret mengembalikannya dalam keadaan aktif. Pada titik ini, rekam jepret tidak lagi tunduk pada kedaluwarsa berdasarkan periode retensi yang dikonfigurasi. Pemulihan hanya dimungkinkan dalam periode retensi setelah pengarsipan.
Catatan
Periode retensi hanya dapat diatur selama pembuatan rekam jepret. Nilai default untuk periode retensi adalah 30 hari untuk penyimpanan Standar dan 7 hari untuk penyimpanan Gratis.
Persyaratan untuk operasi rekam jepret
Bagian berikut merinci izin yang diperlukan untuk melakukan operasi terkait rekam jepret dengan ID Microsoft Entra dan autentikasi HMAC.
Membuat rekam jepret
Untuk membuat rekam jepret di penyimpanan menggunakan autentikasi Microsoft Entra, izin berikut diperlukan. Peran Pemilik Data App Configuration sudah memiliki izin ini.
Microsoft.AppConfiguration/configurationStores/keyvalues/readMicrosoft.AppConfiguration/configurationStores/snapshots/write
Untuk membuat rekam jepret menggunakan autentikasi HMAC, kunci akses baca-tulis harus digunakan.
Mengarsipkan dan memulihkan rekam jepret
Untuk mengarsipkan dan/atau memulihkan rekam jepret menggunakan autentikasi Microsoft Entra, izin berikut diperlukan. Peran Pemilik Data App Configuration sudah memiliki izin ini.
Microsoft.AppConfiguration/configurationStores/snapshots/archive/action
Untuk mengarsipkan dan/atau memulihkan rekam jepret menggunakan autentikasi HMAC, kunci akses baca-tulis harus digunakan.
Membaca dan mencantumkan rekam jepret
Untuk mencantumkan semua rekam jepret, atau mendapatkan semua nilai kunci dalam rekam jepret individual dengan nama izin berikut diperlukan untuk penyimpanan yang menggunakan autentikasi Microsoft Entra. Peran Pemilik Data dan Pembaca Data bawaan sudah memiliki izin ini.
Microsoft.AppConfiguration/configurationStores/snapshots/read
Untuk penyimpanan yang menggunakan autentikasi HMAC, operasi "baca rekam jepret" (untuk membaca nilai kunci dari rekam jepret) dan operasi "daftar rekam jepret" dapat dilakukan menggunakan kunci akses baca-tulis atau kunci akses baca-saja.
Pertimbangan dan batas penagihan
App Configuration memiliki dua tingkatan, Gratis dan Standar. Periksa detail berikut untuk kuota rekam jepret di setiap tingkatan.
Tingkat gratis: Tingkat ini memiliki kuota penyimpanan rekam jepret sebesar 10 MB. Seseorang dapat membuat rekam jepret sebanyak mungkin selama ukuran penyimpanan total semua rekam jepret aktif dan diarsipkan kurang dari 10 MB.
Tingkat standar: Tingkat ini memiliki kuota penyimpanan rekam jepret sebesar 1 GB. Seseorang dapat membuat rekam jepret sebanyak mungkin selama ukuran penyimpanan total semua rekam jepret aktif dan diarsipkan kurang dari 1 GB.
Ukuran maksimum untuk rekam jepret adalah 1 MB.