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

  • Artikel
  • 4 minuter för att läsa

Den Azure App Configuration Push-uppgiften push-meddelandena nyckelvärden från en konfigurationsfil till App Configuration arkivet. Den här uppgiften aktiverar fullständiga cirkelfunktioner i pipelinen eftersom du nu kan hämta inställningar från App Configuration Store samt push-inställningar till App Configuration store.

Förutsättningar

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.

    Skärmbild som visar Azure Resource Manager i listrutan Ny tjänstanslutning.

  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.

    Skärmbild som visar visningsnamnet för tjänstens huvudnamn.

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.

    Skärmbild som visar knappen 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.

    Skärmbild som visar dialogrutan Lägg till rolltilldelning.

Använda i byggen

Det här avsnittet går igenom hur du använder push Azure App Configuration uppgiften i en Azure DevOps-bygg-pipeline.

  1. Gå till sidan för bygg-pipelinen genom att klicka på > Pipelines Pipelines. Dokumentation för bygg-pipelines finns här.
    • 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. Skärmbild som visar knappen Visa assistent för en ny pipeline.
    • Om du använder en befintlig bygg-pipeline klickar du på knappen Redigera längst upp till höger. Skärmbild som visar knappen Redigera för en befintlig pipeline.
  2. Sök efter push Azure App Configuration uppgiften. Skärmbild som visar dialogrutan Lägg till uppgift Azure App Configuration push-meddelanden i sökrutan.
  3. Konfigurera de parametrar som krävs för att uppgiften ska skicka nyckelvärdena från konfigurationsfilen till App Configuration arkivet. Förklaringar av parametrarna finns i avsnittet Parametrar nedan och i knappbeskrivningar bredvid varje parameter. Skärmbild som visar parametrarna för push-uppgift för appkonfiguration.
  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 går igenom hur du använder push Azure App Configuration uppgiften i en Azure DevOps-lanseringspipeline.

  1. Gå till sidan för lanseringspipeline genom att välja Pipelines > Releases (Versioner av pipelines). Dokumentation för lanseringspipelines finns här.
  2. Välj en befintlig lanseringspipeline. Om du inte har någon väljer du + Ny 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. Skärmbild som visar den valda fasen i listrutan Uppgifter.
  5. Klicka + på bredvid det jobb som du vill lägga till en ny aktivitet i. Skärmbild som visar plusknappen bredvid jobbet.
  6. I dialogrutan Lägg till uppgifter skriver du Azure App Configuration Push-in i sökrutan och markerar den.
  7. Konfigurera de nödvändiga parametrarna i uppgiften för att skicka dina nyckelvärden från konfigurationsfilen till App Configuration arkivet. Förklaringar av parametrarna finns i avsnittet Parametrar nedan och i knappbeskrivningar bredvid varje parameter.
  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 push 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.
  • Konfigurationsfilsökväg: Sökvägen till konfigurationsfilen. Parametern Konfigurationsfilsökväg börjar i roten på fildatabasen. Du kan bläddra igenom din byggartefakt för att välja en konfigurationsfil. ( ... till höger om textrutan). Filformaten som stöds är: yaml, json, properties. Följande är en exempelkonfigurationsfil i json-format. 
    {
    "TestApp:Settings:BackgroundColor":"#FFF",
    "TestApp:Settings:FontColor":"#000",
    "TestApp:Settings:FontSize":"24",
    "TestApp:Settings:Message": "Message data"
}
  • Avgränsare: Avgränsaren som används för att platta ut .json- och .yml-filer.
  • Djup: Djupet som .json- och .yml-filerna kommer att plattas ut till.
  • Prefix: En sträng som läggs till i början av varje nyckel som skickas till App Configuration arkivet.
  • Etikett: En sträng som läggs till i varje nyckelvärde som etikett i App Configuration arkivet.
  • Innehållstyp: En sträng som läggs till i varje nyckelvärde som innehållstyp i App Configuration store.
  • Taggar: Ett JSON-objekt i formatet , som definierar taggar som läggs till i varje nyckelvärde som skickas till {"tag1":"val1", "tag2":"val2"} App Configuration arkivet.
  • Ta bort alla Key-Values som lagras med det angivna prefixet och etiketten: Standardvärdet är Avmarkerat.
    • Markerat: Tar bort alla nyckelvärden i App Configuration som matchar både det angivna prefixet och etiketten innan nya nyckelvärden push-tas bort från konfigurationsfilen.
    • Avmarkerad: Push-ar alla nyckelvärden från konfigurationsfilen till App Configuration och lämnar allt annat i App Configuration arkivet intakt.

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 kan jag ladda upp flera konfigurationsfiler?

Skapa flera instanser av åtgärden Azure App Configuration push-överföra inom samma pipeline för att push-överföra flera konfigurationsfiler till App Configuration store.

Hur skapar jag en Key Vault med den här uppgiften?

Om du Key Vault referenser anger du parametern "Innehållstyp" till application/vnd.microsoft.appconfig.keyvaultref+json;charset=utf-8. Om inte alla nyckelvärden i en konfigurationsfil är Key Vault referenser, placera Key Vault och vanliga nyckelvärden i separata konfigurationsfiler och push-överföra dem separat.

Varför får jag ett 409-fel när jag försöker skicka nyckelvärden till mitt konfigurationsarkiv?

Ett 409-konfliktfel visas om uppgiften försöker ta bort eller skriva över ett nyckelvärde som är låst i App Configuration arkivet.