Variabilná knižnica CI/CD

Používajte knižnice premenných v Fabric na správu konfigurácií naprieč fázami release pipeline a na ukladanie hodnôt v Gite. Tento článok vysvetľuje, ako používať premenné knižnice v kontexte správy životného cyklu a nepretržitej integrácie a nepretržitého doručovania (CI/CD).

Knižnice premenných a kanály nasadenia

Knižnice premenných a ich hodnoty môžete nasadiť v kanáloch nasadenia na správu hodnôt premenných naprieč fázami.

Zapamätajte si tieto dôležité informácie:

• Všetky množiny hodnôt v knižnici premenných sú k dispozícii pre všetky fázy kanála nasadenia, ale vo fáze je aktívna iba jedna množina.

• Aktívna hodnota nastavená pre každú fázu sa vyberá nezávisle. Môžete ho kedykoľvek zmeniť.

• Keď prvýkrát nasadíte alebo potvrdíte knižnicu premenných, aktívna množina knižnice má predvolenú hodnotu. Túto hodnotu môžete zmeniť prístupom k novovytvorenej knižnici premenných v cieľovej fáze alebo úložisku a zmenou aktívnej množiny.

  

• Hoci nasadenia neovplyvňujú vybratú aktívnu hodnotu nastavenú v každej fáze, môžete aktualizovať samotné hodnoty v knižnici premenných. Spotrebiteľská položka vo svojom pracovnom priestore (napríklad kanál) automaticky prijíma správnu hodnotu z množiny aktívnych hodnôt.

Nasledujúce operácie s premennými alebo množinami hodnôt v jednej fáze kanála nasadenia spôsobia, že knižnica premenných sa prejaví ako iný zdroj formulárav porovnaní s rovnakou položkou v inej fáze:

• Pridané, odstránené alebo upravené premenné
• Pridané alebo odstránené množiny hodnôt
• Názvy premenných
• Poradie premenných

Jednoduchá zmena aktívnej množiny hodnôt sa pri porovnaní nezaregistruje ako iný zdroj formulára . Aktívna množina hodnôt je súčasťou konfigurácie položky, ale nie je zahrnutá v definícii. Preto sa nezobrazuje v porovnaní kanála nasadenia a neprepisuje sa pri každom nasadení.

Knižnice premenných a integrácia Git

Podobne ako iné položky Fabric, aj knižnice premenných je možné integrovať s Gitom na správu zdrojového kódu. Variabilné položky knižnice sú uložené ako priečinky, ktoré môžete udržiavať a synchronizovať medzi Fabric a poskytovateľom Git.

Povolenia položiek sa kontrolujú počas aktualizácie a odovzdania Gitu.

Schéma pre položku knižnice premenných je objekt JSON, ktorý obsahuje štyri časti:

• Priečinok pre množiny hodnôt
• Nastavenie
• Platform.json, automaticky vygenerovaný súbor
• Premenné

Súbory hodnôt

Priečinok knižnice premenných obsahuje podpriečinok s názvom valueSets. Tento priečinok obsahuje súbor JSON pre každú množinu hodnôt. Tento súbor JSON obsahuje iba hodnoty premenných pre iné ako predvolené hodnoty v danej množine hodnôt.

Pre viac informácií o súbore hodnôt pozri množiny hodnôt a príklad množiny hodnôt.

Hodnoty premenných, ktoré nie sú v tomto súbore, sa prevezmú z predvolenej množiny hodnôt.

Nastavenie

Súbor settings.json obsahuje nastavenia pre knižnicu premenných.

Pre viac informácií pozri premenné a príkladsettings.json.

Premenné

Súbor variables.json obsahuje názvy premenných a ich predvolené hodnoty.

Ďalšie informácie nájdete v variables.json príklade.

Dôležité informácie a obmedzenia

Obmedzenia premenných

• Môže existovať až 1 000 premenných a až 1 000 množín hodnôt, pokiaľ spĺňate obe tieto požiadavky:

  • Celkový počet buniek v alternatívnych množinách hodnôt je menší ako 10 000.
  • Veľkosť položky nepresahuje 1 MB.

  Tieto požiadavky sa overia pri ukladaní zmien.

• Pole poznámky môže mať maximálne 2 048 znakov.

• Pole popisu množiny hodnôt môže mať až 2 048 znakov.

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.

Súvisiaci obsah

• formát zdrojového kódu integrácie Git