Azure Resource Manager-sjablonen maken voor het automatiseren van de implementatie van logische verbruiks-apps voor Azure Logic Apps

  • Artikel

Van toepassing op: Azure Logic Apps (verbruik)

In dit artikel worden de manieren beschreven waarop u een Azure Resource Manager-sjabloon kunt maken om u te helpen bij het automatisch maken en implementeren van een logische app voor verbruik. Azure Logic Apps biedt ook een vooraf gebouwde logische app azure Resource Manager sjabloon die u opnieuw kunt gebruiken, niet alleen om logische apps voor verbruik te maken, maar ook om de resources en parameters voor implementatie te definiëren. U kunt deze sjabloon gebruiken voor uw eigen bedrijfsscenario's of de sjabloon aanpassen aan uw vereisten. Zie Overzicht: Implementatie voor logische apps automatiseren met Azure Resource Manager-sjablonen voor een overzicht van de structuur en syntaxis voor een sjabloon met een werkstroomdefinitie en andere resources die nodig zijn voor de implementatie.

Belangrijk

Dit artikel is alleen van toepassing op logische apps voor verbruik, niet op logische standaard-apps. Zorg ervoor dat verbindingen in uw sjabloon dezelfde Azure-resourcegroep en -locatie gebruiken als uw logische app.

Zie de volgende onderwerpen voor meer informatie over Azure Resource Manager-sjablonen:

Sjablonen maken met Visual Studio

Voor de eenvoudigste manier om geldige sjablonen voor logische apps met parameters te maken die meestal gereed zijn voor implementatie, gebruikt u Visual Studio (gratis Community-editie of hoger) en de Azure Logic Apps Tools voor Visual Studio. Vervolgens kunt u uw logische app maken in Visual Studio of een bestaande logische app zoeken en downloaden vanuit de Azure Portal in Visual Studio.

Door uw logische app te downloaden, krijgt u een sjabloon met de definities voor uw logische app en andere resources, zoals verbindingen. Met de sjabloon worden ook parameters voor de waarden gedefinieerd die worden gebruikt voor het implementeren van uw logische app en andere resources. U kunt de waarden voor deze parameters opgeven in een afzonderlijk parameterbestand. Op die manier kunt u deze waarden eenvoudiger wijzigen op basis van uw implementatiebehoeften. Raadpleeg de volgende onderwerpen voor meer informatie:

Sjablonen maken met Azure PowerShell

U kunt Resource Manager sjablonen maken met behulp van Azure PowerShell met de module LogicAppTemplate. Deze opensource-module evalueert eerst uw logische app en eventuele verbindingen die de logische app gebruikt. De module genereert vervolgens sjabloonresources met de benodigde parameters voor implementatie.

Stel dat u een logische app hebt die een bericht ontvangt van een Azure Service Bus wachtrij en gegevens uploadt naar Azure SQL Database. De module behoudt alle indelingslogica en parameteriseert de SQL- en Service Bus-verbindingsreeksen, zodat u deze waarden kunt opgeven en wijzigen op basis van uw implementatiebehoeften.

Deze voorbeelden laten zien hoe u logische apps maakt en implementeert met behulp van Azure Resource Manager-sjablonen, Azure Pipelines in Azure DevOps en Azure PowerShell:

PowerShell-modules installeren

  1. Als u dat nog niet hebt gedaan, installeert u Azure PowerShell.

  2. Voer de volgende opdracht uit voor de eenvoudigste manier om de LogicAppTemplate-module te installeren vanuit de PowerShell Gallery:

    Install-Module -Name LogicAppTemplate

    Als u wilt bijwerken naar de nieuwste versie, voert u deze opdracht uit:

    Update-Module -Name LogicAppTemplate

U kunt ook handmatig installeren door de stappen in GitHub for Logic App Template Creator uit te voeren.

Azure Resource Manager-client installeren

Als u wilt dat de LogicAppTemplate-module werkt met elk toegangstoken voor Azure-tenants en -abonnementen, installeert u het Azure Resource Manager-clienthulpprogramma. Dit is een eenvoudig opdrachtregelprogramma dat de Azure Resource Manager-API aanroept.

Wanneer u de Get-LogicAppTemplate opdracht met dit hulpprogramma uitvoert, krijgt de opdracht eerst een toegangstoken via het hulpprogramma ARMClient, wordt het token naar het PowerShell-script opgegeven en wordt de sjabloon gemaakt als een JSON-bestand. Zie dit artikel over het azure Resource Manager-clienthulpprogramma voor meer informatie over het hulpprogramma.

Sjabloon genereren met PowerShell

Voer deze PowerShell-opdracht uit om uw sjabloon te genereren nadat u de LogicAppTemplate-module en Azure CLI hebt geïnstalleerd:

$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

Als u de aanbeveling voor piping in een token van het Azure Resource Manager-clienthulpprogramma wilt volgen, voert u in plaats daarvan deze opdracht uit waarbij $SubscriptionId uw Azure-abonnements-id is:

$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

Na extractie kunt u vervolgens een parameterbestand maken op basis van uw sjabloon door deze opdracht uit te voeren:

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

Voer deze opdracht uit voor extractie met Azure Key Vault-verwijzingen (alleen statisch):

Get-ParameterTemplate -TemplateFile $filename -KeyVault Static | Out-File $fileNameParameter
Parameters Vereist Beschrijving
TemplateFile Yes Het bestandspad naar het sjabloonbestand
KeyVault No Een opsomming die beschrijft hoe u mogelijke sleutelkluiswaarden kunt afhandelen. De standaardwaarde is None.

Volgende stappen

Sjablonen voor logische app gebruiken