Nabízená oznámení do App Configuration s Azure Pipelines

  • Článek
  • 4 min ke čtení

Úloha Azure App Configuration push předá pár párů klíč-hodnota z konfiguračního souboru do App Configuration úložiště. Tato úloha umožňuje v rámci kanálu plně funkční kruhy, protože teď můžete vyžádat nastavení z úložiště App Configuration a také nastavení nabízení do App Configuration úložiště.

Požadavky

Vytvoření připojení služby

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

  1. V Azure DevOps přejdete 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é připojení služby vyberte Azure Resource Manager.

    Snímek obrazovky zobrazuje výběr Azure Resource Manager v rozevíracím seznamu nové připojení služby.

  4. V dialogu 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é a prostředek a název pro 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 nové přiřazení role k tomuto instančnímu objektu.

  1. Přejít na nastavení projektu > připojení služby.

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

  3. Vyberte Spravovat instanční objekt.

  4. Všimněte si hodnoty ve zobrazovaném názvu.

    Snímek obrazovky se zobrazeným názvem objektu služby.

Přidat přiřazení role

Přiřaďte správné přiřazení role konfigurace aplikace k přihlašovacím údajům používaným v rámci úlohy, aby úloha mohla získat přístup k úložišti konfigurace aplikace.

  1. Přejít do cílového úložiště konfigurace aplikace

  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 se zobrazí na tlačítku Přidat přiřazení role.

  4. V případě role vyberte možnost vlastník dat konfigurace aplikace. Tato role umožňuje, aby úloha četla do úložiště konfigurace aplikace a zapisovala do něj.

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

    Snímek obrazovky se zobrazí v dialogovém okně Přidat přiřazení role.

Použití v sestaveních

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

  1. Přejděte na stránku kanálu buildu kliknutím na Pipelines > Pipelines. Dokumentaci ke kanálům buildu najdete tady.
    • Pokud vytváříte nový kanál buildu, vyberte v posledním kroku procesu na kartě Kontrola 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 vpravo nahoře na tlačítko Upravit. Snímek obrazovky s tlačítkem Upravit u existujícího kanálu
  2. Vyhledejte úlohu Azure App Configuration push. Snímek obrazovky s dialogem Přidat úlohu Azure App Configuration push ve vyhledávacím poli
  3. Nakonfigurujte nezbytné parametry pro úlohu tak, aby předá klíč-hodnoty z konfiguračního souboru do App Configuration úložiště. 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 oznámení konfigurace aplikace
  4. Uložte a zařadit sestavení do fronty. V protokolu sestavení se zobrazí všechny chyby, ke kterým došlo během provádění úlohy.

Použití ve verzích

Tato část popisuje, jak používat úlohu Azure App Configuration push v kanálech Azure DevOps verze.

  1. Přejděte na stránku kanálu verze výběrem Pipelines > Releases (Verze). 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. Pokud chcete upravit kanál verze, vyberte tlačítko Upravit v pravém horním rohu.
  4. V rozevíracím seznamu Úlohy zvolte Fázi, do které chcete úlohu přidat. Další informace o fázích najdete tady. Snímek obrazovky zobrazuje vybranou fázi v rozevíracím seznamu Úlohy.
  5. Klikněte + vedle úlohy, do které chcete přidat nový úkol. Snímek obrazovky s tlačítkem plus vedle úlohy
  6. V dialogovém okně Přidat úlohy zadejte Azure App Configuration do vyhledávacího pole a vyberte ho.
  7. Nakonfigurujte potřebné parametry v rámci úlohy tak, aby se vaše hodnoty klíče odesouly z konfiguračního souboru do App Configuration úložiště. Vysvětlení parametrů jsou k dispozici v části Parametry níže a v popisech vedle jednotlivých parametrů.
  8. Uložte verzi a zařadit ji do fronty. V protokolu verzí se zobrazí všechny chyby, ke kterým došlo při provádění úlohy.

Parametry

Následující parametry jsou používány úlohou App Configuration push:

  • 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 Název: Rozevírací seznam, který načte dostupná úložiště konfigurace v rámci vybraného předplatného. Pokud chcete aktualizovat a aktualizovat seznam dostupných úložišť konfigurace, stiskněte tlačítko App Configuration název souboru 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. ( ... napravo od textového pole). Podporované formáty souborů jsou: yaml, json, vlastnosti. Následuje příklad konfiguračního souboru ve formátu JSON. 
    {
    "TestApp:Settings:BackgroundColor":"#FFF",
    "TestApp:Settings:FontColor":"#000",
    "TestApp:Settings:FontSize":"24",
    "TestApp:Settings:Message": "Message data"
}
  • Oddělovač: Oddělovač, který se používá k zploštění souborů .json a .yml.
  • Hloubka: Hloubka, se kterou budou soubory .json a .yml zploštěny.
  • Předpona: Řetězec, který se připojí na začátek každého klíče nabízeného do App Configuration úložiště.
  • Popisek: Řetězec, který se přidá ke každé klíč-hodnota jako popisek v rámci App Configuration úložiště.
  • Content Type(Typ obsahu): Řetězec, který se přidá ke každé klíč-hodnota jako typ obsahu v App Configuration úložiště.
  • Značky: Objekt JSON ve formátu , který definuje značky, které se přidávají ke každému klíč-hodnota nabízené do {"tag1":"val1", "tag2":"val2"} vašeho App Configuration úložiště.
  • Odstraňte všechny ostatní Key-Values v obchodě se zadanou předponou a popiskem : Výchozí hodnota je Nezaškrtnuté.
    • Zaškrtnuto: Před nasazování nových klíčových hodnot z konfiguračního souboru odebere všechny hodnoty klíče v App Configuration, které odpovídají zadané předponě i popisku.
    • Nezaškrtnuté: Nasouvá všechny hodnoty klíče z konfiguračního souboru do App Configuration úložiště a ponechá všechno ostatní v App Configuration beze změny.

Řešení potíží

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

Časté otázky

Jak můžu nahrát několik konfiguračních souborů?

V rámci stejného kanálu Azure App Configuration několika instancí úlohy push, aby se do úložiště App Configuration konfiguračních souborů.

Jak můžu pomocí Key Vault vytvořit odkazy na nové?

Pokud chcete Key Vault odkazy, nastavte parametr Content Type na application/vnd.microsoft.appconfig.keyvaultref+json;charset=utf-8. Pokud ne všechny hodnoty klíče v konfiguračním souboru Key Vault odkazy, dejte odkazy Key Vault normální hodnoty klíče do samostatných konfiguračních souborů Key Vault dejte je samostatně.

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

Pokud se úloha pokusí odebrat nebo přepsat klíč-hodnotu, která je uzamčená v App Configuration úložiště, zobrazí se chybová zpráva 409 – Konflikt.