Hodnotové množiny v knižniciach premenných

Hodnotové množiny v knižnici premenných poskytujú alternatívne množiny hodnôt definovaných premenných, podporujúce scenáre ako konfigurácie špecifické pre prostredie (napríklad vývoj, test, produkcia), A/B testovanie alebo prepínanie zdrojov dát v rámci toho istého pracovného priestoru.

Každá množina hodnôt je vytvorená ako množina ukazovateľov na hodnotu predvolených premenných, ktoré je možné podľa potreby prepísať. V danom pracovnom priestore môže byť aktívna iba jedna množina hodnôt a používatelia môžu aktívnu sadu jednoducho prepínať cez UI alebo API.

Hodnotové množiny sú v knižnici jednoznačne pomenované a môžu byť premenované, preusporiadané (iba cez git alebo aktualizáciu s definíciou API) alebo vymazané (s ochranou na zabránenie vymazaniu aktívnej množiny bez opätovného priradenia). Systém sleduje zmeny a vynucuje limity veľkosti, aby zabezpečil výkon, a akákoľvek úprava hodnotových súborov je overená pred uložením. Táto štruktúra umožňuje robustné riadenie konfigurácie, čo vývojárom umožňuje automatizovať nasadenia a udržiavať konzistentnosť naprieč viacerými prostrediami a fázami.

Štruktúra a implementácia hodnotových množín

Definícia položky knižnice premenných podporuje viacero hodnotových množín. V schéme položky (jej JSON definícia) primárna sekcia uvádza všetky premenné a ich predvolené hodnoty. Táto sekcia sa často nazýva súbor "Default values" v Git. Každá množina dodatočných hodnôt je uložená ako samostatná entita (alebo súbor) obsahujúca iba premenné, ktoré sa líšia od predvolenej. Ak je hodnota premennej v danej množine hodnôt rovnaká ako predvolená, nie je explicitne opakovaná v definícii tejto množiny.

• Predvolená sada hodnôt: Vždy sú prítomné a obsahujú základnú hodnotu každej premennej (spolu s metadátami ako názov a typ). Súbor s predvolenými hodnotami enumeruje všetky premenné s ich predvolenými (primárnymi) hodnotami.

• Alternatívna množina hodnôt: Pre každú ďalšiu množinu hodnôt (napríklad sadu hodnôt "Test" alebo "Prod") definícia uvádza len tie premenné, kde hodnota prepisuje predvolenú. Ak premenná nie je uvedená v konkrétnom súbore hodnôt, implicitne používa predvolenú hodnotu pre túto množinu.

Príklad: Ak máte premennú ConnectionString s predvolenou hodnotou "dev-server" a vytvoríte sadu hodnôt "Production", ktorá ju prepíše na "prod-server", predvolená definícia bude mať ConnectionString = "dev-server" a súbor hodnôt "Production" bude obsahovať ConnectionString = "prod-server" (a nič pre premenné, ktoré zostávajú nezmenené). Tento prístup udržiava definície hodnotových množín úsporné a zdôrazňuje len rozdiely.

Reprezentácia správy zdrojového kódu

V integrácii Fabric s Gitom sa predchádzajúca schéma prekladá do viacerých súborov pod priečinkom knižnice premenných. Podľa návrhu je každá množina hodnôt serializovaná do vlastného JSON súboru (pomenovaného podľa množiny hodnôt), ktorý obsahuje jeho prepísania, oddelene od súboru predvolených hodnôt. Napríklad VL položka "MyVars" môže mať:

MyVars_Default.json – predvolené hodnoty všetkých premenných. MyVars_Prod.json – len premenné, ktorých hodnoty sa líšia pre fázu "produkcie". MyVars_Test.json – len premenné, ktorých hodnoty sa líšia pre fázu "Test".

Toto jasné oddelenie znamená, že môžete sledovať zmeny konfigurácie každého prostredia nezávisle v správe zdrojového kódu.

Dôležité je, že výber aktívnej množiny hodnôt nie je súčasťou týchto definačných súborov – je uložený ako stav položky (nastavenie na úrovni pracovného priestoru), aby nasadenie alebo importovanie položky neprepísalo, ktorá množina hodnôt je aktuálne aktívna v danom pracovnom priestore. (Viac o aktívnych hodnotových množinách nižšie.)

Schéma a dátové typy

Hodnotové množiny nezavádzajú nové dátové typy; obsahujú hodnoty rovnakých typov definovaných každou premennou. Definícia položky zaznamenáva názov, typ, predvolenú hodnotu a voliteľnú poznámku každej premennej. Komplexné typy premenných ako Item reference a Connection reference majú štruktúrované schémy (ukladanie ID), ale tieto hodnoty sú reprezentované v každej hodnotovej množine pomocou konzistentnej JSON štruktúry (napríklad item reference uchováva workspace ID + item ID pre danú fázu). Všetky súbory hodnotových množín nasledujú rovnakú schému ako predvolené: v podstate mapovanie názvov premenných na hodnoty danej množiny (vrátane iba tých, ktoré sa od predvolených líšia).

Konvencie pomenovania hodnotových množín

Názov množiny hodnôt v knižnici premenných musí dodržiavať tieto konvencie:

• Nie je prázdny
• Nemá úvodné ani koncové medzery
• Začína písmenom alebo podčiarknutím
• Môže obsahovať písmená, číslice, podčiarkovníky a spojovníky
• Dĺžka nepresahuje 256 znakov

Keď má premenná definovanú hodnotu, ak sa pokúsite zmeniť jej typ, zobrazí sa dialógové okno súhlasu. Dialógové okno vás upozorní, že všetky hodnoty premenných budú resetované a že táto zmena môže byť zásadnou zmenou na strane spotrebiteľskej položky.

Dôležité informácie a obmedzenia

Obmedzenia pre alternatívne množiny hodnôt

• Alternatívne množiny hodnôt v knižnici premenných sa zobrazujú v poradí, v akom ste ich pridali. V súčasnosti ich nie je možné zmeniť v používateľskom rozhraní. Ak chcete zmeniť poradie, upravte súbor JSON priamo.
• Názov každej množiny hodnôt musí byť v knižnici premenných jedinečný.
• Názvy premenných musia byť v knižnici premenných jedinečné. V pracovnom priestore môžete mať dve premenné s rovnakým názvom, ak sa nachádzajú v rôznych položkách.
• V knižnici premenných je vždy nastavená jedna (a len jedna) aktívna hodnota. Množinu hodnôt nemôžete odstrániť, keď je aktívna. Ak ho chcete odstrániť, najskôr nakonfigurujte inú množinu hodnôt tak, aby bola aktívna. Pre každú fázu kanála nasadenia môžete nastaviť inú aktívnu hodnotu.