Изменение параметров узла и приложения для приложений логики уровня "Стандартный" в одноклиентской службе 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. Можно напрямую ссылаться на защищенные строки, например строки подключения и ключи. Аналогично шаблонам Azure Resource Manager (шаблонам 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 Functions Core Tools — локальный файл параметров.

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

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

Чтобы добавить, обновить или удалить параметры приложения, выберите и просмотрите следующие разделы для шаблона портал Azure, Visual Studio Code, Azure CLI или ARM (Bicep). Для параметров, специфичных для логических приложений, ознакомьтесь со справочником по доступным настройкам приложений — 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.CleanupJobPartitionPrefixes": "<workflow-ID-1>:; <workflow-ID-2>:",
"Jobs.SuspendedJobPartitionPrefixes": "<workflow-ID-1>:; <workflow-ID-2>:"

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

Конкурентность триггеров

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

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

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

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

Разбиение на страницы

Разделение на блоки

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

Циклы For each

Циклы до тех пор пока

Переменные

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

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

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

Хранилище BLOB-объектов

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

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

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

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

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

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

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

Ограничения

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

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

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

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

Портал Azure — host.json

Чтобы просмотреть параметры узла для одноклиентского приложения логики на портале Microsoft Azure, выполните описанные ниже шаги.

1. Найдите приложение логики с помощью поля поиска на портале Microsoft Azure и откройте его.

2. В меню ресурсов в разделе "Средства разработки" выберите "Дополнительные средства".

3. В области Расширенные инструменты выберите Перейти, чтобы открыть среду Kudu для приложения логики.

4. На панели инструментов Kudu откройте меню Debug console (Консоль отладки) и выберите CMD.

   Откроется окно консоли, где можно будет перейти к папке wwwroot с помощью командной строки. Можно также просмотреть структуру каталогов, отображаемую в окне консоли.

5. Воспользуйтесь следующим путем для перехода к папке wwwroot: ...\home\site\wwwroot.

6. Над окном консоли, в таблице каталогов рядом с файлом host.json выберите Изменить.

7. После открытия файла host.json проверьте все параметры узла, добавленные ранее для приложения логики.

   Дополнительные сведения о параметрах узла см. в справочном руководстве по доступным параметрам узла — host.json.

Чтобы добавить настройку, выполните действия, описанные ниже.

1. Перед добавлением или изменением параметров остановите приложение логики на портале Microsoft Azure.

   1. В меню ресурсов выберите Обзор.

   2. На панели инструментов области Обзор выберите Остановить.

2. Если файл host.json уже открыт, вернитесь к файлу host.json. В противном случае выполните описанные выше действия, чтобы открыть файл host.json .

3. В объекте extensionBundle добавьте объект extensions, который включает в себя объекты workflow и settings. Например, вот так.

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

4. В объекте settings добавьте плоский список с параметрами узла, которые планируется использовать для всех рабочих процессов в приложении логики, будь то выполняемые локально рабочие процессы или рабочие процессы в Azure. Например, вот так.

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

5. Когда завершите добавление, не забудьте нажать кнопку Сохранить.

6. Теперь перезапустите приложение логики. Вернитесь на страницу Обзор приложения логики и выберите Перезапустить.

Visual Studio Code — host.json

Чтобы просмотреть параметры узла для приложения логики с помощью Visual Studio Code, выполните описанные ниже шаги.

1. В проекте приложения логики найдите и откройте файл host.json на корневом уровне проекта.

2. В объекте extensions, в разделах workflows и settings проверьте все параметры узла, добавленные ранее для приложения логики. В противном случае объект extensions не появится в файле.

   Дополнительные сведения о параметрах узла см. в справочном руководстве по доступным параметрам узла — host.json.

Чтобы добавить настройку хоста, следуйте этим шагам.

1. В файле host.json, в разделе объекта extensionBundle добавьте объектextensions, который включает в себя объекты workflow и settings. Например, вот так.

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

2. В объекте settings добавьте плоский список с параметрами узла, которые планируется использовать для всех рабочих процессов в приложении логики, будь то выполняемые локально рабочие процессы или рабочие процессы в Azure. Например, вот так.

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

Следующие шаги

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