Mengelola dan menggunakan rekam jepret

Dalam artikel ini, pelajari cara membuat, menggunakan, dan mengelola rekam jepret di Azure App Configuration. Rekam jepret adalah sekumpulan pengaturan App Configuration yang disimpan dalam keadaan tidak dapat diubah.

Prasyarat

• Penyimpanan App Configuration. Buat toko.
• Peran "DataOwner" di penyimpanan App Configuration. Detail tentang peran dan izin yang diperlukan untuk rekam jepret

Menambahkan nilai kunci ke penyimpanan Konfigurasi aplikasi

Di penyimpanan App Configuration Anda, buka Penjelajah Konfigurasi Operasi>dan tambahkan nilai kunci berikut. Biarkan Tipe Konten dengan nilai defaultnya. Untuk informasi selengkapnya tentang cara menambahkan nilai kunci ke penyimpanan menggunakan portal Azure atau CLI, buka Membuat nilai kunci.

Membuat rekam jepret

Di bawah Rekam Jepret Operasi>, pilih Buat rekam jepret baru.

1. Masukkan nama rekam jepret dan secara opsional juga tambahkan Tag.

2. Di bawah Pilih jenis komposisi, pertahankan kunci nilai default (default).

   • Dengan jenis Komposisi kunci, jika penyimpanan Anda memiliki kunci yang identik dengan label yang berbeda, hanya nilai kunci yang ditentukan dalam filter terakhir yang berlaku yang disertakan dalam rekam jepret. Nilai kunci yang identik dengan label lain dibiarkan keluar dari rekam jepret.
   • Dengan jenis komposisi Key-Label, jika penyimpanan Anda memiliki kunci yang identik dengan label yang berbeda, semua nilai kunci dengan kunci yang identik tetapi label yang berbeda disertakan dalam rekam jepret tergantung pada filter yang ditentukan.

3. Pilih Tambahkan filter untuk memilih nilai kunci untuk rekam jepret Anda. Pemfilteran dilakukan dengan memilih filter: Sama dengan, Dimulai dengan, Salah Satu dari dan Semua untuk kunci dan untuk label. Anda dapat memasukkan antara satu dan tiga filter.

   1. Tambahkan filter pertama:
      • Di bawah Kunci, pilih Mulai dengan dan masukkan app1
      • Di bawah Label, pilih Sama dengan dan pilih label2 dari menu drop-down.
   2. Tambahkan filter kedua:
      • Di bawah Kunci, pilih Mulai dengan dan masukkan app1
      • Di bawah Label, pilih Sama dengan dan pilih label1 dari menu drop-down.

4. Jika Anda mengarsipkan rekam jepret, secara default, rekam jepret akan disimpan selama 30 hari setelah pengarsipan. Secara opsional, di bawah Opsi pemulihan, kurangi jumlah hari retensi rekam jepret akan tersedia setelah pengarsipan.

   Catatan

   Durasi periode retensi tidak dapat diperbarui setelah rekam jepret dibuat.

5. Pilih Buat untuk menghasilkan rekam jepret. Dalam contoh ini, rekam jepret yang dibuat memiliki jenis komposisi Kunci dan filter di bawah ini:

   • Kunci yang dimulai dengan app1, dengan label2 label
   • Kunci yang dimulai dengan app1, dengan label label1.

   

6. Periksa tabel untuk memahami nilai kunci mana dari penyimpanan konfigurasi yang berakhiran rekam jepret berdasarkan parameter yang disediakan.

   Tombol	Nilai	Label	Disertakan dalam rekam jepret
   app2/bgcolor	Abu-abu Muda	label2	Tidak: tidak dimulai dengan app1.
   app1/color	Hitam	Tidak ada label	Tidak: tidak memiliki label2 atau label1.
   app1/color	Biru	label1	Ya: Memiliki label yang tepat label1 dari filter terakhir yang berlaku.
   app1/color	Hijau	label2	Tidak: Kunci yang sama dengan label label1 dipilih oleh filter kedua mengambil alih yang satu ini meskipun memiliki label yang dipilih, label2.
   app1/color	Kuning	label3	Tidak: tidak memiliki label2 atau label1.
   app1/message	Halo	label1	Ya: Memiliki label yang tepat label1 dari filter terakhir yang berlaku.
   app1/message	Hai!	label2	Tidak: Kunci yang sama dengan label label1 dipilih oleh filter kedua mengambil alih yang satu ini meskipun memiliki label yang dipilih, label2.
   app2/message	Selamat pagi!	label1	Tidak: tidak dimulai dengan app1.

Membuat sampel rekam jepret

Untuk membuat sampel rekam jepret dan memeriksa cara kerja fitur rekam jepret, gunakan kotak pasir rekam jepret. Kotak pasir ini berisi data sampel yang dapat Anda mainkan untuk lebih memahami cara kerja jenis komposisi dan filter rekam jepret.

1. Di Snapshot>Operasi>Rekam jepret Aktif, pilih Uji di kotak pasir.
2. Tinjau data sampel dan berlatih membuat rekam jepret dengan mengisi formulir dengan jenis komposisi dan satu atau beberapa filter.
3. Pilih Buat untuk menghasilkan rekam jepret sampel.
4. Lihat hasil rekam jepret yang dihasilkan di bawah Rekam jepret sampel yang dihasilkan. Rekam jepret sampel menampilkan semua kunci yang disertakan dalam rekam jepret sampel, sesuai dengan pilihan Anda.

Menggunakan rekam jepret

Anda dapat memilih sejumlah rekam jepret untuk konfigurasi aplikasi. Memilih rekam jepret menambahkan semua nilai kuncinya. Setelah ditambahkan ke konfigurasi, nilai kunci dari rekam jepret diperlakukan sama dengan nilai kunci lainnya.

Jika Anda memiliki aplikasi menggunakan Azure App Configuration, Anda dapat memperbaruinya dengan kode sampel berikut untuk menggunakan rekam jepret. Anda hanya perlu memberikan nama rekam jepret, yang peka huruf besar/kecil.

configurationBuilder.AddAzureAppConfiguration(options =>
{
    options.Connect(Environment.GetEnvironmentVariable("ConnectionString"));

    // Select an existing snapshot by name. This will add all of the key-values from the snapshot to this application's configuration.
    options.SelectSnapshot("SnapshotName");
    
    // Other changes to options
});

spring:
  cloud:
    azure:
      appconfiguration:
        stores:
         -
           endpoint: <your-endpoint>
           selects:
             -
              snapshot-name: <name-of-your-snapshot>
           trim-key-prefix: 
             - <prefix-to-trim>

Mengelola rekam jepret aktif

Halaman di bawah Rekam Jepret Operasi>menampilkan dua tab: Rekam jepret aktif dan Rekam jepret yang Diarsipkan. Pilih Rekam jepret aktif untuk melihat daftar semua rekam jepret aktif di penyimpanan App Configuration.

Menampilkan rekam jepret yang sudah ada

Di tab Rekam jepret aktif, pilih elipsis ... di sebelah kanan rekam jepret yang ada dan pilih Tampilkan untuk melihat rekam jepret. Tindakan ini membuka halaman detail Rekam Jepret yang menampilkan pengaturan rekam jepret dan nilai kunci yang disertakan dalam rekam jepret.

Mengarsipkan rekam jepret

Di tab Rekam jepret Aktif, pilih elipsis ... di sebelah kanan rekam jepret yang ada dan pilih Arsipkan untuk mengarsipkan rekam jepret. Konfirmasi arsip dengan memilih Ya atau batalkan dengan Tidak. Setelah rekam jepret diarsipkan, pemberitahuan tampaknya mengonfirmasi operasi dan daftar rekam jepret aktif diperbarui.

Mengelola rekam jepret yang diarsipkan

Buka Rekam jepret Arsip Snapshot>Operasi>untuk melihat daftar semua rekam jepret yang diarsipkan di penyimpanan App Configuration. Rekam jepret yang diarsipkan tetap dapat diakses untuk periode retensi yang dipilih selama pembuatannya.

Lihat rekam jepret yang diarsipkan

Tampilan terperinci rekam jepret juga tersedia dalam status arsip. Di tab Rekam jepret yang diarsipkan, pilih elipsis ... di sebelah kanan rekam jepret yang ada dan pilih Tampilkan untuk melihat rekam jepret. Tindakan ini membuka halaman detail Rekam Jepret yang menampilkan pengaturan rekam jepret dan nilai kunci yang disertakan dalam rekam jepret.

Memulihkan rekam jepret yang diarsipkan

Di tab Rekam jepret yang diarsipkan, pilih elipsis ... di sebelah kanan rekam jepret yang diarsipkan dan pilih Pulihkan untuk memulihkan rekam jepret. Setelah rekam jepret dipulihkan, pemberitahuan tampaknya mengonfirmasi operasi dan daftar rekam jepret yang diarsipkan diperbarui.

Langkah berikutnya