Crie modelos do Azure Resource Manager para automatizar a implantação de aplicativos lógicos de consumo para os Aplicativos Lógicos do Azure

Artigo
01/04/2024

Aplica-se a: Aplicativos Lógicos do Azure (Consumo)

Para ajudá-lo a criar e implantar automaticamente um aplicativo lógico de consumo, este artigo descreve as possíveis maneiras de criar um modelo de Azure Resource Manager. Os Aplicativos Lógicos do Azure também fornecem um modelo de aplicativo lógico predefinido do Azure Resource Manager que você pode reutilizar, não apenas para criar aplicativos lógicos de consumo, mas também para definir os recursos e os parâmetros a serem usados na implantação. Você pode usar esse modelo para seus próprios cenários de negócios ou personalize o modelo para atender às suas necessidades. Para obter uma visão geral sobre a estrutura e a sintaxe para um modelo que contém uma definição de fluxo de trabalho e outros recursos necessários para a implantação, consulte Visão geral: automatizar a implantação para aplicativos lógicos com modelos do Azure Resource Manager.

Importante

Este artigo se aplica somente a aplicativos lógicos de consumo, não a aplicativos lógicos Standard. Verifique se as conexões em seu modelo usam o mesmo grupo e localização de recursos do Azure que o seu aplicativo lógico.

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

Criar modelos com o Visual Studio

A maneira mais fácil de criar um modelo de aplicativo lógico parametrizado válido que está, na maioria das vezes, pronto para implantação, é usando o Visual Studio (versão Community gratuita ou superior) e as Ferramentas de Aplicativos Lógicos do Azure para o Visual Studio. Você pode criar o aplicativo lógico no Visual Studio ou localizar e baixar um aplicativo lógico existente do portal do Azure no Visual Studio.

Ao baixar seu aplicativo lógico, você obtém um modelo que inclui as definições para o aplicativo lógico e outros recursos, como conexões. O modelo também parametriza, ou define parâmetros para, os valores usados para implantar o aplicativo lógico e outros recursos. Você pode fornecer os valores para esses parâmetros em um arquivo de parâmetro separado. Desse modo, você pode alterar esses valores com mais facilidade com base nas suas necessidades de implantação. Para saber mais, consulte esses tópicos:

Criar modelos com o Azure PowerShell

Você pode criar modelos do Resource Manager usando o Azure PowerShell com o módulo LogicAppTemplate. Esse módulo open-source primeiro avalia o aplicativo lógico e todas as conexões que o aplicativo lógico usa. Em seguida, o módulo gera recursos de modelo com os parâmetros necessários para a implantação.

Por exemplo, suponhamos que você tenha um aplicativo lógico que recebe uma mensagem de uma fila do Barramento de Serviço do Azure e carrega dados no Banco de Dados SQL do Azure. O módulo preserva toda a lógica de orquestração e parametriza as cadeias de conexão do SQL e do Barramento de Serviço para que você possa fornecer e alterar esses valores com base nas suas necessidades de implantação.

Estes exemplos mostram como criar e implantar aplicativos lógicos usando modelos do Azure Resource Manager, Azure Pipelines no Azure DevOps e Azure PowerShell:

Instalar módulos do PowerShell

Instale o Azure PowerShell, caso ainda não tenha feito isso.
A maneira mais fácil de instalar o módulo LogicAppTemplate do Galeria do PowerShell é executando este comando:
```
Install-Module -Name LogicAppTemplate
```
Para atualizar para a versão mais recente, execute este comando:
```
Update-Module -Name LogicAppTemplate
```

Ou, para instalar manualmente, siga as etapas no GitHub para Criador do modelo de aplicativo lógico.

Instalar o cliente do Azure Resource Manager

Para que o módulo LogicAppTemplate funcione com qualquer token de acesso de assinatura e locatário do Azure, instale a ferramenta de cliente do Azure Resource Manager, que é uma ferramenta de linha de comando simples que chama a API do Azure Resource Manager.

Quando você executa o comando Get-LogicAppTemplate com essa ferramenta, o comando obtém primeiro um token de acesso por meio da ferramenta ARMClient, canaliza o token para o script do PowerShell e finalmente cria o modelo como um arquivo JSON. Para obter mais informações sobre a ferramenta, consulte este artigo sobre a ferramenta de cliente do Azure Resource Manager.

Gerar o modelo com o PowerShell

Para gerar seu 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 para canalizar um token da ferramenta de cliente do Azure Resource Manager, então execute este comando, em que $SubscriptionId é a sua ID da assinatura 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, você pode criar um arquivo de parâmetros a partir do modelo executando este comando:

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

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

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

Parâmetros	Obrigatório	Descrição
TemplateFile	Sim	O caminho do arquivo para o arquivo de modelo
KeyVault	Não	Uma enumeração que descreve como tratar os possíveis valores de cofre de chaves. O padrão é `None`.

Próximas etapas

Implantar modelos de aplicativo lógico