Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
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.
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.
Ketika pustaka variabel diterapkan ke stage yang kosong, penerapan tersebut membuat ruang kerja dengan set nilai Default yang aktif. Jika lingkungan target memerlukan set nilai lain, buka pustaka variabel di workspace target, atur set nilai yang diperlukan sebagai aktif, dan simpan pustaka variabel sebelum menjalankan item tergantung atau tindakan rencana 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
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.
Gunakan nilai pustaka Variabel dalam rencana penyebaran
Tindakan rencana penerapan dapat menggunakan referensi pustaka Variabel sebagai pengganti nilai parameter literal. Saat penerapan dijalankan, Fabric menentukan referensi dengan menggunakan kumpulan nilai aktif dari pustaka Variabel di ruang kerja target. Ini memungkinkan aksi yang sama menggunakan nilai yang spesifik untuk setiap tahap deployment.
Sebelum melakukan deployment, pastikan ruang kerja target berisi pustaka Variabel dan variabel yang dirujuk, serta kumpulan nilai yang benar sedang aktif. Penerapan tidak mengubah set nilai aktif. Jika penerapan membuat ruang kerja target, Default akan tetap aktif hingga Anda memilih dan menyimpan kumpulan nilai lain.
Untuk aksi rencana penyebaran, Anda dapat menggunakan referensi variabel sebagai nilai parameter. Untuk informasi lebih lanjut, lihat Pass parameter ke sebuah aksi.
Jika Fabric tidak dapat menyelesaikan referensi, ia akan melaporkan bagian referensi mana yang gagal. Untuk urutan resolusi dan perbaikan, lihat Kegagalan resolusi referensi variabel.
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.
Pilihan set nilai aktif adalah status workspace dan tidak disimpan di Git. Ketika sinkronisasi awal mengimpor pustaka variabel ke ruang kerja baru, Default akan aktif. Jika lingkungan target memerlukan set nilai lain, buka pustaka variabel yang diimpor di workspace baru, atur set nilai yang diperlukan sebagai aktif, dan simpan pustaka variabel sebelum menjalankan item tergantung atau tindakan rencana penyebaran.
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
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.