Поделиться через


Экспорт рабочих процессов ISE в стандартное приложение логики

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

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

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

Примечание.

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

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

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

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

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

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

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

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

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

  • Если идентификатор подключения неправильно отформатирован, возникает ошибка. Перед экспортом рабочего процесса убедитесь, что идентификаторы подключений для соединителей соответствуют следующему формату:

    subscriptionId/{subscription-ID}/resourceGroups/{resource-group-name}/providers/Microsoft.Logic/integrationServiceEnvironments/{integration-service-environment-name}/managedApis/{managed-api-name}

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

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

Управляемое:ApiConnection ApiConnectionNotification,ApiConnectionWebhook
Действие Встроенные: , SwitchInitializeVariableIncrementVariableJavaScriptCodeIfHttpWebhookJoinSelectScopeSetVariableResponseTableTerminateAppendToStringVariableDecrementVariableUntilComposeForeachHttpParseJsonAppendToArrayVariableWait

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

Необходимые компоненты

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

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

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

  • Ознакомьтесь с требованиями к настройке Visual Studio Code с расширением Azure Logic Apps (standard).

Примечание.

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

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

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

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

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

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

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

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

  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 и экземпляр ISE, а затем нажмите кнопку "Далее".

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

  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. Прежде чем вносить изменения в рабочий процесс приложения логики источника, обязательно протестируйте новый ресурс и рабочие процессы приложения логики "Стандартный".

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

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

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

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

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

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

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

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

Папка Файл Description
.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 с сводкой результатов экспорта, включая созданные приложения логики и все необходимые действия.

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