Краткое руководство. Создание рабочих процессов и управление ими с помощью Azure PowerShell в Azure Logic Apps

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

В этом кратком руководстве описывается, как создавать автоматизированные рабочие процессы, выполняемые в Azure Logic Apps, и управлять ими с помощью Azure PowerShell. В PowerShell можно создать приложение логики уровня "Потребление" в мультитенантной службе Azure Logic Apps, определив его рабочий процесс приложения логики с помощью JSON-файла. Затем вы можете управлять приложением логики, запуская командлеты в модуле PowerShell Az.LogicApp.

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

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

• Учетная запись Azure с активной подпиской. Если у вас еще нет подписки Azure, создайте бесплатную учетную запись.

• Модуль AZ PowerShell, установлен на локальном компьютере.

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

Проверка необходимых компонентов

Прежде чем начать, проверьте свою среду:

• Войдите на портал Azure и убедитесь, что ваша подписка активна, выполнив команду Connect-AzAccount.

• Проверьте версию Azure PowerShell, выполнив Get-InstalledModule -Name Az. Сведения о последней версии см. в заметках о выпуске.

  Если у вас нет последней версии, выполните обновление установки, как указано в статье Обновление модуля Azure PowerShell.

Пример. Создание группы ресурсов

Если у вас еще нет группы ресурсов для приложения логики, создайте ее с помощью командлета New-AzResourceGroup. Например, следующая команда создает группу ресурсов testResourceGroup в расположении westus.

New-AzResourceGroup -Name testResourceGroup -Location westus

При успешном создании группы ресурсов в выходных данных ProvisioningState будет отображаться значение Succeeded:

ResourceGroupName : testResourceGroup
Location          : westus
ProvisioningState : Succeeded
Tags              :
ResourceId        : /subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/testResourceGroup

Определение рабочего процесса

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

При выполнении команд для создания или обновления приложения логики ваше определение рабочего процесса отправляется в качестве обязательного параметра (Definition) или (DefinitionFilePath) в зависимости от набора параметров. Необходимо создать определение рабочего процесса в виде JSON-файла, который следует за схемой языка определения рабочего процесса.

Создание приложений логики из PowerShell

Чтобы создать рабочий процесс приложения логики из Azure PowerShell, используйте командлет New-AzLogicApp с JSON-файлом для определения.

Пример. Создание приложения логики

В этом примере создается рабочий процесс с именем testLogicApp в группе ресурсов testResourceGroup с расположением westus. JSON-файл testDefinition.json содержит определение рабочего процесса.

New-AzLogicApp -ResourceGroupName testResourceGroup -Location westus -Name testLogicApp -DefinitionFilePath .\testDefinition.json

После успешного создания рабочего процесса PowerShell покажет определение нового рабочего процесса.

Обновление приложений логики из PowerShell

Чтобы обновить рабочий процесс приложения логики из Azure PowerShell, используйте командлет Set-AzLogicApp.

Пример. Обновление приложения логики

В этом примере показано, как обновить образец рабочего процесса, созданный в предыдущем раздел, с помощью другого JSON-файла определения, newTestDefinition.json.

Set-AzLogicApp -ResourceGroupName testResourceGroup -Name testLogicApp -DefinitionFilePath .\newTestDefinition.json

После успешного обновления рабочего процесса PowerShell покажет определение обновленного рабочего процесса приложения логики.

Удаление приложений логики из PowerShell

Чтобы удалить рабочий процесс приложения логики из Azure PowerShell, используйте командлет Remove-AzLogicApp.

Пример. Удаление приложения логики

В этом примере удаляется пример рабочего процесса, созданный в предыдущем разделе.

Remove-AzLogicApp -ResourceGroupName testResourceGroup -Name testLogicApp

После ответа на запрос подтверждения с y приложение логики будет удалено.

Рекомендации. Удаление приложения логики

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

• Azure Logic Apps пытается отменить все выполняющиеся и ожидающие выполнения операции.

  Даже при большом объеме или невыполненной работе большинство выполнений будут отменены до их завершения или запуска. Но процесс отмены может занять некоторое время. При этом некоторые выполнения могут быть возобновлены, пока среда выполнения обрабатывает отмену.

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

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

Отображение приложений логики в PowerShell

Чтобы получить конкретный рабочий процесс приложения логики, воспользуйтесь командой Get-AzLogicApp.

Пример. Получение приложения логики

В этом примере возвращается приложение логики testLogicApp из группы ресурсов testResourceGroup.

Get-AzLogicApp -ResourceGroupName testResourceGroup -Name testLogicApp

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

Дополнительные сведения об Azure PowerShell см. в документации по Azure PowerShell.

Дополнительные примеры сценариев для Logic Apps можно найти в браузере примеров кода Майкрософт.