Redigera app- och värdinställningar för standardlogikappar i Azure Logic Apps med en enda klientorganisation

Gäller för: Azure Logic Apps (Standard)

Den här guiden beskriver hur du hanterar körnings- och miljöinställningar för standardlogikappar i Azure Logic Apps med en enda klientorganisation.

Appinställningarna för en standardlogikapp anger de globala konfigurationsalternativ som påverkar alla arbetsflöden i logikappen. De här inställningarna gäller dock bara när dessa arbetsflöden körs i din lokala utvecklingsmiljö. Arbetsflöden som körs lokalt kan komma åt dessa appinställningar som lokala miljövariabler, som används av lokala utvecklingsverktyg för värden som ofta kan ändras mellan miljöer. Dessa värden kan till exempel innehålla anslutningssträng. När du distribuerar till Azure ignoreras appinställningarna och ingår inte i distributionen.

Logikappen har också värdinställningar som anger inställningar och värden för körningskonfiguration som gäller för alla arbetsflöden i logikappen , till exempel standardvärden för dataflöde, kapacitet, datastorlek och så vidare, oavsett om de körs lokalt eller i Azure.

Inställningarna är nyckel/värde-par som definierar inställningsnamnet och värdet.

Appinställningar, parametrar och distribution

I Azure Logic Apps med flera klientorganisationer beror distributionen på Azure Resource Manager-mallar (ARM-mallar) som kombinerar och hanterar resursetablering för både logikappar och infrastruktur. Den här designen utgör en utmaning när du måste underhålla miljövariabler för logikappar i olika utvecklings-, test- och produktionsmiljöer. Allt i en ARM-mall definieras vid distributionen. Om du bara behöver ändra en enda variabel måste du distribuera om allt.

I Azure Logic Apps för en klientorganisation blir distributionen enklare eftersom du kan separera resursetablering mellan appar och infrastruktur. Du kan använda parametrar för att abstrahera värden som kan ändras mellan miljöer. Genom att definiera parametrar som ska användas i dina arbetsflöden kan du först fokusera på att utforma arbetsflöden och sedan infoga miljöspecifika variabler senare. Du kan anropa och referera till miljövariabler vid körning med hjälp av appinställningar och parametrar. På så sätt behöver du inte distribuera om så ofta.

Appinställningar integreras med Azure Key Vault. Du kan referera direkt till säkra strängar, till exempel anslutningssträng och nycklar. På samma sätt som ARM-mallar, där du kan definiera miljövariabler vid distributionen, kan du definiera appinställningar i logikappens arbetsflödesdefinition. Du kan sedan samla in dynamiskt genererade infrastrukturvärden, till exempel anslutningsslutpunkter, lagringssträngar med mera. Appinställningar har dock storleksbegränsningar och kan inte refereras från vissa områden i Azure Logic Apps.

Mer information om hur du konfigurerar dina logikappar för distribution finns i följande dokumentation:

• Skapa parametrar mellan miljöer för arbetsflödesindata i Azure Logic Apps
• Översikt över DevOps-implementering för logikappar med enkelhyresmodell
• Konfigurera DevOps-distribution för enklientbaserade logikappar

Visual Studio Code-projektstruktur

I Visual Studio Code har logikappprojektet någon av följande typer:

• Tilläggspaketbaserad (Node.js), som är standardtypen
• NuGet-paketbaserad (.NET), som du kan konvertera från standardtypen

Baserat på dessa typer kan projektet innehålla lite olika mappar eller filer. Ett Nuget-paketbaserat projekt har till exempel en .bin mapp som innehåller paket och andra biblioteksfiler. Ett tilläggspaketbaserat projekt innehåller inte den här .bin mappen.

Vissa scenarier kräver ett NuGet-paketbaserat projekt för att appen ska kunna köras, till exempel när du vill utveckla och köra anpassade inbyggda åtgärder. Mer information om hur du konverterar projektet till att använda NuGet finns i Aktivera författande av inbyggd anslutningsanslutning.

Standardtilläggets paketbaserade projekt har en mapp och filstruktur som liknar följande exempel:

MyWorkspaceName
| MyBundleBasedLogicAppProjectName
  || .vscode
  || Artifacts
     ||| Maps 
         |||| MapName1
         |||| ...
     ||| Rules
     ||| Schemas
         |||| SchemaName1
         |||| ...
  || lib
     ||| builtinOperationSdks
         |||| JAR
         |||| net472
     ||| custom
  || WorkflowName1
     ||| workflow.json
     ||| ...
  || WorkflowName2
     ||| workflow.json
     ||| ...
  || workflow-designtime
     ||| host.json
     ||| local.settings.json
  || .funcignore
  || connections.json
  || host.json
  || local.settings.json

På projektets rotnivå hittar du följande mappar och filer tillsammans med andra objekt:

Referens för appinställningar – local.settings.json

I Visual Studio Code, på logikappprojektets rotnivå, innehåller local.settings.json-filen globala konfigurationsalternativ som påverkar alla arbetsflöden i logikappen när den körs i din lokala utvecklingsmiljö. När dina arbetsflöden körs lokalt används de här inställningarna som lokala miljövariabler, och deras värden kan ofta ändras mellan de olika miljöer där du kör dina arbetsflöden. Information om hur du visar och hanterar de här inställningarna finns i Hantera appinställningar – local.settings.json.

Appinställningar i Azure Logic Apps fungerar på samma sätt som appinställningar i Azure Functions eller Azure Web Apps. Om du har använt dessa andra tjänster tidigare kanske du redan är bekant med appinställningarna. Mer information finns i Referens för appinställningar för Azure Functions och Arbeta med Azure Functions Core Tools – filen Lokala inställningar.

I följande tabell beskrivs de appinställningar som logikappen använder. Vissa inställningar krävs för att logikappen ska fungera korrekt:

Hantera appinställningar – local.settings.json

Om du vill lägga till, uppdatera eller ta bort appinställningar väljer du och granskar följande avsnitt för Azure-portalen, Visual Studio Code eller Azure CLI. Appinställningar som är specifika för logikappar finns i Referens för appinställningar – local.settings.json.

az logicapp config appsettings list --name <MyLogicApp> --resource-group <MyResourceGroup>

az logicapp config appsettings set --name <MyLogicApp> --resource-group <MyResourceGroup> --settings CUSTOM_LOGIC_APP_SETTING=12345 

Referens för värdinställningar – host.json

I Visual Studio Code, på logikappprojektets rotnivå, innehåller denhost.json metadatafilen de körningsinställningar och standardvärden som gäller för alla arbetsflöden i en logikappresurs oavsett om den körs lokalt eller i Azure. Information om hur du visar och hanterar dessa inställningar finns i Hantera värdinställningar – host.json. Du kan också hitta information om relaterade gränser i dokumentationen Gränser och konfiguration för Azure Logic Apps .

Jobborkestreringsgenomströmning

De här inställningarna påverkar dataflödet och kapaciteten för Azure Logic Apps med en enda klientorganisation för att köra arbetsflödesåtgärder.

Följande inställningar används för att manuellt stoppa och omedelbart ta bort de angivna arbetsflödena i standardlogikappen.

Om du vill ange enskilda arbetsflöden använder du följande syntax där varje arbetsflödes-ID följs av ett kolon (:) och avgränsas med ett semikolon (;):

"Jobs.CleanupJobPartition": "<workflow-ID-1>:;<workflow-ID-2>",
"Jobs.SuspendedJobPartition": "<workflow-ID-1>:;<workflow-ID-2>:",
"SequencerJobs.SuspendedSequencerPartition": "<workflow-ID-1>:;<workflow-ID-2>:"

Om du vill avbryta en specifik körning anger du körnings-ID:t efter arbetsflödes-ID:t med 2D som avgränsare, till exempel:

"Jobs.SuspendedJobPartition": "<workflow-ID-1>:2D<run-ID>;",

Upprepningsbaserade utlösare

Utlösa konkurrens

Följande samtidighetsinställningar gäller endast för arbetsflöden som börjar med en upprepningsbaserad utlösare för inbyggda tjänstleverantörsbaserade anslutningar och styr antalet arbetsflöden som körs vid samma tidpunkt.

För ett arbetsflöde som börjar med en funktionsbaserad utlösare kan du försöka konfigurera batchbearbetning där det stöds. Batchbearbetning är dock inte alltid rätt lösning. Med utlösare för Azure Service Bus kan en batch till exempel behålla meddelanden efter att låset har gått ut. Därför misslyckas alla åtgärder, till exempel fullständiga eller avbrutna, på sådana meddelanden.

Körningsvaraktighet och kvarhållning av historik

Utför åtgärder

Ändra timeout-värde för funktionsbaserade inbyggda åtgärder

För inbyggda åtgärder som körs som funktionsanrop i Azure Functions lägger du till både Runtime.FlowRunRetryableActionJobCallback.ActionJobExecutionTimeout värdinställningarna och functionTimeout i dinhost.json-fil enligt följande exempel:

{
   "version": "2.0",
   "extensionBundle": {
      "id": "Microsoft.Azure.Functions.ExtensionBundle.Workflows",
      "version": "[1.*, 2.0.0)"
   },
   "extensions": {
      "workflow": {
         "settings": {
            "Runtime.FlowRunRetryableActionJobCallback.ActionJobExecutionTimeout": "01:00:00"
         }
      }
   },
   "functionTimeout": "01:00:00"
}

Indata och utdata

Pagination

Chunking

Lagra innehåll infogat eller använd blobar

För varje loop

Loopar tills

Variables

Inbyggda HTTP-åtgärder

Inbyggda HTTP Webhook-åtgärder

Inbyggda Azure Storage-åtgärder

BLOB-lagring

Tabell- och kölagring

Fildelning

Inbyggda Azure Functions-åtgärder

Inbyggda Azure Service Bus-åtgärder

Inbyggda SFTP-åtgärder

Åtgärder för hanterade anslutningsoperationer

Återförsöksprincip för alla andra åtgärder

Limitations

Maximal innehållsstorlek:

Som standard begränsas inbyggda utlösare, till exempel HTTP eller Begäran, till meddelandestorleken som beskrivs i Referens för gränser och konfiguration – Meddelanden. Om du vill hantera filer som är större än gränsen kan du prova att ladda upp ditt innehåll som en blob till Azure Blob Storage och sedan hämta ditt innehåll med hjälp av Azure Blob-anslutningsappen.

Hantera värdinställningar – host.json

Du kan lägga till, uppdatera eller ta bort värdinställningar som anger inställningar och värden för körningskonfiguration som gäller för alla arbetsflöden i logikappen, till exempel standardvärden för dataflöde, kapacitet, datastorlek och så vidare, oavsett om de körs lokalt eller i Azure. Värdinställningar som är specifika för logikappar finns i Referens för värdinställningar – host.json.

Relaterat innehåll

• Skapa parametrar mellan miljöer för arbetsflödesindata i Azure Logic Apps
• Konfigurera DevOps-distribution för Standard-logikappar i en enanvändarmiljö i Azure Logic Apps