Skapa Azure Resource Manager-mallar för att automatisera distribution av förbrukningslogikappar för Azure Logic Apps

Artikel
01/04/2024

Gäller för: Azure Logic Apps (förbrukning)

För att hjälpa dig att automatiskt skapa och distribuera en förbrukningslogikapp beskriver den här artikeln hur du kan skapa en Azure Resource Manager-mall. Azure Logic Apps tillhandahåller också en fördefinierad logikapp i Azure Resource Manager mall som du kan återanvända, inte bara för att skapa förbrukningslogikappar, utan även för att definiera resurser och parametrar för distribution. Du kan använda den här mallen för dina egna affärsscenarier eller anpassa mallen så att den uppfyller dina krav. En översikt över strukturen och syntaxen för en mall som innehåller en arbetsflödesdefinition och andra resurser som krävs för distribution finns i Översikt: Automatisera distribution för logikappar med Azure Resource Manager mallar.

Viktigt

Den här artikeln gäller endast för förbrukningslogikappar, inte standardlogikappar. Se till att anslutningarna i mallen använder samma Azure-resursgrupp och plats som din logikapp.

Mer information om Azure Resource Manager-mallar finns i följande avsnitt:

Skapa mallar med Visual Studio

Det enklaste sättet att skapa giltiga parametriserade logikappmallar som mest är redo för distribution är att använda Visual Studio (kostnadsfri Community Edition eller senare) och Azure Logic Apps Tools för Visual Studio. Du kan sedan antingen skapa din logikapp i Visual Studio eller hitta och ladda ned en befintlig logikapp från Azure Portal till Visual Studio.

Genom att ladda ned logikappen får du en mall som innehåller definitionerna för logikappen och andra resurser, till exempel anslutningar. Mallen parameteriserar eller definierar även parametrar för de värden som används för att distribuera logikappen och andra resurser. Du kan ange värdena för dessa parametrar i en separat parameterfil. På så sätt kan du enklare ändra dessa värden baserat på dina distributionsbehov. Mer information finns i de här ämnena:

Skapa mallar med Azure PowerShell

Du kan skapa Resource Manager mallar med hjälp av Azure PowerShell med modulen LogicAppTemplate. Den här modulen med öppen källkod utvärderar först logikappen och eventuella anslutningar som logikappen använder. Modulen genererar sedan mallresurser med nödvändiga parametrar för distribution.

Anta till exempel att du har en logikapp som tar emot ett meddelande från en Azure Service Bus kö och laddar upp data till Azure SQL Database. Modulen bevarar all orkestreringslogik och parametriserar SQL- och Service Bus-anslutningssträngarna så att du kan ange och ändra dessa värden baserat på dina distributionsbehov.

De här exemplen visar hur du skapar och distribuerar logikappar med hjälp av Azure Resource Manager-mallar, Azure Pipelines i Azure DevOps och Azure PowerShell:

Installera PowerShell-moduler

Installera Azure PowerShell om du inte redan gjort det.
Det enklaste sättet att installera LogicAppTemplate-modulen från PowerShell-galleriet är att köra det här kommandot:
```
Install-Module -Name LogicAppTemplate
```
Om du vill uppdatera till den senaste versionen kör du det här kommandot:
```
Update-Module -Name LogicAppTemplate
```

Om du vill installera manuellt följer du stegen i GitHub for Logic App Template Creator.

Installera Azure Resource Manager-klienten

För att LogicAppTemplate-modulen ska fungera med en Azure-klient och prenumerationsåtkomsttoken installerar du Azure Resource Manager-klientverktyget, som är ett enkelt kommandoradsverktyg som anropar Azure Resource Manager-API:et.

När du kör Get-LogicAppTemplate kommandot med det här verktyget hämtar kommandot först en åtkomsttoken via ARMClient-verktyget, skickar token till PowerShell-skriptet och skapar mallen som en JSON-fil. Mer information om verktyget finns i den här artikeln om klientverktyget för Azure Resource Manager.

Generera mall med PowerShell

Skapa mallen när du har installerat LogicAppTemplate-modulen och Azure CLI genom att köra det här PowerShell-kommandot:

$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

Om du vill följa rekommendationen för att skicka en token från Azure Resource Manager-klientverktyget kör du det här kommandot i stället där $SubscriptionId är ditt Azure-prenumerations-ID:

$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

Efter extrahering kan du sedan skapa en parameterfil från mallen genom att köra det här kommandot:

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

Kör följande kommando för extrahering med Azure Key Vault-referenser (endast statisk):

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

Parametrar	Krävs	Beskrivning
TemplateFile	Ja	Filsökvägen till mallfilen
KeyVault	Inga	En uppräkning som beskriver hur du hanterar möjliga nyckelvalvsvärden. Standardvärdet är `None`.

Nästa steg

Distribuera mallar för logikappar