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 jest ustrukturyzowana w celu obsługi wielu zestawów wartości. W schemacie elementu (jego definicji JSON) wszystkie zmienne i ich wartości domyślne są wymienione w sekcji podstawowej (często nazywanej plikiem "Wartości domyślne" w usłudze Git). Każdy dodatkowy zestaw wartości jest przechowywany jako oddzielna jednostka (lub plik) zawierająca tylko zmienne, które różnią się od domyślnego. Innymi słowy, jeśli wartość zmiennej w danym zestawie wartości jest taka sama jak domyślna, nie jest jawnie powtarzana w definicji tego zestawu wartości.

• 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 przypadku integracji Git w systemie Fabric, powyższy schemat przekłada się na wiele plików w folderze Zmienne Biblioteka. 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, mają strukturalne schematy (przechowujące identyfikatory), 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 przestrzeni roboczej 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.