Automatisieren der Erstellung und Bereitstellung für Logik-App-Standardworkflows mit Azure DevOps

Für Logik-App-Standardworkflows, die in Azure Logic Apps mit einem Mandaten ausgeführt werden, können Sie Visual Studio Code mit der Erweiterung Azure Logic Apps (Standard) verwenden, um Ihr Logik-App-Projekt lokal zu entwickeln, zu testen und zu speichern, indem Sie ein beliebiges Quellcodeverwaltungssystem verwenden. Um jedoch alle Vorteile der einfachen und konsistenten Bereitstellung Ihrer Workflows in verschiedenen Umgebungen und Plattformen zu erzielen, müssen Sie auch Ihren Build- und Bereitstellungsprozess automatisieren.

Die Azure Logic Apps (Standard)-Erweiterung bietet Tools zum Erstellen und Verwalten automatisierter Build- und Bereitstellungsprozesse mithilfe von Azure DevOps. Bevor Sie diese Automatisierung starten, sollten Sie jedoch die folgenden Elemente berücksichtigen:

• Die Azure-Logik-App-Ressource, in der Sie Ihre Workflows erstellen

• Die von Azure gehosteten Verbindungen, die Workflows verwenden und die aus von Microsoft verwalteten Connectors erstellt werden.

  Diese Verbindungen unterscheiden sich von den Verbindungen, die direkt und nativ mit der Azure Logic Apps-Laufzeit ausgeführt werden.

• Die spezifischen Einstellungen und Parameter für die verschiedenen Umgebungen, in denen Sie bereitstellen möchten

Die Erweiterung hilft Ihnen, die folgenden erforderlichen Aufgaben zum Automatisieren von Erstellung und Bereitstellung auszuführen:

• Parametrisieren der Verbindungsverweise zur Entwurfszeit. Diese Aufgabe vereinfacht das Aktualisieren von Verweisen in verschiedenen Umgebungen, ohne die lokale Entwicklungsfunktionalität zu unterbrechen.

• Generieren von Skripts, die die Bereitstellung für Ihre Logik-App-Standardressource automatisieren, einschließlich aller abhängigen Ressourcen.

• Generieren von Skripts, die die Bereitstellung für von Azure gehostete Verbindungen automatisieren.

• Vorbereiten umgebungsspezifischer Parameter, die Sie während des Erstellungsprozesses in das Azure Logic Apps-Paket einfügen können, ohne die lokale Entwicklungsfunktionalität zu unterbrechen.

• Generieren von Pipelines nach Bedarf mithilfe von Azure DevOps, um die Infrastrukturbereitstellung zusammen mit den Erstellungs- und Releaseprozessen zu unterstützen.

In diesem Leitfaden wird gezeigt, wie Sie die folgenden Aufgaben ausführen:

1. Erstellen eines Logik-App-Arbeitsbereichs und eines Projekts in Visual Studio Code mit den Dateien, die Pipelines für Infrastrukturbereitstellung, Continuous Integration (CI) und Continuous Deployment (CD) erstellen.

2. Erstellen einer Verbindung zwischen Ihrem Arbeitsbereich und Git-Repository in Azure DevOps.

3. Erstellen von Pipelines in Azure DevOps.

Weitere Informationen finden Sie in der folgenden Dokumentation:

• Was ist Azure DevOps?
• Was ist Azure Pipelines?

Bekannte Probleme und Einschränkungen

• Diese Funktion unterstützt nur Logik-App-Standardprojekte. Wenn Ihr Visual Studio Code-Arbeitsbereich sowohl ein Logik-App-Standardprojekt als auch ein benutzerdefiniertes Functions-Codeprojekt enthält, werden für beide Bereitstellungsskripts generiert, benutzerdefinierte Codeprojekte werden derzeit jedoch ignoriert. Die Möglichkeit zum Erstellen von Buildpipelines für benutzerdefinierten Code ist in der Roadmap enthalten.

• Die Erweiterung erstellt Pipelines für Infrastrukturbereitstellung, Continuous Integration (CI) und Continuous Deployment (CD). Sie sind jedoch dafür verantwortlich, die Pipelines mit Azure DevOps zu verbinden und die relevanten Trigger zu erstellen.

• Derzeit unterstützt die Erweiterung nur Azure Resource Management-Vorlagen (ARM-Vorlagen) für Infrastrukturbereitstellungsskripts. Andere Vorlagen sind in Planung.

Voraussetzungen

• Ein Azure-Konto und ein Azure-Abonnement. Falls Sie kein Abonnement besitzen, können Sie sich für ein kostenloses Azure-Konto registrieren.

• Visual Studio Code mit der Erweiterung Azure Logic Apps (Standard). Informationen zum Erfüllen dieser Anforderungen finden Sie unter den Voraussetzungen zum Erstellen von Standardworkflows mit Visual Studio Code.

• Erstellungs- und Releaseaufgaben für Azure Logic Apps (Standard) für Azure DevOps-Aufgaben. Sie finden diese Aufgaben im Azure DevOps Marketplace.

• Ein vorhandenes Git-Repository in Azure DevOps, in dem Sie Ihr Logik-App-Projekt speichern können.

• Eine Azure Resource Manager-Dienstverbindung mit einem vorhandenen Dienstprinzipal.

• Eine vorhandene Azure-Ressourcengruppe, in der Sie Ihre Logik-App bereitstellen möchten.

Erstellen eines Logik-App-Arbeitsbereichs, -Projekts und -Workflows

1. Wählen Sie auf der Aktivitätsleiste in Visual Studio Code das Azure-Symbol aus.

2. Öffnen Sie im Fenster Azure auf der Symbolleiste Arbeitsbereich das Menü Azure Logic Apps, und wählen Sie Neuen Logik-App-Arbeitsbereich erstellen aus.

   

3. Folgen Sie den Aufforderungen, um die folgenden Aufgaben auszuführen:

   1. Wählen Sie den Ordner aus, in dem der Arbeitsbereich erstellt werden soll.

   2. Geben Sie den Namen Ihres Arbeitsbereichs ein.

   3. Wählen Sie den Projekttyp aus: Logik-App

   4. Geben Sie den Namen ihres Logik-App-Projekts ein.

   5. Wählen Sie die Workflowvorlage aus. Geben Sie den Workflownamen ein.

   6. Wählen Sie aus, ob der Arbeitsbereich im aktuellen Visual Studio Code-Fenster oder in einem neuen Fenster geöffnet werden soll.

      Visual Studio Code zeigt den neuen Arbeitsbereich und das Logik-App-Projekt an.

4. Führen Sie die folgenden Schritte aus, um den Workflow-Designer zu öffnen:

   1. Erweitern Sie im Logik-App-Projekt den Ordner mit dem Workflownamen.

   2. Wenn sie noch nicht geöffnet ist, öffnen Sie die Datei workflow.json, öffnen Sie das Kontextmenü der Datei, und wählen Sie Designer öffnen aus.

   3. Wenn Sie aufgefordert werden, Parametrisierungen für Verbindungen zuzulassen, wenn Ihr Projekt geladen wird, wählen Sie Ja aus.

      Mit dieser Auswahl kann Ihr Projekt Parameter in Verbindungsdefinitionen verwenden, sodass Sie Erstellung und Bereitstellung für verschiedene Umgebungen automatisieren können.

   4. Befolgen Sie die Anweisungen, um die folgenden Elemente auszuwählen:

      • Verwenden von Connectors aus Azure

        Hinweis

        Wenn Sie diesen Schritt überspringen, können Sie nur die integrierten Connectors verwenden, die laufzeitgehostet sind. Führen Sie die folgenden Schritte aus, um die von Microsoft verwalteten, von Azure gehosteten Connectors zu einem späteren Zeitpunkt zu aktivieren:

        1. Öffnen Sie das Kontextmenü für die Datei workflow.json, und wählen Sie Connectors von Azure verwenden aus.

        2. Wählen Sie eine vorhandene Azure-Ressourcengruppe aus, die Sie für Ihre Logik-App verwenden möchten.

        3. Laden Sie den Workflow-Designer erneut.

      • Die vorhandene Azure-Ressourcengruppe, die Sie für Ihre Logik-App verwenden möchten

5. Wenn Sie fertig sind, laden Sie den Workflow-Designer neu. Melden Sie sich an Azure an, wenn Sie dazu aufgefordert werden.

   

Sie können den Workflow jetzt beliebig bearbeiten und Ihren Workflow dabei lokal testen. Informationen zum Erstellen und Testen eines Beispielworkflows finden Sie im Artikel zum Erstellen von Standardworkflows mit Visual Studio Code.

Generieren von Bereitstellungsskripts

Nachdem Sie Ihren Workflow erstellt und lokal getestet haben, erstellen Sie Ihre Bereitstellungsskripts.

1. Öffnen Sie im leeren Bereich unter allen Projektdateien das Kontextmenü des Projekts, und wählen Sie Bereitstellungsskripts generieren aus.

   

2. Befolgen Sie die Aufforderungen, um die folgenden Schritte auszuführen:

   1. Wählen Sie die vorhandene Azure-Ressourcengruppe aus, die Sie für Ihre Logik-App verwenden möchten.

   2. Geben Sie einen eindeutigen Namen für Ihre Logik-App-Ressource ein.

   3. Geben Sie einen eindeutigen Namen für Ihre Speicherkontoressource ein.

   4. Geben Sie einen eindeutigen Namen ein, der für Ihren App Service-Plan verwendet werden soll.

   5. Wählen Sie den Arbeitsbereichsordner aus, in dem Sie die Dateien generieren möchten.

      Speicherort des Bereitstellungsordners	Beschreibung
      Neuer Bereitstellungsordner (Standard)	Erstellen Sie einen neuen Ordner im aktuellen Arbeitsbereich.
      Anderen Ordner auswählen	Wählen Sie einen anderen Ordner im aktuellen Arbeitsbereich aus.

   Wenn Sie fertig sind, erstellt Visual Studio Code einen Ordner mit dem Namen deployment/{Name-der-Logik-App} im Stammverzeichnis Ihres Arbeitsbereichs. Dieser Ordner verwendet den gleichen Logik-App-Namen, den Sie in diesen Schritten angegeben haben.

   Hinweis

   Die Werte von Variablen, App-Einstellungen und Parametern in den folgenden Dateien werden basierend auf der Eingabe, die Sie in diesen Schritten bereitgestellt haben, vorab aufgefüllt. Wenn Sie auf eine andere Umgebung abzielen, stellen Sie sicher, dass Sie die Werte für die erstellten Parameter und Variablendateien aktualisieren.

   

   Unter dem Ordner {Name-der-Logik-App} sehen Sie die folgende Struktur:

   Ordnername	Dateiname und Beschreibung
   ADOPipelineScripts	- CD-pipeline.yml: Die Continuous Delivery-Pipeline, die die Anweisungen zum Bereitstellen des Logik-App-Codes für die Logik-App-Ressource in Azure enthält. - CD-pipeline-variables.yml: Eine YAML-Datei, die die von der CD-pipeline.yml-Datei verwendeten Variablen enthält. - CI-pipeline.yml: Die Continuous Integration-Pipeline, die die Anweisungen zum Erstellen und Generieren der Artefakte enthält, die zum Bereitstellen der Logik-App-Ressource in Azure erforderlich sind. - CI-pipeline-variables.yml: Eine YAML-Datei, die die von der CI-pipeline.yml-Datei verwendeten Variablen enthält. - infrastructure-pipeline.yml: Eine YAML-Pipeline mit Infrastructure-as-Code, die die Anweisungen zum Laden aller ARM-Vorlagen in Azure und zum Ausführen der Schritte in der Datei infrastructure-pipeline-template.yml enthält. - infrastructure-pipeline-template.yml: Eine YAML-Pipelinedatei mit den Schritten zum Bereitstellen einer Logik-App-Ressource mit allen erforderlichen Abhängigkeiten und zum Bereitstellen jeder vom Quellcode erforderlichen verwalteten Verbindung. - infrastructure-pipeline-variables.yml: Eine YAML-Pipeline, die alle Variablen enthält, die zum Ausführen der Schritte in der Datei infrastructure-pipeline-template.yml erforderlich sind.
   ArmTemplates	- {Verbindungstyp}.parameters.json: Eine Ressourcen-Manager-Parameterdatei, die die Parameter enthält, die zum Bereitstellen einer von Azure gehosteten Verbindung mit dem Namen {Verbindungstyp} in Azure erforderlich sind. Diese Datei ist für jede in Azure gehostete Verbindung in Ihrem Workflow vorhanden. - {Verbindungstyp}.template.json: Eine Ressourcen-Manager-Vorlagendatei, die eine von Azure gehostete Verbindung namens {Verbindungsverweis} darstellt und die Informationen enthält, die zum Bereitstellen der entsprechenden Verbindungsressource in Azure verwendet werden. Diese Datei ist für jede in Azure gehostete Verbindung in Ihrem Workflow vorhanden. - {Name-der-Logik-App}.parameters.json: Eine Ressourcen-Manager-Parameterdatei, die die Parameter enthält, die zum Bereitstellen der Logik-App-Standardressource mit dem Namen {Name-der-Logik-App} in Azure erforderlich sind, einschließlich aller Abhängigkeiten. - {Name-der-Logik-App}.template.json: Eine Ressourcen-Manager-Vorlagendatei, die die Logik-App-Standardressource namens {Name-der-Logik-App} darstellt und die Informationen enthält, die zum Bereitstellen der Logik-App-Ressource in Azure verwendet werden.
   WorkflowParameters	parameters.json: Diese JSON-Datei ist eine Kopie der lokalen Parameterdatei und enthält eine Kopie aller benutzerdefinierten Parameter sowie die Cloudversion aller Parameter, die von der Erweiterung erstellt wurden, um von Azure gehostete Verbindungen zu parametrisieren. Diese Datei wird verwendet, um das Paket zu erstellen, das für Azure bereitgestellt wird.

Verbinden Ihres Arbeitsbereichs mit Ihrem Git-Repository

1. Führen Sie die folgenden Schritte aus, um Ihr Repository zu initialisieren:

   1. Wählen Sie in Visual Studio Code in der Aktivitätsleiste das Symbol Quellcodeverwaltung aus.

   2. Wählen Sie im Fenster Quellcodeverwaltung die Option Repository initialisieren aus.

   3. Wählen Sie im Eingabeaufforderungsmenü Ordner auswählen aus. Wählen Sie den Arbeitsbereichstammordner und dann Repository initialisieren aus.

      

   4. Wählen Sie im Fenster Quellcodeverwaltung die Option Repository öffnen aus.

   5. Wählen Sie im Eingabeaufforderungsmenü das soeben erstellte Repository aus.

   Weitere Informationen finden Sie im Artikel zu Visual Studio Code – Initialisieren eines Repositorys in einem lokalen Ordner.

2. Führen Sie die folgenden Schritte aus, um die URL für Ihr Git-Repository abzurufen, damit Sie ein Remoterepository hinzufügen können:

   1. Öffnen Sie in Azure DevOps das Teamprojekt für Ihre Azure DevOps-Organisation.

   2. Erweitern Sie im linken Menü Repositorys, und wählen Sie Dateien aus.

   3. Wählen Sie auf der Symbolleiste des Bereichs Dateien die Option Klonen aus.

      

   4. Kopieren Sie im Fenster Repository klonen die HTTPS-Version der Klon-URL.

      Weitere Informationen finden Sie unter Abrufen der Klon-URL eines Azure Repos-Git-Repositorys.

3. Führen Sie die folgenden Schritte aus, um ein Remoterepository für Ihr Git-Repository hinzuzufügen:

   1. Kehren Sie zu Visual Studio Code und zum Fenster Quellcodeverwaltung zurück.

   2. Öffnen Sie unter Repositorys der Quellcodeverwaltung über die Symbolleiste Ihres Repositorys das Menü mit den Auslassungspunkten (...), und wählen Sie Remoterepository>Remoterepository hinzufügen aus.

      

4. Fügen Sie an der Eingabeaufforderung die kopierte URL ein, und geben Sie einen Namen für das Remoterepository ein, normalerweise origin.

   Sie haben nun eine Verbindung zwischen Visual Studio Code und Ihrem Repository erstellt.

5. Bevor Sie Ihre Pipelines im nächsten Abschnitt einrichten, öffnen Sie die CD-pipeline.yml-Datei, und benennen Sie die CI-Pipeline im Attribut source so um, dass sie dem CI-Pipelinenamen entspricht, den Sie verwenden möchten.

   

6. Committen Sie im Fenster Quellcodeverwaltung Ihre Änderungen, und veröffentlichen Sie sie im Repository.

   Weitere Informationen finden Sie im Artikel zu Staging und Committen von Codeänderungen.

Erstellen von Pipelines in Azure DevOps

Um die Infrastruktur zusammen mit den CI- und CD-Pipelines in Azure DevOps zu erstellen, wiederholen Sie die folgenden Schritte für jede der folgenden Pipelinedateien:

• infrastructure-pipeline.yml für die „Infrastructure-as-Code“-Pipeline.
• CI-pipeline.yml für die Continuous Integration-Pipeline.
• CD-pipeline.yml für die Continuous Delivery-Pipeline.

Einrichten einer Pipeline

1. Wechseln Sie in Azure DevOps zurück zu Ihrem Teamprojekt und zum Bereich Repositorys>Dateien.

2. Wählen Sie im Bereich Dateien die Option Build einrichten aus.

   

3. Bestätigen Sie im Bereich Inventory your pipeline die Repositoryinformationen, und wählen Sie Pipeline konfigurieren aus.

   

4. Wählen Sie im Bereich Pipeline konfigurieren die Option Vorhandene Azure Pipelines-YAML-Datei aus.

   

5. Führen Sie im Bereich Vorhandene YAML-Datei auswählen die folgenden Schritte aus, um die Datei Infrastructure-pipeline.yml auszuwählen:

   1. Wählen Sie für Branch den Branch aus, in dem Sie Ihre Änderungen committet haben, z. B. main oder Releasebranch.

   2. Wählen Sie für Pfad den Pfad aus, der für Ihre Pipeline verwendet werden soll. Der folgende Pfad ist der Standardwert:

      deployment/{Name-der-Logik-App}/ADOPipelineScripts/{Name-der-Infrastrukturpipeline}.yml

   3. Wenn Sie bereit sind, wählen Sie Weiter aus.

      

6. Wählen Sie im Bereich Pipeline konfigurieren die Option Pipeline überprüfen aus.

7. Geben Sie im Bereich Review your governed pipeline die folgenden Informationen an:

   • Pipelinename: Geben Sie einen Namen für die Pipeline ein.
   • Pipelineordner: Wählen Sie den Ordner aus, in dem die Pipeline gespeichert werden soll. Der Name lautet ./deployment/{Name-der-Logik-App}/pipelines.

8. Klicken Sie auf Speichern, wenn Sie fertig sind.

   

Anzeigen und Ausführen der Pipeline

Führen Sie die folgenden Schritte aus, um Ihre Pipeline zu suchen und auszuführen:

1. Erweitern Sie im linken Menü Ihres Teamprojekts Pipelines, und wählen Sie Pipelines aus.

2. Wählen Sie die Registerkarte Alle aus, um alle verfügbaren Pipelines anzuzeigen. Suchen Sie die Pipeline, und wählen Sie sie aus.

3. Wählen Sie auf der Symbolleiste der Pipeline Pipeline ausführen aus.

   

Weitere Informationen finden Sie unter Erstellen Ihrer ersten Pipeline.

Weitere Informationen

• Anpassen Ihrer Pipeline

• Verwalten Ihrer Pipeline mit der Azure CLI

• Continuous integration mit Azure Pipelines in Visual Studio Code