Share via

Nabízení nastavení do App Configuration pomocí Azure Pipelines

  • Článek

Úloha Azure App Configuration Push nasdílí hodnoty klíčů z konfiguračního souboru do úložiště App Configuration. Tato úloha umožňuje funkci plného kruhu v rámci kanálu, protože teď můžete načíst nastavení z úložiště App Configuration a také nastavení nabízených oznámení do úložiště App Configuration.

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 na projekt, 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 části Nové připojení služby vyberte Azure Resource Manager.

    Snímek obrazovky ukazuje výběr azure Resource Manager z rozevíracího seznamu Nové připojení služby.

  4. V dialogovém okně Metoda ověřování vyberte Instanční objekt (automatický) a vytvořte nový instanční objekt nebo vyberte Instanční objekt (ručně) a použijte existující instanční objekt.

  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 naPřipojení službyNastavení> projektu.

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

  3. Vyberte Spravovat instanční objekt.

  4. Poznamenejte si hodnotu v poli Zobrazovaný název.

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

Přidat přiřazení role

Přiřazení správných App Configuration přiřazení rolí k přihlašovacím údajům, které se používají v rámci úkolu, aby úkol mohl přistupovat k úložišti App Configuration.

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

  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 znázorňuje tlačítko Přidat přiřazení rolí.

  4. V části Role vyberte App Configuration Vlastník dat. Tato role umožňuje úkolu číst z úložiště App Configuration a zapisovat do úložiště App Configuration.

  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 a přiřadit.

Použití v buildech

Tato část popisuje, jak používat úlohu Azure App Configuration Push v kanálu sestavení Azure DevOps.

  1. Kliknutím na Pipelines Pipelines (Kanály>) přejděte na stránku kanálu sestavení. Dokumentaci k kanálům sestavení najdete tady.
    • Pokud vytváříte nový kanál sestavení, vyberte v posledním kroku procesu na kartě Revize možnost 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 na tlačítko Upravit v pravém horním rohu.

      Snímek obrazovky znázorňuje tlačítko Upravit u existujícího kanálu.

  2. Vyhledejte Azure App Configuration Push Task.

    Snímek obrazovky znázorňuje dialogové okno Přidat úlohu s Azure App Configuration Nasdílení změn ve vyhledávacím poli.

  3. Nakonfigurujte parametry potřebné k tomu, aby úloha odeslala hodnoty klíč-hodnoty z konfiguračního souboru do úložiště App Configuration. Vysvětlení parametrů jsou k dispozici v části Parametry níže a v popisech vedle jednotlivých parametrů.

    Snímek obrazovky znázorňuje parametry úlohy nabízeného nabízení konfigurace aplikace.

  4. Uložte sestavení do fronty a vytvořte ho 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 Azure App Configuration Push v kanálu verze Azure DevOps.

  1. Přejděte na stránku kanálu verze tak, že vyberete Verze kanálů>. Dokumentaci ke kanálům verze 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 vyberte fázi , do které chcete úkol přidat. Další informace o fázích najdete tady.

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

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

    Snímek obrazovky ukazuje tlačítko plus vedle úlohy.

  6. V dialogovém okně Přidat úkoly zadejte do vyhledávacího pole Azure App Configuration Push a vyberte ho.
  7. Nakonfigurujte potřebné parametry v rámci úlohy tak, aby se hodnoty klíčů nasdílely z konfiguračního souboru do úložiště App Configuration. Vysvětlení parametrů jsou k dispozici v části Parametry níže a v popisech vedle jednotlivých parametrů.
  8. Uložení a přidání verze do fronty V protokolu vydaných verzí se zobrazí všechna selhání, ke kterým došlo během provádění úlohy.

Parametry

Úloha App Configuration Push 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.
  • App Configuration Koncový bod: Rozevírací seznam, který načte dostupnou konfiguraci, ukládá koncový bod ve vybraném předplatném. Pokud chcete aktualizovat a aktualizovat seznam dostupných koncových bodů úložišť konfigurace, stiskněte tlačítko Aktualizovat App Configuration Koncový bod 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 properties. Pro profil KvSet je podporovaným formátem souboru json.
  • Profil obsahu souboru: Profil obsahu konfiguračního souboru. Výchozí hodnota je Výchozí.
    • Výchozí: Odkazuje na běžné formáty konfiguračních souborů, které jsou přímo využitelné aplikacemi.
    • Kvset: Odkazuje na schéma souboru, které obsahuje všechny vlastnosti App Configuration klíč-hodnota, včetně klíče, hodnoty, popisku, typu obsahu a značek. Parametry úlohy 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íč-hodnota.
    • Vše: Importuje všechny hodnoty klíčů v konfiguračním souboru do App Configuration.
    • Ignorovat shodu: Importuje pouze nastavení, která nemají odpovídající hodnotu klíče v App Configuration. Odpovídající hodnoty klíče se považují za hodnoty klíče se stejným klíčem, popiskem, hodnotou, typem obsahu a značkami.
  • Spuštění na sucho: Výchozí hodnota je Nezaškrtnutá.
    • Zaškrtnuto: Pro App Configuration se neprovedou žádné aktualizace. Místo toho se všechny aktualizace, které by se provedly při normálním spuštění, budou vytištěny do konzoly ke kontrole.
    • Nezaškrtnuté: Provede všechny aktualizace App Configuration a nevytiskne se do konzoly.
  • Oddělovač: Oddělovač, který se používá ke sloučení souborů .json a .yml.
  • Hloubka: Hloubka, se kterou budou soubory .json a .yml zploštěny.
  • Předpona: Řetězec, který je připojen na začátek každého klíče nasdílený do úložiště App Configuration.
  • Popisek: Řetězec, který se přidá ke každé hodnotě klíč-hodnota jako popisek v úložišti App Configuration.
  • Typ obsahu: Řetězec, který se přidá do každé hodnoty klíč-hodnota jako typ obsahu v úložišti App Configuration.
  • Značky: Objekt JSON ve formátu {"tag1":"val1", "tag2":"val2"}, který definuje značky, které se přidají do každé hodnoty klíče a hodnoty vložené do úložiště App Configuration.
  • Odstranit hodnoty klíče, které nejsou zahrnuty v konfiguračním souboru: Výchozí hodnota je Nezaš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 App Configuration, které odpovídají zadané předponě a popisku, a teprve potom do konfiguračního souboru nasdílí nové hodnoty klíč-hodnoty.
      • Profil obsahu Kvset: Odebere všechny hodnoty klíčů v úložišti App Configuration, které nejsou součástí konfiguračního souboru, před vložením nových hodnot klíčů z konfiguračního souboru.
    • Nezaškrtnuté: Nasdílí všechny hodnoty klíčů z konfiguračního souboru do úložiště App Configuration a všechno ostatní v úložišti App Configuration ponechá beze změny.

Řešení potíží

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

Časté otázky

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

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

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

V závislosti na profilu obsahu souboru, který jste vybrali, si projděte příklady v Azure App Configuration podpory konfiguračního souboru.

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

Chybová zpráva 409 Konflikt se zobrazí, pokud se úloha pokusí odebrat nebo přepsat hodnotu klíče, která je uzamčena v úložišti App Configuration.