Краткое руководство. Создание и развертывание рабочего процесса приложения логики категории "Потребление" в Azure Logic Apps с несколькими клиентами с помощью шаблона ARM

Статья
03/05/2024

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

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

Шаблон Azure Resource Manager — это файл нотации объектов JavaScript (JSON), который определяет инфраструктуру и конфигурацию проекта. В шаблоне используется декларативный синтаксис. Вы описываете предполагаемое развертывание без написания последовательности команд программирования для создания развертывания.

Если окружение соответствует предварительным требованиям и вы знакомы с использованием шаблонов ARM, нажмите кнопку Развертывание в Azure. Шаблон откроется на портале Azure.

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

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

Изучение шаблона

В этом кратком руководстве используется шаблон Создание приложения логики, который можно найти в коллекции шаблонов быстрого запуска Azure. Здесь он не приводится, так как он слишком длинный. Но вы можете просмотреть файл azuredeploy.json в коллекции шаблонов.

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

Этот шаблон создает следующий ресурс Azure:

Microsoft.Logic/workflows, который создает рабочий процесс для ресурса приложения логики категории "Потребление".

Чтобы найти дополнительные шаблоны быстрого запуска для Azure Logic Apps, изучите шаблоны Microsoft.Logic в коллекции.

Развертывание шаблона

Следуйте указаниям по развертыванию шаблона быстрого запуска:

Вариант	Описание
Портал Azure	Если среда Azure соответствует предварительным требованиям и вы раньше использовали шаблоны ARM, эти действия помогут вам войти в Azure и открыть шаблон быстрого запуска на портале Azure. Дополнительные сведения см. в статье Развертывание ресурсов с помощью шаблонов ARM на портале Azure.
Azure CLI	Интерфейс командной строки Azure предоставляет возможности командной строки для создания ресурсов Azure и управления ими. Для выполнения этих команд вам понадобится Azure CLI 2.6 или более поздней версии. Чтобы узнать используемую вами версию CLI, введите az --version. Дополнительные сведения см. в следующей документации: - Что такое Azure CLI - Приступая к работе с Azure CLI
Azure PowerShell	В Azure PowerShell доступен набор командлетов, которые используют модель Azure Resource Manager для управления ресурсами Azure. Дополнительные сведения см. в следующей документации: - Обзор Azure PowerShell - Знакомство с модулем Az для Azure PowerShell - Начало работы с Azure PowerShell
REST API управления ресурсами Azure	В Azure доступны REST API (API передачи репрезентативного состояния). Это конечные точки службы, которые поддерживают набор операций HTTP (методов) и предоставляют доступ на создание, получение, обновление или удаление ресурсов сервера. Подробные сведения см. в статье Справочник по REST API Azure.

Выберите следующее изображение, чтобы войти с помощью учетной записи Azure, и откройте шаблон быстрого запуска на портале Azure:

На портале на странице Создание приложения логики с помощью шаблона введите или выберите следующие значения:

Свойство	Значение	Описание
Подписка	<имя-подписки-Azure>	Имя подписки Azure, которую нужно использовать.
Группа ресурсов	<имя-группы-ресурсов-Azure>	Имя новой или существующей группы ресурсов Azure. В этом примере используется Check-Azure-Status-RG.
Регион	<Azure-region>	Регион центра обработки данных Azure для использования приложения логики. В этом примере используется регион западная часть США.
Имя приложения логики	<logic-app-name>	Имя, используемое для приложения логики. В этом примере используется Check-Azure-Status-LA.
URI теста	<test-URI>	Универсальный код ресурса (URI) для вызываемой службы на основе определенного расписания. В этом примере используется https://azure.status.microsoft/en-us/status/ (страница состояния Azure).
Местонахождение	<Azure-region-for-all-resources>	Регион Azure, используемый для всех ресурсов, если он отличается от значения по умолчанию. В этом примере используется значение по умолчанию [resourceGroup().location], которое является расположением группы ресурсов.

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

Screenshot showing Azure portal with

Когда все будет готово, выберите Просмотр и создание.
Выполните действия, описанные в разделе Обзор развернутых ресурсов.

read -p "Enter a project name to use for generating resource names:" projectName &&
read -p "Enter the location, such as 'westus':" location &&
templateUri="https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.logic/logic-app-create/azuredeploy.json" &&
resourceGroupName="${projectName}rg" &&
az group create --name $resourceGroupName --location "$location" &&
az deployment group create --resource-group $resourceGroupName --template-uri  $templateUri &&
echo "Press [ENTER] to continue ..." &&
read

Дополнительные сведения см. в следующей документации:

$projectName = Read-Host -Prompt "Enter a project name to use for generating resource names"
$location = Read-Host -Prompt "Enter the location, such as 'westus'"
$templateUri = "https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.logic/logic-app-create/azuredeploy.json"

$resourceGroupName = "${projectName}rg"

New-AzResourceGroup -Name $resourceGroupName -Location "$location"
New-AzResourceGroupDeployment -ResourceGroupName $resourceGroupName -TemplateUri $templateUri

Read-Host -Prompt "Press [ENTER] to continue ..."

Дополнительные сведения см. в следующей документации:

Если вы не хотите использовать существующую группу ресурсов Azure, создайте новую, следуя приведенному ниже синтаксису для запроса, который отправляется в REST API управления ресурсами:

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}?api-version=2019-10-01

значение	Описание
<subscriptionId>	GUID для подписки Azure, которую вы хотите использовать
<resourceGroupName>	Имя создаваемой группы ресурсов Azure. В этом примере используется Check-Azure-Status-RG.

Например:

PUT https://management.azure.com/subscriptions/xxxxXXXXxxxxXXXXX/resourcegroups/Check-Azure-Status-RG?api-version=2019-10-01

Дополнительные сведения см. в следующей документации:

Чтобы развернуть шаблон быстрого запуска в группе ресурсов, выполните следующий синтаксис для запроса, отправляемого в REST API управления ресурсами:

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Resources/deployments/{deploymentName}?api-version=2019-10-01

значение	Описание
<subscriptionId>	GUID для подписки Azure, которую вы хотите использовать
<resourceGroupName>	Имя используемой группы ресурсов Azure. В этом примере используется Check-Azure-Status-RG.
<deploymentName>	Имя, используемое для развертывания. В этом примере используется Check-Azure-Status-LA.

Например:

PUT https://management.azure.com/subscriptions/xxxxXXXXxxxxXXXXX/resourcegroups/Check-Azure-Status-RG/providers/Microsoft.Resources/deployments/Check-Azure-Status-LA?api-version=2019-10-01

Дополнительные сведения см. в разделе REST API управления ресурсами: развертывания — создание или обновление.

Вы можете предоставить значения, которые будут использоваться для развертывания, такие как регион Azure, а также ссылки на шаблон быстрого запуска и файл параметров, который содержит значения для шаблона быстрого запуска, используемого при развертывании. Для этого используйте следующий синтаксис для текста запроса, отправляемого в REST API управления ресурсами:

{
   "location": "{Azure-region}",
   "properties": {
      "templateLink": {
         "uri": "{quickstart-template-URL}",
         "contentVersion": "1.0.0.0"
      },
      "parametersLink": {
         "uri": "{quickstart-template-parameter-file-URL}",
         "contentVersion": "1.0.0.0"
      },
      "mode": "Incremental"
   }
}

Свойство	Значение	Описание
расположение	<Azure-region>	Регион Azure, который будет использоваться для развертывания. В этом примере используется регион западная часть США.
templateLink : uri	<quickstart-template-URL>	РАСПОЛОЖЕНИЕ URL-адреса для шаблона быстрого запуска, используемого для развертывания: https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.logic/logic-app-create/azuredeploy.json
parametersLink : uri	<quickstart-template-parameter-file-URL>	URL-адрес файла параметров шаблона быстрого запуска, который будет использоваться для развертывания: https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.logic/logic-app-create/azuredeploy.parameters.json Дополнительные сведения о файле параметров Resource Manager см. в следующей документации: - Создание файла параметров Resource Manager - Руководство. Использование файлов параметров для развертывания шаблона ARM
mode	<deployment-mode>	Выполните добавочное обновление или полное обновление. В этом примере используется incremental (значение по умолчанию). Подробные сведения см. в статье Режимы развертывания Azure Resource Manager.

Например:

{
   "location": "West US",
   "properties": {
      "templateLink": {
         "uri": "https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.logic/logic-app-create/azuredeploy.json",
         "contentVersion": "1.0.0.0"
      },
      "parametersLink": {
         "uri": "https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.logic/logic-app-create/azuredeploy.parameters.json",
         "contentVersion": "1.0.0.0"
      },
      "mode": "Incremental"
   }
}

Дополнительные сведения см. в следующих статьях:

Просмотр развернутых ресурсов

Чтобы просмотреть рабочий процесс приложения логики, вы можете использовать портал Azure, выполнить скрипт, созданный с помощью Azure CLI или Azure PowerShell, либо использовать REST API приложения логики.

В поле поиска на портале Azure введите имя приложения логики (в нашем примере — Check-Azure-Status-LA). В списке результатов выберите ваше приложение логики.
На портале Azure найдите и выберите приложение логики (в нашем примере — Check-Azure-Status-RG).
После открытия конструктора рабочего процесса изучите рабочий процесс приложения логики, созданный с помощью шаблона быстрого запуска.
Чтобы проверить приложение логики, на панели инструментов конструктора щелкните Запустить.

echo "Enter your logic app name:" &&
read logicAppName &&
az logic workflow show --resource-group $resourceGroupName --name $logicAppName &&
echo "Press [ENTER] to continue ..."

Подробные сведения см. в разделе Azure CLI: az logic workflow show.

$logicAppName = Read-Host -Prompt "Enter your logic app name"
Get-AzLogicApp -ResourceGroupName $resourceGroupName -Name $logicAppName 
Write-Host "Press [ENTER] to continue..."

Дополнительные сведения см. в статье Azure PowerShell: Get-AzLogicApp.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Logic/workflows/{workflowName}?api-version=2016-06-01

значение	Описание
subscriptionId	GUID подписки Azure, в которой развернут шаблон быстрого запуска.
resourceGroupName	Имя группы ресурсов Azure, в которой развернут шаблон быстрого запуска. В этом примере используется Check-Azure-Status-RG.
workflowName	Имя развернутого приложения логики. В этом примере используется Check-Azure-Status-LA.

Например:

GET https://management.azure.com/subscriptions/xxxxXXXXxxxxXXXXX/resourceGroups/Check-Azure-Status-RG/providers/Microsoft.Logic/workflows/Check-Azure-Status-LA?api-version=2016-06-01

Дополнительные сведения см. в разделе REST API Logic Apps: Рабочие процессы — Получение.

Очистка ресурсов

Если вы планируете продолжать работу с последующими краткими руководствами и статьями, эти ресурсы можно не удалять. Если приложение логики больше не требуется, удалите группу ресурсов с помощью портала Azure, Azure CLI, Azure PowerShell или REST API управления ресурсами.

На портале Azure найдите и выберите группу ресурсов, которую необходимо удалить (в нашем примере — Check-Azure-Status-RG).
При необходимости в меню группы ресурсов выберите Обзор. На странице обзора выберите Удалить группу ресурсов.
Для подтверждения введите имя группы ресурсов.

Подробные сведения см. в разделе Удаление группы ресурсов.

echo "Enter your resource group name:" &&
read resourceGroupName &&
az group delete --name $resourceGroupName &&
echo "Press [ENTER] to continue ..."

Подробные сведения см. в разделе Azure CLI: az group delete.

$resourceGroupName = Read-Host -Prompt "Enter the resource group name"
Remove-AzResourceGroup -Name $resourceGroupName
Write-Host "Press [ENTER] to continue..."

Дополнительные сведения см. в статье Azure PowerShell: Remove-AzResourceGroup.

DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}?api-version=2019-10-01

значение	Описание
subscriptionId	GUID подписки Azure, в которой развернут шаблон быстрого запуска.
resourceGroupName	Имя группы ресурсов Azure, в которой развернут шаблон быстрого запуска. В этом примере используется Check-Azure-Status-RG.

Например:

GET https://management.azure.com/subscriptions/xxxxXXXXxxxxXXXXX/resourceGroups/Check-Azure-Status-RG?api-version=2019-10-01

Дополнительные сведения см. в разделе REST API управления ресурсами: группы ресурсов — удаление.

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

Создание и развертывание первого шаблона ARM

Краткое руководство. Создание и развертывание рабочего процесса приложения логики категории "Потребление" в Azure Logic Apps с несколькими клиентами с помощью шаблона ARM

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

Изучение шаблона

Развертывание шаблона

Просмотр развернутых ресурсов

Очистка ресурсов

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

Дополнительные ресурсы