Nabízená nastavení do konfigurace aplikace pomocí Azure Pipelines

Úloha push konfigurace Aplikace Azure nasdílí hodnoty klíčů z konfiguračního souboru do úložiště App Configuration Store. Tato úloha umožňuje úplné kruhové funkce v rámci kanálu, protože teď můžete načíst nastavení z App Configuration Storu a také nabízená nastavení do App Configuration Storu.

Požadavky

• Předplatné Azure – vytvoření bezplatného předplatného
• App Configuration Store – vytvořte si ho zdarma
• Projekt Azure DevOps – vytvořte si ho zdarma
• Aplikace Azure konfigurační nabízená úloha – stáhněte si ji zdarma z Visual Studio Marketplace
• Agent Azure Pipelines verze 2.206.1 nebo novější a Node verze 16 nebo novější pro spuštění úlohy na agentech v místním prostředí.

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.

   

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.

   

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í.

   

4. Jako roli vyberte Vlastník dat konfigurace aplikace. Tato role umožňuje úloze číst a zapisovat do obchodu App Configuration Store.

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

   

6. Vyberte Zkontrolovat + přiřadit.

Použití v buildech

V této části se dozvíte, jak používat úlohu nabízených oznámení 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álům buildu najdete tady.
   • Pokud vytváříte nový kanál buildu, v posledním kroku procesu na kartě Revize vyberte Zobrazit asistenta na pravé straně kanálu.

     

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

     

2. Vyhledejte úlohu nabízených oznámení konfigurace Aplikace Azure.

   

3. Nakonfigurujte potřebné parametry pro úlohu tak, aby nasdílely hodnoty klíčů z konfiguračního souboru do app Configuration Storu. Vysvětlení parametrů jsou k dispozici v části Parametry níže a v popisech vedle každého parametru.

   

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

V této části se dozvíte, jak používat úlohu nabízených oznámení 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álům verzí najdete tady.
2. Zvolte existující kanál verze. Pokud ho nemáte, vyberte + Nový a vytvořte nový.
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 tady.

   

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

   

6. V dialogovém okně Přidat úkoly zadejte do vyhledávacího pole Aplikace Azure Konfigurační oznámení a vyberte ho.
7. Nakonfigurujte nezbytné parametry v rámci úlohy tak, aby odsílaly hodnoty klíčů z konfiguračního souboru do úložiště App Configuration Store. Vysvětlení parametrů jsou k dispozici v části Parametry níže a v popisech vedle každého parametru.
8. Uložte a zařadíte do fronty verzi. Protokol vydaných verzí zobrazí všechna selhání, ke kterým došlo během provádění úlohy.

Parametry

Úloha Nabízená oznámení konfigurace aplikace 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ý koncový bod konfigurace do vybraného předplatného. 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.
• Cesta ke konfiguračnímu souboru: Cesta ke konfiguračnímu souboru. Parametr Cesta ke konfiguračnímu souboru začíná v kořenovém adresáři úložiště souborů. Můžete procházet artefakt sestavení a vybrat konfigurační soubor. (... vpravo od textového pole). Podporované formáty souborů závisí na profilu obsahu souboru. U výchozího profilu jsou podporované formáty souborů yaml, json a vlastnosti. Pro profil KvSet je podporovaný formát souboru json.
• Profil obsahu souboru: Profil obsahu konfiguračního souboru. Výchozí hodnota je Výchozí.
  • Výchozí nastavení: Odkazuje na běžné formáty konfiguračních souborů, které jsou přímo použitelnými aplikacemi.
  • Kvset: Odkazuje na schéma souboru, které obsahuje všechny vlastnosti hodnoty klíče konfigurace aplikace, včetně klíče, hodnoty, popisku, typu obsahu a značek. Parametry úkolu Oddělovač, Popisek, Typ obsahu, Předpona, Značky a Hloubka se při použití profilu Kvset nepoužijí.
• Režim importu: Výchozí hodnota je Vše. Určuje chování při importu hodnot klíčů.
  • Vše: Importuje všechny hodnoty klíčů v konfiguračním souboru do konfigurace aplikace.
  • Ignorovat shodu: Importuje pouze nastavení, která nemají v konfiguraci aplikace odpovídající klíč-hodnota. Odpovídající hodnoty klíče se považují za klíčové hodnoty se stejným klíčem, popiskem, hodnotou, typem obsahu a značkami.
• Suché spuštění: Výchozí hodnota není zaškrtnutá.
  • Zaškrtnuto: Ve službě App Configuration nebudou provedeny žádné aktualizace. Místo toho se všechny aktualizace, které by byly provedeny v normálním spuštění, vytisknout do konzoly ke kontrole.
  • Nezaškrtnuto: Provede všechny aktualizace konfigurace aplikace a netiskne se do konzoly.
• Oddělovač: Oddělovač, který slouží k zploštění .json a .yml souborů.
• Hloubka: Hloubka .json a .yml souborů bude zploštěna.
• Předpona: Řetězec, který je připojený k začátku každého klíče nabízeného do App Configuration Storu.
• Popisek: Řetězec, který se přidá do každé hodnoty klíče jako popisek v obchodě App Configuration Store.
• Typ obsahu: Řetězec, který se přidá ke každé hodnotě klíče jako typ obsahu v obchodě App Configuration Store.
• Značky: Objekt JSON ve formátu {"tag1":"val1", "tag2":"val2"}, který definuje značky přidané do každého klíče-hodnota vložené do vašeho obchodu App Configuration.
• Odstraňte hodnoty klíče, které nejsou součástí konfiguračního souboru: Výchozí hodnota není zaškrtnutá. Chování této možnosti závisí na profilu obsahu konfiguračního souboru.
  • Zaškrtnuto:
    • Výchozí profil obsahu: Odebere všechny hodnoty klíčů v úložišti konfigurace aplikace, které odpovídají zadané předponě i popisku před odesláním nových hodnot klíče z konfiguračního souboru.
    • Profil obsahu Kvset: Odebere všechny hodnoty klíčů v obchodě App Configuration Store, které nejsou součástí konfiguračního souboru, a teprve potom z konfiguračního souboru nasdílí nové hodnoty klíče.
  • Nezaškrtnuto: Nasdílí všechny hodnoty klíčů z konfiguračního souboru do obchodu App Configuration Store a ponechá všechno ostatní v obchodě App Configuration beze změny.

Ř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

Jak můžu nahrát více konfiguračních souborů?

Vytvořte několik instancí úlohy nabízení konfigurace Aplikace Azure v rámci stejného kanálu, aby se do úložiště App Configuration Store odeslalo více konfiguračních souborů.

Jak můžu pomocí této úlohy vytvořit odkazy na službu Key Vault nebo příznaky funkcí?

V závislosti na vybraném profilu obsahu souboru si projděte příklady v konfiguračním souboru podpory konfigurace Aplikace Azure.

Proč se mi při pokusu o nasdílení hodnot klíčů do úložiště konfigurace zobrazuje chyba 409?

Chybová zpráva 409 Konfliktní zpráva se objeví, pokud se úloha pokusí odebrat nebo přepsat klíč-hodnota, která je uzamčena v App Configuration Storu.