Criar modelos do Azure Resource Manager para automatizar a implementação de aplicações lógicas de consumo para o Azure Logic Apps

Artigo
01/04/2024

Aplica-se a: Azure Logic Apps (Consumo)

Para o ajudar a criar e implementar automaticamente uma aplicação lógica de Consumo, este artigo descreve as formas como pode criar um modelo do Azure Resource Manager. O Azure Logic Apps também fornece uma aplicação lógica pré-criada do Azure Resource Manager modelo que pode reutilizar, não só para criar aplicações lógicas de Consumo, mas também para definir os recursos e parâmetros para implementação. Pode utilizar este modelo para os seus próprios cenários empresariais ou personalizar o modelo para satisfazer os seus requisitos. Para obter uma descrição geral sobre a estrutura e a sintaxe de um modelo que contém uma definição de fluxo de trabalho e outros recursos necessários para a implementação, veja Descrição geral: Automatizar a implementação de aplicações lógicas com modelos de Resource Manager do Azure.

Importante

Este artigo aplica-se apenas a aplicações lógicas de Consumo e não a aplicações lógicas Standard. Certifique-se de que as ligações no modelo utilizam o mesmo grupo de recursos e localização do Azure que a sua aplicação lógica.

Para obter mais informações sobre os modelos do Azure Resource Manager, veja os seguintes tópicos:

Criar modelos com o Visual Studio

Para obter a forma mais fácil de criar modelos de aplicações lógicas parametrizadas válidos, que estão maioritariamente prontos para implementação, utilize o Visual Studio (edição gratuita da Comunidade ou superior) e as Ferramentas do Azure Logic Apps para Visual Studio. Em seguida, pode criar a sua aplicação lógica no Visual Studio ou localizar e transferir uma aplicação lógica existente do portal do Azure para o Visual Studio.

Ao transferir a sua aplicação lógica, obtém um modelo que inclui as definições da sua aplicação lógica e outros recursos, como ligações. O modelo também parametriza ou define parâmetros para os valores utilizados para implementar a sua aplicação lógica e outros recursos. Pode fornecer os valores para estes parâmetros num ficheiro de parâmetros separado. Desta forma, pode alterar mais facilmente estes valores com base nas suas necessidades de implementação. Para obter mais informações, veja estes tópicos:

Criar modelos com Azure PowerShell

Pode criar modelos de Resource Manager com Azure PowerShell com o módulo LogicAppTemplate. Este módulo open source avalia primeiro a sua aplicação lógica e quaisquer ligações que a aplicação lógica utilize. Em seguida, o módulo gera recursos de modelo com os parâmetros necessários para a implementação.

Por exemplo, suponha que tem uma aplicação lógica que recebe uma mensagem de uma fila de Azure Service Bus e carrega dados para SQL do Azure Base de Dados. O módulo preserva toda a lógica de orquestração e parametriza as cadeias de ligação do SQL e do Service Bus para que possa fornecer e alterar esses valores com base nas suas necessidades de implementação.

Estes exemplos mostram como criar e implementar aplicações lógicas com modelos do Azure Resource Manager, pipelines do Azure no Azure DevOps e Azure PowerShell:

Instalar módulos do PowerShell

Se ainda não o fez, instale Azure PowerShell.
Para obter a forma mais fácil de instalar o módulo LogicAppTemplate a partir do Galeria do PowerShell, execute este comando:
```
Install-Module -Name LogicAppTemplate
```
Para atualizar para a versão mais recente, execute este comando:
```
Update-Module -Name LogicAppTemplate
```

Em alternativa, para instalar manualmente, siga os passos no GitHub para Criador de Modelos de Aplicação Lógica.

Instalar o cliente do Azure Resource Manager

Para que o módulo LogicAppTemplate funcione com qualquer token de acesso de subscrição e inquilino do Azure, instale a ferramenta de cliente do Azure Resource Manager, que é uma ferramenta de linha de comandos simples que chama a API de Resource Manager do Azure.

Quando executa o Get-LogicAppTemplate comando com esta ferramenta, o comando obtém primeiro um token de acesso através da ferramenta ARMClient, encaminha o token para o script do PowerShell e cria o modelo como um ficheiro JSON. Para obter mais informações sobre a ferramenta, veja este artigo sobre a ferramenta cliente do Azure Resource Manager.

Gerar modelo com o PowerShell

Para gerar o modelo depois de instalar o módulo LogicAppTemplate e a CLI do Azure, execute este comando do PowerShell:

$parameters = @{
    Token = (az account get-access-token | ConvertFrom-Json).accessToken
    LogicApp = '<logic-app-name>'
    ResourceGroup = '<Azure-resource-group-name>'
    SubscriptionId = $SubscriptionId
    Verbose = $true
}

Get-LogicAppTemplate @parameters | Out-File C:\template.json

Para seguir a recomendação de encaminhamento num token da ferramenta de cliente do Azure Resource Manager, execute este comando em vez disso, onde $SubscriptionId está o ID da subscrição do Azure:

$parameters = @{
    LogicApp = '<logic-app-name>'
    ResourceGroup = '<Azure-resource-group-name>'
    SubscriptionId = $SubscriptionId
    Verbose = $true
}

armclient token $SubscriptionId | Get-LogicAppTemplate @parameters | Out-File C:\template.json

Após a extração, pode criar um ficheiro de parâmetros a partir do modelo ao executar este comando:

Get-ParameterTemplate -TemplateFile $filename | Out-File '<parameters-file-name>.json'

Para extração com referências de Key Vault do Azure (apenas estáticas), execute este comando:

Get-ParameterTemplate -TemplateFile $filename -KeyVault Static | Out-File $fileNameParameter

Parâmetros	Necessário	Descrição
TemplateFile	Sim	O caminho do ficheiro para o ficheiro de modelo
KeyVault	Não	Uma enumeração que descreve como lidar com possíveis valores do cofre de chaves. A predefinição é `None`.

Passos seguintes

Implementar modelos de aplicação lógica