Mengimpor atau mengekspor data konfigurasi

Azure App Configuration mendukung operasi impor dan ekspor data. Gunakan operasi ini untuk bekerja dengan data konfigurasi secara massal dan bertukar data antara penyimpanan App Configuration dan proyek kode Anda. Misalnya, Anda dapat menyiapkan satu penyimpanan App Configuration untuk pengujian dan satu lagi untuk produksi. Anda dapat menyalin pengaturan aplikasi di antaranya sehingga Anda tidak perlu memasukkan data dua kali.

Artikel ini menyediakan panduan untuk mengimpor dan mengekspor data menggunakan portal Microsoft Azure atau Azure CLI. Jika Anda telah mengadopsi Konfigurasi sebagai Kode dan mengelola konfigurasi Anda di GitHub atau Azure DevOps, Anda dapat menyiapkan impor file konfigurasi yang sedang berlangsung menggunakan GitHub Actions atau menggunakan Tugas Impor Alur Azure.

Mengimpor data

Mengimpor data konfigurasi ke dalam penyimpanan App Configuration dari sumber yang ada. Gunakan fungsi impor untuk memigrasikan data ke penyimpanan App Configuration atau mengagregasi data dari beberapa sumber.

Panduan ini memperlihatkan cara mengimpor data App Configuration:

• dari file konfigurasi di JSON, YAML, atau Properti
• dari penyimpanan Konfigurasi Aplikasi
• dari Azure App Service
• dari Azure Kubernetes Service ConfigMaps

Mengimpor data dari file konfigurasi

Ikuti langkah-langkah di bawah ini untuk mengimpor nilai kunci dari file.

Portal

Dari portal Microsoft Azure, ikuti langkah-langkah berikut:

1. Arahkan ke toko App Configuration Anda, lalu pilih Impor/ekspor dari menu Operasi.

   

2. Tombol impor radio dipilih secara default. Di bawah Jenis sumber, pilih File konfigurasi.

3. Isi formulir dengan parameter berikut:

   Pengaturan	Description	Example
   Jenis file	Pilih jenis file untuk diimpor: YAML, Properti, atau JSON.	JSON

4. Klik tombol Telusuri , dan pilih file yang akan diimpor.

5. Isi bagian formulir berikutnya:

   Pengaturan	Description	Example
   Profil konten file	Pilih profil konten: Default atau KVSet. Profil konten file Default mengacu pada skema file konfigurasi konvensional yang diadopsi secara luas oleh kerangka kerja atau sistem pemrograman yang ada, mendukung format file JSON, YAML, atau Properti. Profil konten file KVSet mengacu pada skema file yang berisi semua properti nilai kunci App Configuration, termasuk kunci, nilai, label, jenis konten, dan tag.	Default
   Mode impor	Mode impor digunakan untuk menentukan apakah akan mengabaikan nilai kunci yang identik. Dengan opsi Abaikan kecocokan , nilai kunci apa pun di penyimpanan yang sama dengan yang ada di file konfigurasi diabaikan. Dengan opsi Semua , semua nilai kunci dalam file konfigurasi diperbarui.	Abaikan kecocokan
   Mengecualikan bendera fitur	Jika dicentang, bendera fitur tidak akan diimpor.	Tidak Dicentang
   Ketat	Jika kotak dicentang, nilai kunci apa pun di penyimpanan dengan awalan dan label yang ditentukan yang tidak disertakan dalam file konfigurasi akan dihapus saat profil Konten file diatur ke Default. Saat profil Konten file diatur ke KVSet, nilai kunci apa pun di penyimpanan yang tidak disertakan dalam file konfigurasi akan dihapus. Jika kotak tidak dicentang, tidak ada nilai kunci di penyimpanan yang akan dihapus.	Tidak Dicentang
   Pemisah	Pemisah adalah pemisah yang digunakan untuk meratakan file JSON atau YAML ke dalam nilai kunci. Ini akan diabaikan untuk file properti dan penanda fitur. Nilai yang didukung termasuk tanpa pemisah, titik (.), koma (,), titik koma (;), tanda hubung (-), garis bawah (_), garis bawah ganda (__), garis miring (/), dan titik dua (:).	:
   Kedalaman	Optional. Kedalaman proses meratakan file JSON atau YAML menjadi pasangan kunci-dan-nilai. Secara bawaan, file akan diratakan ke tingkat terdalam jika pemisah dipilih. Pengaturan ini tidak berlaku untuk file properti atau bendera fitur.
   Tambahkan awalan	Optional. Jika ditentukan, awalan akan ditambahkan ke nama kunci semua nilai kunci yang diimpor.	TestApp:
   Tambahkan label	Optional. Jika ditentukan, label yang disediakan akan ditetapkan ke semua nilai kunci yang diimpor.	prod
   Tambahkan tipe isi	Optional. Jika ditentukan, jenis konten yang disediakan akan ditambahkan ke semua nilai kunci yang diimpor.	JSON (aplikasi/json)
   Menambahkan tag	Optional. Jika ditentukan, tag yang disediakan akan ditambahkan ke semua nilai kunci yang diimpor.	{tag: tag1}

6. Pilih Terapkan untuk melanjutkan impor.

Anda telah berhasil mengimpor nilai kunci dari file JSON. Nama-nama kunci diratakan menggunakan pemisah : dan diawali dengan TestApp:. Semua nilai kunci yang diimpor diberi label sebagai prod, dengan tipe konten application/json, dan ditandai dengan tag: tag1.

Azure CLI

Dari Azure CLI, ikuti langkah-langkah di bawah ini. Jika Anda tidak memiliki Azure CLI yang terinstal secara lokal, Anda dapat secara opsional menggunakan Azure Cloud Shell.

1. Masukkan perintah az appconfig kv import impor dan tambahkan parameter berikut:

   Pengaturan	Description	Example
   --name	Masukkan nama penyimpanan App Configuration yang ingin Anda impor datanya.	my-app-config-store
   --source	Masukkan file untuk menunjukkan bahwa Anda mengimpor data konfigurasi aplikasi dari file.	file
   --path	Masukkan jalur lokal ke file yang berisi data yang ingin Anda impor.	C:/Users/john/Downloads/data.json
   --format	Masukkan yaml, properti, atau json untuk menunjukkan format file yang Anda impor.	json

2. Secara opsional juga tambahkan parameter berikut:

   Pengaturan	Description	Example
   --separator	Optional. Pemisah adalah pembatas untuk memformat pasangan kunci menjadi JSON/YAML. Diperlukan untuk mengekspor struktur hierarkis dan akan diabaikan untuk file properti dan bendera fitur. Pilih salah satu opsi berikut: ., , ,, :, ;, /-, , _. —	;
   --prefix	Optional. Awalan kunci adalah bagian awal dari kunci. Awalan dapat digunakan untuk mengelola grup nilai kunci di penyimpanan konfigurasi. Awalan ini akan ditambahkan ke bagian depan properti "kunci" dari setiap nilai kunci yang diimpor.	TestApp:
   --label	Optional. Masukkan label yang akan diberikan pada pasangan kunci-nilai yang diimpor.	prod
   --content-type	Optional. Masukkan appconfig/kvset atau application/json untuk menyatakan bahwa konten yang diimpor terdiri dari referensi Key Vault atau file JSON.	application/json

   Contoh: impor semua nilai kunci dan bendera fitur dari file JSON, terapkan label "prod", dan tambahkan awalan "TestApp". Tambahkan jenis konten "application/json".

   az appconfig kv import --name my-app-config-store --source file --path D:/abc.json --format json --separator ; --prefix TestApp: --label prod --content-type application/json
   

3. Baris perintah menampilkan daftar perubahan yang akan datang. Konfirmasi impor dengan memilih y.

   

Anda mengimpor nilai kunci dari file JSON, dan menetapkan label "prod" dan awalan "TestApp:". Pemisah ";" digunakan dan semua nilai kunci yang Anda impor memiliki tipe konten yang ditetapkan sebagai "JSON".

Untuk parameter dan contoh opsional lainnya, buka az appconfig kv import.

Mengimpor data dari App Configuration store

Anda dapat mengimpor nilai dari satu penyimpanan App Configuration ke penyimpanan App Configuration lain, atau Anda dapat mengimpor nilai dari satu penyimpanan App Configuration ke penyimpanan App Configuration yang sama untuk menduplikasi nilainya dan menerapkan parameter yang berbeda, seperti label baru atau jenis konten.

Ikuti langkah-langkah di bawah ini untuk mengimpor nilai kunci dan bendera fitur dari penyimpanan Azure App Configuration.

Portal

Dari portal Microsoft Azure, ikuti langkah-langkah berikut:

1. Arahkan ke toko App Configuration Anda, lalu pilih Impor/ekspor dari menu Operasi.

   

2. Tombol impor radio dipilih secara default. Di bawah Jenis sumber, pilih App Configuration.

3. Pilih penyimpanan App Configuration untuk mengimpor data, dan isi formulir dengan parameter berikut:

   Pengaturan	Description	Example
   Subscription	Langganan Anda saat ini dipilih secara default.	my-subscription
   Grup sumber daya	Pilih kelompok sumber daya yang berisi penyimpanan App Configuration dengan konfigurasi untuk diimpor. Grup sumber daya Anda saat ini dipilih secara default.	my-resource-group
   Sumber Daya	Pilih store App Configuration yang berisi konfigurasi yang ingin Anda impor.	my-other-app-config-store

4. Isi bagian formulir berikutnya:

   Pengaturan	Description	Example
   Mode pemilihan	Pilih apakah akan mengimpor dari nilai kunci reguler, yang merupakan opsi default, atau dari rekam jepret.	Default
   Filter utama	Digunakan untuk memfilter nilai kunci berdasarkan nama kunci untuk impor. Jika tidak ada kunci yang ditentukan, semua kunci memenuhi syarat.	Dimulai dengan pengujian
   Pada waktu tertentu	Optional. Isi bidang ini untuk mengimpor nilai kunci dari titik waktu tertentu di penyimpanan konfigurasi yang dipilih. Jika dibiarkan kosong, nilai tersebut default ke titik waktu saat ini dari nilai kunci.	28/07/2022 12:00:00 AM
   Dari label	Pilih satu atau beberapa label untuk mengimpor nilai kunci yang terkait dengan label tersebut. Jika tidak ada label yang dipilih, semua label memenuhi syarat.	prod
   Mengecualikan bendera fitur	Jika dicentang, bendera fitur tidak akan diimpor.	Tidak Dicentang
   Tambahkan awalan	Optional. Jika ditentukan, awalan akan ditambahkan ke nama kunci semua nilai kunci yang diimpor.	TestApp:
   Menimpa label	Optional. Secara default, label asli dari nilai kunci sumber dipertahankan. Untuk mengambil alihnya, centang kotak dan masukkan label baru untuk nilai kunci yang diimpor.	baru
   Mengesampingkan tipe konten	Optional. Secara default, jenis konten asli dari nilai kunci sumber dipertahankan. Untuk mengambil alihnya, centang kotak dan masukkan tipe konten baru untuk nilai kunci yang diimpor. Perhatikan bahwa jenis konten flag fitur tidak dapat diubah.	JSON (aplikasi/json)

5. Pilih Terapkan untuk melanjutkan impor.

Anda mengimpor nilai kunci dari penyimpanan App Configuration per 28 Januari 2021, pukul 12.00, dengan nama kunci yang dimulai dengan test dan label prod. Nama kunci diawali dengan TestApp:. Semua nilai kunci yang diimpor diberi label new dan jenis application/jsonkonten .

Azure CLI

Dari Azure CLI, ikuti langkah-langkah di bawah ini. Jika Anda tidak memiliki Azure CLI yang terinstal secara lokal, Anda dapat secara opsional menggunakan Azure Cloud Shell.

1. Masukkan perintah az appconfig kv import impor dan masukkan parameter berikut:

   Pengaturan	Description	Example
   --name	Masukkan nama penyimpanan App Configuration tempat Anda ingin mengimpor data	my-app-config-store
   --source	Masukkan appconfig untuk menandakan bahwa Anda mengimpor data dari penyimpanan App Configuration.	appconfig
   --src-name	Masukkan nama penyimpanan App Configuration yang ingin Anda impor datanya.	my-source-app-config
   --src-label	Batasi impor Anda ke nilai kunci dengan label tertentu. Jika Anda tidak menggunakan parameter ini, hanya nilai kunci dengan label null yang akan diimpor. Mendukung tanda bintang sebagai filter: masukkan * untuk semua label; abc* untuk semua label dengan abc sebagai awalan.	prod

2. Secara opsional tambahkan parameter berikut:

   Pengaturan	Description	Example
   --label	Optional. Masukkan label yang akan diberikan pada pasangan kunci-nilai yang diimpor.	new
   --content-type	Optional. Masukkan appconfig/kvset atau application/json untuk menyatakan bahwa konten yang diimpor terdiri dari referensi Key Vault atau file JSON. Tipe konten hanya dapat diganti untuk nilai kunci yang diimpor. Jenis konten default untuk bendera fitur adalah "application/vnd.microsoft.appconfig.ff+json; charset=utf-8' secara default dan tidak diperbarui oleh parameter ini.	application/json

   Contoh: impor nilai kunci dan bendera fitur dengan label "prod" dari App Configuration lain, dan tetapkan label "baru". Tambahkan jenis konten "application/json".

   az appconfig kv import --name my-app-config-store --source appconfig --src-name my-source-app-config --src-label prod --label new --content-type application/json
   

3. Baris perintah menampilkan daftar perubahan yang akan datang. Konfirmasi impor dengan memilih y.

   

Anda mengimpor nilai kunci dengan label "prod" dari penyimpanan App Configuration, dan menetapkan label "baru". Semua nilai kunci yang Anda impor memiliki jenis konten yang ditetapkan sebagai "JSON".

Untuk parameter dan contoh opsional lainnya, buka az appconfig kv import.

Mengimpor data dari Azure App Service

Ikuti langkah-langkah di bawah ini untuk mengimpor nilai kunci dari Azure App Service.

Nota

App Service saat ini tidak mendukung bendera fitur. Semua bendera fitur yang diimpor ke App Service dikonversi ke nilai kunci secara otomatis. Sumber daya App Service Anda hanya dapat berisi nilai kunci.

Portal

Dari portal Microsoft Azure:

1. Arahkan ke toko App Configuration Anda, lalu pilih Impor/ekspor dari menu Operasi.

   

2. Tombol impor radio dipilih secara default. Di bawah Jenis sumber, pilih App Services.

3. Pilih penyimpanan App Configuration untuk mengimpor data, dan isi formulir dengan parameter berikut:

   Pengaturan	Description	Example
   Subscription	Langganan Anda saat ini dipilih secara default.	my-subscription
   Grup sumber daya	Pilih grup sumber daya yang berisi App Service dengan konfigurasi untuk diimpor.	my-resource-group
   Sumber Daya	Pilih App Service yang berisi konfigurasi yang ingin Anda impor.	my-app-service

4. Isi bagian formulir berikutnya:

   Pengaturan	Description	Example
   Memperbarui pengaturan untuk merujuk	Jika dicentang, pengaturan aplikasi di App Service akan diperbarui ke referensi App Configuration untuk nilai kunci yang diimpor. Ini memungkinkan Anda mengelola pengaturan aplikasi di App Configuration ke depannya. App Service Anda akan secara otomatis menarik nilai saat ini dari App Configuration. Untuk mempelajari selengkapnya, lihat Menggunakan referensi App Configuration untuk App Service dan Azure Functions.	Diperiksa
   Tambahkan awalan	Optional. Jika ditentukan, awalan akan ditambahkan ke nama kunci semua nilai kunci yang diimpor.	TestApp:
   Tambahkan label	Optional. Jika ditentukan, label yang disediakan akan ditetapkan ke semua nilai kunci yang diimpor.	prod
   Tambahkan tipe isi	Optional. Jika ditentukan, jenis konten yang disediakan akan ditambahkan ke semua nilai kunci yang diimpor.	JSON (aplikasi/json)

5. Pilih Terapkan untuk melanjutkan impor.

Anda mengimpor semua pengaturan aplikasi dari App Service sebagai nilai kunci, dan menetapkan label prod dan awalan TestApp:. Semua nilai kunci yang Anda impor memiliki tipe konten yang ditetapkan sebagai application/json.

Azure CLI

Dari Azure CLI, ikuti langkah-langkah di bawah ini. Jika Anda tidak memiliki Azure CLI yang terinstal secara lokal, Anda dapat secara opsional menggunakan Azure Cloud Shell.

1. Masukkan perintah az appconfig kv import impor dan tambahkan parameter berikut:

   Pengaturan	Description	Example
   --name	Masukkan nama penyimpanan App Configuration yang ingin Anda impor datanya.	my-app-config-store
   --source	Masukkan appservice untuk menunjukkan bahwa Anda mengimpor data konfigurasi aplikasi dari Azure App Service.	appservice
   --appservice-account	Masukkan ID ARM App Service atau gunakan nama App Service, jika berada di grup langganan dan sumber daya yang sama dengan App Configuration.	/subscriptions/123/resourceGroups/my-resource-group/providers/Microsoft.Web/sites/my-app-service atau my-app-service

2. Secara opsional juga tambahkan parameter berikut:

   Pengaturan	Description	Example
   --prefix	Optional. Awalan kunci adalah bagian awal dari properti "kunci" nilai kunci. Awalan dapat digunakan untuk mengelola grup nilai kunci di penyimpanan konfigurasi. Awalan ini akan ditambahkan ke bagian depan properti "kunci" dari setiap nilai kunci yang diimpor.	TestApp:
   --label	Optional. Masukkan label yang akan diberikan pada pasangan kunci-nilai yang diimpor. Jika Anda tidak menentukan label, label null akan ditetapkan ke nilai kunci Anda.	prod
   --content-type	Optional. Masukkan appconfig/kvset atau application/json untuk menyatakan bahwa konten yang diimpor terdiri dari referensi Key Vault atau file JSON.	application/json

   Untuk mendapatkan nilai untuk --appservice-account, gunakan perintah az webapp show --resource-group <resource-group> --name <resource-name>.

   Contoh: impor semua pengaturan aplikasi dari App Service Anda sebagai nilai kunci dengan label "prod", ke penyimpanan App Configuration Anda, dan tambahkan awalan "TestApp:".

   az appconfig kv import --name my-app-config-store --source appservice --appservice-account /subscriptions/123/resourceGroups/my-resource-group/providers/Microsoft.Web/sites/my-app-service --label prod --prefix TestApp:
   

3. Baris perintah menampilkan daftar perubahan yang akan datang. Konfirmasi impor dengan memilih y.

   

Anda mengimpor semua pengaturan aplikasi dari App Service Anda sebagai nilai kunci, menetapkan label "prod", dan menambahkan awalan "TestApp:". Semua nilai kunci yang telah Anda impor memiliki jenis konten yang ditetapkan sebagai "JSON".

Untuk parameter dan contoh opsional lainnya, buka az appconfig kv import.

Mengimpor data dari Azure Kubernetes Service ConfigMaps

Ikuti langkah-langkah di bawah ini untuk mengimpor nilai kunci dari Azure Kubernetes Service ConfigMaps. Dukungan portal untuk fitur ini sedang dalam pengembangan, silakan gunakan Azure CLI untuk mengimpor dari AKS.

Portal

Dukungan portal Microsoft Azure untuk fitur ini sedang dalam pengembangan.

Azure CLI

Dari Azure CLI, ikuti langkah-langkah di bawah ini. Jika Anda tidak memiliki Azure CLI yang terinstal secara lokal, Anda dapat secara opsional menggunakan Azure Cloud Shell.

1. Masukkan perintah az appconfig kv import impor dan tambahkan parameter berikut:

   Pengaturan	Description	Example
   --name	Masukkan nama penyimpanan App Configuration yang ingin Anda impor datanya.	my-app-config-store
   --source	Masukkan aks untuk menunjukkan bahwa Anda mengimpor data konfigurasi aplikasi dari Azure Kubernetes Service.	aks
   --aks-cluster	Masukkan ID ARM Azure Kubernetes Service atau gunakan nama Azure Kubernetes Service, jika berada di grup langganan dan sumber daya yang sama dengan App Configuration.	/subscriptions/123/resourceGroups/my-resource-group/providers/Microsoft.ContainerService/managedClusters/my-aks-cluster atau my-aks-cluster
   --configmap-namespace	Masukkan namespace ConfigMap yang ingin Anda impor.	default
   --configmap-name	Masukkan nama ConfigMap yang ingin Anda impor.	my-configmap

2. Secara opsional juga tambahkan parameter berikut:

   Pengaturan	Description	Example
   --prefix	Optional. Awalan kunci adalah bagian awal dari properti "kunci" nilai kunci. Awalan dapat digunakan untuk mengelola grup nilai kunci di penyimpanan konfigurasi. Awalan ini akan ditambahkan ke bagian depan properti "kunci" dari setiap nilai kunci yang diimpor.	TestApp:
   --label	Optional. Masukkan label yang akan diberikan pada pasangan kunci-nilai yang diimpor. Jika Anda tidak menentukan label, label null akan ditetapkan ke nilai kunci Anda.	test
   --content-type	Optional. Masukkan appconfig/kvset atau application/json untuk menyatakan bahwa konten yang diimpor terdiri dari referensi Key Vault atau file JSON.	application/json
   --format	Optional. Masukkan yaml, properti, atau json untuk menunjukkan format ConfigMap yang Anda impor.	json
   --separator	Optional. Pemisah adalah pembatas untuk meratakan pasangan kunci-nilai. Diperlukan untuk mengekspor struktur hierarkis dan akan diabaikan untuk file properti dan bendera fitur. Pilih salah satu opsi berikut: ., , ,, :, ;, /-, , _. —	;

   Untuk mendapatkan nilai untuk --aks-cluster, gunakan perintah az aks show --resource-group <resource-group> --name <aks-cluster-name>.

   Contoh: impor semua pengaturan dari AKS Configmap Anda sebagai nilai kunci dengan label "uji", ke penyimpanan App Configuration Anda, dan tambahkan awalan "TestApp:".

   az appconfig kv import --name my-app-config-store --source aks --aks-cluster /subscriptions/123/resourceGroups/my-resource-group/providers/Microsoft.ContainerService/managedClusters/my-aks-cluster --configmap-namespace default --configmap-name my-configmap --label test --prefix TestApp:
   

3. Baris perintah menampilkan daftar perubahan yang akan datang. Konfirmasi impor dengan memilih y.

   

Anda mengimpor semua pengaturan dari AKS ConfigMap Anda sebagai nilai kunci, menetapkan label "uji", dan menambahkan awalan "TestApp:".

Untuk parameter dan contoh opsional lainnya, buka az appconfig kv import.

Mengekspor data

Ekspor menulis data konfigurasi yang disimpan di App Configuration ke tujuan lain. Gunakan fungsi ekspor, sebagai contoh, untuk menyimpan data dari toko konfigurasi aplikasi ke dalam file yang dapat disematkan dalam kode aplikasi Anda pada saat penyebaran.

Panduan ini menunjukkan cara mengekspor data App Configuration:

• ke file konfigurasi di JSON, YAML, atau Properti
• ke dalam penyimpanan Konfigurasi Aplikasi
• menuju sumber daya Azure App Service

Mengekspor data ke file konfigurasi

Ikuti langkah-langkah ini untuk mengekspor data konfigurasi dari penyimpanan App Configuration ke file JSON, YAML, atau Properties.

Portal

Dari portal Microsoft Azure, ikuti langkah-langkah berikut:

1. Akses penyimpanan App Configuration Anda, dan pilih Impor/ekspor.

   

2. Pilih tombol radio Ekspor dan di bawah Jenis target, pilih File konfigurasi.

3. Isi formulir dengan parameter berikut:

   Pengaturan	Description	Example
   Jenis file	Pilih jenis file untuk diekspor: YAML, Properti, atau JSON.	JSON
   Profil konten file	Pilih profil konten: Default atau KVSet. Profil konten file Default mengacu pada skema file konfigurasi konvensional yang diadopsi secara luas oleh kerangka kerja atau sistem pemrograman yang ada, mendukung format file JSON, YAML, atau Properti. Profil konten file KVSet mengacu pada skema file yang berisi semua properti nilai kunci App Configuration, termasuk kunci, nilai, label, jenis konten, dan tag.	Default
   Mode pemilihan	Pilih apakah akan mengekspor dari nilai kunci reguler, yang merupakan opsi default, atau dari rekam jepret.	Default
   Filter utama	Digunakan untuk memfilter nilai kunci berdasarkan nama kunci untuk ekspor. Jika tidak ada kunci yang ditentukan, semua kunci memenuhi syarat.	Dimulai dengan TestApp:
   Pada waktu tertentu	Optional. Isi bidang ini untuk mengekspor nilai kunci dari titik waktu tertentu di penyimpanan konfigurasi yang dipilih. Jika dibiarkan kosong, nilai tersebut default ke titik waktu saat ini dari nilai kunci.	28/07/2022 12:00:00 AM
   Dari label	Pilih label untuk mengekspor nilai kunci yang terkait dengan label tersebut. Jika tidak ada label yang dipilih, semua label memenuhi syarat. Perhatikan bahwa Anda hanya dapat memilih satu label saat mengekspor dengan Default profil konten file. Untuk mengekspor nilai kunci dengan lebih dari satu label, gunakan KVSet profil konten file.	prod
   Hapus awalan	Optional. Jika ditentukan, awalan akan dihapus dari semua nama kunci dari nilai kunci yang diekspor yang mengandungnya.	TestApp:
   Pemisah	Pemisah adalah pemisah yang digunakan untuk mensegmentasi nama kunci dan merekonstruksi konfigurasi hierarkis untuk file JSON atau YAML dari nilai kunci. Ini akan diabaikan untuk file properti dan penanda fitur. Nilai yang didukung tidak termasuk pemisah, titik (.), koma (,), titik koma (;), tanda hubung (-), garis bawah (_), garis bawah ganda (__), garis miring (/), dan titik dua (:).	:

4. Pilih Ekspor untuk menyelesaikan ekspor.

Anda mengekspor nilai kunci dari toko App Configuration per 28 Juli 2021, tepat pada pukul 12 pagi, dengan nama kunci yang dimulai dengan TestApp: dan label prod, ke file JSON. Awalan TestApp: dipangkas dari nama kunci, dan pemisah : digunakan untuk mensegmentasi nama kunci dan merekonstruksi format JSON hierarkis.

Azure CLI

Dari Azure CLI, ikuti langkah-langkah di bawah ini. Jika Anda tidak memiliki Azure CLI yang terinstal secara lokal, Anda dapat secara opsional menggunakan Azure Cloud Shell.

1. Masukkan perintah az appconfig kv export ekspor dan tambahkan parameter berikut:

   Pengaturan	Description	Example
   --name	Masukkan nama penyimpanan App Configuration yang berisi nilai kunci yang ingin Anda ekspor.	my-app-config-store
   --destination	Masukkan file untuk menunjukkan bahwa Anda mengekspor data ke file.	file
   --path	Masukkan jalur tempat Anda ingin menyimpan file.	C:/Users/john/Downloads/data.json
   --format	Masukkan yaml, properties atau json untuk menunjukkan format file yang ingin Anda ekspor.	json
   --label	Masukkan label untuk mengekspor nilai kunci dan bendera fitur dengan label ini. Jika Anda tidak menentukan label, secara default, Anda hanya mengekspor nilai kunci dan bendera fitur tanpa label. Anda dapat memasukkan satu label, memasukkan beberapa label dengan memisahkannya dengan ,, atau menggunakan * untuk memperhitungkan semua label.	prod

   Penting

   Jika Anda tidak memilih label, hanya nilai kunci tanpa label yang akan diekspor. Untuk mengekspor nilai kunci dengan label, Anda harus memilih labelnya.

2. Secara opsional juga tambahkan parameter berikut:

   Pengaturan	Description	Example
   --separator	Optional. Pemisah adalah pembatas untuk memformat pasangan kunci menjadi JSON/YAML. Diperlukan untuk mengekspor struktur hierarkis dan akan diabaikan untuk file properti dan bendera fitur. Pilih salah satu opsi berikut: ., , ,, :, ;, /-, , _. —	;
   --prefix	Optional. Awalan yang akan dipangkas dari properti "kunci" pada setiap pasangan kunci-nilai. Awalan kunci adalah bagian awal dari kunci. Awalan dapat digunakan untuk mengelola grup nilai kunci di penyimpanan konfigurasi. Awalan akan diabaikan untuk bendera fitur.	TestApp:

   Contoh: ekspor semua nilai kunci dan bendera fitur dengan label "prod" ke file JSON.

   az appconfig kv export --name my-app-config-store --label prod --destination file --path D:/abc.json --format json --separator ; --prefix TestApp:
   

3. Baris perintah menampilkan daftar nilai kunci yang diekspor ke file. Konfirmasi ekspor dengan memilih y.

   

Bendera fitur varian diekspor ke file menggunakan skema Manajemen Fitur Microsoft, sementara bendera fitur lain diekspor menggunakan skema Manajemen Fitur .NET untuk kompatibilitas. Untuk mengekspor bendera fitur secara eksklusif menggunakan skema Microsoft Feature Management, atur variabel lingkungan AZURE_APPCONFIG_FM_COMPATIBLE ke False.

Anda telah mengekspor nilai kunci dan bendera fitur yang memiliki label "prod" ke file konfigurasi, dan telah memangkas awalan "TestApp". Nilai dipisahkan oleh ";" dalam file.

Untuk parameter dan contoh opsional lainnya, buka az appconfig kv export.

Mengekspor data ke penyimpanan App Configuration

Ikuti langkah-langkah di bawah ini untuk mengekspor nilai kunci dan bendera fitur ke penyimpanan Azure App Configuration.

Anda dapat mengekspor nilai dari satu penyimpanan App Configuration ke penyimpanan App Configuration lain, atau Anda dapat mengekspor nilai dari satu penyimpanan App Configuration ke penyimpanan App Configuration yang sama untuk menduplikasi nilainya dan menerapkan parameter yang berbeda, seperti label baru atau jenis konten.

Portal

Dari portal Microsoft Azure, ikuti langkah-langkah berikut:

1. Navigasi ke penyimpanan App Configuration yang berisi data yang ingin Anda ekspor, dan pilih Impor/ekspor dari menu Operasi .

   

2. Pilih tombol radio Ekspor dan di bawah Jenis target, pilih Konfigurasi Aplikasi.

3. Isi formulir dengan parameter berikut:

   Pengaturan	Description	Example
   Mode pemilihan	Pilih apakah akan mengekspor dari nilai kunci reguler, yang merupakan opsi default, atau dari rekam jepret.	Default
   Filter utama	Digunakan untuk memfilter nilai kunci berdasarkan nama kunci untuk ekspor. Jika tidak ada kunci yang ditentukan, semua kunci memenuhi syarat.	Dimulai dengan TestApp:
   Pada waktu tertentu	Optional. Isi bidang ini untuk mengekspor nilai kunci dari titik waktu tertentu di penyimpanan konfigurasi yang dipilih. Jika dibiarkan kosong, nilai tersebut default ke titik waktu saat ini dari nilai kunci.	28/07/2022 12:00:00 AM
   Dari label	Pilih satu atau beberapa label untuk mengekspor nilai kunci yang terkait dengan label tersebut. Jika tidak ada label yang dipilih, semua label memenuhi syarat.	prod
   Mengecualikan bendera fitur	Jika dicentang, bendera fitur tidak akan diekspor.	Tidak Dicentang

4. Pilih penyimpanan tujuan, isi formulir dengan parameter berikut:

   Pengaturan	Description	Example
   Subscription	Langganan Anda saat ini dipilih secara default.	my-subscription
   Grup sumber daya	Pilih grup sumber daya yang berisi penyimpanan App Configuration tempat Anda ingin mengekspor konfigurasi. Grup sumber daya Anda saat ini dipilih secara default.	my-resource-group
   Sumber Daya	Pilih penyimpanan untuk App Configuration tempat Anda ingin mengekspor konfigurasi.	my-other-app-config-store

5. Isi bagian formulir berikutnya:

   Pengaturan	Description	Example
   Hapus awalan	Optional. Jika ditentukan, awalan akan dihapus dari semua nama kunci dari nilai kunci yang diekspor yang mengandungnya.	TestApp:
   Menimpa label	Optional. Secara default, label asli dari nilai kunci sumber dipertahankan. Untuk menggantikannya, centang kotak dan masukkan label baru untuk kunci-nilai yang diekspor.	baru
   Mengesampingkan tipe konten	Optional. Secara default, jenis konten asli dari nilai kunci sumber dipertahankan. Untuk mengambil alihnya, centang kotak dan masukkan tipe konten baru untuk nilai kunci yang diekspor. Perhatikan bahwa jenis konten flag fitur tidak dapat diubah.	JSON (aplikasi/json)

6. Pilih Terapkan untuk melanjutkan ekspor.

Anda mengekspor nilai kunci dari penyimpanan App Configuration per 28 Juli 2022, pukul 12.00, dengan nama kunci yang dimulai dengan TestApp: dan label prod, ke penyimpanan App Configuration lainnya. Semua nilai-kunci yang diekspor dipangkas dari awalan kunci TestApp:, dan diberi label new serta jenis konten application/json.

Azure CLI

Dari Azure CLI, ikuti langkah-langkah di bawah ini. Jika Anda tidak memiliki Azure CLI yang terinstal secara lokal, Anda dapat secara opsional menggunakan Azure Cloud Shell.

1. Masukkan perintah az appconfig kv export ekspor dan masukkan parameter berikut:

   Pengaturan	Description	Example
   --name	Masukkan nama penyimpanan App Configuration yang berisi nilai kunci yang ingin Anda ekspor.	my-app-config-store
   --destination	Masukkan appconfig untuk menandakan bahwa Anda mengekspor data ke penyimpanan Konfigurasi Aplikasi.	appconfig
   --dest-name	Masukkan nama penyimpanan App Configuration yang ingin Anda ekspor datanya.	my-other-app-config-store
   --label	Masukkan label untuk mengekspor nilai kunci dan bendera fitur dengan label ini. Jika Anda tidak menentukan label, secara default, Anda hanya akan mengekspor nilai kunci dan bendera fitur tanpa label. Anda dapat memasukkan satu label, memasukkan beberapa label dengan memisahkannya dengan ,, atau menggunakan * untuk memperhitungkan semua label.	prod

   Penting

   Jika nilai kunci yang ingin Anda ekspor memiliki label, Anda harus menggunakan perintah --label dan memasukkan label yang sesuai. Jika Anda tidak memilih label, hanya nilai kunci tanpa label yang akan diekspor. Gunakan tanda koma (,) untuk memilih beberapa label atau gunakan * untuk menyertakan semua label, termasuk label null (tanpa label).

2. Secara opsional juga tambahkan parameter berikut:

   Pengaturan	Description	Example
   --dest-label	Optional. Masukkan label tujuan, untuk menetapkan label ini ke nilai kunci yang diekspor.	new

   Contoh: ekspor nilai kunci dan flag fitur dengan label "prod" ke store App Configuration lain dan tambahkan label tujuan "baru".

   az appconfig kv export --name my-app-config-store --destination appconfig --dest-name my-other-app-config-store --dest-label new --label prod
   

3. Baris perintah menampilkan daftar nilai kunci yang diekspor ke file. Konfirmasi ekspor dengan memilih y.

   

Anda mengekspor nilai kunci dan tanda fitur yang memiliki label "prod" dari toko Konfigurasi Aplikasi dan menetapkan label "baru".

Untuk parameter dan contoh opsional lainnya, buka az appconfig kv import.

Mengekspor data ke Azure App Service

Ikuti langkah-langkah di bawah ini untuk mengekspor nilai kunci ke Azure App Service.

Nota

Mengekspor bendera fitur ke App Service tidak didukung.

Portal

Dari portal Microsoft Azure, ikuti langkah-langkah berikut:

1. Arahkan ke toko App Configuration Anda, lalu pilih Impor/ekspor dari menu Operasi.

   

2. Pilih tombol radio Ekspor dan di bawah Jenis target, pilih App Services.

3. Opsi Ekspor sebagai referensi dicentang secara default. Ketika kotak dicentang, pengaturan aplikasi di App Service akan ditambahkan sebagai referensi App Configuration untuk nilai kunci yang diekspor. Ini memungkinkan Anda mengelola pengaturan Anda di App Configuration, dengan App Service Anda secara otomatis menarik nilai saat ini dari App Configuration. Untuk mempelajari selengkapnya, lihat Menggunakan referensi App Configuration untuk App Service dan Azure Functions. Jika kotak tidak dicentang, kunci dan nilai akan langsung diekspor ke App Service. Ingatlah untuk mengekspor data Anda lagi setiap kali Anda membuat perubahan di App Configuration untuk memastikan aplikasi Anda mengambil pembaruan.

4. Isi formulir dengan parameter berikut:

   Pengaturan	Description	Example
   Mode pemilihan	Pilih apakah akan mengekspor dari nilai kunci reguler, yang merupakan opsi default, atau dari rekam jepret.	Default
   Filter utama	Digunakan untuk memfilter nilai kunci berdasarkan nama kunci untuk ekspor. Jika tidak ada kunci yang ditentukan, semua kunci memenuhi syarat.	Dimulai dengan TestApp:
   Pada waktu tertentu	Optional. Isi bidang ini untuk mengekspor nilai kunci dari titik waktu tertentu di penyimpanan konfigurasi yang dipilih. Jika dibiarkan kosong, nilai tersebut default ke titik waktu saat ini dari nilai kunci.	28/07/2022 12:00:00 AM
   Dari label	Pilih satu label untuk mengekspor nilai kunci yang terkait dengan label ini.	prod

5. Pilih penyimpanan tujuan dan isi formulir dengan parameter berikut:

   Pengaturan	Description	Example
   Subscription	Langganan Anda saat ini dipilih secara default.	my-subscription
   Grup sumber daya	Pilih grup sumber daya yang berisi App Service tempat Anda ingin mengekspor konfigurasi.	my-resource-group
   Sumber Daya	Pilih App Service tempat Anda ingin mengekspor konfigurasi.	my-app-service

6. Secara opsional isi bagian formulir berikutnya:

   Pengaturan	Description	Example
   Hapus awalan	Optional. Jika ditentukan, awalan akan dihapus dari semua nama kunci dari nilai kunci yang diekspor yang mengandungnya.	TestApp:

7. Pilih Terapkan untuk melanjutkan ekspor.

Anda mengekspor nilai kunci dari penyimpanan App Configuration per 28 Juli 2022, pukul 12.00, dengan nama kunci yang dimulai dengan TestApp: dan label prod, ke pengaturan aplikasi sumber daya App Service. Awalan TestApp: dipangkas dari nama kunci yang diekspor.

Jika Anda mencentang kotak untuk mengekspor nilai kunci sebagai referensi, nilai kunci yang diekspor ditunjukkan sebagai referensi App Configuration di kolom "Sumber" pengaturan konfigurasi sumber daya App Service Anda.

Azure CLI

Dari Azure CLI, ikuti langkah-langkah di bawah ini. Jika Anda tidak memiliki Azure CLI yang terinstal secara lokal, Anda dapat secara opsional menggunakan Azure Cloud Shell.

1. Masukkan perintah az appconfig kv export ekspor dan masukkan parameter berikut:

   Pengaturan	Description	Example
   --name	Masukkan nama penyimpanan App Configuration yang berisi nilai kunci yang ingin Anda ekspor.	my-app-config-store
   --destination	Masukkan appservice untuk menunjukkan bahwa Anda mengekspor data ke App Service.	appservice
   --appservice-account	Masukkan ID ARM App Service atau gunakan nama App Service, jika berada di grup langganan dan sumber daya yang sama dengan App Configuration.	/subscriptions/123/resourceGroups/my-as-resource-group/providers/Microsoft.Web/sites/my-app-service atau my-app-service
   --label	Optional. Masukkan label untuk mengekspor nilai kunci dan bendera fitur dengan label ini. Jika Anda tidak menentukan label, secara default, Anda hanya akan mengekspor nilai kunci dan bendera fitur tanpa label.	prod

   Untuk mendapatkan nilai untuk --appservice-account, gunakan perintah az webapp show --resource-group <resource-group> --name <resource-name>.

2. Secara opsional juga tambahkan awalan:

   Pengaturan	Description	Example
   --prefix	Optional. Awalan yang akan dipangkas dari properti "kunci" nilai kunci yang diekspor. Awalan kunci adalah bagian awal dari kunci. Awalan dapat digunakan untuk mengelola grup nilai kunci di penyimpanan konfigurasi.	TestApp:

   Contoh: ekspor semua nilai kunci dengan label "prod" ke aplikasi App Service dan pangkas awalan "TestApp".

   az appconfig kv export --name my-app-config-store --destination appservice --appservice-account /subscriptions/123/resourceGroups/my-resource-group/providers/Microsoft.Web/sites/my-app-service/config/web --label prod --prefix TestApp:
   

   Baris perintah menampilkan daftar nilai kunci yang diekspor ke sumber daya App Service. Konfirmasi ekspor dengan memilih y.

   

   Anda mengekspor semua nilai kunci dengan label "prod" ke sumber daya Azure App Service, dan memangkas awalan "TestApp:".

3. Secara opsional, tentukan parameter untuk mengekspor sebagai Referensi Konfigurasi Aplikasi.

   Pengaturan	Description
   --export-as-reference -r	Optional. Tentukan apakah nilai kunci diekspor ke App Service sebagai referensi App Configuration. Pelajari selengkapnya.

   Contoh: ekspor semua nilai kunci dengan label "prod" sebagai referensi konfigurasi aplikasi ke aplikasi App Service.

   az appconfig kv export --name my-app-config-store --destination appservice --appservice-account "/subscriptions/123/resourceGroups/my-resource-group/providers/Microsoft.Web/sites/my-app-service" --label prod --export-as-reference
   

   Baris perintah menampilkan daftar nilai kunci yang diekspor sebagai referensi konfigurasi aplikasi ke sumber daya App Service. Konfirmasi ekspor dengan memilih y.

   

   Anda telah mengekspor semua nilai kunci dengan label "prod" sebagai referensi konfigurasi aplikasi ke sumber daya Azure App Service. Di sumber daya App Service Anda, nilai kunci yang diimpor akan ditunjukkan sebagai referensi App Configuration di kolom "Sumber".

   

Untuk parameter dan contoh opsional lainnya, buka az appconfig kv export.

Pesan kesalahan

Anda mungkin mengalami pesan kesalahan berikut saat mengimpor atau mengekspor nilai kunci App Configuration:

• Akses publik dinonaktifkan untuk toko Anda atau Anda mengakses dari ujung pribadi yang tidak termasuk dalam konfigurasi ujung pribadi toko. Jika penyimpanan App Configuration Anda memiliki titik akhir privat yang diaktifkan, Anda hanya dapat mengaksesnya dari dalam jaringan virtual yang dikonfigurasi secara default. Pastikan bahwa komputer yang menjalankan portal Microsoft Azure atau CLI bergabung ke jaringan virtual yang sama dengan titik akhir privat. Jika Anda baru saja mengaktifkan akses jaringan publik ke penyimpanan App Configuration, tunggu setidaknya 5 menit sebelum mencoba kembali untuk memungkinkan cache di-refresh.

Langkah selanjutnya

Mengintegrasikan dalam alur CI/CD