Zestawy wartości w bibliotekach zmiennych

Zestawy wartości w bibliotece zmiennych udostępniają alternatywne zestawy wartości dla zdefiniowanych zmiennych, które obsługują scenariusze, takie jak konfiguracje specyficzne dla środowiska (na przykład deweloperskie, testowe, produkcyjne), testowanie A/B lub zmiana źródła danych w ramach tego samego obszaru roboczego.

Każdy zestaw wartości jest tworzony jako kolekcja wskaźników do wartości zmiennych domyślnych, które można zastąpić zgodnie z potrzebami. W danym obszarze roboczym może być aktywny tylko jeden zestaw wartości, a użytkownicy mogą łatwo przełączać aktywny zestaw za pośrednictwem interfejsu użytkownika lub interfejsu API.

Zestawy wartości są unikatowo nazwane w bibliotece i można zmienić ich nazwę, zmienić kolejność (tylko za pomocą narzędzia git lub aktualizacji za pomocą interfejsu API definicji) lub usunąć (z zabezpieczeniami, aby zapobiec usunięciu aktywnego zestawu bez ponownego przypisania). System śledzi zmiany i wymusza limity rozmiaru w celu zapewnienia wydajności, a wszelkie modyfikacje zestawów wartości są weryfikowane przed zapisaniem. Ta struktura umożliwia niezawodne zarządzanie konfiguracją, dzięki czemu deweloperzy mogą zautomatyzować wdrożenia i zachować spójność w wielu środowiskach i etapach.

Struktura i implementacja zestawów wartości

Definicja elementu biblioteki zmiennych obsługuje wiele zbiorów wartości. W schemacie elementu (jego definicji JSON) sekcja główna wymienia wszystkie zmienne oraz ich wartości domyślne. Ta sekcja jest często nazywana plikiem "Default values" w Gicie. Każdy dodatkowy zbiór wartości jest przechowywany jako osobna jednostka (lub plik) zawierający jedynie zmienne różniące się od domyślnej. Jeśli wartość zmiennej w danym zbiorze jest taka sama jak domyślna, nie jest ona wyraźnie powtarzana w definicji tego zbioru.

• Domyślny zestaw wartości: Zawsze obecne i zawiera wartość punktu odniesienia każdej zmiennej (wraz z metadanymi, takimi jak nazwa i typ). Plik wartości domyślnych wylicza wszystkie zmienne z ich domyślnymi (podstawowymi) wartościami.

• Zestaw wartości alternatywnych: dla każdego dodatkowego zestawu wartości (na przykład zestawu wartości "Test" lub "Prod") definicja wyświetla tylko te zmienne, w których wartość zastępuje wartość domyślną. Jeśli zmienna nie znajduje się na liście w określonym pliku zestawu wartości, niejawnie używa wartości domyślnej dla tego zestawu.

Przykład: Jeśli masz zmienną ConnectionString z wartością domyślną "dev-server" i utworzysz zestaw wartości "Production" przesłaniający tę wartość na wartość "prod-server", domyślna definicja będzie miała wartość ConnectionString = "dev-server", a plik "Production" zestawu wartości będzie zawierać ConnectionString = "prod-server" (i nic dla zmiennych, które pozostają niezmienione). Takie podejście pozwala na utrzymanie zwięzłych definicji zestawów wartości i wyróżnia tylko różnice.

Reprezentacja kontroli źródła

W integracji usługi Fabric z usługą Git powyższy schemat jest odwzorowywany jako wiele plików w folderze biblioteki zmiennych. Zgodnie z projektem każdy zestaw wartości jest serializowany do własnego pliku JSON (nazwanego po zestawie wartości) zawierającego jego przesłonięcia, niezależnie od pliku wartości domyślnych. Na przykład element vl "MyVars" może mieć następujące elementy:

MyVars_Default.json — wartości domyślne wszystkich zmiennych. MyVars_Prod.json — tylko zmienne o wartościach różniących się w etapie "Prod". MyVars_Test.json — tylko zmienne o wartościach różniących się dla etapu "Test".

Ta wyraźna separacja oznacza, że można śledzić zmiany konfiguracji każdego środowiska niezależnie w kontroli źródła.

Co ważne, wybór aktywnego zestawu wartości nie jest częścią tych plików definicji — jest przechowywany jako stan elementu (ustawienie na poziomie obszaru roboczego), dzięki czemu wdrażanie lub importowanie elementu nie zastępuje tego, który zestaw wartości jest obecnie aktywny w danym obszarze roboczym. (Więcej informacji na temat aktywnych zestawów wartości poniżej).

Schemat i typy danych

Zestawy wartości nie wprowadzają nowych typów danych; przechowują wartości tych samych typów zdefiniowanych przez każdą zmienną. Definicja elementu rejestruje nazwę każdej zmiennej, typ, wartość domyślną i opcjonalną notatkę. Złożone typy zmiennych, takie jak Odwołanie do elementu i Odwołanie do połączenia, mają schematy strukturalne (przechowywanie identyfikatorów), ale te wartości są reprezentowane w każdym zestawie wartości przy użyciu spójnej struktury JSON (na przykład odwołanie do elementu przechowuje identyfikator obszaru roboczego i identyfikator elementu dla tego etapu). Wszystkie pliki zbioru wartości są zgodne z tą samą strukturą schematu co domyślna: zasadniczo jest to mapowanie nazw zmiennych na wartości tego zbioru (tylko te wartości, które różnią się od wartości domyślnych).

Konwencje nazewnictwa zestawów wartości

Nazwa zestawu wartości w bibliotece zmiennych musi być zgodna z następującymi konwencjami:

• Nie jest pusty
• Nie ma spacji wiodących ani końcowych
• Zaczyna się od litery lub podkreślenia
• Może zawierać litery, cyfry, podkreślenia i łączniki
• Długość nie przekracza 256 znaków

Gdy zmienna ma zdefiniowaną wartość, jeśli spróbujesz zmienić jej typ, zostanie wyświetlone okno dialogowe zgody. W oknie dialogowym zostanie wyświetlone alerty, że wszystkie wartości zmiennych zostaną zresetowane i że ta zmiana może być zmianą powodującą niezgodność po stronie elementu odbiorcy.

Uwagi i ograniczenia

Ograniczenia dotyczące zestawów wartości alternatywnych

• Zestawy wartości alternatywnych w bibliotece zmiennych są wyświetlane w kolejności, w której zostały dodane. Obecnie nie można zmienić ich kolejności w interfejsie użytkownika. Aby zmienić kolejność, przeprowadź bezpośrednią edycję pliku JSON.
• Nazwa każdego zestawu wartości musi być unikatowa w bibliotece zmiennych.
• Nazwy zmiennych muszą być unikatowe w bibliotece zmiennych. Jeśli znajdują się w różnych elementach, możesz mieć dwie zmienne o tej samej nazwie w obszarze roboczym.
• Zawsze istnieje jeden (i tylko jeden) aktywny zbiór wartości w bibliotece zmiennych. Nie można usunąć zestawu wartości, gdy jest ona aktywna. Aby go usunąć, najpierw skonfiguruj inny zestaw wartości jako aktywny. Można mieć różny aktywny zestaw wartości dla każdego etapu potoku wdrażania.