Erstellen von Azure Resource Manager-Vorlagen, um die Bereitstellung von Logik-Apps (Verbrauch) für Azure Logic Apps zu automatisieren

Gilt für: Azure Logic Apps (Verbrauch)

Um Sie dabei zu unterstützen, das Erstellen und Bereitstellen einer Logik-App im Verbrauchstarif zu automatisieren, sind in diesem Artikel die Möglichkeiten beschrieben, mit denen Sie eine Azure Resource Manager-Vorlage erstellen. Azure Logic Apps bietet eine vordefinierte Azure Resource Manager-Vorlage, die Sie nicht nur zum Erstellen von Logik-Apps (Verbrauch), sondern auch zum Definieren der Ressourcen und Parameter für die Bereitstellung wiederverwenden können. Die Vorlage kann für eigene Unternehmensszenarien verwendet oder an Ihre individuellen Anforderungen angepasst werden. Eine Übersicht über die Struktur und die Syntax einer Vorlage, die eine Workflowdefinition und weitere Ressourcen enthält, die zur Bereitstellung erforderlich sind, finden Sie unter Übersicht: Automatisieren der Bereitstellung für Logik-Apps mit Azure Resource Manager-Vorlagen.

Wichtig

Dieser Artikel gilt nur für Logik-Apps im Verbrauchstarif, nicht für Logik-Apps im Standard-Tarif. Für Verbindungen in Ihrer Vorlage müssen dieselbe Azure-Ressourcengruppe und derselbe Standort wie für Ihre Logik-App verwendet werden.

Weitere Informationen zu Azure Resource Manager-Vorlagen finden Sie unter den folgenden Themen:

Erstellen von Vorlagen mit Visual Studio

Als einfachste Möglichkeit, gültige parametrisierte Logik-App-Vorlagen zu erstellen, die weitestgehend zur Bereitstellung bereit sind, verwenden Sie Visual Studio (kostenlose Community Edition oder höher) und die Azure Logic Apps-Tools für Visual Studio. Sie können dann entweder Ihre Logik-App in Visual Studio erstellen oder im Azure-Portal nach einer vorhandenen Logik-App suchen und diese nach Visual Studio herunterladen.

Wenn Sie Ihre Logik-App herunterladen, erhalten Sie eine Vorlage, die die Definitionen für Ihre Logik-App sowie weitere Ressourcen, etwa Verbindungen, enthält. In der Vorlage sind außerdem die Werte parametrisiert oder Parameter für die Werte definiert, die zur Bereitstellung Ihrer Logik-App und anderer Ressourcen verwendet werden. Sie können die Werte für diese Parameter in einer separaten Parameterdatei bereitstellen. Auf diese Weise können Sie diese Werte einfacher entsprechend Ihren Bereitstellungsanforderungen ändern. Weitere Informationen finden Sie in den folgenden Themen:

Erstellen von Vorlagen mit Azure PowerShell

Sie können Ressourcen-Manager-Vorlagen erstellen, indem Sie Azure PowerShell mit dem LogicAppTemplate-Modul verwenden. Dieses Open Source-Modul bewertet zunächst Ihre Logik-App und alle Verbindungen, die die Logik-App verwendet. Das Modul generiert dann Vorlagenressourcen mit den erforderlichen Parametern für die Bereitstellung.

Angenommen, Sie haben eine Logik-App, die eine Nachricht von einer Azure Service Bus-Warteschlange empfängt und Daten in Azure SQL-Datenbank hochlädt. Das Modul speichert die gesamte Orchestrierungslogik und parametrisiert die SQL- und Service Bus-Verbindungszeichenfolgen, sodass Sie diese Werte entsprechend Ihren Bereitstellungsanforderungen bereitstellen und ändern können.

Diese Beispiele veranschaulichen das Erstellen und Bereitstellen von Logik-Apps mithilfe von Azure Resource Manager-Vorlagen, Azure Pipelines in Azure DevOps und Azure PowerShell:

Installieren von PowerShell-Modulen

  1. Installieren Sie Azure PowerShell, sofern dies noch nicht geschehen ist.

  2. Der einfachste Weg zum Installieren des LogicAppTemplate-Moduls aus dem PowerShell-Katalog besteht darin, den folgenden Befehl auszuführen:

    Install-Module -Name LogicAppTemplate
    

    Um auf die neueste Version zu aktualisieren, führen Sie den folgenden Befehl aus:

    Update-Module -Name LogicAppTemplate
    

Wenn Sie manuell installieren möchten, führen Sie die Schritte in GitHub für LogicAppTemplateCreator aus.

Installieren des Azure Resource Manager-Clients

Damit das LogicAppTemplate-Modul mit jedem Azure-Mandanten und Abonnementzugriffstoken funktioniert, installieren Sie das Azure Resource Manager-Clienttool. Dieses Tool ist ein einfaches Befehlszeilentool, aus dem die Azure Resource Manager-API aufgerufen wird.

Wenn Sie den Get-LogicAppTemplate-Befehl mit diesem Tool ausführen, geht der Befehl wie folgt vor: Er ruft zunächst ein Zugriffstoken über das ARMClient-Tool ab, reicht das Token an das PowerShell-Skript weiter und erstellt die Vorlage als JSON-Datei. Weitere Informationen über das Tool finden Sie in diesem Artikel zu dem Azure Resource Manager-Clienttool.

Generieren einer Vorlage mit PowerShell

Um Ihre Vorlage nach dem Installieren von LogicAppTemplate-Modul und Azure CLI zu generieren, führen Sie den folgenden PowerShell-Befehl aus:

$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

Um der Empfehlung für das Weiterreichen eines Tokens aus dem Azure Resource Manager-Clienttool zu folgen, führen Sie stattdessen diesen Befehl aus, wobei $SubscriptionId Ihre Azure-Abonnement-ID ist:

$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

Nach dem Extrahieren können Sie eine Parameterdatei aus ihrer Vorlage erstellen, indem Sie den folgenden Befehl ausführen:

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

Zum Extrahieren mit Azure Key Vault-Verweisen (nur statisch) führen Sie den folgenden Befehl aus:

Get-ParameterTemplate -TemplateFile $filename -KeyVault Static | Out-File $fileNameParameter
Parameter Erforderlich BESCHREIBUNG
TemplateFile Ja Der Pfad zu Ihrer Vorlagendatei
KeyVault Nein Eine Enumeration, in der beschrieben ist, wie mögliche Schlüsseltresorwerte (Key Vault-Werte) verarbeitet werden Der Standardwert lautet None.

Nächste Schritte