Dela via

Automatisera kompilering och distribution för standardarbetsflöden för logikappar med Azure DevOps

  • Artikel

För standardarbetsflöden för logikappar som körs i Azure Logic Apps med en enda klientorganisation kan du använda Visual Studio Code med Tillägget Azure Logic Apps (Standard) för att lokalt utveckla, testa och lagra ditt logikappprojekt med valfritt källkontrollsystem. Men för att få alla fördelar med att enkelt och konsekvent distribuera dina arbetsflöden i olika miljöer och plattformar måste du också automatisera bygg- och distributionsprocessen.

Tillägget Azure Logic Apps (Standard) innehåller verktyg som du kan använda för att skapa och underhålla automatiserade bygg- och distributionsprocesser med Azure DevOps. Tänk dock på följande element innan du påbörjar den här automatiseringen:

  • Azure-logikappresursen där du skapar dina arbetsflöden

  • De Azure-värdbaserade anslutningar som arbetsflöden använder och skapas från Microsoft-hanterade anslutningsappar.

    Dessa anslutningar skiljer sig från de anslutningar som körs direkt och internt med Azure Logic Apps-körningen.

  • De specifika inställningarna och parametrarna för de olika miljöer där du vill distribuera

Tillägget hjälper dig att utföra följande nödvändiga uppgifter för att automatisera kompilering och distribution:

  • Parametrisera anslutningsreferenser vid designtillfället. Den här uppgiften förenklar processen med att uppdatera referenser i olika miljöer utan att bryta lokala utvecklingsfunktioner.

  • Generera skript som automatiserar distributionen för din standardlogikappresurs, inklusive alla beroende resurser.

  • Generera skript som automatiserar distributionen för Azure-värdbaserade anslutningar.

  • Förbered miljöspecifika parametrar som du kan mata in i Azure Logic Apps-paketet under byggprocessen utan att bryta den lokala utvecklingsfunktionen.

  • Generera pipelines på begäran med hjälp av Azure DevOps för att stödja infrastrukturdistribution tillsammans med bygg- och lanseringsprocesserna.

Den här guiden visar hur du utför följande uppgifter:

  1. Skapa en logikappsarbetsyta och ett projekt i Visual Studio Code som innehåller de filer som skapar pipelines för infrastrukturdistribution, kontinuerlig integrering (CI) och kontinuerlig distribution (CD).

  2. Skapa en anslutning mellan din arbetsyta och Git-lagringsplats i Azure DevOps.

  3. Skapa pipelines i Azure DevOps.

Mer information finns i följande dokumentation:

Kända problem och begränsningar

  • Den här funktionen stöder endast standardlogikappprojekt. Om din Visual Studio Code-arbetsyta innehåller både ett standardlogikappprojekt och ett anpassat kodprojekt för Functions har båda distributionsskripten genererade, men anpassade kodprojekt ignoreras för närvarande. Möjligheten att skapa byggpipelines för anpassad kod finns i översikten.

  • Tillägget skapar pipelines för infrastrukturdistribution, kontinuerlig integrering (CI) och kontinuerlig distribution (CD). Du ansvarar dock för att ansluta pipelines till Azure DevOps och skapa relevanta utlösare.

  • Tillägget stöder för närvarande endast Azure Resource Management-mallar (ARM-mallar) för distributionsskript för infrastruktur. Andra mallar håller på att planeras.

Förutsättningar

Skapa en logikappsarbetsyta, ett projekt och ett arbetsflöde

  1. I Visual Studio Code går du till aktivitetsfältet och väljer Azure-ikonen.

  2. I Azure-fönstret i verktygsfältet Arbetsyta öppnar du Menyn Azure Logic Apps och väljer Skapa ny arbetsyta för logikappen.

    Skärmbild som visar Visual Studio Code, Azure-ikonen markerad på den vänstra menyn, avsnittet Arbetsyta och valt alternativ för Skapa ny logikapparbetsyta.

  3. Följ anvisningarna för att slutföra följande uppgifter:

    1. Välj mappen för att skapa din arbetsyta.

    2. Ange namnet på arbetsytan.

    3. Välj projekttyp: Logikapp

    4. Ange namnet på logikappens projekt.

    5. Välj arbetsflödesmallen. Ange arbetsflödets namn.

    6. Välj om du vill öppna arbetsytan i det aktuella Visual Studio Code-fönstret eller ett nytt fönster.

      Visual Studio Code visar den nya arbetsytan och logikappsprojektet.

  4. Följ dessa steg för att öppna arbetsflödesdesignern:

    1. I logikappprojektet expanderar du mappen med ditt arbetsflödesnamn.

    2. Om den inte redan är öppen öppnar du filen workflow.json , öppnar filens snabbmeny och väljer Öppna designer.

    3. När du uppmanas att tillåta parameteriseringar för anslutningar när projektet läses in väljer du Ja.

      Med det här valet kan ditt projekt använda parametrar i anslutningsdefinitioner så att du kan automatisera bygget och distributionen för olika miljöer.

    4. Följ anvisningarna för att välja dessa objekt:

      • Använda anslutningsappar från Azure

        Kommentar

        Om du hoppar över det här steget kan du bara använda de inbyggda anslutningsappar som körs. Följ dessa steg om du vill aktivera Microsoft-hanterade, Azure-värdbaserade anslutningsappar vid ett senare tillfälle:

        1. Öppna snabbmenyn för filen workflow.json och välj Använd anslutningsappar från Azure.

        2. Välj en befintlig Azure-resursgrupp som du vill använda för din logikapp.

        3. Ladda om arbetsflödesdesignern.

      • Den befintliga Azure-resursgrupp som du vill använda för din logikapp

  5. När du är klar läser du in arbetsflödesdesignern igen. Logga in på Azure om du uppmanas att göra det.

    Skärmbild som visar Visual Studio Code, Explorer-ikonen markerad på den vänstra menyn, logikappsprojektet och arbetsflödesdesignern.

Nu kan du redigera arbetsflödet på valfritt sätt och lokalt testa arbetsflödet längs vägen. Information om hur du skapar och testar ett exempelarbetsflöde finns i Skapa standardarbetsflöden med Visual Studio Code.

Generera distributionsskript

När du har skapat och testat arbetsflödet lokalt skapar du dina distributionsskript.

  1. Från det tomma området under alla projektfiler öppnar du projektets snabbmeny och väljer Generera distributionsskript.

    Skärmbild som visar Visual Studio Code, Explorer-ikonen markerad på den vänstra menyn, logikappsprojektet, den öppnade snabbmenyn för projektfönstret och det valda alternativet för Generera distributionsskript.

  2. Följ anvisningarna för att slutföra dessa steg:

    1. Välj den befintliga Azure-resursgruppen som ska användas för din logikapp.

    2. Ange ett unikt namn för logikappresursen.

    3. Ange ett unikt namn för lagringskontoresursen.

    4. Ange ett unikt namn som ska användas för din App Service-plan.

    5. Välj den arbetsytemapp där du vill generera filerna.

      Plats för distributionsmapp beskrivning
      Ny distributionsmapp (standard) Skapa en ny mapp på den aktuella arbetsytan.
      Välj en annan mapp Välj en annan mapp på den aktuella arbetsytan.

    När du är klar skapar Visual Studio Code en mapp med namnet deployment/{logic-app-name} i arbetsytans rot. Den här mappen använder samma logikappnamn som du angav i de här stegen.

    Kommentar

    Värdena för variabler, appinställningar och parametrar i följande filer fylls i i förväg baserat på de indata som du angav i de här stegen. När du riktar in dig på en annan miljö kontrollerar du att du uppdaterar värdena för de skapade parametrarna och variabelfilerna.

    Skärmbild som visar Visual Studio Code, Explorer-ikonen markerad på den vänstra menyn, logikappsprojektet och markerad mapp för distributionsskript med innehåll.

    Under mappen {logic-app-name} har du följande struktur:

    Mappnamn Filnamn och beskrivning
    ADOPipelineScripts - CD-pipeline.yml: Pipelinen för kontinuerlig leverans som innehåller instruktionerna för att distribuera logikappkoden till logikappresursen i Azure.

    - CD-pipeline-variables.yml: En YAML-fil som innehåller variablerna som används av CD-pipeline.yml-filen.

    - CI-pipeline.yml: Pipelinen för kontinuerlig integrering som innehåller instruktioner för att skapa och generera artefakter som krävs för att distribuera logikappresursen till Azure.

    - CI-pipeline-variables.yml: En YAML-fil som innehåller variablerna som används av CI-pipeline.yml-filen.

    - infrastructure-pipeline.yml: En YAML-pipeline med "Infrastruktur som kod" som innehåller instruktioner för att läsa in alla ARM-mallar till Azure och köra stegen i infrastructure-pipeline-template.yml-filen.

    - infrastructure-pipeline-template.yml: En YAML-pipelinefil som innehåller stegen för att distribuera en logikappresurs med alla nödvändiga beroenden och distribuera varje hanterad anslutning som krävs av källkoden.

    - infrastructure-pipeline-variables.yml: En YAML-pipeline som innehåller alla variabler som krävs för att köra stegen i infrastructure-pipeline-template.yml-filen.
    ArmTemplates - {connection-type}.parameters.json: En Resource Manager-parameterfil som innehåller de parametrar som krävs för att distribuera en Azure-värdbaserad anslutning med namnet {connection-type} till Azure. Den här filen finns för varje Azure-värdbaserad anslutning i arbetsflödet.

    - {anslutningstyp}.template.json: En Resource Manager-mallfil som representerar en Azure-värdbaserad anslutning med namnet {connection-reference} och som innehåller den information som används för att distribuera motsvarande anslutningsresurs till Azure. Den här filen finns för varje Azure-värdbaserad anslutning i arbetsflödet.

    - {logic-app-name}.parameters.json: En Resource Manager-parameterfil som innehåller de parametrar som krävs för att distribuera standardlogikappresursen med namnet {logic-app-name} till Azure, inklusive alla beroenden.

    - {logic-app-name}.template.json: En Resource Manager-mallfil som representerar standardlogikappresursen med namnet {logic-app-name} och innehåller den information som används för att distribuera logikappresursen till Azure.
    WorkflowParameters parameters.json: Den här JSON-filen är en kopia av filen med lokala parametrar och innehåller en kopia av alla användardefinierade parametrar plus molnversionen av alla parametrar som skapas av tillägget för att parametrisera Azure-värdbaserade anslutningar. Den här filen används för att skapa paketet som distribueras till Azure.

Ansluta din arbetsyta till din Git-lagringsplats

  1. Följ dessa steg för att initiera lagringsplatsen:

    1. I Visual Studio Code går du till aktivitetsfältet och väljer ikonen Källkontroll .

    2. I fönstret Källkontroll väljer du Initiera lagringsplats.

    3. På promptmenyn väljer du Välj mapp. Välj arbetsytans rotmapp och välj sedan Initiera lagringsplats.

      Skärmbild som visar Visual Studio Code, fönstret Källkontroll och valt alternativ med namnet Initiera lagringsplats.

    4. I fönstret Källkontroll väljer du Öppna lagringsplats.

    5. På snabbmenyn väljer du den lagringsplats som du nyss skapade.

    Mer information finns i Visual Studio Code – Initiera en lagringsplats i en lokal mapp.

  2. Följ dessa steg för att hämta URL:en för din Git-lagringsplats så att du kan lägga till en fjärranslutning:

    1. I Azure DevOps öppnar du teamprojektet för din Azure DevOps-organisation.

    2. På den vänstra menyn expanderar du Lagringsplatser och väljer Filer.

    3. I verktygsfältet Filer väljer du Klona.

      Skärmbild som visar Azure DevOps-teamprojekt, Git-lagringsplats och valt alternativ med namnet Klona.

    4. I fönstret Klona lagringsplats kopierar du HTTPS-versionen av klonens URL.

      Mer information finns i Hämta klonings-URL:en för din Git-lagringsplats i Azure Repos.

  3. Följ de här stegen för att lägga till en fjärranslutning för din Git-lagringsplats:

    1. Gå tillbaka till Visual Studio Code och till fönstret Källkontroll .

    2. Under Källkontrolldatabaser öppnar du ellipsmenyn (...) i lagringsplatsens verktygsfält och väljer Fjärrtillägg>.

      Skärmbild som visar Visual Studio Code, fönstret Källkontroll och det valda alternativet med namnet Lägg till fjärranslutning.

  4. I prompten klistrar du in den kopierade URL:en och anger ett namn på fjärren, som vanligtvis är ursprung.

    Nu har du skapat en anslutning mellan Visual Studio Code och lagringsplatsen.

  5. Innan du konfigurerar dina pipelines i nästa avsnitt öppnar du filen CD-pipeline.yml och byter namn på CI-pipelinen source i attributet så att den matchar det CI-pipelinenamn som du vill använda.

    Skärmbild som visar Visual Studio Code, källkontrollfönstret, öppnat CD-pipeline.yml fil och markerat källfält för CI-pipelinenamn.

  6. I fönstret Källkontroll checkar du in ändringarna och publicerar dem på lagringsplatsen.

    Mer information finns i Steg- och incheckningskodändringar.

Skapa pipelines i Azure DevOps

Om du vill skapa infrastrukturen tillsammans med CI- och CD-pipelines i Azure DevOps upprepar du följande steg för var och en av följande pipelinefiler:

  • infrastructure-pipeline.yml för pipelinen "Infrastruktur som kod".
  • CI-pipeline.yml för pipelinen för kontinuerlig integrering.
  • CD-pipeline.yml för pipelinen för kontinuerlig leverans.

Konfigurera en pipeline

  1. I Azure DevOps går du tillbaka till ditt teamprojekt och till fönstret Lagringsfiler>.

  2. I fönstret Filer väljer du Konfigurera bygge.

    Skärmbild som visar Azure DevOps-teamprojekt, Git-lagringsplats och valt alternativ med namnet Konfigurera bygge.

  3. I fönstret Inventering av pipelinen bekräftar du lagringsplatsens information och väljer Konfigurera pipeline.

    Skärmbild som visar lagersidan med lagringsplatsinformation för din pipeline.

  4. I fönstret Konfigurera din pipeline väljer du Befintlig YAML-fil för Azure Pipelines.

    Skärmbild som visar sidan Konfigurera för att välja en pipelinetyp.

  5. I fönstret Välj en befintlig YAML-fil följer du dessa steg för att välja din Infrastructure-pipeline.yml-fil :

    1. För Gren väljer du den gren där du har checkat in dina ändringar, till exempel main eller din versionsgren.

    2. För Sökväg väljer du den sökväg som ska användas för din pipeline. Följande sökväg är standardvärdet:

      deployment/{logic-app-name}/ADOPipelineScripts/{infrastructure-pipeline-name}.yml

    3. När du är klar väljer du Fortsätt.

      Skärmbild som visar fönstret för Välj en befintlig YAML-fil.

  6. I fönstret Konfigurera din pipeline väljer du Granska pipeline.

  7. I fönstret Granska din reglerade pipeline anger du följande information:

    • Pipelinenamn: Ange ett namn för pipelinen.
    • Pipelinemapp: Välj den mapp där pipelinen ska sparas, med namnet ./deployment/{logic-app-name}/pipelines.

  8. När du är klar väljer du Spara.

    Skärmbild som visar fönstret Granska styrd pipeline.

Visa och köra pipeline

Följ dessa steg för att hitta och köra din pipeline:

  1. På gruppprojektets vänstra meny expanderar du Pipelines och väljer Pipelines.

  2. Välj fliken Alla för att visa alla tillgängliga pipelines. Leta upp och välj din pipeline.

  3. I pipelinens verktygsfält väljer du Kör pipeline.

    Skärmbild som visar fönstret för den skapade pipelinen och det valda alternativet för Kör pipeline.

Mer information finns i Skapa din första pipeline.

Se även