Nilai kunci point-in-time

Azure App Configuration mempertahankan catatan perubahan yang dibuat pada kunci-nilai. Catatan ini menyediakan garis waktu perubahan kunci-nilai. Anda dapat merekonstruksi riwayat kunci-nilai apa pun dan memberikan nilai sebelumnya kapan saja dalam periode riwayat utama (7 hari untuk penyimpanan gratis, atau 30 hari untuk penyimpanan tingkat Standar). Dengan menggunakan fitur ini, Anda dapat "melakukan perjalanan waktu" ke belakang dan mengambil kunci-nilai lama. Misalnya, Anda dapat memulihkan pengaturan konfigurasi yang digunakan sebelum penerapan terbaru untuk mengembalikan aplikasi ke konfigurasi sebelumnya.

Memulihkan nilai kunci

Anda dapat menggunakan portal Azure atau CLI untuk mengambil kunci-nilai sebelumnya.

Portal

1. Masuk ke portal Azure. Pilih Semua sumber daya, dan pilih instans penyimpanan App Configuration tempat nilai kunci Anda disimpan.

2. Di menu Operations, pilih Restore.

   

3. Pilih Tanggal: Pilih tanggal untuk memilih tanggal dan waktu yang ingin Anda kembalikan.

4. Klik di luar bidang tanggal dan waktu atau tekan Tab untuk memvalidasi pilihan Anda. Anda sekarang dapat melihat nilai kunci mana yang telah berubah antara tanggal dan waktu yang Anda pilih dan waktu saat ini. Langkah ini membantu Anda memahami kunci dan nilai apa yang sedang Anda persiapkan untuk kembali.

   

   Portal tersebut menampilkan tabel nilai kunci. Kolom pertama menyertakan simbol yang menunjukkan apa yang akan terjadi jika Anda memulihkan data pada tanggal dan waktu yang dipilih:

   • Tanda minus merah (–) berarti nilai kunci tidak ada pada tanggal dan waktu yang Anda pilih dan akan dihapus.
   • Tanda plus hijau (+) berarti nilai kunci ada pada tanggal dan waktu yang Anda pilih dan tidak ada sekarang. Jika Anda kembali ke tanggal dan waktu yang dipilih, tanggal dan waktu yang dipilih akan ditambahkan kembali ke konfigurasi Anda.
   • Tanda lingkaran oranye (•) berarti nilai kunci telah diubah sejak tanggal dan waktu yang Anda pilih. Kunci akan kembali ke nilai yang pernah dimilikinya pada tanggal dan waktu yang dipilih.

5. Pilih kotak centang di baris untuk memilih/membatalkan pilihan nilai kunci untuk mengambil tindakan. Ketika dipilih itu akan menampilkan perbedaan untuk nilai kunci antara tanggal dan waktu saat ini dan yang dipilih.

   

   Dalam contoh di atas, pratinjau tersebut menampilkan kunci TestApp:Pengaturan:BackgroundColor, yang saat ini memiliki nilai #FFF. Nilai ini akan dimodifikasi untuk #45288E jika kita melanjutkan dengan memulihkan data.

   Anda dapat memilih satu atau beberapa kotak centang dalam tabel untuk mengambil tindakan pada nilai kunci pilihan Anda. Anda juga dapat menggunakan kotak centang select-all di bagian paling atas daftar untuk memilih / membatalkan pilihan semua nilai kunci.

6. Pilih Restore untuk memulihkan nilai kunci yang dipilih ke data dan waktu yang dipilih.

   

Azure CLI

Gunakan Azure CLI seperti yang dijelaskan di bawah ini untuk mengambil dan memulihkan nilai kunci sebelumnya. Jika Anda tidak memiliki Azure CLI yang terinstal secara lokal, Anda dapat secara opsional menggunakan Azure Cloud Shell.

Di CLI, gunakan az appconfig revision list untuk melihat perubahan atau az appconfig kv restore untuk memulihkan nilai kunci, menambahkan parameter yang sesuai. Tentukan instans Azure App Configuration dengan memberikan nama toko (--name <app-config-store-name>) atau dengan menggunakan string koneksi (--connection-string <your-connection-string>). Batasi output dengan menentukan titik waktu tertentu (--datetime), label (--label) dan jumlah maksimum item yang akan dikembalikan (--top). dan dengan menentukan jumlah maksimum item yang akan dikembalikan (--top).

Ambil semua perubahan yang direkam ke kunci-nilai Anda.

az appconfig revision list --name <your-app-config-store-name>

Pulihkan semua nilai kunci ke titik waktu tertentu.

az appconfig kv restore --name <app-config-store-name> --datetime "2019-05-01T11:24:12Z"

Pulihkan untuk label apa pun yang dimulai dengan v1. ke titik waktu tertentu.

az appconfig kv restore --name <app-config-store-name> --label v1.* --datetime "2019-05-01T11:24:12Z"

Untuk contoh lebih lanjut dari perintah CLI dan parameter opsional untuk memulihkan nilai kunci, buka Azure CLI documentation.

Anda juga dapat mengakses riwayat nilai kunci tertentu. Fitur ini memungkinkan Anda untuk memeriksa nilai kunci tertentu pada titik waktu yang dipilih dan kembali ke nilai sebelumnya tanpa memperbarui nilai kunci lainnya.

Tampilan historis/Garis waktu dari nilai kunci

Tip

Metode ini nyaman jika Anda memiliki tidak lebih dari beberapa perubahan yang harus dilakukan, karena Configuration explorer hanya memungkinkan Anda membuat perubahan kunci demi kunci. Jika Anda perlu memulihkan beberapa nilai kunci sekaligus, gunakan menu Restore sebagai gantinya.

Portal

Anda juga dapat mengakses riwayat revisi nilai kunci tertentu di portal.

1. Di menu Operations, pilih Configuration explorer.

2. Pilih More actions untuk kunci yang ingin Anda jelajahi, lalu History

   

   Anda sekarang dapat melihat riwayat revisi untuk kunci yang dipilih dan informasi tentang perubahannya.

3. Pilih Restore untuk memulihkan kunci dan nilai ke titik waktu ini.

   

Azure CLI

Gunakan Azure CLI seperti yang dijelaskan di bawah ini untuk mengambil dan memulihkan satu nilai kunci. Jika Anda tidak memiliki Azure CLI yang terinstal secara lokal, Anda dapat secara opsional menggunakan Azure Cloud Shell.

Di CLI, gunakan az appconfig revision list untuk melihat perubahan pada nilai kunci atau gunakan az appconfig kv restore untuk memulihkan nilai kunci, menambahkan parameter yang sesuai. Tentukan instans Azure App Configuration dengan memberikan nama toko (--name <app-config-store-name>) atau dengan menggunakan string koneksi (--connection-string <your-connection-string>). Batasi output dengan menentukan kunci tertentu (--key). Secara opsional, tentukan label (--label), titik waktu (--datetime) dan jumlah maksimum item yang akan dikembalikan (--top).

Daftar riwayat revisi untuk "warna" kunci dengan label apa pun.

az appconfig revision list --name <app-config-store-name> --key color

Daftar riwayat revisi nilai kunci tertentu dengan label.

az appconfig revision list --name <app-config-store-name> --key color --label test

Daftar riwayat revisi nilai kunci dengan beberapa label.

az appconfig revision list --name <app-config-store-name> --key color --label test,prod,\0

Ambil semua perubahan yang direkam untuk kunci color pada titik-waktu-tertentu yang spesifik.

az appconfig revision list --name <app-config-store-name> --key color --datetime "2019-05-01T11:24:12Z" 

Ambil 10 perubahan terakhir yang direkam untuk kunci color pada titik waktu tertentu.

az appconfig revision list --name <app-config-store-name> --key color --top 10 --datetime "2019-05-01T11:24:12Z" 

Untuk contoh dan parameter opsional lainnya, buka dokumentasi Azure CLI.

Langkah berikutnya

Buat aplikasi web ASP.NET Core