Экспорт рабочих процессов потребления в приложение логики уровня "Стандартный"

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

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

Теперь вы можете экспортировать приложения логики потребления в стандартное приложение логики. Используя Visual Studio Code и последнее расширение Azure Logic Apps (стандартный), вы экспортируете приложения логики в виде рабочих процессов с отслеживанием состояния в проект приложения логики уровня "Стандартный". Затем можно локально обновлять, тестировать и отлаживать рабочие процессы, чтобы подготовить их к повторному развертыванию. Когда вы будете готовы, вы можете выполнить развертывание непосредственно из Visual Studio Code или с помощью собственного процесса DevOps.

Примечание

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

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

В этой статье содержатся сведения о процессе экспорта и показано, как экспортировать рабочие процессы приложения логики из isE в локальный проект приложения логики уровня "Стандартный" в Visual Studio Code.

Известные проблемы и ограничения

  • Средство экспорта не экспортирует сведения об инфраструктуре, например параметры учетной записи интеграции.

  • Средство экспорта может экспортировать рабочие процессы приложения логики с триггерами, имеющими параметры параллелизма. Однако azure Logic Apps с одним клиентом игнорирует эти параметры.

  • Приложения логики должны существовать в одном регионе, если вы хотите экспортировать их в рамках одного проекта приложения логики уровня "Стандартный".

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

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

Экспортируемые типы операций

Операция Тип JSON
Триггер Встроенные: Http, HttpWebhook, Recurrence, manual (запрос)

Управляемый: ApiConnectionApiConnectionNotification, ApiConnectionWebhook
Действие Встроенные: AppendToArrayVariable, , AppendToStringVariable, Compose, DecrementVariable, ForeachHttp, HttpWebhook, JoinIncrementVariableInitializeVariableIfParseJsonJavaScriptCodeResponse, Scope, Select, SetVariable, , SwitchTableTerminateUntilWait

- Управляемый: ApiConnection, ApiConnectionWebhook

Предварительные требования

  • Одно или несколько приложений логики для развертывания в той же подписке и регионе Azure, например Восточная часть США 2.

  • Доступ на уровне подписки читателя Azure к подписке, в которой в настоящее время развернуты приложения логики.

  • Azure участник доступ на уровне группы ресурсов, если выбран параметр Развернуть управляемые соединители.

  • Ознакомьтесь с требованиями к настройке Visual Studio Code с помощью расширения Azure Logic Apps (стандартный) и соответствующих требованиям.

Примечание

Обязательно установите версию 2.0.16 или более позднюю для расширения Azure Logic Apps (стандартная) для Visual Studio Code. Для некоторых сценариев преобразования требуется последняя версия конструктора рабочих процессов, который доступен начиная с этой версии.

Группирование приложений логики для экспорта

С помощью расширения Azure Logic Apps (стандартный) можно объединить несколько рабочих процессов приложения логики потребления в один проект приложения логики уровня "Стандартный". В Azure Logic Apps с одним клиентом один ресурс приложения логики уровня "Стандартный" может содержать несколько рабочих процессов. При таком подходе можно предварительно проверить рабочие процессы, чтобы не пропустить зависимости при выборе приложений логики для экспорта.

При выборе приложений логики для экспорта учитывайте следующие рекомендации:

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

  • Сведения об организации и количестве рабочих процессов для каждого приложения логики см. в статье Рекомендации и рекомендации.

Экспорт рабочих процессов потребления в локальный проект

Выбор приложений логики для экспорта

  1. В Visual Studio Code войдите в Azure, если вы еще этого не сделали.

  2. На панели действий Visual Studio Code выберите Azure, чтобы открыть окно Azure (SHIFT+ALT+A).

    Снимок экрана: панель действий Visual Studio Code с выбранным значком Azure.

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

    Снимок экрана: окно Azure, панель инструментов раздела

  4. После открытия вкладки Экспорт выберите подписку Azure и регион, а затем нажмите кнопку Далее.

    Снимок экрана: вкладка

  5. Выберите приложения логики для экспорта. Каждое выбранное приложение логики отображается в списке Выбранные приложения логики сбоку. Затем щелкните Далее.

    Совет

    Вы также можете выполнять поиск приложений логики и выполнять фильтрацию по группе ресурсов.

    Снимок экрана: раздел

    Средство экспорта начинает проверять, разрешены ли выбранные приложения логики для экспорта.

Проверка результатов проверки экспорта

  1. После завершения проверки экспорта просмотрите результаты, развернув запись для каждого приложения логики.

    • Приложения логики с ошибками не могут быть экспортируемыми. Эти приложения логики необходимо удалить из списка экспорта, пока вы не исправите их в источнике. Чтобы удалить приложение логики из списка, выберите Назад.

      Например, SourceLogicApp2 имеет ошибку и не может быть экспортирован до исправления:

      Снимок экрана: раздел

    • Приложения логики, которые проходят проверку с предупреждениями или без них, по-прежнему могут экспортироваться. Чтобы продолжить, выберите Экспорт , если все приложения успешно проверяются, или Экспорт с предупреждениями , если у приложений есть предупреждения.

      Например, в SourceLogicApp3 есть предупреждение, но вы по-прежнему можете продолжить экспорт:

      Снимок экрана: раздел

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

    Значок проверки Состояние проверки
    Значок успешного выполнения Элемент прошел проверку, поэтому экспорт можно продолжить без проблем для устранения проблем.
    Значок сбоя Проверка элемента завершилась сбоем, поэтому невозможно продолжить экспорт.

    Запись проверки для элемента, завершившемся с ошибкой, автоматически отображается в развернутом виде и предоставляет сведения о сбое проверки.
    Значок предупреждения Элемент прошел проверку с предупреждением, но экспорт может продолжаться с необходимым разрешением после экспорта.

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

    Снимок экрана: раздел

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

    Снимок экрана: раздел

  4. В разделе После шагов экспорта просмотрите все необходимые действия после экспорта, например:

    Снимок экрана: раздел

  5. В зависимости от сценария выберите Экспорт и завершить или Экспорт с предупреждениями и завершить.

    Средство экспорта скачивает проект в выбранное расположение папки, развертывает проект в Visual Studio Code и развертывает все управляемые подключения, если вы выбрали этот вариант.

    Снимок экрана: раздел

  6. После завершения этого процесса Visual Studio Code открывает новую рабочую область. Теперь можно безопасно закрыть окно экспорта.

  7. В проекте приложения логики уровня "Стандартный" откройте и просмотрите файл README.md, чтобы просмотреть необходимые действия после экспорта.

    Снимок экрана: новый проект приложения логики уровня

Действия после экспорта

Действия по исправлению

Некоторые экспортированные рабочие процессы приложений логики требуют выполнения действий по исправлению после экспорта на платформе "Стандартный".

  1. В проекте приложения логики уровня "Стандартный" откройте файл README.md и просмотрите действия по исправлению экспортированных рабочих процессов. Средство экспорта создает файл README.md, содержащий все необходимые шаги после экспорта.

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

Действия и параметры учетной записи интеграции

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

Действия и параметры пакетной службы

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

Структура папок проекта

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

В следующей таблице описаны новые папки и файлы, добавленные в процессе экспорта.

Папка Файл Описание
.development\deployment LogicAppStandardConnections.parameters.json Файл параметров шаблона Azure Resource Manager для развертывания управляемых соединителей
LogicAppStandardConnections.template.json Определение шаблона Azure Resource Manager для развертывания управляемых соединителей
LogicAppStandardInfrastructure.parameters.json Файл параметров шаблона Azure Resource Manager для развертывания ресурса приложения логики уровня "Стандартный"
LogicAppStandardInfrastructure.template.json Определение шаблона Azure Resource Manager для развертывания ресурса приложения логики уровня "Стандартный"
.logs\export exportReport.json Экспортируйте необработанный файл сводки отчета, который включает все шаги, необходимые для исправления после экспорта
exportValidation.json Необработанный файл отчета о проверке, включающий результаты проверки для каждого экспортированного приложения логики
README.md Файл Markdown со сводкой результатов экспорта, включая созданные приложения логики и все необходимые действия

Дальнейшие действия