Sdílet prostřednictvím

Export nastavení z konfigurace aplikace pomocí Azure Pipelines

  • Článek

Úloha exportu konfigurace Aplikace Azure exportuje hodnoty klíčů z obchodu App Configuration Store a nastaví je jako proměnné kanálu Azure, které můžou následné úlohy využívat. Tato úloha doplňuje úlohu importu konfigurace Aplikace Azure, která importuje hodnoty klíčů z konfiguračního souboru do obchodu App Configuration Store. Další informace najdete v tématu Import nastavení do konfigurace aplikace pomocí Azure Pipelines.

Požadavky

Vytvoření připojení služby

Připojení služby umožňuje přístup k prostředkům ve vašem předplatném Azure z projektu Azure DevOps.

  1. V Azure DevOps přejděte do projektu, který obsahuje váš cílový kanál. V levém dolním rohu vyberte Nastavení projektu.

  2. V části Pipelines (Kanály) vyberte Service connections (Připojení ke službám). V pravém horním rohu vyberte Nové připojení služby.

  3. V novém připojení služby vyberte Azure Resource Manager.

    Snímek obrazovky znázorňující výběr Azure Resource Manageru z rozevíracího seznamu Připojení k nové službě

  4. V dialogovém okně Metoda ověřování vyberte federaci identit úloh (automatická) a vytvořte novou federaci identit úloh nebo vyberte Federaci identit úloh (ruční) pro použití existující federace identit úloh.

  5. Zadejte své předplatné, skupinu prostředků a název připojení služby.

Pokud jste vytvořili nový instanční objekt, vyhledejte název instančního objektu přiřazeného k připojení služby. V dalším kroku přidáte k tomuto instančnímu objektu nové přiřazení role.

  1. Přejděte na připojení služby Nastavení>projektu.

  2. Vyberte nové připojení služby.

  3. Vyberte Spravovat instanční objekt.

  4. Poznamenejte si hodnotu v zobrazovaném názvu.

    Snímek obrazovky znázorňující zobrazovaný název instančního objektu

Přidat přiřazení role

Přiřaďte správná přiřazení role App Configuration k přihlašovacím údajům používaným v rámci úlohy, aby úloha byla přístup k App Configuration Storu.

  1. Přejděte do cílového obchodu App Configuration.

  2. V nabídce vlevo vyberte Řízení přístupu (IAM).

  3. V pravém podokně vyberte Přidat přiřazení rolí.

    Snímek obrazovky s tlačítkem Přidat přiřazení rolí

  4. Jako roli vyberte Čtenář dat konfigurace aplikace. Tato role umožňuje úloze číst z App Configuration Storu.

  5. Vyberte instanční objekt přidružený k připojení služby, které jste vytvořili v předchozí části.

    Snímek obrazovky s dialogovým oknem Přidat přiřazení role

  6. Vyberte Zkontrolovat + přiřadit.

  7. Pokud úložiště obsahuje odkazy na službu Key Vault, přejděte do příslušné služby Key Vault a přiřaďte roli uživatele tajného klíče služby Key Vault k instančnímu objektu vytvořenému v předchozím kroku. V nabídce služby Key Vault vyberte zásady přístupu a ujistěte se, že je jako model oprávnění vybraný řízení přístupu na základě role Azure.

Použití v buildech

Tato část popisuje, jak používat úlohu exportu konfigurace Aplikace Azure v kanálu buildu Azure DevOps.

  1. Kliknutím na Kanály pipelines (Kanály>kanálů) přejděte na stránku kanálu buildu. Dokumentaci ke kanálu buildu najdete v tématu Vytvoření prvního kanálu.
    • Pokud vytváříte nový kanál buildu, v posledním kroku procesu na kartě Revize vyberte Zobrazit asistenta na pravé straně kanálu.

    Snímek obrazovky s tlačítkem Zobrazit asistenta pro nový kanál

    • Pokud používáte existující kanál buildu, klikněte v pravém horním rohu na tlačítko Upravit .

    Snímek obrazovky ukazuje tlačítko Upravit pro existující kanál.

  2. Vyhledejte úlohu exportu konfigurace Aplikace Azure.

    Snímek obrazovky s dialogovým oknem Přidat úlohu s Aplikace Azure exportem konfigurace do vyhledávacího pole

  3. Pokud chcete exportovat hodnoty klíčů z App Configuration Storu, nakonfigurujte potřebné parametry pro úlohu. Popisy parametrů jsou k dispozici v části Parametry a v popisech vedle každého parametru.
    • Nastavte parametr předplatného Azure na název připojení služby, které jste vytvořili v předchozím kroku.
    • Nastavte koncový bod konfigurace aplikace na koncový bod úložiště App Configuration Store.
    • Ponechte výchozí hodnoty pro zbývající parametry.

      Snímek obrazovky znázorňující parametry úlohy konfigurace aplikace

  4. Uložte a zařadíte sestavení do fronty. Protokol sestavení zobrazí všechna selhání, ke kterým došlo během provádění úlohy.

Použití ve verzích

Tato část popisuje, jak používat úlohu exportu konfigurace Aplikace Azure v kanálu verze Azure DevOps.

  1. Výběrem možnosti Pipelines>Release (Verze kanálů) přejděte na stránku kanálu verze. Dokumentaci ke kanálu verze najdete v tématu Kanály verze.
  2. Zvolte existující kanál verze. Pokud ho nemáte, klikněte na Nový kanál a vytvořte nový kanál.
  3. Výběrem tlačítka Upravit v pravém horním rohu upravte kanál verze.
  4. V rozevíracím seznamu Úkoly zvolte dílčí fázi , do které chcete úkol přidat. Další informace o fázích najdete v části Přidat fáze, závislosti a podmínky.

    Snímek obrazovky znázorňující vybranou fázi v rozevíracím seznamu Úkoly

  5. Klikněte + vedle úlohy, do které chcete přidat nový úkol.

    Snímek obrazovky znázorňující tlačítko plus vedle úlohy

  6. Vyhledejte úlohu exportu konfigurace Aplikace Azure.

    Snímek obrazovky s dialogovým oknem Přidat úlohu s Aplikace Azure exportem konfigurace do vyhledávacího pole

  7. Pokud chcete exportovat hodnoty klíčů z app Configuration Storu, nakonfigurujte potřebné parametry v rámci úlohy. Popisy parametrů jsou k dispozici v části Parametry a v popisech vedle každého parametru.
    • Nastavte parametr předplatného Azure na název připojení služby, které jste vytvořili v předchozím kroku.
    • Nastavte koncový bod konfigurace aplikace na koncový bod úložiště App Configuration Store.
    • Ponechte výchozí hodnoty pro zbývající parametry.
  8. Uložte a zařadíte do fronty verzi. Protokol vydaných verzí zobrazuje všechna selhání, ke kterým došlo během provádění úlohy.

Parametry

Úloha exportu konfigurace Aplikace Azure používá následující parametry:

  • Předplatné Azure: Rozevírací seznam obsahující dostupná připojení služeb Azure. Pokud chcete aktualizovat a aktualizovat seznam dostupných připojení služeb Azure, stiskněte tlačítko Aktualizovat předplatné Azure napravo od textového pole.
  • Koncový bod konfigurace aplikace: Rozevírací seznam, který načte dostupné konfigurační úložiště koncových bodů ve vybraném předplatném. Pokud chcete aktualizovat a aktualizovat seznam dostupných koncových bodů úložiště konfigurace, stiskněte tlačítko Aktualizovat koncový bod konfigurace aplikace napravo od textového pole.
  • Režim výběru: Určuje, jak jsou vybrány hodnoty klíčů načtené z úložiště konfigurace. Režim výběru Výchozí umožňuje používat filtry klíčů a popisků. Režim výběru Snímek umožňuje výběr hodnot klíčů ze snímku. Výchozí hodnota je Výchozí.
  • Filtr klíčů: Filtr lze použít k výběru požadovaných hodnot klíče z konfigurace Aplikace Azure. Hodnota * vybere všechny hodnoty klíče. Další informace najdete v tématu Dotazování hodnot klíč-hodnota.
  • Popisek: Určuje, který popisek se má použít při výběru hodnot klíčů z App Configuration Storu. Pokud není k dispozici žádný popisek, načtou se hodnoty klíč-hodnoty bez popisku. Následující znaky nejsou povoleny: , *.
  • Název snímku: Určuje snímek, ze kterého se mají načíst hodnoty klíče v konfiguraci Aplikace Azure.
  • Střih předpony klíče: Určuje jednu nebo více předpon, které by se měly před nastavením jako proměnných oříznout z klíčů App Configuration. Znak nového řádku lze použít k oddělení více předpon.
  • Potlačení upozornění pro přepisované klíče: Výchozí hodnota není zaškrtnutá. Určuje, jestli se mají zobrazovat upozornění při přepsání existujících klíčů. Tuto možnost povolte, pokud se očekává, že hodnoty klíče stažené z konfigurace aplikace mají překrývající se klíče s tím, co existuje v proměnných kanálu.

Použití hodnot klíč-hodnota v následných úkolech

Hodnoty klíče, které se načítají z konfigurace aplikace, jsou nastavené jako proměnné kanálu, které jsou přístupné jako proměnné prostředí. Klíč proměnné prostředí je klíč klíč-hodnota, který se načte z app Configuration po oříznutí předpony, pokud je zadán.

Pokud například následující úloha spustí skript PowerShellu, může spotřebovat hodnotu klíče s klíčem myBuildSetting takto:

echo "$env:myBuildSetting"

A hodnota se vytiskne do konzoly.

Poznámka:

Odkazy služby Azure Key Vault v rámci služby App Configuration se přeloží a nastaví jako proměnné tajných kódů. V Azure Pipelines se tajné proměnné maskují z protokolu. Nepředají se do úkolů jako proměnné prostředí a musí být předány jako vstupy.

Řešení problému

Pokud dojde k neočekávané chybě, lze protokoly ladění povolit nastavením proměnné system.debug kanálu na truehodnotu .

Často kladené dotazy

Návody vytvořit konfiguraci z více klíčů a popisků?

Někdy může být potřeba vytvořit konfiguraci z několika popisků, například z výchozího a vývojového prostředí. K implementaci tohoto scénáře je možné použít několik úloh konfigurace aplikací v jednom kanálu. Hodnoty klíčů načtené úkolem v pozdějším kroku nahradí všechny hodnoty z předchozích kroků. V výše uvedeném příkladu lze úkol použít k výběru hodnot klíčů s výchozím popiskem, zatímco druhý úkol může vybrat hodnoty klíčů s popiskem vývoje. Klíče s popiskem pro vývoj přepíší stejné klíče výchozím popiskem.

Další krok

Úplný odkaz na parametry nebo použití této úlohy kanálu v kanálech YAML najdete v následujícím dokumentu.

Referenční informace k úloze exportu konfigurace Aplikace Azure

Pokud chcete zjistit, jak importovat hodnoty klíčů z konfiguračního souboru do obchodu App Configuration Store, pokračujte následujícím dokumentem.

Import nastavení do služby App Configuration pomocí kanálů Azure

Pokud chcete zjistit, jak vytvořit snímek v obchodě App Configuration Store, pokračujte následujícím dokumentem.

Vytváření snímků v Konfiguraci aplikací pomocí Azure Pipelines