Pustaka variabel CI/CD

Gunakan pustaka variabel di Fabric untuk mengelola konfigurasi di seluruh tahapan alur rilis dan untuk menyimpan nilai di Git. Artikel ini menjelaskan cara menggunakan pustaka variabel dalam konteks manajemen siklus hidup dan integrasi berkelanjutan dan pengiriman berkelanjutan (CI/CD).

Pustaka variabel dan alur penyebaran

Anda dapat menyebarkan pustaka variabel dan nilainya dalam alur penyebaran untuk mengelola nilai variabel di seluruh tahap.

Cuplikan layar alur penyebaran.

Ingat informasi penting ini:

  • Semua kumpulan nilai dalam pustaka variabel tersedia untuk semua tahap pipeline deployment, tetapi hanya satu kumpulan yang aktif pada suatu tahap.

  • Nilai aktif yang ditetapkan untuk setiap tahap dipilih secara independen. Anda dapat mengubahnya kapan saja.

  • Saat Anda pertama kali menyebarkan atau menerapkan pustaka variabel, kumpulan aktif pustaka memiliki nilai default. Anda dapat mengubah nilai ini dengan mengakses pustaka variabel yang baru dibuat di tahap target atau repositori dan mengubah set aktif.

    Cuplikan layar perintah untuk mengubah nilai aktif yang ditetapkan dari default ke nilai alternatif yang ditetapkan dalam alur penyebaran.

  • Meskipun deployment tidak memengaruhi kumpulan nilai aktif yang dipilih di setiap tahap, Anda dapat memperbarui nilainya sendiri di pustaka variabel. Item konsumen di ruang kerjanya (misalnya, pipa) secara otomatis mendapatkan nilai yang sesuai dari set nilai aktif.

Operasi berikut untuk variabel atau set nilai dalam satu tahap alur penyebaran menyebabkan pustaka variabel tercermin sebagai Sumber formulir yang berbedadibandingkan dengan item yang sama dalam tahap yang berbeda:

  • Menambahkan, menghapus, atau mengedit variabel
  • Set nilai yang ditambahkan atau dihapus
  • Nama variabel
  • Urutan variabel

Cuplikan layar perbandingan pipeline deployment dengan pustaka variabel yang terlihat berbeda di kedua tahap.

Perubahan sederhana pada kumpulan nilai aktif tidak terdeteksi sebagai Sumber form yang berbeda saat dibandingkan. Kumpulan nilai aktif adalah bagian dari konfigurasi item, tetapi tidak disertakan dalam definisi. Itulah sebabnya itu tidak muncul pada perbandingan alur penyebaran dan tidak ditimpa pada setiap penyebaran.

Pustaka variabel dan integrasi Git

Seperti item Fabric lainnya, pustaka variabel dapat diintegrasikan dengan Git untuk kontrol sumber. Item pustaka variabel disimpan sebagai folder yang dapat Anda pertahankan dan sinkronkan antara Fabric dan penyedia Git Anda.

Izin item diperiksa saat pembaruan dan commit Git.

Skema untuk item pustaka variabel adalah objek JSON yang berisi empat bagian:

  • Folder untuk kumpulan nilai
  • Pengaturan
  • Platform.json, file yang dihasilkan secara otomatis
  • Variabel

Cuplikan layar folder Git dengan file pustaka variabel di dalamnya.

Kumpulan nilai

Folder pustaka variabel berisi subfolder yang disebut valueSets. Folder ini berisi file JSON untuk setiap set nilai. File JSON ini hanya berisi nilai variabel untuk nilai non-default dalam kumpulan nilai tersebut.

Untuk informasi selengkapnya tentang file kumpulan nilai, lihat kumpulan nilai dan contoh kumpulan nilai.

Nilai untuk variabel yang tidak ada dalam file ini diambil dari kumpulan nilai default.

Pengaturan

File settings.json berisi pengaturan untuk pustaka variabel.

Untuk informasi selengkapnya, lihat variabel dan contohsettings.json.

Variabel

File variables.json berisi nama variabel dan nilai defaultnya.

Untuk informasi selengkapnya, lihat contoh variables.json.

Pertimbangan dan batasan

Batasan untuk variabel

  • Mungkin ada hingga 1.000 variabel dan hingga 1.000 set nilai, selama Anda memenuhi kedua persyaratan ini:

    • Jumlah total sel dalam set nilai alternatif kurang dari 10.000.
    • Ukuran item tidak melebihi 1 MB.

    Persyaratan ini divalidasi saat Anda menyimpan perubahan.

  • Bidang catatan dapat memiliki hingga 2.048 karakter.

  • Bidang deskripsi himpunan nilai dapat memiliki hingga 2.048 karakter.

Batasan untuk kumpulan nilai alternatif

  • Set nilai alternatif dalam pustaka variabel muncul dalam urutan Anda menambahkannya. Saat ini, Anda tidak dapat menyusun ulang di UI. Untuk mengubah urutan, edit file JSON secara langsung.
  • Nama setiap set nilai harus unik dalam pustaka variabel.
  • Nama variabel harus unik dalam pustaka variabel. Anda dapat memiliki dua variabel dengan nama yang sama di ruang kerja jika berada di item yang berbeda.
  • Selalu ada satu (dan hanya satu) nilai aktif dalam pustaka variabel pada satu waktu. Anda tidak dapat menghapus nilai yang ditetapkan saat aktif. Untuk menghapusnya, pertama-tama konfigurasikan nilai lain yang diatur menjadi aktif. Anda dapat memiliki nilai aktif yang berbeda yang ditetapkan untuk setiap tahap alur penyebaran.

Konten terkait

  • Last updated on