Изменение настроек приложения и среды для логических приложений стандартного уровня в Azure Logic Apps в однопользовательской среде

Область применения: Azure Logic Apps (стандартная версия)

В этом руководстве объясняется, как управлять настройками среды выполнения и окружения для стандартных логических приложений в одноарендных Azure Logic Apps.

Параметры приложения для приложения логики уровня "Стандартный" указывают глобальные параметры конфигурации, влияющие на все рабочие процессы в этом приложении логики. Однако эти параметры применяются только в том случае, если эти рабочие процессы выполняются в локальной среде разработки. Локальные рабочие процессы могут обращаться к этим параметрам приложения как к локальным переменным среды, используемым локальными средствами разработки в качестве значений, которые могут часто изменяться при смене среды. Например, эти значения могут содержать строки подключения. При развертывании в Azure параметры приложения не учитываются и не включаются в развертывание.

Приложение логики также имеет параметры узла, которые указывают параметры конфигурации среды выполнения и значения, применимые ко всем рабочим процессам в этом приложении логики, например значения по умолчанию для пропускной способности, емкости, размера данных и т. д., независимо от того, выполняются ли они локально или в Azure.

Параметры — это пары "ключ-значение" , определяющие имя и значение параметра.

Настройки, параметры и развертывание приложения

В мультитенантных Azure Logic Apps развертывание зависит от шаблонов Azure Resource Manager (шаблонов ARM), которые объединяют и обрабатывают подготовку ресурсов для приложений логики и инфраструктуры. При таком подходе возникает необходимость сохранять одни и те же переменные среды для приложений логики в различных средах разработки и тестирования, а также в рабочей среде. Все параметры в шаблоне ARM определяются при развертывании. Если необходимо изменить только одну переменную, необходимо повторить развертывание полностью.

В Azure Logic Apps с одним клиентом развертывание становится проще, так как можно разделить подготовку ресурсов между приложениями и инфраструктурой. Параметры можно использовать для абстрактных значений, которые могут изменяться между средами. Если определить параметры для использования в рабочих процессах, можно сначала сосредоточиться на разработке рабочих процессов и позже вставить переменные для конкретной среды. Вы можете вызывать переменные среды и ссылаться на них в среде выполнения с помощью параметров и настроек приложения. Таким образом, вам не придется так часто выполнять повторное развертывание.

Настройки приложения интегрированы с Azure Key Vault. Можно напрямую ссылаться на защищенные строки, например строки подключения и ключи. Аналогично шаблонам ARM, где переменные среды определяют в процессе развертывания, настройки приложения можно задать в рамках определения рабочего процесса приложения логики. Затем можно захватывать динамически генерируемые значения инфраструктуры, такие как конечные точки подключения, строки хранения и другие. Однако для настроек приложения установлены ограничения по размеру, и на них нельзя ссылаться из определенных областей в Azure Logic Apps.

Дополнительные сведения о настройке приложений логики для развертывания см. в указанных ниже документах.

• Создание параметров между средами для входных данных рабочего процесса в Azure Logic Apps
• Общие сведения о развертывании DevOps для приложений логики на основе одного клиента
• Настройка развертывания DevOps для приложений логики с одним клиентом

Структура проекта Visual Studio Code

В Visual Studio Code ваш проект приложения логики может относиться к одному из следующих типов:

• На основе пакета расширений (Node.js) — это тип по умолчанию
• На основе пакета NuGet (.NET) — его можно преобразовать из типа по умолчанию

На основе этих типов проект может включать несколько разных папок или файлов. Например, проект на основе пакетов Nuget содержит папку .bin , содержащую пакеты и другие файлы библиотеки. Проект на основе пакета расширений не включает эту папку .bin .

В некоторых сценариях для запуска приложения требуется проект на основе пакета NuGet, например при разработке и выполнении пользовательских встроенных операций. Для получения дополнительной информации о переводе своего проекта на использование NuGet см. раздел Включение создания встроенных соединителей.

Проект пакета расширений по умолчанию имеет папку и структуру файлов, аналогичную следующему примеру:

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

На корневом уровне проекта можно найти следующие папки и файлы вместе с другими элементами:

Справочник по настройкам приложения — local.settings.json

В Visual Studio Code на корневом уровне проекта приложения логики файл local.settings.json содержит глобальные параметры конфигурации, влияющие на все рабочие процессы в этом приложении логики во время выполнения в локальной среде разработки. Когда рабочие процессы выполняются локально, доступ к этим параметрам осуществляется как к локальным переменным среды. При этом их значения часто изменяются при использовании различных сред, в которых выполняются рабочие процессы. Сведения о просмотре этих параметров и управлении ими см. в статье "Управление параметрами приложения" — local.settings.json.

Параметры приложения в Azure Logic Apps работают аналогично параметрам приложения в службе "Функции Azure" или службе "Веб-приложения Azure". Если вы раньше использовали эти службы, возможно, что вы уже знакомы с параметрами приложений. Дополнительные сведения см. в справочнике по параметрам приложений для функций Azure и работе с основными инструментами Функций Azure — локальным файлом параметров.

В следующей таблице описаны параметры приложения, которые использует приложение логики. Некоторые параметры необходимы для правильной работы приложения логики:

Управление параметрами приложения — local.settings.json

Чтобы добавить, обновить или удалить параметры приложения, выберите и просмотрите следующие разделы портала Azure, Visual Studio Code или Azure CLI. Параметры приложения, относящиеся к приложениям логики, см. в статье "Справочник по параметрам приложения" — 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 

Справочник по параметрам узла — host.json

В Visual Studio Code на корневом уровне проекта приложения логики файл метаданных host.json содержит параметры среды выполнения и значения по умолчанию, которые применяются ко всем рабочим процессам в ресурсе приложения логики, работающем локально или в Azure. Сведения о том, как просматривать и управлять этими параметрами, см. в статье "Управление параметрами узла " host.json". Сведения о связанных ограничениях приведены также в документации об ограничениях и конфигурации для Azure Logic Apps.

Пропускная способность выполнения заданий

Эти параметры влияют на пропускную способность и производительность одноклиентской службы Azure Logic Apps при выполнении операций рабочего процесса.

Следующие параметры используются для ручной остановки и немедленного удаления указанных рабочих процессов в приложении логики "Стандартный".

Чтобы указать отдельные рабочие процессы, используйте следующий синтаксис, где за каждым идентификатором рабочего процесса следует двоеточие (:) и разделяется точкой с запятой (;):

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

Чтобы отменить определенный запуск, укажите идентификатор выполнения, следующий за идентификатором рабочего процесса с 2D в качестве разделителя, например:

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

Триггеры на основе повторения

Параллелизм триггера

Следующие параметры параллелизма применяются только к рабочим процессам, которые начинаются с триггера повторения для встроенных коннекторов, основанных на поставщиках услуг, и управляют числом рабочих процессов, которые выполняются одновременно.

Для рабочего процесса, начинающегося с триггера на основе функций, можно попытаться настроить пакетную обработку, где поддерживается. Однако пакетная обработка не всегда является правильным решением. Например, при использовании триггеров Azure Service Bus пакет может удерживать сообщения дольше длительности блокировки. В результате любые действия, такие как завершение или отмена, не удаются в таких сообщениях.

Длительность выполнения и хранение истории

Запуск действий

Измените значение таймаута для встроенных операций, основанных на функциях

Для встроенных операций, которые выполняются в качестве вызовов функций в Функциях Azure, добавьте параметры узла Runtime.FlowRunRetryableActionJobCallback.ActionJobExecutionTimeout и functionTimeout в файл host.json, как показано в следующем примере:

{
   "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"
}

Входные и выходные данные

Pagination

Chunking

Сохраняйте содержимое в виде встроенных элементов или используйте BLOBs (бинарные большие объекты)

Циклы For each

До циклов

Variables

Встроенные операции HTTP

Встроенные операции веб-перехватчика HTTP

Встроенные операции в хранилище Azure

Хранилище данных типа BLOB

Хранилище данных таблиц и очередей

Общий доступ к файлам

Встроенные операции Функций Azure

Встроенные операции Служебной шины Azure

Встроенные операции SFTP

Управляемые операции соединителя

Политика повторных попыток для всех остальных операций

Limitations

Максимальный размер содержимого:

По умолчанию встроенные триггеры, такие как HTTP или запрос, ограничены размером сообщения, описанным в разделе "Ограничения и справочник по конфигурации" — "Сообщения". Чтобы обрабатывать файлы, превышающие предел, попробуйте отправить содержимое в виде большого двоичного объекта в Хранилище BLOB-объектов Azure, а затем получить содержимое с помощью соединителя BLOB-объектов Azure.

Управление параметрами узла — host.json

Можно добавлять, обновлять и удалять параметры узла, определяющие параметры конфигурации среды выполнения и значения, применяемые ко всем рабочим процессам в этом приложении логики. Например, это могут быть значения по умолчанию для пропускной способности, емкости, размера данных и т. д., которые не зависят от того, выполняются ли приложения локально или в Azure. Сведения о параметрах узла, относящихся к приложениям логики, см. в статье "Справочник по параметрам узла" — host.json.

Связанный контент

• Создание параметров между средами для входных данных рабочего процесса в Azure Logic Apps
• Настройка развертывания DevOps для приложений Azure Logic Apps уровня "Стандартный" в одноарендной среде