Nastavení vyžádání do konfigurace aplikace pomocí Azure Pipelines

Úloha Konfigurace aplikace Azure přebírá klíčové hodnoty z úložiště konfigurace aplikace a nastavuje je jako proměnné kanálu Azure, které mohou být spotřebovány následujícími úlohami. Tato úloha doplňuje úlohu nabízení konfigurace aplikace Azure , která z konfiguračního souboru vloží hodnoty klíč-to do úložiště konfigurace aplikace. Další informace najdete v tématu nastavení nabízených oznámení do konfigurace aplikací pomocí Azure Pipelines.

Požadavky

• Předplatné Azure – Vytvořte si ho zdarma .
• Úložiště konfigurace aplikace – vytvořte si ho zdarma ve Azure Portal.
• projekt Azure DevOps – můžete ho vytvořit zdarma .
• úkol konfigurace aplikace Azure – stáhněte si ho zdarma z webu Visual Studio Marketplace.
• Uzel 10 – pro uživatele, kteří úlohu spouštějí v samoobslužných agentech.

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.

   

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.

   

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

   

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.

   

Použít v sestaveních

v této části se dozvíte, jak používat úlohu konfigurace aplikace Azure v kanálu sestavení Azure DevOps.

1. Kliknutím na Pipelines Pipelines přejděte na stránku kanálu sestavení > . Dokumentaci k kanálu sestavení najdete v tématu Vytvoření prvního kanálu.
   • Pokud vytváříte nový kanál sestavení, v posledním kroku procesu na kartě Revize vyberte Zobrazit pomocníka na pravé straně kanálu.
   • Pokud používáte existující kanál sestavení, klikněte na tlačítko Upravit v pravém horním rohu.
2. Vyhledejte úlohu Konfigurace aplikace Azure .
3. Nakonfigurujte potřebné parametry pro úlohu, aby vyčetly klíčové hodnoty z úložiště konfigurace aplikace. Popisy parametrů jsou k dispozici v části parametry níže a v popiscích tlačítek vedle jednotlivých parametrů.
   • Nastavte parametr předplatné Azure na název připojení služby, které jste vytvořili v předchozím kroku.
   • Nastavte název konfigurace aplikace na název prostředku vašeho úložiště konfigurace aplikace.
   • Pro zbývající parametry ponechte výchozí hodnoty.
4. Uložit 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žít ve verzích

v této části se dozvíte, jak používat úlohu konfigurace aplikace Azure v kanálu verze Azure DevOps.

1. vyberte Pipelines > verze, přejděte na stránku kanálu vydání. Dokumentaci k vydaným kanálům vydaných verzí najdete v tématu kanály verzí.
2. Vyberte existující kanál verze. Pokud ho nemáte, klikněte na Nový kanál a vytvořte nový.
3. Kliknutím na tlačítko Upravit v pravém horním rohu upravte kanál verze.
4. V rozevíracím seznamu úlohy vyberte fázi , do které chcete úkol přidat. Další informace o fázích najdete tady.
5. Klikněte na tlačítko + Další do úlohy, do které chcete přidat nový úkol.
6. Vyhledejte úlohu Konfigurace aplikace Azure .
7. Nakonfigurujte potřebné parametry v rámci úlohy, aby vyčetly klíčové hodnoty z úložiště konfigurace aplikace. Popisy parametrů jsou k dispozici v části parametry níže a v popiscích tlačítek vedle jednotlivých parametrů.
   • Nastavte parametr předplatné Azure na název připojení služby, které jste vytvořili v předchozím kroku.
   • Nastavte název konfigurace aplikace na název prostředku vašeho úložiště konfigurace aplikace.
   • Pro zbývající parametry ponechte výchozí hodnoty.
8. Uložte a zařadíte do fronty verzi. V protokolu vydaných verzí se zobrazí všechny chyby zjištěné při spuštění úlohy.

Parametry

Úkol konfigurace aplikace Azure používá následující parametry:

• Předplatné Azure: rozevírací seznam obsahující dostupná připojení služby Azure. Pokud chcete aktualizovat a aktualizovat seznam dostupných připojení služby Azure, klikněte na tlačítko Aktualizovat předplatné Azure napravo od textového pole.
• Název konfigurace aplikace: rozevírací seznam, který načte vaše dostupná úložiště konfigurace pod vybraným předplatným. Pokud chcete aktualizovat a aktualizovat seznam dostupných úložišť konfigurací, stiskněte tlačítko aktualizovat název konfigurace aplikace napravo od textového pole.
• Filtr klíčů: pomocí filtru můžete vybrat, které klíčové hodnoty se z konfigurace aplikace Azure vyžadují. Hodnota * vybere všechny klíčové hodnoty. Další informace o najdete v tématu hodnoty klíčů dotazů.
• Label: Určuje, který popisek se má použít při výběru hodnot klíče z úložiště konfigurace aplikace. Pokud není zadaný žádný popisek, načtou se hodnoty klíč-hodnota bez popisku. Následující znaky nejsou povoleny:, *.
• Řezací předpona klíče: Určuje jednu nebo více předpon, které by měly být z konfiguračních klíčů aplikace oříznuty, než je nastavíte jako proměnné. Více předpon lze oddělit znakem nového řádku.

Použití hodnot klíč-hodnota v následujících úlohách

Hodnoty klíč-hodnota načtené z konfigurace aplikace se nastaví jako proměnné kanálu, které jsou přístupné jako proměnné prostředí. Klíč proměnné prostředí je klíč hodnoty klíče, který je načten z konfigurace aplikace po vystřihování předpony, je-li zadána.

Pokud třeba následná úloha spustí skript PowerShellu, může to spotřebovat klíčovou hodnotu s klíčem "myBuildSetting", například:

echo "$env:myBuildSetting"

A hodnota bude vytištěna do konzoly.

Ř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

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

Existují situace, kdy může být nutné, aby konfigurace byla složena z více popisků, například jako výchozí a vývoj. K implementaci tohoto scénáře se dá v jednom kanálu použít víc úloh konfigurace aplikace. Klíčové hodnoty načtené úlohou v pozdějším kroku nahradí všechny hodnoty z předchozích kroků. Ve výše uvedeném příkladu se dá úkol použít k výběru hodnot klíče s výchozím popiskem, zatímco druhý úkol může vybírat klíčové hodnoty pomocí popisku pro vývoj. Klíče s popisem pro vývoj budou přepisovat stejné klíče s výchozím popiskem.