Pull-inställningar för App Configuration med Azure Pipelines

Uppgiften Azure App Configuration hämtar nyckelvärden från ditt App Configuration och anger dem som Azure-pipelinevariabler, som kan användas av efterföljande uppgifter. Den här uppgiften kompletterar den Azure App Configuration Push-uppgift som push-meddelandena för nyckelvärden från en konfigurationsfil till App Configuration arkivet. Mer information finns i Push-inställningar för att App Configuration med Azure Pipelines.

Förutsättningar

• Azure-prenumeration – skapa en kostnadsfritt
• App Configuration store – skapa ett kostnadsfritt i Azure Portal.
• Azure DevOps-projekt – skapa ett kostnadsfritt
• Azure App Configuration – ladda ned kostnadsfritt från Visual Studio Marketplace.
• Nod 10 – för användare som kör uppgiften på agenter med egen värd.

Skapa en tjänstanslutning

En tjänstanslutning ger dig åtkomst till resurser i din Azure-prenumeration från ditt Azure DevOps-projekt.

1. I Azure DevOps går du till projektet som innehåller din målpipeline. Välj Projektinställningar i det nedre vänstra hörnet.

2. Under Pipelines väljer du Tjänstanslutningar. Välj Ny tjänstanslutning i det övre högra hörnet.

3. I Ny tjänstanslutning väljer du Azure Resource Manager.

   

4. I dialogrutan Autentiseringsmetod väljer du Tjänstens huvudnamn (automatiskt) för att skapa ett nytt huvudnamn för tjänsten eller väljer Tjänstens huvudnamn (manuellt) för att använda ett befintligt huvudnamn för tjänsten.

5. Ange din prenumeration och resurs och ett namn på din tjänstanslutning.

Om du har skapat ett nytt huvudnamn för tjänsten, leta reda på namnet på tjänstens huvudnamn som tilldelats till tjänstanslutningen. Du lägger till en ny rolltilldelning till tjänstens huvudnamn i nästa steg.

1. Gå till Tjänstanslutningar > för projektinställningar.

2. Välj den nya tjänstanslutningen.

3. Välj Hantera tjänstens huvudnamn.

4. Observera värdet i Visningsnamn.

   

Lägg till rolltilldelning

Tilldela rätt App Configuration rolltilldelningar till de autentiseringsuppgifter som används i aktiviteten så att aktiviteten kan komma åt App Configuration arkivet.

1. Gå till målbutiken App Configuration butik.

2. I den vänstra menyn väljer du Åtkomstkontroll (IAM).

3. I den högra rutan väljer du Lägg till rolltilldelningar.

   

4. För Roll väljer du App Configuration dataägare. Med den här rollen kan uppgiften läsa från och skriva till App Configuration store.

5. Välj tjänstens huvudnamn som är associerat med tjänstanslutningen som du skapade i föregående avsnitt.

   

Använda i byggen

Det här avsnittet visar hur du använder Azure App Configuration i en Azure DevOps-bygg-pipeline.

1. Gå till sidan för bygg-pipelinen genom att klicka på > Pipelines Pipelines. Dokumentation om bygg-pipeline finns i Skapa din första pipeline.
   • Om du skapar en ny bygg-pipeline går du till det sista steget i processen och går till fliken Granska och väljer Visa assistenten till höger om pipelinen.
   • Om du använder en befintlig bygg-pipeline klickar du på knappen Redigera längst upp till höger.
2. Sök efter Azure App Configuration uppgift.
3. Konfigurera de nödvändiga parametrarna för uppgiften för att hämta nyckelvärdena från App Configuration arkivet. Beskrivningar av parametrarna finns i avsnittet Parametrar nedan och i knappbeskrivningar bredvid varje parameter.
   • Ange azure-prenumerationsparametern till namnet på tjänstanslutningen som du skapade i ett tidigare steg.
   • Ange namnet App Configuration namnet på resursnamnet för ditt App Configuration store.
   • Lämna standardvärdena för de återstående parametrarna.
4. Spara och köa ett bygge. Byggloggen visar eventuella fel som inträffade under körningen av aktiviteten.

Använda i versioner

Det här avsnittet visar hur du använder Azure App Configuration i en Azure DevOps-lanseringspipeline.

1. Gå till sidan för lanseringspipeline genom att välja Pipelines > Releases (Versioner av pipelines). Dokumentation om lanseringspipeline finns i Release pipelines.
2. Välj en befintlig lanseringspipeline. Om du inte har någon klickar du på Ny pipeline för att skapa en ny.
3. Välj knappen Redigera i det övre högra hörnet för att redigera lanseringspipelinen.
4. I listrutan Uppgifter väljer du den fas som du vill lägga till uppgiften i. Mer information om faser finns här.
5. Klicka + på bredvid det jobb som du vill lägga till en ny uppgift i.
6. Sök efter Azure App Configuration uppgift.
7. Konfigurera de nödvändiga parametrarna i uppgiften för att hämta dina nyckelvärden från App Configuration arkivet. Beskrivningar av parametrarna finns i avsnittet Parametrar nedan och i knappbeskrivningar bredvid varje parameter.
   • Ange azure-prenumerationsparametern till namnet på tjänstanslutningen som du skapade i ett tidigare steg.
   • Ange namnet App Configuration namnet på resursnamnet för ditt App Configuration store.
   • Lämna standardvärdena för de återstående parametrarna.
8. Spara och köa en version. Publiceringsloggen visar eventuella fel som påträffas under körningen av uppgiften.

Parametrar

Följande parametrar används av Azure App Configuration uppgiften:

• Azure-prenumeration: En listrutan som innehåller dina tillgängliga Azure-tjänstanslutningar. Om du vill uppdatera listan över tillgängliga Azure-tjänstanslutningar trycker du på knappen Uppdatera Azure-prenumeration till höger om textrutan.
• App Configuration namn: En listrutan som läser in dina tillgängliga konfigurationslager under den valda prenumerationen. Om du vill uppdatera listan över tillgängliga konfigurationslager trycker du på knappen Uppdatera App Configuration namn till höger om textrutan.
• Nyckelfilter: Filtret kan användas för att välja vilka nyckelvärden som begärs från Azure App Configuration. Värdet * väljer alla nyckelvärden. Mer information om finns i Frågenyckelvärden.
• Etikett: Anger vilken etikett som ska användas när du väljer nyckelvärden från App Configuration arkivet. Om ingen etikett anges hämtas nyckelvärden utan etikett. Följande tecken tillåts inte: , *.
• Trim Key Prefix(Trimma nyckelprefix): Anger ett eller flera prefix som ska trimmas från App Configuration innan de anges som variabler. Flera prefix kan avgränsas med ett nytt radtecken.

Använda nyckelvärden i efterföljande uppgifter

Nyckelvärdena som hämtas från App Configuration anges som pipelinevariabler, som kan nås som miljövariabler. Nyckeln för miljövariabeln är nyckeln för nyckelvärdet som hämtas från den App Configuration efter att prefixet har trimmats, om det har angetts.

Om en efterföljande uppgift till exempel kör ett PowerShell-skript kan den använda ett nyckelvärde med nyckeln "myBuildSetting" så här:

echo "$env:myBuildSetting"

Och värdet skrivs ut till konsolen.

Felsökning

Om ett oväntat fel inträffar kan felsökningsloggar aktiveras genom att ange pipelinevariabeln system.debug till true .

Vanliga frågor

Hur gör jag för att skapa min konfiguration från flera nycklar och etiketter?

Det finns tillfällen när konfigurationen kan behöva bestå av flera etiketter, till exempel standard och dev. Flera App Configuration kan användas i en pipeline för att implementera det här scenariot. Nyckelvärdena som hämtas av en uppgift i ett senare steg ersätter alla värden från föregående steg. I ovanstående exempel kan en uppgift användas för att välja nyckelvärden med standardetiketten medan en andra uppgift kan välja nyckelvärden med utvecklingsetiketten. Nycklarna med utvecklingsetiketten åsidosätter samma nycklar med standardetiketten.