Mengimpor atau mengekspor data konfigurasi

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

Artikel ini menyediakan panduan untuk mengimpor dan mengekspor data menggunakan portal 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 Azure Pipeline Push.

Impor data

Impor membawa data konfigurasi ke dalam penyimpanan Azure App Configuration dari sumber yang ada. Gunakan fungsi impor untuk memigrasikan data ke penyimpanan Azure App Configuration atau menggabungkan data dari beberapa sumber.

Panduan ini menampilkan cara mengimpor data App Configuration:

• dari file konfigurasi di Json, Yaml, atau Properties
• dari penyimpanan App Configuration
• dari Azure App Service

Impor data dari file konfigurasi

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

Portal

Dari portal Azure, ikuti langkah-langkah berikut:

1. Navigasi ke penyimpanan App Configuration Anda, dan 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:

   Parameter	Deskripsi	Contoh
   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 selanjutnya dari formulir:

   Parameter	Deskripsi	Contoh
   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 bendera fitur. Nilai yang didukung termasuk tanpa pemisah, titik (.), koma (,), titik koma (;), tanda hubung (-), garis bawah (_), garis bawah ganda (__), garis miring (/), dan titik dua (:).	:
   Kedalaman	Opsional. Kedalaman untuk meratakan file JSON atau YAML menjadi pasangan kunci-nilai. Secara default, file diratakan ke tingkat terdalam jika pemisah dipilih. Pengaturan ini tidak berlaku untuk file properti atau bendera fitur.
   Tambahkan awalan	Opsional. Jika ditentukan, awalan akan ditambahkan ke nama kunci semua nilai kunci yang diimpor.	TestApp:
   Tambahkan label	Opsional. Jika ditentukan, label yang disediakan akan ditetapkan ke semua nilai kunci yang diimpor.	menjolok
   Tambahkan tipe isi	Opsional. Jika ditentukan, jenis konten yang disediakan akan ditambahkan ke semua nilai kunci yang diimpor.	JSON (aplikasi/json)
   Tambahkan tag	Opsional. 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 kunci diratakan menggunakan pemisah : dan diawali dengan TestApp:. Semua nilai kunci yang diimpor diberi label sebagai prod, dengan jenis application/jsonkonten , 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 impor az appconfig kv import dan tambahkan parameter berikut:

   Parameter	Deskripsi	Contoh
   --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, tambahkan juga parameter berikut:

   Parameter	Deskripsi	Contoh
   --separator	Opsional. Pemisah adalah pembatas untuk meratakan nilai kunci ke Json/Yaml. Pemisah tersebut diperlukan untuk mengekspor struktur hierarkis dan akan diabaikan untuk file properti dan bendera fitur. Pilih salah satu opsi berikut ini: ., ,, :, ;, /, -, _, —.	;
   --prefix	Opsional. Awalan kunci adalah bagian awal dari sebuah 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	Opsional. Masukkan label yang akan ditetapkan ke nilai kunci yang Anda impor.	prod
   --content-type	Opsional. 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.

Impor data dari penyimpanan App Configuration

Anda dapat mengimpor nilai dari satu penyimpanan App Configuration ke penyimpanan App Configuration lainnya, 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 Azure, ikuti langkah-langkah berikut:

1. Navigasi ke penyimpanan App Configuration Anda, dan 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:

   Parameter	Deskripsi	Contoh
   Langganan	Langganan Anda saat ini dipilih secara default.	my-subscription
   Grup sumber daya	Pilih grup 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 penyimpanan App Configuration yang berisi konfigurasi yang ingin Anda impor.	my-other-app-config-store

4. Isi bagian selanjutnya dari formulir:

   Parameter	Deskripsi	Contoh
   Mode pemilihan	Pilih apakah akan mengimpor dari nilai kunci reguler, yang merupakan opsi default, atau dari rekam jepret.	Default
   Filter kunci	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	Opsional. 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 Pukul 12.00.00
   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.	menjolok
   Mengecualikan bendera fitur	Jika dicentang, bendera fitur tidak akan diimpor.	Tidak Dicentang
   Tambahkan awalan	Opsional. Jika ditentukan, awalan akan ditambahkan ke nama kunci semua nilai kunci yang diimpor.	TestApp:
   Mengesampingkan label	Opsional. 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	Opsional. 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 bendera fitur tidak dapat ditimpa.	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 impor az appconfig kv import dan masukkan parameter berikut:

   Parameter	Deskripsi	Contoh
   --name	Masukkan nama penyimpanan App Configuration tempat Anda ingin mengimpor data	my-app-config-store
   --source	Masukkan appconfig untuk menunjukkan bahwa Anda mengimpor data dari penyimpanan App Configuration.	appconfig
   --src-name	Masukkan nama penyimpanan App Configuration tempat Anda ingin mengimpor data.	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 prefiks.	prod

2. Secara opsional, tambahkan parameter berikut:

   Parameter	Deskripsi	Contoh
   --label	Opsional. Masukkan label yang akan ditetapkan ke nilai kunci yang Anda impor.	new
   --content-type	Opsional. Masukkan appconfig/kvset atau application/json untuk menyatakan bahwa konten yang diimpor terdiri dari referensi Key Vault atau file JSON. Jenis 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.

Catatan

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. Navigasi ke penyimpanan App Configuration Anda, dan 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:

   Parameter	Deskripsi	Contoh
   Langganan	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 selanjutnya dari formulir:

   Parameter	Deskripsi	Contoh
   Memperbarui pengaturan ke referensi	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.	Dicentang
   Tambahkan awalan	Opsional. Jika ditentukan, awalan akan ditambahkan ke nama kunci semua nilai kunci yang diimpor.	TestApp:
   Tambahkan label	Opsional. Jika ditentukan, label yang disediakan akan ditetapkan ke semua nilai kunci yang diimpor.	menjolok
   Tambahkan tipe isi	Opsional. 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 impor az appconfig kv import dan tambahkan parameter berikut:

   Parameter	Deskripsi	Contoh
   --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 dalam langganan dan grup 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, tambahkan juga parameter berikut:

   Parameter	Deskripsi	Contoh
   --prefix	Opsional. 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	Opsional. Masukkan label yang akan ditetapkan ke nilai kunci yang Anda impor. Jika Anda tidak menentukan label, label null akan ditetapkan ke nilai kunci Anda.	prod
   --content-type	Opsional. 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 --appservice-account, gunakan perintah az webapp show --resource-group <resource-group> --name <resource-name>.

   Contoh: impor semua pengaturan aplikasi dari App Service sebagai nilai kunci dengan label "prod", ke penyimpanan App Configuration Anda, dan tambahkan prefiks "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.

Mengekspor data

Ekspor menulis data konfigurasi yang disimpan di Azure App Configuration ke tujuan lain. Gunakan fungsi ekspor, misalnya, untuk menyimpan data dari penyimpanan App Configuration ke file yang dapat disematkan dalam kode aplikasi Anda selama penyebaran.

Panduan ini menunjukkan cara mengekspor data App Configuration:

• ke file konfigurasi di Json, Yaml atau Properties
• ke penyimpanan App Configuration
• ke sumber daya Azure App Service

Ekspor 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 Azure, ikuti langkah-langkah berikut:

1. Navigasi ke 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:

   Parameter	Deskripsi	Contoh
   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 kunci	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	Opsional. 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 Pukul 12.00.00
   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.	menjolok
   Hapus awalan	Opsional. Jika ditentukan, awalan akan dihapus dari nama kunci semua nilai kunci yang diekspor yang berisinya.	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 bendera 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 penyimpanan App Configuration per 28 Juli 2021, pukul 12.00, 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 ekspor az appconfig kv export dan tambahkan parameter berikut:

   Parameter	Deskripsi	Contoh
   --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, tambahkan juga parameter berikut:

   Parameter	Deskripsi	Contoh
   --separator	Opsional. Pemisah adalah pembatas untuk meratakan nilai kunci ke Json/Yaml. Pemisah tersebut diperlukan untuk mengekspor struktur hierarkis dan akan diabaikan untuk file properti dan bendera fitur. Pilih salah satu opsi berikut ini: ., ,, :, ;, /, -, _, —.	;
   --prefix	Opsional. Awalan yang akan dipangkas dari setiap properti "kunci" nilai kunci. Awalan kunci adalah bagian awal dari sebuah kunci. Awalan dapat digunakan untuk mengelola grup nilai kunci di penyimpanan konfigurasi. Prefiks 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.

   

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

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

Ekspor 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 lainnya, 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 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 App Configuration.

3. Isi formulir dengan parameter berikut:

   Parameter	Deskripsi	Contoh
   Mode pemilihan	Pilih apakah akan mengekspor dari nilai kunci reguler, yang merupakan opsi default, atau dari rekam jepret.	Default
   Filter kunci	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	Opsional. 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 Pukul 12.00.00
   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.	menjolok
   Mengecualikan bendera fitur	Jika dicentang, bendera fitur tidak akan diekspor.	Tidak Dicentang

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

   Parameter	Deskripsi	Contoh
   Langganan	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 App Configuration tempat Anda ingin mengekspor konfigurasi.	my-other-app-config-store

5. Isi bagian selanjutnya dari formulir:

   Parameter	Deskripsi	Contoh
   Hapus awalan	Opsional. Jika ditentukan, awalan akan dihapus dari nama kunci semua nilai kunci yang diekspor yang berisinya.	TestApp:
   Mengesampingkan label	Opsional. Secara default, label asli dari nilai kunci sumber dipertahankan. Untuk mengambil alihnya, centang kotak dan masukkan label baru untuk nilai kunci yang diekspor.	baru
   Mengesampingkan tipe konten	Opsional. 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 bendera fitur tidak dapat ditimpa.	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 awalan TestApp:kunci , dan 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 ekspor az appconfig kv export dan masukkan parameter berikut:

   Parameter	Deskripsi	Contoh
   --name	Masukkan nama penyimpanan App Configuration yang berisi nilai kunci yang ingin Anda ekspor.	my-app-config-store
   --destination	Masukkan appconfig untuk menunjukkan bahwa Anda mengekspor data ke penyimpanan App Configuration.	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 menggunakan ,, atau gunakan * untuk mempertimbangkan 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, tambahkan juga parameter berikut:

   Parameter	Deskripsi	Contoh
   --dest-label	Opsional. Masukkan label tujuan, untuk menetapkan label ini ke nilai kunci yang diekspor.	new

   Contoh: ekspor nilai kunci dan bendera fitur dengan label "prod" ke penyimpanan 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 bendera fitur yang memiliki label "prod" dari penyimpanan App Configuration dan menetapkan label "baru".

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

Ekspor data ke Azure App Service

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

Catatan

Mengekspor bendera fitur ke App Service tidak didukung.

Portal

Dari portal Azure, ikuti langkah-langkah berikut:

1. Navigasi ke penyimpanan App Configuration Anda, dan 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 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:

   Parameter	Deskripsi	Contoh
   Mode pemilihan	Pilih apakah akan mengekspor dari nilai kunci reguler, yang merupakan opsi default, atau dari rekam jepret.	Default
   Filter kunci	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	Opsional. 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 Pukul 12.00.00
   Dari label	Pilih satu label untuk mengekspor nilai kunci yang terkait dengan label ini.	menjolok

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

   Parameter	Deskripsi	Contoh
   Langganan	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 selanjutnya:

   Parameter	Deskripsi	Contoh
   Hapus awalan	Opsional. Jika ditentukan, awalan akan dihapus dari nama kunci semua nilai kunci yang diekspor yang berisinya.	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 ekspor az appconfig kv export dan masukkan parameter berikut:

   Parameter	Deskripsi	Contoh
   --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 dalam langganan dan grup 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	Opsional. 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 --appservice-account, gunakan perintah az webapp show --resource-group <resource-group> --name <resource-name>.

2. Secara opsional, tambahkan juga prefiks:

   Parameter	Deskripsi	Contoh
   --prefix	Opsional. Awalan yang akan dipangkas dari properti "kunci" nilai kunci yang diekspor. Awalan kunci adalah bagian awal dari sebuah 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 prefiks "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 bendera untuk diekspor sebagai Referensi App Configuration.

   Parameter	Deskripsi
   --export-as-reference -r	Opsional. 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 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 penyimpanan Anda atau Anda mengakses dari titik akhir privat yang tidak ada dalam konfigurasi titik akhir privat penyimpanan. Jika penyimpanan App Configuration Anda mengaktifkan titik akhir privat, Anda hanya dapat mengaksesnya dari dalam jaringan virtual yang dikonfigurasi secara default. Pastikan bahwa komputer yang menjalankan portal Azure atau CLI digabungkan 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 berikutnya

Mengintegrasikan dengan alur CI/CD