Share via

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

  • Artikel

Azure App Configuration Push-uppgift skickar nyckelvärden från en konfigurationsfil till ditt App Configuration arkiv. Den här uppgiften möjliggör fullständig cirkelfunktion 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 målpipelinen. I det nedre vänstra hörnet väljer du Projektinställningar.

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

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

    Skärmbild som visar hur du väljer Azure Resource Manager från 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, resursgrupp och ett namn för tjänstanslutningen.

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

  1. Gå till Project Settings>Service-anslutningar.

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

  1. Gå till målarkivet App Configuration.

  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.

  6. Välj Granska + tilldela.

Använda i versioner

Det här avsnittet beskriver hur du använder Azure App Configuration Push-uppgift i en Azure DevOps-byggpipeline.

  1. Gå till sidan bygg-pipeline 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 väljer Visa assistent till höger i pipelinen på fliken Granska.

      Skärmbild som visar knappen Visa assistent för en ny pipeline.

    • Om du använder en befintlig byggpipeline 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 Azure App Configuration push-uppgift.

    Skärmbild som visar dialogrutan Lägg till aktivitet med Azure App Configuration Push i sökrutan.

  3. Konfigurera nödvändiga parametrar för uppgiften för att push-överföra nyckelvärdena från konfigurationsfilen till App Configuration store. Förklaringar av parametrarna finns i avsnittet Parametrar nedan och i knappbeskrivningar bredvid varje parameter.

    Skärmbild som visar push-uppgiftsparametrarna för appkonfigurationen.

  4. Spara och köa en version. Byggloggen visar eventuella fel som inträffade under körningen av aktiviteten.

Använda i versioner

Det här avsnittet beskriver hur du använder Azure App Configuration Push-uppgift i en Azure DevOps-versionspipeline.

  1. Gå till sidan versionspipeline genom att välja Pipelines-versioner>. Dokumentation för versionspipelines finns här.
  2. Välj en befintlig versionspipeline. 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 versionspipelinen.
  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 + 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 aktiviteter skriver du Azure App Configuration Pusha in i sökrutan och markerar den.
  7. Konfigurera nödvändiga parametrar i uppgiften för att push-överföra dina nyckelvärden från konfigurationsfilen till App Configuration store. Förklaringar av parametrarna finns i avsnittet Parametrar nedan och i knappbeskrivningar bredvid varje parameter.
  8. Spara och köa en version. Versionsloggen visar eventuella fel som påträffas under körningen av uppgiften.

Parametrar

Följande parametrar används av App Configuration Push-uppgift:

  • Azure-prenumeration: En listruta som innehåller dina tillgängliga Azure-tjänstanslutningar. Om du vill uppdatera din lista över tillgängliga Azure-tjänstanslutningar trycker du på knappen Uppdatera Azure-prenumeration till höger om textrutan.
  • App Configuration slutpunkt: En listruta som läser in slutpunkten för dina tillgängliga konfigurationslager under den valda prenumerationen. Om du vill uppdatera listan över tillgängliga konfigurationslagerslutpunkter trycker du på knappen Uppdatera App Configuration slutpunkt till höger om textrutan.
  • Sökväg till konfigurationsfil: Sökvägen till konfigurationsfilen. Parametern Configuration File Path börjar vid roten på fillagringsplatsen. Du kan bläddra igenom din byggartefakt för att välja en konfigurationsfil. (... knapp till höger om textrutan). Vilka filformat som stöds beror på filinnehållsprofilen. För standardprofilen är de filformat som stöds yaml, json och egenskaper. För KvSet-profilen är det filformat som stöds json.
  • Filinnehållsprofil: Konfigurationsfilens innehållsprofil. Standardvärdet är Standard.
    • Standard: Refererar till de konventionella konfigurationsfilformat som är direkt förbrukningsbara av program.
    • Kvset: Refererar till ett filschema som innehåller alla egenskaper för ett App Configuration nyckelvärde, inklusive nyckel, värde, etikett, innehållstyp och taggar. Aktivitetsparametrarna "Avgränsare", "Etikett", "Innehållstyp", "Prefix", "Taggar" och "Djup" är inte tillämpliga när du använder Kvset-profilen.
  • Importläge: Standardvärdet är Alla. Avgör beteendet vid import av nyckelvärden.
    • Alla: Importerar alla nyckelvärden i konfigurationsfilen till App Configuration.
    • Ignore-Match: Importerar endast inställningar som inte har något matchande nyckelvärde i App Configuration. Matchande nyckelvärden anses vara nyckelvärden med samma nyckel, etikett, värde, innehållstyp och taggar.
  • Torr körning: Standardvärdet är Avmarkerat.
    • Markerad: Inga uppdateringar utförs för App Configuration. I stället skrivs alla uppdateringar som skulle ha utförts i en normal körning ut till konsolen för granskning.
    • Avmarkerad: Utför uppdateringar av App Configuration och skriver inte ut till konsolen.
  • Avgränsare: Avgränsaren som används för att platta ut .json- och .yml-filer.
  • Djup: Det djup 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 store.
  • Etikett: En sträng som läggs till i varje nyckelvärde som etikett i App Configuration store.
  • 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 {"tag1":"val1", "tag2":"val2"}, som definierar taggar som läggs till i varje nyckelvärde som skickas till din App Configuration store.
  • Ta bort nyckelvärden som inte ingår i konfigurationsfilen: Standardvärdet är Avmarkerat. Beteendet för det här alternativet beror på konfigurationsfilens innehållsprofil.
    • Markerad:
      • Standardinnehållsprofil: Tar bort alla nyckelvärden i App Configuration-arkivet som matchar både det angivna prefixet och etiketten innan nya nyckelvärden skickas från konfigurationsfilen.
      • Kvset-innehållsprofil: Tar bort alla nyckelvärden i App Configuration arkiv som inte ingår i konfigurationsfilen innan nya nyckelvärden skickas från konfigurationsfilen.
    • Avmarkerad: Push-överför alla nyckelvärden från konfigurationsfilen till App Configuration arkivet 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 laddar jag upp flera konfigurationsfiler?

Skapa flera instanser av Azure App Configuration Push-uppgift i samma pipeline för att skicka flera konfigurationsfiler till App Configuration store.

Hur skapar jag Key Vault referenser eller funktionsflaggor med den här uppgiften?

Beroende på vilken filinnehållsprofil du har valt kan du läsa exempel i Azure App Configuration stöd för konfigurationsfilen.

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.