CI/CD správa knihovny proměnných

Používejte knihovny proměnných ve Fabric ke správě konfigurací napříč fázemi release pipeline a k ukládání hodnot v Gitu. Tento článek vysvětluje, jak používat knihovny proměnných v kontextu správy životního cyklu a kontinuální integrace a průběžného doručování (CI/CD).

Knihovny proměnných a kanály nasazení

V kanálech průběžného nasazování můžete nasadit knihovny proměnných a jejich hodnoty ke správě hodnot proměnných napříč fázemi.

Snímek obrazovky s kanálem nasazení

Mějte na paměti tyto důležité informace:

  • Všechny sady hodnot v knihovně proměnných jsou k dispozici pro všechny fáze kanálu nasazení, ale ve fázi je aktivní pouze jedna sada.

  • Aktivní hodnota nastavená pro každou fázi je vybrána nezávisle. Můžete ho kdykoli změnit.

  • Při prvním nasazení nebo potvrzení knihovny proměnných má aktivní sada knihovny výchozí hodnotu. Tuto hodnotu můžete změnit tak, že přejdete k nově vytvořené knihovně proměnných v cílové fázi nebo úložišti a změníte aktivní sadu.

    Snímek obrazovky s příkazem pro změnu aktivní hodnoty nastavené z výchozí hodnoty na alternativní hodnotu nastavenou v kanálu nasazení

  • Přestože nasazení nemají vliv na vybranou aktivní hodnotu nastavenou v každé fázi, můžete aktualizovat hodnoty samotné v knihovně proměnných. Spotřebitelská položka v pracovním prostoru (například potrubí) automaticky obdrží správnou hodnotu z aktivní sady hodnot.

Následující operace s proměnnými nebo sadami hodnot v jedné fázi kanálu nasazení způsobí, že se knihovna proměnných projeví jako jiný zdroj formulářeve srovnání se stejnou položkou v jiné fázi:

  • Přidání, odstranění nebo úprava proměnných
  • Přidání nebo odstranění sad hodnot
  • Názvy proměnných
  • Pořadí proměnných

Snímek obrazovky s porovnáním kanálů nasazování, kde se knihovna proměnných v obou fázích zobrazuje odlišně.

Jednoduchá změna sady aktivních hodnot se při porovnání neregistruje jako jiný zdroj formuláře . Aktivní sada hodnot je součástí konfigurace položky, ale není součástí definice. Proto se nezobrazuje v porovnání kanálů nasazení a není při každém nasazení přepsán.

Integrace proměnných knihoven a Gitu

Stejně jako ostatní položky infrastruktury je možné knihovny proměnných integrovat s Gitem pro správu zdrojového kódu. Položky v knihovně proměnných jsou uložené jako složky, které můžete spravovat a synchronizovat mezi Fabric a vaším poskytovatelem služby Git.

Oprávnění k položce se kontrolují během aktualizace a potvrzení Gitu.

Schéma položky knihovny proměnných je objekt JSON, který obsahuje čtyři části:

  • Složka pro sady hodnot
  • Nastavení
  • Platform.json, automaticky vygenerovaný soubor
  • Proměnné

Snímek obrazovky složky Git se soubory z knihovny proměnných v ní.

Sady hodnot

Složka knihovny proměnných obsahuje podsložku s názvem valueSets. Tato složka obsahuje soubor JSON pro každou sadu hodnot. Tento soubor JSON obsahuje pouze hodnoty proměnných pro jiné než výchozí hodnoty v této sadě hodnot.

Další informace o souboru sady hodnot najdete v tématu sady hodnot a příklad sady hodnot.

Hodnoty proměnných, které nejsou v tomto souboru, jsou převzaty z výchozí sady hodnot.

Nastavení

Soubor settings.json obsahuje nastavení pro knihovnu proměnných.

Další informace najdete v příkladu proměnných a settings.json.

Proměnné

Soubor variables.json obsahuje názvy proměnných a jejich výchozí hodnoty.

Další informace najdete v příkladuvariables.json.

Úvahy a omezení

Omezení proměnných

  • Může existovat až 1 000 proměnných a až 1 000 sad hodnot, pokud splňujete oba tyto požadavky:

    • Celkový počet buněk v alternativních sadách hodnot je menší než 10 000.
    • Velikost položky nepřesahuje 1 MB.

    Tyto požadavky se ověřují při ukládání změn.

  • Pole poznámky může mít až 2 048 znaků.

  • Pole popisu sady hodnot může mít až 2 048 znaků.

Omezení pro alternativní sady hodnot

  • Alternativní sady hodnot v knihovně proměnných se zobrazí v pořadí, ve kterém jste je přidali. V současné době je nemůžete v uživatelském rozhraní přeuspořádat. Pokud chcete změnit pořadí, upravte soubor JSON přímo.
  • Název každé sady hodnot musí být v knihovně proměnných jedinečný.
  • Názvy proměnných musí být v knihovně proměnných jedinečné. Pokud se nachází v různých položkách, můžete mít v pracovním prostoru dvě proměnné se stejným názvem.
  • V knihovně proměnných je vždy aktivní právě jedna sada hodnot. Hodnotu nastavenou v době, kdy je aktivní, nemůžete odstranit. Pokud ho chcete odstranit, nejprve nakonfigurujte jinou sadu hodnot tak, aby byla aktivní. Pro každou fázi kanálu nasazení můžete mít jinou sadu aktivních hodnot.

Související obsah

  • Last updated on