Değişken kütüphanesi CI/CD

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.

Dağıtım işlem hattının ekran görüntüsü.

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 kitaplığını ilk kez dağıttığınızda veya kaydettiğinizde, kitaplığın etkin kümesi varsayılan değere sahiptir. Hedef aşamada veya depoda yeni oluşturulan değişken kitaplığına erişerek ve etkin kümeyi değiştirerek bu değeri değiştirebilirsiniz.

    Etkin bir değer kümesini varsayılan değerden dağıtım işlem hattında ayarlanan alternatif değere değiştirmeye yönelik komutun ekran görüntüsü.

  • 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ı

İki aşamada farklı olarak gösterilen değişken kitaplığıyla karşılaştırılan dağıtım işlem hatlarının ekran görüntüsü.

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.

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.

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ğişken kitaplık dosyalarının bulunduğu git klasörünün ekran görüntüsü.

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.