Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
Fabric'te değişken kütüphanelerini kullanarak sürüm hattının aşamaları arasında yapılandırmaları yönetin ve değerleri Git'te kaydedin. Bu makalede, değişken kitaplıklarının yaşam döngüsü yönetimi ve sürekli tümleştirme ve sürekli teslim (CI/CD) bağlamında nasıl kullanılacağı açıklanmaktadır.
Değişken kitaplıkları ve dağıtım işlem hatları
Değişken değerlerini aşamalar arasında yönetmek için dağıtım işlem hatlarında değişken kitaplıkları ve bunların değerlerini dağıtabilirsiniz.
Bu önemli bilgileri unutmayın:
Değişken kitaplığındaki tüm değer kümeleri dağıtım işlem hattının tüm aşamalarında kullanılabilir, ancak bir aşamada yalnızca bir küme etkindir.
Her aşama için ayarlanan etkin değer bağımsız olarak seçilir. İstediğiniz zaman değiştirebilirsiniz.
Bir değişken kütüphanesi boş bir aşamaya dağıtıldığında, dağıtım Varsayılan değer kümesinin aktif olduğu bir çalışma alanı oluşturur. Hedef ortam başka bir değer seti gerektiriyorsa, hedef çalışma alanında değişken kütüphanesini açın, gerekli değer kümesini aktif olarak ayarlayın ve değişken kütüphanesini bağımlı öğeler veya dağıtım planı eylemleri çalıştırmadan önce kaydedin.
Dağıtımlar her aşamada seçilen etkin değer kümesini etkilemese de, değerleri değişken kitaplığında kendileri güncelleştirebilirsiniz. Çalışma alanında bulunan tüketici öğesi (örneğin, işlem hattı), etkin değer kümesinden doğru değeri otomatik olarak alır.
Dağıtım işlem hattının bir aşamasındaki değişkenlere veya değer kümelerine yönelik aşağıdaki işlemler, değişken kitaplığının farklı bir aşamadaki aynı öğeye kıyaslaFarklı form kaynağı olarak yansıtılmasına neden olur:
- Değişkenler eklendi, silindi veya düzenlendi
- Değer kümeleri eklendi veya silindi
- Değişkenlerin adları
- Değişkenlerin sırası
Etkin değer kümesinde yapılan basit bir değişiklik, karşılaştırdığınızda Farklı form kaynağı olarak kaydedilmez. Etkin değer kümesi, öğe yapılandırmasının bir parçasıdır, ancak tanıma dahil değildir. Bu nedenle dağıtım işlem hattı karşılaştırmalarında gösterilmez ve her dağıtımda üzerine tekrar yazılmaz.
Bir dağıtım planında Değişken kütüphane değerlerini kullanın
Bir dağıtım planı eylemi, literal parametre değeri yerine Değişken kütüphane referansı kullanabilir. Dağıtım çalıştığında, Fabric referansı hedef çalışma alanında Değişken kütüphanesinin aktif değer kümesini kullanarak çözer. Bu, aynı eylemin her dağıtım aşamasına özgü değerleri kullanmasına olanak tanır.
Dağıtımdan önce, hedef çalışma alanında referans verilen Değişken kütüphanesi ve değişkeni içerdiğinden ve doğru değer kümesinin aktif olduğundan emin olun. Dağıtım aktif değer kümesini değiştirmez. Dağıtım hedef çalışma alanını oluşturursa, Varsayılan, siz başka bir değer kümesini seçip kaydedene kadar etkin kalır.
Bir dağıtım planı eylemi için, bir parametrenin değeri olarak değişken referansı kullanabilirsiniz. Daha fazla bilgi için bkz. Parametreleri bir eyleme aktar.
Fabric referansı çözemiyorsa, referansın hangi kısmının başarısız olduğunu bildirir. Çözünürlük dizisi ve düzeltmeler için bkz. Değişken referans çözünürlük hataları.
Değişken kitaplıkları ve Git tümleştirmesi
Diğer Doku öğeleri gibi değişken kitaplıkları da kaynak denetimi için Git ile tümleştirilebilir. Değişken kitaplık öğeleri, Doku ile Git sağlayıcınız arasında koruyabileceğiniz ve eşitleyebileceğiniz klasörler olarak depolanır.
Öğe izinleri Git güncelleştirme ve işleme sırasında denetleniyor.
Aktif değer kümesi seçimi workspace state'dir ve Git'te saklanmaz. İlk senkronizasyon değişken kütüphanesini yeni bir çalışma alanına aktardığında, Varsayılan aktif olur. Hedef ortam başka bir değer seti gerektiriyorsa, yeni çalışma alanında içe aktarılan değişken kütüphanesini açın, gerekli değer kümesini aktif olarak ayarlayın ve bağımlı öğeler veya dağıtım planı eylemlerini çalıştırmadan önce değişken kütüphanesini kaydedin.
Değişken kitaplık öğesinin şeması, dört bölüm içeren bir JSON nesnesidir:
- Değer kümeleri klasörü
- Ayarlar
- Platform.json, otomatik olarak oluşturulan bir dosya
- Değişkenler
Değer kümeleri
Değişken kitaplığı klasörü adlı valueSetsbir alt klasör içerir. Bu klasör her değer kümesi için bir JSON dosyası içerir. Bu JSON dosyası yalnızca bu değer kümesindeki varsayılan olmayan değerlerin değişken değerlerini içerir.
Değer kümesi dosyası hakkında daha fazla bilgi için bkz. değer kümeleri ve değer kümesi örneği.
Bu dosyada olmayan değişkenlerin değerleri varsayılan değer kümesinden alınır.
Ayarlar
Dosya, settings.json değişken kitaplığının ayarlarını içerir.
Daha fazla bilgi için bkz. değişkenler ve settings.json örneği.
Değişkenler
Dosya, variables.json değişken adlarını ve varsayılan değerlerini içerir.
Daha fazla bilgi için variables.json örneğine bakın.
Dikkat edilmesi gerekenler ve sınırlamalar
Değişkenler için sınırlamalar
Bu gereksinimlerin ikisini de karşıladığınız sürece en fazla1.000 değişken ve 1.000'e kadar değer kümesi olabilir:
- Alternatif değer kümelerindeki toplam hücre sayısı 10.000'den azdır.
- Öğenin boyutu 1 MB'ı aşmaz.
Değişiklikleri kaydettiğinizde bu gereksinimler doğrulanır.
Not alanında en çok 2.048 karakter olabilir.
Değer kümesi açıklama alanında en çok 2.048 karakter olabilir.
Alternatif değer kümeleri için sınırlamalar
- Değişken kitaplığındaki alternatif değer kümeleri, bunları eklediğiniz sırada görünür. Şu anda kullanıcı arabiriminde bunları yeniden sıralayamazsınız. Sırayı değiştirmek için JSON dosyasını doğrudan düzenleyin.
- Her değer kümesinin adı bir değişken kitaplığı içinde benzersiz olmalıdır.
- Değişken adları bir değişken kitaplığı içinde benzersiz olmalıdır. Farklı öğelerde olduklarında, çalışma alanında aynı ada sahip iki değişkeniniz olabilir.
- Değişken kitaplığında bir kerede her zaman bir (ve yalnızca bir) etkin değer ayarlanır. Etkinken bir değer kümesini silemezsiniz. Silmek için önce başka bir değer kümesini etkin olacak şekilde yapılandırın. Dağıtım işlem hattının her aşaması için farklı bir etkin değer ayarlayabilirsiniz.