Poznámka:
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
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.
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 nasazení knihovny proměnných do prázdné fáze se vytvoří pracovní prostor, v němž je aktivní sada hodnot Default. Pokud cílové prostředí vyžaduje jinou sadu hodnot, otevřete knihovnu proměnných v cílovém pracovním prostoru, nastavte požadovanou sadu hodnot jako aktivní a uložte knihovnu proměnných před spuštěním závislých položek nebo akcí plánu 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
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.
Použijte v plánu nasazení hodnoty proměnných z knihovny
Akce deployment plan může místo literální hodnoty parametru použít odkaz na knihovnu proměnných. Když se nasazení spustí, Fabric vyřeší referenci použitím aktivní hodnotové sady knihovny proměnných v cílovém pracovním prostoru. To umožňuje téže akci používat hodnoty specifické pro každou fázi nasazení.
Před nasazením se ujistěte, že cílový pracovní prostor obsahuje odkazovanou knihovnu proměnných a proměnnou a že je aktivní správná sada hodnot. Nasazení nemění sadu aktivních hodnot. Pokud nasazení vytvoří cílový pracovní prostor, výchozí nastavení je aktivní, dokud nevyberete a neuložíte jinou sadu hodnot.
Pro akci v plánu nasazení můžete použít proměnnou referenci jako hodnotu parametru. Pro více informací viz Předání parametrů akci.
Pokud Fabric nemůže vyřešit referenci, hlásí, která část reference selhala. Pro sekvenci rozlišení a opravy viz Selhání proměnných referenčních rozlišení.
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.
Výběr aktivní hodnoty je stav pracovního prostoru a není uložen v Gitu. Když počáteční synchronizace importuje knihovnu proměnných do nového pracovního prostoru, je aktivní Výchozí . Pokud cílové prostředí vyžaduje jinou sadu hodnot, otevřete importovanou knihovnu proměnných v novém pracovním prostoru, nastavte požadovanou sadu hodnot jako aktivní a uložte knihovnu proměnných před spuštěním závislých položek nebo akcí plánu nasazení.
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é
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.