Exportera förbrukningsarbetsflöden till en standardlogikapp

Standardarbetsflöden för logikappar, som körs i Azure Logic Apps med en enda klientorganisation, erbjuder många nya och förbättrade funktioner. Du får till exempel beräkningsisolering, integrering av virtuella nätverk och privata slutpunkter tillsammans med App Services Environment-värdtjänster, lokal utveckling och felsökning med Visual Studio Code, låg svarstid med tillståndslösa arbetsflöden med mera.

Om du vill ha fördelarna med Standard-arbetsflöden, men dina arbetsflöden körs i Azure Logic Apps med flera klientorganisationer, kan du nu flytta dina förbrukningsarbetsflöden till Azure Logic Apps med en enda klientorganisation. Den här växeln är meningsfull i scenarier som kräver några av standardfunktionerna, till exempel isolering och nätverksintegrering, kortare svarstid eller bättre förutsägbarhet för kostnader.

Nu kan du exportera logikappar för förbrukning till en standardlogikapp. Med Visual Studio Code och det senaste Tillägget för Azure Logic Apps (Standard) exporterar du dina logikappar som tillståndskänsliga arbetsflöden till ett standardlogikappprojekt. Du kan sedan uppdatera, testa och felsöka dina arbetsflöden lokalt för att förbereda dem för omdistribution. När du är klar kan du distribuera antingen direkt från Visual Studio Code eller via din egen DevOps-process.

Anteckning

Exportfunktionen migrerar inte dina arbetsflöden. I stället replikerar det här verktyget artefakter, till exempel arbetsflödesdefinitioner, anslutningar, integrationskontoartefakter med mera. Källlogikappens resurser, arbetsflöden, utlösarhistorik, körningshistorik och andra data förblir intakta.

Du styr exportprocessen och din migreringsresa. Du kan testa och verifiera dina exporterade arbetsflöden till din belåtenhet med målmiljön. Du väljer när du vill inaktivera eller ta bort dina källlogikappar.

Den här artikeln innehåller information om exportprocessen och visar hur du exporterar dina logikapparbetsflöden från en ISE till ett lokalt standardlogikappprojekt i Visual Studio Code.

Kända problem och begränsningar

  • Exportverktyget exporterar inte någon infrastrukturinformation, till exempel inställningar för integrationskontot.

  • Exportverktyget kan exportera logikapparbetsflöden med utlösare som har samtidighetsinställningar. Azure Logic Apps med en klientorganisation ignorerar dock de här inställningarna.

  • Logikappar måste finnas i samma region om du vill exportera dem inom samma standardlogikappprojekt.

  • Som standard klonas inte autentiseringsuppgifter för anslutning från källlogikappens arbetsflöden. Innan logikappens arbetsflöden kan köras måste du autentisera anslutningarna igen efter exporten.

  • Om en Azure-anslutning har en inbyggd anslutningsversion konverterar exportverktyget som standard automatiskt Azure-anslutningsappen till den inbyggda anslutningsappen. Det finns inget alternativ för att välja bort det här beteendet.

Exporterbara åtgärdstyper

Åtgärd JSON-typ
Utlösare Inbyggd: Http, HttpWebhook, Recurrence, manual (begäran)

Hanterad: ApiConnectionApiConnectionNotification, ApiConnectionWebhook
Åtgärd Inbyggd: AppendToArrayVariable, , AppendToStringVariableCompose, DecrementVariable, Foreach, Http, HttpWebhook, If, IncrementVariable, , InitializeVariable, JavaScriptCode, Join, ParseJson, Response, Scope, , Select, SetVariable, Switch, Table, Terminate, , UntilWait

- Hanterad: ApiConnection, ApiConnectionWebhook

Förutsättningar

  • En eller flera logikappar som ska distribueras till samma prenumeration och Azure-region, till exempel USA, östra 2.

  • Åtkomst på prenumerationsnivå för Azure-läsare till den prenumeration där logikapparna för närvarande distribueras.

  • Åtkomst på resursgruppsnivå för Azure-deltagare, om du väljer alternativet Distribuera hanterade anslutningsappar.

  • Granska och uppfylla kraven för hur du konfigurerar Visual Studio Code med Tillägget Azure Logic Apps (Standard).

Anteckning

Se till att installera version 2.0.16 eller senare för Azure Logic Apps-tillägget (Standard) för Visual Studio Code. Vissa konverteringsscenarier kräver den senaste arbetsflödesdesignern, som är tillgänglig från och med den här versionen.

Gruppera logikappar för export

Med Tillägget Azure Logic Apps (Standard) kan du kombinera flera arbetsflöden för förbrukningslogikappar till ett enda standardlogikappprojekt. I Azure Logic Apps med en enda klientorganisation kan en standardlogikappresurs ha flera arbetsflöden. Med den här metoden kan du verifiera dina arbetsflöden i förväg så att du inte missar några beroenden när du väljer logikappar för export.

Tänk på följande rekommendationer när du väljer logikappar för export:

  • Gruppera logikappar där arbetsflöden delar samma resurser, till exempel integrationskontotefakter, kartor och scheman, eller använd resurser via en processkedja.

  • Information om organisation och antal arbetsflöden per logikapp finns i Metodtips och rekommendationer.

Exportera förbrukningsarbetsflöden till ett lokalt projekt

Välj logikappar för export

  1. Logga in på Azure i Visual Studio Code om du inte redan har gjort det.

  2. I Aktivitetsfältet i Visual Studio Code väljer du Azure för att öppna Azure-fönstret (Skift + Alt + A).

    Skärmbild som visar aktivitetsfältet i Visual Studio Code med Azure-ikonen markerad.

  3. I verktygsfältet Arbetsyta går du till Menyn Azure Logic Apps och väljer Exportera logikapp.

    Skärmbild som visar Azure-fönstret, verktygsfältet Arbetsyteavsnitt och Exportera logikapp valt.

  4. När fliken Exportera har öppnats väljer du din Azure-prenumeration och region och väljer sedan Nästa.

    Skärmbild som visar fliken Exportera med Azure-prenumeration och region valt.

  5. Välj de logikappar som ska exporteras. Varje vald logikapp visas i listan Valda logikappar åt sidan. När du är klar väljer du Nästa.

    Tips

    Du kan också söka efter logikappar och filtrera på resursgruppen.

    Skärmbild som visar avsnittet

    Exportverktyget börjar verifiera om dina valda logikappar är berättigade till export.

Granska exportverifieringsresultat

  1. När exportverifieringen har slutförts granskar du resultaten genom att expandera posten för varje logikapp.

    • Logikappar som har fel är inte berättigade till export. Du måste ta bort dessa logikappar från exportlistan tills du åtgärdar dem vid källan. Om du vill ta bort en logikapp från listan väljer du Tillbaka.

      SourceLogicApp2 har till exempel ett fel och kan inte exporteras förrän det har åtgärdats:

      Skärmbild som visar avsnittet Granska exportstatus och valideringsstatus för logikappens arbetsflöde med fel.

    • Logikappar som klarar valideringen med eller utan varningar är fortfarande berättigade till export. Om du vill fortsätta väljer du Exportera om alla appar verifieras korrekt eller väljer Exportera med varningar om appar har varningar.

      SourceLogicApp3 har till exempel en varning, men du kan fortfarande fortsätta att exportera:

      Skärmbild som visar avsnittet Granska exportstatus och valideringsstatus för logikappens arbetsflöde med varning.

    Följande tabell innehåller mer information om varje verifieringsikon och status:

    Verifieringsikon Valideringsstatus
    Lyckad ikon Objektet har godkänts, så exporten kan fortsätta utan problem att lösa.
    Ikonen Misslyckades Objektet kunde inte valideras, så exporten kan inte fortsätta.

    Verifieringsposten för det misslyckade objektet visas automatiskt expanderad och innehåller information om valideringsfelet.
    Varningsikon Objektet godkändes med en varning, men exporten kan fortsätta med nödvändig lösning efter exporten.

    Verifieringsposten för objektet med en varning visas automatiskt expanderad och innehåller information om varningen och nödvändig reparation efter export.
  2. När avsnittet Slutför export visas för Exportplats bläddrar du till och väljer en lokal mapp för det nya standardlogikappprojektet.

    Skärmbild som visar avsnittet Slutför export och egenskapen Exportplats med vald projektmapp för lokal export.

  3. Om arbetsflödet har hanterade anslutningar som du vill distribuera, vilket endast rekommenderas för icke-produktionsmiljöer, väljer du Distribuera hanterade anslutningar, som visar befintliga resursgrupper i din Azure-prenumeration. Välj den resursgrupp där du vill distribuera de hanterade anslutningarna.

    Skärmbild som visar avsnittet Slutför export med vald lokal exportmapp,

  4. Under Steg efter export granskar du eventuella nödvändiga steg efter exporten, till exempel:

    Skärmbild som visar avsnittet Efter exportsteg och nödvändiga steg efter export, om sådana finns.

  5. Baserat på ditt scenario väljer du Exportera och slutför eller Exportera med varningar och slutför.

    Exportverktyget laddar ned projektet till den valda mappplatsen, expanderar projektet i Visual Studio Code och distribuerar eventuella hanterade anslutningar, om du har valt det alternativet.

    Skärmbild som visar avsnittet

  6. När processen är klar öppnar Visual Studio Code en ny arbetsyta. Nu kan du stänga exportfönstret på ett säkert sätt.

  7. Öppna och granska README.md-filen från standardlogikappprojektet för de nödvändiga stegen efter exporten.

    Skärmbild som visar ett nytt standardlogikappprojekt med README.md fil öppen.

Steg efter export

Reparationssteg

Vissa exporterade arbetsflöden för logikappar kräver reparationssteg efter exporten för att köras på standardplattformen.

  1. Öppna filen README.md från standardlogikappprojektet och granska reparationsstegen för dina exporterade arbetsflöden. Exportverktyget genererar README.md-filen, som innehåller alla nödvändiga steg efter exporten.

  2. Innan du gör några ändringar i källlogikappens arbetsflöde bör du testa den nya resursen och arbetsflödena för standardlogikappen.

Åtgärder och inställningar för integrationskonto

Om du exporterar åtgärder som är beroende av ett integrationskonto måste du manuellt konfigurera standardlogikappen med en referenslänk till integrationskontot som innehåller de artefakter som krävs. Mer information finns i Länka integrationskontot till en standardlogikapp.

Batch-åtgärder och inställningar

Om du exporterar åtgärder som använder Batch-åtgärder med flera konfigurationer som lagras i ett integrationskonto måste du manuellt konfigurera Batch-åtgärderna med rätt värden efter exporten. Mer information finns i Skicka, ta emot och batcharbeta meddelanden i Azure Logic Apps.

Projektmappsstruktur

När exportprocessen är klar innehåller standardlogikappsprojektet nya mappar och filer tillsammans med de flesta andra i ett typiskt standardlogikappprojekt.

I följande tabell beskrivs dessa nya mappar och filer som lagts till av exportprocessen:

Mapp Fil Beskrivning
.development\deployment LogicAppStandardConnections.parameters.json Parameterfil för Azure Resource Manager-mall för distribution av hanterade anslutningsappar
LogicAppStandardConnections.template.json Azure Resource Manager malldefinition för distribution av hanterade anslutningsappar
LogicAppStandardInfrastructure.parameters.json Parameterfil för Azure Resource Manager-mall för distribution av standardlogikappresurs
LogicAppStandardInfrastructure.template.json Azure Resource Manager-malldefinition för distribution av standardlogikappresurs
.logs\export exportReport.json Exportera rapportsammanfattningens rådatafil, som innehåller alla steg som krävs för reparation efter export
exportValidation.json Raw-filen för valideringsrapporten, som innehåller valideringsresultaten för varje exporterad logikapp
README.md Markdown-fil med sammanfattning av exportresultat, inklusive de skapade logikapparna och alla nödvändiga nästa steg

Nästa steg