Bagikan melalui

Mengimpor pengaturan ke App Configuration dengan Azure Pipelines

  • Artikel

Tugas Impor Azure App Configuration mengimpor nilai kunci dari file konfigurasi ke penyimpanan App Configuration Anda. Tugas ini memungkinkan fungsionalitas lingkaran penuh dalam alur karena Anda sekarang dapat mengekspor pengaturan dari penyimpanan App Configuration dan mengimpor pengaturan ke penyimpanan App Configuration.

Prasyarat

Membuat koneksi layanan

Koneksi layanan memberi Anda akses ke sumber daya di langganan Azure Anda dari proyek Azure DevOps Anda.

  1. Di Azure DevOps, buka proyek yang berisi slur target Anda. Di sudut kiri bawah, pilih Pengaturan proyek.

  2. Pada Alur, pilih Koneksi layanan. Di sudut kanan atas, pilih Koneksi layanan baru.

  3. Di Koneksi layanan baru, pilih Azure Resource Manager.

    Cuplikan layar memperlihatkan memilih Azure Resource Manager dari daftar menurun Koneksi layanan baru.

  4. Dalam dialog Metode autentikasi, pilih Federasi identitas beban kerja (otomatis) untuk membuat federasi identitas beban kerja baru atau pilih Federasi identitas beban kerja (manual) untuk menggunakan federasi identitas beban kerja yang ada.

  5. Masukkan langganan, grup sumber daya, dan nama untuk koneksi layanan Anda.

Jika Anda membuat perwakilan layanan baru, temukan nama perwakilan layanan yang ditetapkan ke koneksi layanan. Anda akan menambahkan penetapan peran baru ke perwakilan layanan ini pada langkah berikutnya.

  1. Buka Pengaturan Proyek>Koneksi layanan.

  2. Pilih koneksi layanan baru.

  3. Pilih Kelola Perwakilan Layanan.

  4. Perhatikan nilai dalam Nama tampilan.

    Cuplikan layar memperlihatkan nama tampilan perwakilan layanan.

Menambahkan penetapan peran

Tetapkan penetapan peran Azure App Configuration yang tepat ke informasi masuk yang digunakan dalam tugas sehingga tugas dapat mengakses penyimpanan Azure App Configuration.

  1. Buka penyimpanan Azure App Configuration target Anda.

  2. Di menu sebelah kiri, pilih Kontrol akses (IAM).

  3. Di panel kanan, pilih Tambahkan penetapan peran.

    Cuplikan layar memperlihatkan tombol Tambahkan penetapan peran.

  4. Di bawahPeran, pilih Pemilik Data Azure App Configuration. Peran ini memungkinkan tugas untuk membaca dari dan menulis ke penyimpanan Azure App Configuration.

  5. Pilih prinsipal perwakilan layanan yang terkait dengan koneksi layanan yang Anda buat di bagian sebelumnya.

    Cuplikan layar yang memperlihatkan dialog Tambahkan penetapan peran.

  6. Pilih Tinjau + tetapkan.

Menggunakan dalam build

Bagian ini membahas cara menggunakan tugas Impor Azure App Configuration di alur build Azure DevOps.

  1. Buka halaman alur build dengan mengeklik Alur>Alur. Untuk informasi selengkapnya tentang alur build, buka Membuat alur pertama Anda.
    • Jika Anda membuat alur build baru, pada langkah terakhir proses yaitu pada tab Tinjau, pilih Tampilkan asisten di sisi kanan alur.

      Cuplikan layar menunjukkan tombol Perlihatkan asisten untuk alur baru.

    • Jika Anda menggunakan alur build yang sudah ada, klik tombol Edit di kanan atas.

      Cuplikan layar menunjukkan tombol Edit untuk alur yang sudah ada.

  2. Cari Tugas Impor Azure App Configuration.

    Cuplikan layar memperlihatkan dialog Tambahkan Tugas dengan Impor Azure App Configuration di kotak pencarian.

  3. Konfigurasikan parameter yang diperlukan untuk tugas guna mengimpor nilai kunci dari file konfigurasi ke penyimpanan App Configuration. Penjelasan parameter tersedia di bagian Parameter , dan di tipsalat di samping setiap parameter.

    Cuplikan layar memperlihatkan parameter tugas impor konfigurasi aplikasi.

  4. Menyimpan dan mengantrekan build. Log build menampilkan kegagalan apa pun yang terjadi selama eksekusi tugas.

Menggunakan dalam rilis

Bagian ini membahas cara menggunakan tugas Impor Azure App Configuration dalam alur rilis Azure DevOps.

  1. Buka halaman alur rilis dengan memilih Alur>Rilis. Untuk informasi selengkapnya tentang alur rilis, buka Membuat alur rilis pertama Anda.
  2. Pilih alur rilis yang ada. Jika Anda tidak memiliki alur rilis yang ada, pilih + Baru untuk membuat alur rilis baru.
  3. Pilih tombol Edit di pojok kanan atas untuk mengedit alur rilis.
  4. Dari menu drop-down Tugas, pilih Tahap yang ingin Anda tambahkan tugasnya. Informasi selengkapnya tentang tahapan dapat ditemukan di Tambahkan tahapan, dependensi, & kondisi.

    Cuplikan layar menunjukkan tahap yang dipilih di menu drop-down Tugas.

  5. Klik + di samping Pekerjaan yang ingin ditambahkan tugas barunya.

    Cuplikan layar menunjukkan tombol plus di samping pekerjaan.

  6. Dalam dialog Tambahkan tugas, ketik Impor Azure App Configuration ke dalam kotak pencarian dan pilih.
  7. Konfigurasikan parameter yang diperlukan dalam tugas untuk mengimpor nilai kunci anda dari file konfigurasi ke penyimpanan App Configuration Anda. Penjelasan parameter tersedia di bagian Parameter , dan di tipsalat di samping setiap parameter.
  8. Menyimpan dan mengantrekan rilis. Log rilis menampilkan kegagalan apa pun yang ditemui selama eksekusi tugas.

Parameter

Parameter berikut digunakan oleh tugas Impor App Configuration:

  • Azure subscription: Menu drop-down yang berisi koneksi layanan Azure yang tersedia. Untuk memperbarui dan me-refresh daftar koneksi layanan Azure yang tersedia, tekan tombol Refresh Azure subscription di sebelah kanan kotak teks.
  • Titik Akhir App Configuration: Drop-down yang memuat titik akhir penyimpanan konfigurasi yang tersedia di bawah langganan yang dipilih. Untuk memperbarui dan menyegarkan daftar titik akhir penyimpanan konfigurasi yang tersedia, tekan tombol Refresh Titik Akhir Konfigurasi Aplikasi di sebelah kanan kotak teks.
  • Jalur File Konfigurasi: Jalur ke file konfigurasi Anda. Parameter Jalur File Konfigurasi dimulai pada akar repositori file. Anda dapat menelusuri artefak build untuk memilih file konfigurasi. (tombol ... di sebelah kanan kotak teks). Format file yang didukung bergantung pada profil konten file. Untuk profil default, format file yang didukung adalah yaml, json, dan properti. Untuk profil KvSet, format file yang didukung adalah json.
  • Profil Konten File: Profil konten File Konfigurasi. Nilai defaultnya adalah Default.
    • Default: Mengacu pada format file konfigurasi konvensional yang secara langsung dapat dikonsumsi oleh aplikasi.
    • Kvset: Mengacu pada skema file yang berisi semua properti nilai kunci App Configuration, termasuk kunci, nilai, label, jenis konten, dan tag. Parameter tugas 'Pemisah', 'Label', 'Tipe konten', 'Awalan', 'Tag', dan 'Kedalaman' tidak berlaku saat menggunakan profil Kvset.
  • Mode Impor: Nilai defaultnya adalah Semua. Menentukan perilaku saat mengimpor nilai kunci.
    • Semua: Mengimpor semua nilai kunci dalam file konfigurasi ke App Configuration.
    • Ignore-Match: Mengimpor hanya pengaturan yang tidak memiliki nilai kunci yang cocok dalam App Configuration. Nilai kunci yang cocok dianggap sebagai nilai kunci dengan kunci, label, nilai, jenis konten, dan tag yang sama.
  • Dry Run: Nilai default tidak dicentang.
    • Dicentang: Tidak ada pembaruan yang dilakukan untuk App Configuration. Sebagai gantinya, setiap pembaruan yang akan dilakukan dalam eksekusi normal dicetak ke konsol untuk ditinjau.
    • Tidak dicentang: Melakukan pembaruan apa pun pada App Configuration dan tidak mencetak ke konsol.
  • Pemisah: Pemisah yang digunakan untuk meratakan file .json dan .yml.
  • Kedalaman: Kedalaman file .json dan .yml diratakan.
  • Awalan: String ditambahkan ke awal setiap kunci yang diimpor ke penyimpanan App Configuration.
  • Label: String yang ditambahkan ke setiap nilai kunci sebagai label dalam penyimpanan App Configuration.
  • Jenis Konten: String ditambahkan ke setiap nilai kunci sebagai jenis konten dalam penyimpanan App Configuration.
  • Tag: Objek JSON dalam format {"tag1":"val1", "tag2":"val2"}, yang menentukan tag yang ditambahkan ke setiap nilai kunci yang diimpor ke penyimpanan App Configuration Anda.
  • Hapus nilai kunci yang tidak disertakan dalam file konfigurasi: Nilai default tidak dicentang. Perilaku opsi ini tergantung pada profil konten file konfigurasi.
    • Diperiksa:
      • Profil konten default: Menghapus semua nilai kunci di penyimpanan App Configuration yang cocok dengan awalan dan label yang ditentukan sebelum mengimpor nilai kunci baru dari file konfigurasi.
      • Profil konten Kvset: Menghapus semua nilai kunci di penyimpanan App Configuration yang tidak disertakan dalam file konfigurasi sebelum mengimpor nilai kunci baru dari file konfigurasi.
    • Tidak dicentang: Mengimpor semua nilai kunci dari file konfigurasi ke penyimpanan App Configuration dan membiarkan semua yang lain di penyimpanan App Configuration tetap utuh.

Pemecahan Masalah

Jika terjadi kesalahan tak terduga, log debug dapat diaktifkan dengan mengatur variabel alur system.debug ke true.

FAQ

Bagaimana cara mengunggah beberapa file konfigurasi?

Untuk mengimpor beberapa file konfigurasi ke penyimpanan App Configuration, buat beberapa instans tugas Impor Azure App Configuration dalam alur yang sama.

Bagaimana cara membuat referensi Key Vault atau bendera fitur menggunakan tugas ini?

Bergantung pada profil konten file yang Anda pilih, lihat contoh di dukungan Azure App Configuration untuk file konfigurasi.

Mengapa saya menerima kesalahan 409 saat mencoba mengimpor nilai kunci ke penyimpanan konfigurasi saya?

Pesan kesalahan Konflik 409 terjadi jika tugas mencoba menghapus atau menimpa nilai kunci yang dikunci di penyimpanan App Configuration.

Langkah selanjutnya

Untuk referensi lengkap parameter atau untuk menggunakan tugas alur ini di alur YAML, lihat dokumen berikut.

Referensi Tugas Impor Azure App Configuration

Untuk mempelajari cara mengekspor nilai kunci dari penyimpanan App Configuration Anda dan mengaturnya sebagai variabel alur Azure, lanjutkan ke dokumen berikut.

Mengekspor pengaturan dari App Configuration dengan alur Azure

Untuk mempelajari cara membuat rekam jepret di penyimpanan App Configuration, lanjutkan ke dokumen berikut.

Membuat rekam jepret di App Configuration dengan Azure Pipelines