Creación de plantillas de Azure Resource Manager para automatizar la implementación de aplicaciones lógicas de consumo para Azure Logic Apps

Artículo
01/04/2024

Se aplica a: Azure Logic Apps (consumo)

Para ayudarle a crear e implementar automáticamente una aplicación lógica de consumo, en este artículo se describen las maneras en que puede crear una plantilla de Azure Resource Manager. Azure Logic Apps también proporciona una plantilla precompilada de Azure Resource Manager para aplicaciones lógicas que puede reutilizar no solo para crear aplicaciones lógicas de consumo, sino también para definir los recursos y los parámetros para la implementación. Puede usar esta plantilla para sus propios escenarios empresariales o personalizar para satisfacer sus requisitos. Para obtener información general sobre la estructura y la sintaxis de una plantilla que contiene una definición de flujo de trabajo y otros recursos necesarios para la implementación, consulte Introducción: Implementación automatizada de aplicaciones lógicas con plantillas de Azure Resource Manager.

Importante

Este artículo solo se aplica a las aplicaciones lógicas de consumo, no a las aplicaciones lógicas estándar. Asegúrese de que las conexiones de la plantilla usen el mismo grupo de recursos y la misma ubicación de Azure que la aplicación lógica.

Para más información sobre las plantillas de Azure Resource Manager, consulte los temas siguientes:

Creación de plantillas con Visual Studio

Para crear de manera fácil plantillas de aplicación lógica parametrizadas válidas que estén principalmente listas para la implementación, use Visual Studio (la edición Community gratis o superior) y las herramientas de Azure Logic Apps para Visual Studio. A continuación, puede crear la aplicación lógica en Visual Studio o buscar y descargar una aplicación lógica existente desde Azure Portal en Visual Studio.

Al descargar la aplicación lógica, obtiene una plantilla que incluye las definiciones de la aplicación lógica y otros recursos, como las conexiones. La plantilla también parametriza o define los parámetros de los valores que se usan para implementar la aplicación lógica y otros recursos. Puede asignar los valores a estos parámetros en un archivo de parámetros independiente. De este modo, puede cambiar estos valores más fácilmente en función de sus necesidades de implementación. Para más información, consulte los temas siguientes:

Creación de plantillas con Azure PowerShell

Puede crear plantillas de Resource Manager mediante Azure PowerShell con el módulo LogicAppTemplate. Este módulo de código abierto evalúa primero la aplicación lógica y las conexiones que usa. Después, el módulo genera los recursos de plantilla con los parámetros necesarios para la implementación.

Por ejemplo, suponga que tiene una aplicación lógica que recibe un mensaje de una cola de Azure Service Bus y sube datos a Azure SQL Database. El módulo conserva toda la lógica de orquestación y parametriza las cadenas de conexión de SQL y Service Bus con el fin de que se puedan proporcionar y cambiar esos valores en función de sus necesidades de implementación.

En estos ejemplos se muestra cómo crear e implementar aplicaciones lógicas mediante plantillas de Azure Resource Manager, Azure Pipelines en Azure DevOps y Azure PowerShell:

Instalación de módulos PowerShell

Si todavía no lo ha hecho, instale Azure PowerShell.
La forma más fácil de instalar el módulo LogicAppTemplate es desde la Galería de PowerShell. Para ello, ejecute este comando:
```
Install-Module -Name LogicAppTemplate
```
Para actualizar a la versión más reciente, ejecute este comando:
```
Update-Module -Name LogicAppTemplate
```

O bien, para realizar la instalación manualmente, siga los pasos de GitHub para el Creador de plantillas de aplicación lógica.

Instalación del cliente de Azure Resource Manager

Para que el módulo LogicAppTemplate funcione con cualquier inquilino de Azure y cualquier token de acceso de suscripción, instale la herramienta de cliente de Azure Resource Manager, que es una sencilla herramienta de línea de comandos que llama a la API de Azure Resource Manager.

Al ejecutar el comando Get-LogicAppTemplate con esta herramienta, el comando obtiene primero un token de acceso mediante la herramienta ARMClient, canaliza el token al script de PowerShell y crea la plantilla como un archivo JSON. Para obtener más información sobre la herramienta, consulte este artículo acerca de la herramienta cliente de Azure Resource Manager.

Generación de plantillas con PowerShell

Para generar la plantilla después de instalar el módulo LogicAppTemplate y la CLI de Azure, ejecute este comando de 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 la recomendación de la canalización en un token desde la herramienta de cliente de Azure Resource Manager, ejecute este comando como alternativa donde $SubscriptionId sea su identificador de suscripción de 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

Después de la extracción, puede crear un archivo de parámetros a partir de la plantilla. Para ello, ejecute este comando:

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

Para la extracción con referencias de Azure Key Vault (solo estática), ejecute este comando:

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

Parámetros	Obligatorio	Descripción
TemplateFile	Sí	Ruta de acceso al archivo de plantilla
KeyVault	No	Una enumeración que describe cómo controlar los posibles valores del almacén de claves. El valor predeterminado es `None`.

Pasos siguientes

Implementación de plantillas de aplicaciones lógicas