Değişken kitaplıklarındaki değer kümeleri

Değişken kitaplığındaki değer kümeleri, tanımlı değişkenler için alternatif değer kümeleri sağlar ve ortama özgü yapılandırmalar (örneğin geliştirme, test, üretim), A/B testi veya aynı çalışma alanı içinde veri kaynağı geçişi gibi senaryoları destekler.

Her değer kümesi, varsayılan değişken değerine yönelik bir işaretçi koleksiyonu olarak oluşturulur ve gerektiğinde geçersiz kılınabilir. Belirli bir çalışma alanı için aynı anda yalnızca bir değer kümesi etkin olabilir ve kullanıcılar kullanıcı arabirimi veya API aracılığıyla etkin kümeyi kolayca değiştirebilir.

Değer kümeleri kitaplık içinde benzersiz olarak adlandırılır ve yeniden adlandırılabilir, yeniden sıralanabilir (yalnızca git aracılığıyla veya tanım API'siyle güncelleştirme yoluyla) veya silinebilir (etkin kümenin yeniden atanmadan silinmesini önlemeye yönelik önlemlerle). Sistem, performansı sağlamak için değişiklikleri izler ve boyut sınırlarını zorlar ve değer kümelerinde yapılan tüm değişiklikler kaydedilmeden önce doğrulanır. Bu yapı, geliştiricilerin birden çok ortam ve aşamada dağıtımları otomatikleştirmesine ve tutarlılığı korumasına olanak tanıyan sağlam yapılandırma yönetimi sağlar.

Değer Kümelerinin Yapısı ve Uygulanması

Değişken Kitaplığı öğesinin tanımı birden çok değer kümesini destekleyecek şekilde yapılandırılmıştır. Öğenin şemasında (JSON tanımı), tüm değişkenler ve varsayılan değerleri birincil bölümde listelenir (genellikle Git'te "Varsayılan değerler" dosyası olarak adlandırılır). Her ek değer kümesi, yalnızca varsayılandan farklı değişkenleri içeren ayrı bir varlık (veya dosya) olarak depolanır. Başka bir deyişle, bir değişkenin belirli bir değer kümesindeki değeri varsayılan değerle aynıysa, bu değer kümesinin tanımında açıkça yinelenmemiştir.

• Varsayılan Değer Kümesi: Her zaman mevcut ve her değişkenin temel değerini (ad ve tür gibi meta verilerle birlikte) içerir. Varsayılan değerler dosyası, tüm değişkenleri varsayılan (birincil) değerleriyle numaralandırır.

• Alternatif Değer Kümesi: Her ek değer kümesi için (örneğin, "Test" veya "Üretim" değer kümesi), tanım yalnızca değerin varsayılanı geçersiz kıldığı değişkenleri listeler. Bir değişken belirli bir değer kümesi dosyasında listelenmiyorsa, bu küme için varsayılan değeri örtük olarak kullanır.

Örnek: Varsayılan değeri "dev-server" olan bir ConnectionString değişkeniniz varsa ve bunu "prod-server" olarak geçersiz kılarak bir "Üretim" değer kümesi oluşturursanız, Varsayılan tanım ConnectionString = "dev-server" değerine sahip olur ve "Üretim" değer kümesinin dosyası ConnectionString = "prod-server" (ve değişmeyen değişkenler için hiçbir şey) içermez. Bu yaklaşım değer kümesi tanımlarının yalın kalmasını sağlar ve yalnızca farkları vurgular.

Kaynak Denetimi Gösterimi

Fabric’in Git entegrasyonunda, yukarıdaki şema Değişken Kütüphanesi'nin klasörü altında birden çok dosyaya çevrilir. Tasarım gereği, her değer kümesi, geçersiz kılmalarını içeren ve değer kümesinin adını taşıyan ayrı bir JSON dosyasına serileştirilir ve bu dosya varsayılan değerler dosyasından ayrıdır. Örneğin, "MyVars" adlı bir VL öğesinde aşağıdakiler olabilir:

MyVars_Default.json – tüm değişkenlerin varsayılan değerleri. MyVars_Prod.json: Yalnızca "Üretim" aşaması için farklı değerlere sahip değişkenler. MyVars_Test.json: Yalnızca "Test" aşaması için farklı değerlere sahip değişkenler.

Bu net ayrım, her ortamın yapılandırmasındaki değişiklikleri kaynak denetiminde bağımsız olarak izleyebildiğiniz anlamına gelir.

Önemli olan, etkin değer kümesi seçimi tanım dosyalarına dahil edilmemiştir; bu değer kümeleri, belirli bir çalışma alanında hangi kümenin etkin olduğunu korumak için, öğe durumunda (çalışma alanı düzeyi ayarı) depolanır. Bu sayede öğeyi dağıtmak veya içeri aktarmak, hâlihazırda aktif olan değer kümesinin üzerine yazmaz. (Aşağıda etkin değer kümeleri hakkında daha fazla bilgi bulabilirsiniz.)

Şema ve Veri Türleri

Değer kümeleri yeni veri türleri sunmaz; her değişken tarafından tanımlanan aynı türlerdeki değerleri barındırırlar. Öğe tanımı her değişkenin adını, türünü, varsayılan değerini ve isteğe bağlı notu kaydeder. Öğe başvurusu gibi karmaşık değişken türleri yapılandırılmış şemalara sahiptir (kimlikleri depolar), ancak bu değerler tutarlı bir JSON yapısı kullanılarak her değer kümesinde gösterilir (Örneğin, öğe başvurusu söz konusu aşamanın öğesi için çalışma alanı kimliği + öğe kimliği depolar). Tüm değer kümesi dosyaları varsayılanla aynı şema yapısını izler: temelde değişken adlarının bu kümenin değerlerine eşlemini (yalnızca varsayılandan ayrılanlar dahil).

Değer kümeleri için adlandırma kuralları

Değişken kitaplığı içinde ayarlanan bir değerin adı şu kurallara uygun olmalıdır:

• Boş değil
• Başta veya sonda boşluk yok
• Harf veya alt çizgiyle başlar
• Harf, sayı, alt çizgi ve kısa çizgi içerebilir
• Uzunluğu 256 karakteri aşmaz

Bir değişken tanımlı bir değere sahip olduktan sonra, türünü değiştirmeye çalışırsanız bir onay iletişim kutusu görüntülenir. İletişim kutusu, tüm değişken değerlerinin sıfırlanacağı ve bu değişikliğin tüketici öğesi tarafında hataya neden olabilecek bir değişiklik olabileceği konusunda sizi uyarır.

Dikkat edilmesi gerekenler ve sınırlamalar

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.