Úprava nastavení hostitele a aplikace pro standardní aplikace logiky v Azure Logic Apps s jedním tenantem

Platí pro: Azure Logic Apps (Standard)

V Azure Logic Apps s jedním tenantem určují nastavení aplikace pro standardní aplikaci logiky globální možnosti konfigurace, které ovlivňují všechny pracovní postupy v této aplikaci logiky. Tato nastavení se ale použijí jenom v případě, že se tyto pracovní postupy spouštějí v místním vývojovém prostředí. Místně spuštěné pracovní postupy mají přístup k těmto nastavením aplikace jako místní proměnné prostředí, které používají místní vývojové nástroje pro hodnoty, které se často mění mezi prostředími. Tyto hodnoty mohou například obsahovat připojovací řetězec. Když nasadíte do Azure, nastavení aplikace se ignorují a nejsou součástí vašeho nasazení.

Vaše aplikace logiky má také nastavení hostitele, která určují nastavení konfigurace modulu runtime a hodnoty, které platí pro všechny pracovní postupy v této aplikaci logiky , například výchozí hodnoty propustnosti, kapacity, velikosti dat atd., ať už běží místně nebo v Azure.

Nastavení, parametry a nasazení aplikací

Ve službě Azure Logic Apps s více tenanty závisí nasazení na šablonách Azure Resource Manageru (šablony ARM), které kombinují a zpracovávají zřizování prostředků pro aplikace logiky i infrastrukturu. Tento návrh představuje výzvu, když potřebujete udržovat proměnné prostředí pro aplikace logiky v různých vývojových, testovacích a produkčních prostředích. Vše v šabloně ARM je definováno při nasazení. Pokud potřebujete změnit jenom jednu proměnnou, musíte všechno znovu nasadit.

V Azure Logic Apps s jedním tenantem je nasazení jednodušší, protože můžete oddělit zřizování prostředků mezi aplikacemi a infrastrukturou. Parametry můžete použít k abstrakci hodnot, které se můžou mezi prostředími měnit. Definováním parametrů pro použití v pracovních postupech se můžete nejprve zaměřit na návrh pracovních postupů a později vložit proměnné specifické pro prostředí. Proměnné prostředí můžete za běhu volat a odkazovat na je pomocí nastavení a parametrů aplikace. Tímto způsobem nemusíte znovu nasadit tak často.

Nastavení aplikace se integruje se službou Azure Key Vault. Můžete přímo odkazovat na zabezpečené řetězce, jako jsou připojovací řetězec a klíče. Podobně jako šablony Azure Resource Manageru (šablony ARM), kde můžete definovat proměnné prostředí v době nasazení, můžete definovat nastavení aplikace v rámci definice pracovního postupu aplikace logiky. Pak můžete zaznamenávat dynamicky generované hodnoty infrastruktury, jako jsou koncové body připojení, řetězce úložiště a další. Nastavení aplikace ale mají omezení velikosti a nejde na to odkazovat z určitých oblastí v Azure Logic Apps.

Další informace o nastavení aplikací logiky pro nasazení najdete v následující dokumentaci:

• Vytvoření parametrů pro hodnoty, které se mění v pracovních postupech mezi prostředími pro Azure Logic Apps s jedním tenantem
• Přehled nasazení DevOps pro aplikace logiky založené na jednom tenantovi
• Nastavení nasazení DevOps pro aplikace logiky založené na jednom tenantovi

Struktura projektu editoru Visual Studio Code

V editoru Visual Studio Code má váš projekt aplikace logiky některý z následujících typů:

• Sada rozšíření (Node.js), což je výchozí typ
• Balíček NuGet (.NET), který můžete převést z výchozího typu

Na základě těchto typů projekt obsahuje mírně odlišné složky a soubory. Projekt založený na NuGetu obsahuje složku .bin, která obsahuje balíčky a další soubory knihovny. Projekt založený na sadě neobsahuje složku .bin a další soubory. Některé scénáře vyžadují spuštění projektu založeného na NuGetu, například když chcete vyvíjet a spouštět vlastní integrované operace. Další informace o převodu projektu na použití NuGetu najdete v tématu Povolení vytváření integrovaných konektorů.

U výchozího projektu založeného na sadě má váš projekt strukturu složek a souborů, která je podobná následujícímu příkladu:

MyBundleBasedLogicAppProjectName
| .vscode
| Artifacts
  || Maps 
     ||| MapName1
     ||| ...
  || Schemas
     ||| SchemaName1
     ||| ...
| WorkflowName1
  || workflow.json
  || ...
| WorkflowName2
  || workflow.json
  || ...
| workflow-designtime
| .funcignore
| connections.json
| host.json
| local.settings.json

Na kořenové úrovni projektu najdete následující soubory a složky s dalšími položkami:

Referenční informace o nastavení aplikace – local.settings.json

V editoru Visual Studio Code na kořenové úrovni projektu aplikace logiky soubor local.settings.json obsahuje globální možnosti konfigurace, které ovlivňují všechny pracovní postupy v této aplikaci logiky při spuštění v místním vývojovém prostředí. Při místním spuštění pracovních postupů se tato nastavení přistupují jako místní proměnné prostředí a jejich hodnoty se můžou často měnit mezi různými prostředími, ve kterých pracovní postupy spouštíte. Pokud chcete tato nastavení zobrazit a spravovat, přečtěte si téma Správa nastavení aplikace – local.settings.json.

Nastavení aplikace v Azure Logic Apps fungují podobně jako nastavení aplikací ve službě Azure Functions nebo Azure Web Apps. Pokud jste tyto další služby používali dříve, možná už znáte nastavení aplikace. Další informace najdete v referenčníchinformacích

Aby se váš pracovní postup správně spustil, vyžadují se některá nastavení aplikace.

Správa nastavení aplikace – local.settings.json

Pokud chcete přidat, aktualizovat nebo odstranit nastavení aplikace, vyberte a projděte si následující části šablony webu Azure Portal, Visual Studio Code, Azure CLI nebo ARM (Bicep). Informace o nastavení aplikace specifické pro aplikace logiky najdete v referenční příručce k dostupným nastavením aplikace – 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 

Referenční informace o nastavení hostitele – host.json

V editoru Visual Studio Code na kořenové úrovni projektu aplikace logiky obsahuje soubor metadat host.json nastavení modulu runtime a výchozí hodnoty, které platí pro všechny pracovní postupy v prostředku aplikace logiky bez ohledu na to, jestli běží místně nebo v Azure. Pokud chcete tato nastavení zobrazit a spravovat, přečtěte si téma Správa nastavení hostitele – host.json. Související informace o omezeních najdete také v dokumentaci k limitům a konfiguraci pro Azure Logic Apps .

Propustnost orchestrace úloh

Tato nastavení ovlivňují propustnost a kapacitu pro azure Logic Apps s jedním tenantem pro spouštění operací pracovního postupu.

Obě následující nastavení se používají k ručnímu zastavení a okamžitému odstranění zadaných pracovních postupů ve standardní aplikaci logiky.

Následující příklad ukazuje syntaxi těchto nastavení, kde za každým ID pracovního postupu následuje dvojtečka (:) a oddělená středníkem (;):

"Jobs.CleanupJobPartitionPrefixes": "<workflow-ID-1>:; <workflow-ID-2:",
"Jobs.SuspendedJobPartitionPrefixes": "<workflow-ID-1>:; <workflow-ID-2>:"

Triggery založené na opakování

Souběžnost triggerů

Následující nastavení fungují jenom pro pracovní postupy, které začínají triggerem založeným na opakování pro integrované konektory založené na poskytovateli služeb. U pracovního postupu, který začíná triggerem založeným na funkci, se můžete pokusit nastavit dávkování tam, kde je to podporované. Dávkování ale není vždy správným řešením. Například s triggery služby Azure Service Bus může dávka obsahovat zprávy nad rámec doby trvání uzamčení. V důsledku toho se u takových zpráv nezdaří jakákoli akce, například dokončení nebo opuštění.

Doba trvání spuštění a uchovávání historie

Spuštění akcí

Vstupy a výstupy

Stránkování

Chunking

Ukládání obsahu vložených nebo použití objektů blob

Pro každou smyčku

Smyčky Until

Proměnné

Integrované operace HTTP

Integrované operace webhooku HTTP

Integrované operace Azure Storage

Blob Storage

Table and Queue Storage

Sdílená složka

Integrované operace Azure Functions

Integrované operace služby Azure Service Bus

Integrované operace SFTP

Operace spravovaného konektoru

Zásady opakování pro všechny ostatní operace

Omezení

• Maximální velikost obsahu

  Ve výchozím nastavení jsou předdefinované triggery, například HTTP nebo Požadavek, omezené na velikost zprávy popsanou v referenčních informacích o omezeních a konfiguraci – Zprávy. Pokud chcete zpracovat soubory větší než limit, zkuste obsah nahrát jako objekt blob do služby Azure Blob Storage a pak získat obsah pomocí konektoru Azure Blob.

Správa nastavení hostitele – host.json

Můžete přidat, aktualizovat nebo odstranit nastavení hostitele, která určují nastavení konfigurace modulu runtime a hodnoty, které platí pro všechny pracovní postupy v této aplikaci logiky , jako jsou výchozí hodnoty pro propustnost, kapacitu, velikost dat atd., ať už běží místně nebo v Azure. Informace o nastavení hostitele specifické pro aplikace logiky najdete v referenční příručce pro dostupná nastavení modulu runtime a nasazení – host.json.

Azure Portal – host.json

Pokud chcete zkontrolovat nastavení hostitele pro aplikaci logiky založené na jednom tenantovi na webu Azure Portal, postupujte takto:

1. Ve vyhledávacím poli webu Azure Portal najděte a otevřete aplikaci logiky.

2. V nabídce aplikace logiky v části Vývojové nástroje vyberte Rozšířené nástroje.

3. Na stránce Rozšířené nástroje vyberte Přejít, čímž otevřete prostředí Kudu pro vaši aplikaci logiky.

4. Na panelu nástrojů Kudu v nabídce konzoly Ladění vyberte CMD.

5. Na webu Azure Portal zastavte aplikaci logiky.

   1. V nabídce aplikace logiky vyberte Přehled.

   2. Na panelu nástrojů podokna Přehled vyberte Zastavit.

6. V nabídce aplikace logiky v části Vývojové nástroje vyberte Rozšířené nástroje.

7. V podokně Rozšířené nástroje vyberte Přejít, čímž otevřete prostředí Kudu pro vaši aplikaci logiky.

8. Na panelu nástrojů Kudu otevřete nabídku konzoly Ladění a vyberte CMD.

   Otevře se okno konzoly, abyste mohli pomocí příkazového řádku přejít do složky wwwroot . Nebo můžete procházet adresářovou strukturu, která se zobrazí nad oknem konzoly.

9. Přejděte k následující cestě ke složce wwwroot : ...\home\site\wwwroot.

10. Nad oknem konzoly v tabulce adresáře vedle souboru host.json vyberte Upravit.

11. Po otevření souboru host.json zkontrolujte všechna nastavení hostitele, která byla dříve přidána pro vaši aplikaci logiky.

    Další informace o nastavení hostitele najdete v referenční příručce k dostupným nastavením hostitele – host.json.

Pokud chcete přidat nastavení, postupujte takto:

1. Před přidáním nebo úpravou nastavení zastavte aplikaci logiky na webu Azure Portal.

   1. V nabídce aplikace logiky vyberte Přehled.
   2. Na panelu nástrojů podokna Přehled vyberte Zastavit.

2. Vraťte se do souboru host.json . extensionBundle Pod objekt přidejte extensions objekt, který zahrnuje objekty workflow a settings objekty, například:

   {
      "version": "2.0",
      "extensionBundle": {
         "id": "Microsoft.Azure.Functions.ExtensionBundle",
         "version": "[1.*, 2.0.0)"
      },
      "extensions": {
         "workflow": {
            "settings": {
            }
         }
      }
   }
   

3. V objektu settings přidejte plochý seznam s nastavením hostitele, které chcete použít pro všechny pracovní postupy v aplikaci logiky, ať už se tyto pracovní postupy spouštějí místně nebo v Azure, například:

   {
      "version": "2.0",
      "extensionBundle": {
         "id": "Microsoft.Azure.Functions.ExtensionBundle",
         "version": "[1.*, 2.0.0)"
      },
      "extensions": {
         "workflow": {
            "settings": {
               "Runtime.Trigger.MaximumWaitingRuns": "100"
            }
         }
      }
   }
   

4. Až budete hotovi, nezapomeňte vybrat Uložit.

5. Teď restartujte aplikaci logiky. Vraťte se na stránku Přehled aplikace logiky a vyberte Restartovat.

Visual Studio Code – host.json

Pokud chcete zkontrolovat nastavení hostitele pro vaši aplikaci logiky v editoru Visual Studio Code, postupujte takto:

1. V projektu aplikace logiky na kořenové úrovni projektu vyhledejte a otevřete soubor host.json .

2. V objektu extensions v části workflows a settingszkontrolujte všechna nastavení hostitele, která byla dříve přidána pro vaši aplikaci logiky. extensions V opačném případě se objekt v souboru nezobrazí.

   Další informace o nastavení hostitele najdete v referenční příručce k dostupným nastavením hostitele – host.json.

Pokud chcete přidat nastavení hostitele, postupujte takto:

1. Do souboru host.json pod extensionBundle objekt přidejte extensions objekt, který zahrnuje workflow objekty a settings objekty, například:

   {
      "version": "2.0",
      "extensionBundle": {
         "id": "Microsoft.Azure.Functions.ExtensionBundle",
         "version": "[1.*, 2.0.0)"
      },
      "extensions": {
         "workflow": {
            "settings": {
            }
         }
      }
   }
   

2. V objektu settings přidejte plochý seznam s nastavením hostitele, které chcete použít pro všechny pracovní postupy v aplikaci logiky, ať už se tyto pracovní postupy spouštějí místně nebo v Azure, například:

   {
      "version": "2.0",
      "extensionBundle": {
         "id": "Microsoft.Azure.Functions.ExtensionBundle",
         "version": "[1.*, 2.0.0)"
      },
      "extensions": {
         "workflow": {
            "settings": {
               "Runtime.Trigger.MaximumWaitingRuns": "100"
            }
         }
      }
   }
   

Další kroky

• Vytvoření parametrů pro hodnoty, které se mění v pracovních postupech mezi prostředími pro Azure Logic Apps s jedním tenantem
• Nastavení nasazení DevOps pro službu Azure Logic Apps pro jednoho tenanta