Impor atau ekspor data konfigurasi

  • Artikel

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 dengan Azure App Configuration. Jika Anda ingin menyiapkan sinkronisasi berkelanjutan dengan repositori GitHub Anda, lihat tugas GitHub Actions dan Azure Pipelines.

Anda dapat mengimpor atau mengekspor data menggunakan portal Azure atau Azure CLI.

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:

Impor data dari file konfigurasi

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

Catatan

Mengimpor bendera fitur dari file tidak didukung. Jika file konfigurasi berisi bendera fitur, file tersebut akan diimpor sebagai nilai kunci reguler secara otomatis.

Pada portal Azure, ikuti langkah-langkah berikut:

  1. Telusuri penyimpanan App Configuration Anda, dan pilih Impor/ekspor dari menu Operasi.

    Cuplikan layar portal Azure, mengimpor file.

  2. Pada tab Impor, pilih File konfigurasi di bawah Layanan sumber.

  3. Isi formulir dengan parameter berikut:

    Parameter Deskripsi Contoh
    Untuk bahasa Pilih bahasa komputer file yang Anda impor antara .NET, Java (Spring) dan Lainnya. .NET
    Jenis file Pilih jenis file yang Anda impor antara Yaml, Properties dan Json. Json

  4. Pilih Folder ikon, lalu telusuri ke file yang ingin diimpor.

    Catatan

    Pesan ditampilkan di layar, menunjukkan bahwa file berhasil diambil.

  5. Isi bagian selanjutnya dari formulir:

    Parameter Deskripsi Contoh
    Pemisah Pemisah adalah karakter yang diuraikan dalam file konfigurasi yang diimpor untuk memisahkan nilai kunci yang akan ditambahkan ke penyimpanan konfigurasi Anda. Pilih salah satu opsi berikut ini: ., ,, :, ;, /, -, _, —. ;
    Prefiks Pilihan. Awalan kunci adalah bagian awal dari properti "kunci" nilai kunci. Awalan dapat digunakan untuk mengelola grup kunci-nilai di penyimpanan konfigurasi. Awalan yang dimasukkan akan ditambahkan ke bagian depan properti "kunci" dari setiap nilai kunci yang Anda impor dari file ini. TestApp:
    Label Pilihan. Pilih label yang ada atau masukkan label baru yang akan ditetapkan ke nilai kunci yang Anda impor. prod
    Jenis konten Pilihan. Tunjukkan apakah Anda mengimpor file JSON atau referensi Azure Key Vault. Untuk informasi selengkapnya tentang referensi Key Vault, buka Menggunakan referensi Key Vault di aplikasi ASP.NET Core. JSON (application/json)

  6. Pilih Terapkan untuk melanjutkan impor.

Anda telah mengimpor nilai kunci dari file JSON, memberinya label "prod" dan prefiks "TestApp". Pemisah ":" digunakan dan semua nilai kunci yang telah Anda impor memiliki jenis konten yang ditetapkan sebagai "JSON".

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.

Pada portal Azure, ikuti langkah-langkah berikut:

  1. Telusuri penyimpanan App Configuration Anda, dan pilih Impor/ekspor dari menu Operasi.

    Cuplikan layar portal Azure, mengimpor dari penyimpanan Azure App Configuration.

  2. Pada tab Impor, pilih App Configuration di bawah Layanan sumber.

  3. Pilih Pilih sumber daya, isi formulir dengan parameter berikut, dan pilih Terapkan:

    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

    Catatan

    Pesan "Kunci akses berhasil diambil" menunjukkan bahwa koneksi dengan penyimpanan App Configuration berhasil."

  4. Isi bagian selanjutnya dari formulir:

    Parameter Deskripsi Contoh
    Dari label Pilih setidaknya satu label untuk mengimpor nilai dengan label terkait. Pilih semua akan mengimpor nilai kunci dengan label apa pun, dan (Tanpa label) akan membatasi impor ke nilai kunci tanpa label. prod
    Pada waktu tertentu Opsional. Isi untuk mengimpor nilai kunci dari titik waktu tertentu. Ini adalah titik waktu kunci-nilai di penyimpanan konfigurasi yang dipilih. Format: "YYYY-MM-DDThh:mm:ssZ". Bidang ini default ke titik waktu saat ini dari nilai kunci ketika dibiarkan kosong. 28/07/2022 Pukul 12.00.00
    Mengambil alih label nilai kunci default Pilihan. Secara default, item yang diimpor menggunakan label yang saat ini dipakai. Centang kotak dan masukkan label untuk mengambil alih default ini dengan label kustom. baru
    Mengambil alih jenis konten nilai kunci default Pilihan. Secara default, item yang diimpor menggunakan jenis konten saat ini. Centang kotak dan pilih Referensi Key Vault atau JSON (aplikasi/json) di bawah Jenis konten 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' dan tidak diperbarui oleh parameter ini. JSON (application/json)

  5. Pilih Terapkan untuk melanjutkan impor.

Anda telah mengimpor nilai kunci dan bendera fitur dengan label "prod" dari penyimpanan App Configuration pada 28 Januari 2021 pukul 12 pagi, dan telah menetapkan label "baru". Semua kunci-nilai yang telah Anda impor memiliki jenis konten yang ditetapkan sebagai "JSON".

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.

Dari portal Microsoft Azure:

  1. Telusuri penyimpanan App Configuration Anda, dan pilih Impor/ekspor dari menu Operasi.

    Cuplikan layar portal Azure, mengimpor dari App Service.

  2. Pada tab Impor, pilih App Services di bawah Layanan sumber.

  3. Pilih Pilih sumber daya, isi formulir dengan parameter berikut, dan pilih Terapkan:

    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

    Catatan

    Pesan ditampilkan, menunjukkan jumlah nilai kunci yang berhasil diambil dari sumber daya App Service sumber daya.

  4. Isi bagian selanjutnya dari formulir:

    Parameter Deskripsi Contoh
    Prefiks Opsional. Awalan kunci adalah bagian awal dari properti "kunci" nilai kunci. Awalan dapat digunakan untuk mengelola grup kunci-nilai di penyimpanan konfigurasi. Awalan ini akan ditambahkan ke bagian depan properti "kunci" dari setiap nilai kunci yang diimpor. TestApp:
    Label Pilihan. Pilih label yang ada atau masukkan label baru yang akan ditetapkan ke nilai kunci yang Anda impor. prod
    Jenis konten Pilihan. Tunjukkan apakah file yang Anda impor adalah referensi Key Vault atau file JSON. Untuk informasi selengkapnya tentang referensi Key Vault, buka Menggunakan referensi Key Vault di aplikasi ASP.NET Core. JSON (application/json)

  5. Pilih Terapkan untuk melanjutkan impor.

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

Ekspor 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:

Ekspor data ke file konfigurasi

Ikuti langkah-langkah di bawah ini untuk mengekspor data konfigurasi dari penyimpanan konfigurasi aplikasi ke file Json, Yaml, atau Properties.

Catatan

Mengekspor bendera fitur dari penyimpanan App Configuration ke file konfigurasi saat ini hanya didukung di CLI.

Dari portal Azure, ikuti langkah-langkah berikut:

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

    Cuplikan layar portal Azure, mengekspor file

  2. Pada tab Ekspor, pilih File konfigurasi di bawah Layanan sumber.

  3. Isi formulir dengan parameter berikut:

    Parameter Deskripsi Contoh
    Prefiks Opsional. Awalan ini akan dipangkas dari setiap properti "kunci" nilai kunci. Awalan kunci adalah bagian awal dari sebuah kunci. Awalan dapat digunakan untuk mengelola grup kunci-nilai di penyimpanan konfigurasi. TestApp:
    Dari label Pilih label yang ada untuk membatasi ekspor Anda ke nilai kunci dengan label tertentu. Jika Anda tidak memilih label, secara default hanya nilai kunci dengan label "No Label" yang akan diekspor. Lihat catatan di bawah. prod
    Pada waktu tertentu Opsional. Isi untuk mengimpor nilai kunci dari titik waktu tertentu. Ini adalah titik waktu kunci-nilai di penyimpanan konfigurasi yang dipilih. Format: "YYYY-MM-DDThh:mm:ssZ". Bidang ini default ke titik waktu saat ini dari nilai kunci ketika dibiarkan kosong. 28/07/2022 Pukul 12.00.00
    Jenis file Pilih jenis file yang Anda ekspor antara Yaml, Properties, atau Json. JSON
    Pemisah Pemisah adalah pembatas untuk meratakan nilai kunci ke Json/Yaml. Pemisah ini mendukung struktur hierarki konfigurasi dan tidak berlaku untuk file properti dan bendera fitur. Pilih salah satu opsi berikut: ., ,, :, ;, /, -, _, —, atau (Tanpa pemisah). ;

    Penting

    Jika Anda tidak memilih label Dari, hanya nilai kunci tanpa label yang akan diekspor. Untuk mengekspor nilai kunci dengan label, Anda harus memilih labelnya. Perhatikan bahwa Anda hanya dapat memilih satu label per ekspor di portal, jika Anda ingin mengekspor nilai kunci dengan semua label yang ditentukan, silakan gunakan CLI.

  4. Pilih Ekspor untuk menyelesaikan ekspor.

Anda telah mengekspor nilai kunci yang memiliki label "prod" dari file konfigurasi, pada statusnya dari 28/07/2021 12.00.00, dan telah memangkas prefiks "TestApp". Nilai dipisahkan oleh ";" dalam file.

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.

Pada portal Azure, ikuti langkah-langkah berikut:

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

    Cuplikan layar portal Azure, mengekspor dari penyimpanan App Configuration.

  2. Pada tab Ekspor, pilih App Configuration di bawah Layanan target.

  3. Pilih Pilih sumber daya, isi formulir dengan parameter berikut, dan pilih Terapkan:

    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. my-resource-group
    Sumber daya Pilih penyimpanan App Configuration yang berisi konfigurasi yang ingin Anda impor. my-app-config-store

  4. Halaman saat ini menampilkan Layanan target dan ID sumber daya yang dipilih. Tindakan Pilih sumber daya memungkinkan Anda beralih ke sumber lain penyimpanan App Configuration.

    Catatan

    Pesan ditampilkan di layar, menunjukkan bahwa nilai kunci berhasil diambil.

  5. Isi bagian selanjutnya dari formulir:

    Parameter Deskripsi Contoh
    Dari label Pilih setidaknya satu label untuk mengekspor nilai dengan label yang sesuai. Pilih semua akan mengekspor nilai kunci dengan label apa pun, dan (Tanpa label) akan membatasi ekspor ke nilai kunci tanpa label. prod
    Pada waktu tertentu Opsional. Isi untuk mengimpor nilai kunci dari titik waktu tertentu. Ini adalah titik waktu kunci-nilai di penyimpanan konfigurasi yang dipilih. Format: "YYYY-MM-DDThh:mm:ssZ". Bidang ini default ke titik waktu saat ini dari nilai kunci ketika dibiarkan kosong. 28/07/2022 Pukul 12.00.00
    Mengambil alih label nilai kunci default Pilihan. Secara default, item yang diimpor menggunakan label yang saat ini dipakai. Centang kotak dan masukkan label untuk mengambil alih default ini dengan label kustom. baru

  6. Pilih Terapkan untuk melanjutkan ekspor.

Anda telah mengekspor nilai kunci dan bendera fitur yang memiliki label "prod" dari penyimpanan App Configuration, pada statusnya dari 28/07/2022 12.00.00, dan telah menetapkan label "baru".

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 saat ini tidak didukung.

Pada portal Azure, ikuti langkah-langkah berikut:

  1. Telusuri penyimpanan App Configuration Anda, dan pilih Impor/ekspor dari menu Operasi.

    Cuplikan layar portal Azure, mengekspor dari App Service.

  2. Pada tab Ekspor, pilih App Services di bawah Layanan target.

  3. Pilih Pilih sumber daya, isi formulir dengan parameter berikut, dan pilih Terapkan:

    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 diekspor. my-resource-group
    Sumber daya Pilih App Service yang berisi konfigurasi yang ingin Anda ekspor. my-app-service

  4. Halaman saat ini menampilkan Layanan target dan ID sumber daya yang dipilih. Tindakan Pilih sumber daya memungkinkan Anda beralih ke target lain App Service sumber daya.

  5. Secara opsional, isi bagian formulir selanjutnya:

    Parameter Deskripsi Contoh
    Prefiks Opsional. Awalan ini akan dipangkas dari setiap 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. Prefiks akan diabaikan untuk bendera fitur. TestApp:
    Ekspor sebagai referensi Pilihan. Periksa untuk mengekspor nilai kunci ke App Service sebagai referensi App Configuration. Pelajari lebih lanjut
    Pada waktu tertentu Opsional. Isi untuk mengekspor nilai kunci dari titik waktu tertentu. Ini adalah titik waktu kunci-nilai di penyimpanan konfigurasi yang dipilih. Format: "YYYY-MM-DDThh:mm:ssZ". Bidang ini default ke titik waktu saat ini dari nilai kunci ketika dibiarkan kosong. 28/07/2022 Pukul 12.00.00
    Dari label Pilihan. Pilih label yang ada untuk membatasi ekspor Anda ke nilai kunci dengan label tertentu. Jika Anda tidak memilih label, hanya nilai kunci berlabel "Tanpa label" yang akan diekspor. prod

  6. Pilih Terapkan untuk melanjutkan ekspor.

Anda telah mengekspor nilai kunci yang memiliki label "prod" dari sumber daya App Service, pada statusnya dari 28/07/2021 12.00.00, dan telah memangkas prefiks "TestApp". Nilai kunci telah diekspor dengan jenis konten dalam format JSON.

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

Cuplikan layar pengaturan konfigurasi App Service. Referensi App Configuration yang diekspor di App Service(Portal).

Pesan kesalahan

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

  • File yang dipilih harus antara 1 hingga 2097152 byte.: file Anda terlalu besar. Pilih file yang lebih kecil.
  • Akses publik dinonaktifkan untuk penyimpanan Anda atau Anda mengakses dari titik akhir privat yang tidak ada dalam konfigurasi titik akhir privat penyimpanan. Untuk mengimpor nilai kunci dari penyimpanan App Configuration, Anda harus memiliki akses ke penyimpanan tersebut. Jika perlu, aktifkan akses publik untuk penyimpanan sumber atau akses dari titik akhir privat yang disetujui. Jika Anda baru saja mengaktifkan akses publik, tunggu hingga 5 menit hingga cache di-refresh.

Langkah berikutnya

Mengintegrasikan dengan alur CI/CD