Delen via

Build en implementatie automatiseren voor standaardwerkstromen voor logische apps met Azure DevOps

  • Artikel

Voor standaardwerkstromen voor logische apps die worden uitgevoerd in Azure Logic Apps met één tenant, kunt u Visual Studio Code gebruiken met de Azure Logic Apps-extensie (Standard) om uw logische app-project lokaal te ontwikkelen, te testen en op te slaan met behulp van een broncodebeheersysteem. Om echter de volledige voordelen te krijgen van het eenvoudig en consistent implementeren van uw werkstromen in verschillende omgevingen en platforms, moet u ook uw build- en implementatieproces automatiseren.

De Azure Logic Apps-extensie (Standard) biedt hulpprogramma's voor het maken en onderhouden van geautomatiseerde build- en implementatieprocessen met behulp van Azure DevOps. Voordat u deze automatisering start, moet u echter rekening houden met de volgende elementen:

  • De resource van de logische Azure-app waarin u uw werkstromen maakt

  • De door Azure gehoste verbindingen die werkstromen gebruiken en worden gemaakt op basis van door Microsoft beheerde connectors.

    Deze verbindingen verschillen van de verbindingen die rechtstreeks en systeemeigen worden uitgevoerd met de Azure Logic Apps-runtime.

  • De specifieke instellingen en parameters voor de verschillende omgevingen waar u wilt implementeren

Met de extensie kunt u de volgende vereiste taken uitvoeren om de build en implementatie te automatiseren:

  • Parameteriseer verbindingsverwijzingen tijdens het ontwerp. Deze taak vereenvoudigt het proces van het bijwerken van verwijzingen in verschillende omgevingen zonder dat de functionaliteit voor lokale ontwikkeling wordt onderbroken.

  • Genereer scripts waarmee de implementatie voor uw standaardresource voor logische apps wordt geautomatiseerd, inclusief alle afhankelijke resources.

  • Scripts genereren waarmee de implementatie voor door Azure gehoste verbindingen wordt geautomatiseerd.

  • Bereid omgevingsspecifieke parameters voor die u tijdens het buildproces in het Azure Logic Apps-pakket kunt injecteren zonder de functionaliteit voor lokale ontwikkeling te verbreken.

  • Genereer pijplijnen op aanvraag met behulp van Azure DevOps ter ondersteuning van de implementatie van infrastructuur, samen met de build- en releaseprocessen.

In deze handleiding ziet u hoe u de volgende taken uitvoert:

  1. Maak een logische app-werkruimte en -project in Visual Studio Code met de bestanden die pijplijnen maken voor de implementatie van de infrastructuur, continue integratie (CI) en continue implementatie (CD).

  2. Maak een verbinding tussen uw werkruimte en Git-opslagplaats in Azure DevOps.

  3. Pijplijnen maken in Azure DevOps.

Voor meer informatie raadpleegt u de volgende documentatie:

Bekende problemen en beperkingen

  • Deze mogelijkheid ondersteunt alleen Standard-projecten voor logische apps. Als uw Visual Studio Code-werkruimte zowel een Standard logic app-project als een aangepast functions-codeproject bevat, hebben beide implementatiescripts gegenereerd, maar aangepaste codeprojecten worden momenteel genegeerd. De mogelijkheid om build-pijplijnen voor aangepaste code te maken, staat op de roadmap.

  • De extensie maakt pijplijnen voor infrastructuurimplementatie, continue integratie (CI) en continue implementatie (CD). U bent echter verantwoordelijk voor het verbinden van de pijplijnen met Azure DevOps en het maken van de relevante triggers.

  • Momenteel ondersteunt de extensie alleen Azure Resource Management-sjablonen (ARM-sjablonen) voor infrastructuurimplementatiescripts. Andere sjablonen zijn in planning.

Vereisten

Een logische app-werkruimte, -project en -werkstroom maken

  1. Selecteer in Visual Studio Code op de activiteitenbalk het Azure-pictogram.

  2. Open in het Azure-venster op de werkbalk Werkruimte het menu Azure Logic Apps en selecteer Nieuwe werkruimte voor logische apps maken.

    Schermopname van Visual Studio Code, Azure-pictogram geselecteerd in het linkermenu, de sectie Werkruimte en de geselecteerde optie voor het maken van een nieuwe werkruimte voor logische apps.

  3. Volg de aanwijzingen om de volgende taken uit te voeren:

    1. Selecteer de map om uw werkruimte te maken.

    2. Voer de naam van uw werkruimte in.

    3. Selecteer het projecttype: Logische app

    4. Voer de naam van uw logische app-project in.

    5. Selecteer de werkstroomsjabloon. Voer de naam van uw werkstroom in.

    6. Selecteer of u uw werkruimte wilt openen in het huidige Visual Studio Code-venster of een nieuw venster.

      Visual Studio Code toont uw nieuwe werkruimte- en logische app-project.

  4. Volg deze stappen om de werkstroomontwerper te openen:

    1. Vouw in uw logische app-project de map uit met de naam van uw werkstroom.

    2. Als dit nog niet is geopend, opent u het workflow.json bestand, opent u het snelmenu van het bestand en selecteert u Designer openen.

    3. Wanneer u wordt gevraagd om parameters toe te staan voor verbindingen wanneer uw project wordt geladen, selecteert u Ja.

      Met deze selectie kan uw project parameters gebruiken in verbindingsdefinities, zodat u de build en implementatie voor verschillende omgevingen kunt automatiseren.

    4. Volg de aanwijzingen om deze items te selecteren:

      • Connectors van Azure gebruiken

        Notitie

        Als u deze stap overslaat, kunt u alleen de ingebouwde connectors gebruiken die door runtime worden gehost. Voer de volgende stappen uit om de door Microsoft beheerde, door Azure gehoste connectors op een later tijdstip in te schakelen:

        1. Open het snelmenu voor het workflow.json-bestand en selecteer Connectors gebruiken in Azure.

        2. Selecteer een bestaande Azure-resourcegroep die u wilt gebruiken voor uw logische app.

        3. Laad de werkstroomontwerper opnieuw.

      • De bestaande Azure-resourcegroep die u wilt gebruiken voor uw logische app

  5. Wanneer u klaar bent, laadt u de werkstroomontwerper opnieuw. Meld u aan bij Azure als u hierom wordt gevraagd.

    Schermopname van Visual Studio Code, explorer-pictogram geselecteerd in het linkermenu, het project van de logische app en de werkstroomontwerper.

U kunt de werkstroom nu op elke gewenste manier bewerken en uw werkstroom lokaal testen. Zie Standard-werkstromen maken met Visual Studio Code om een voorbeeldwerkstroom te maken en te testen.

Implementatiescripts genereren

Nadat u uw werkstroom hebt gemaakt en lokaal hebt getest, maakt u uw implementatiescripts.

  1. Open in het lege gebied onder al uw projectbestanden het snelmenu van uw project en selecteer Implementatiescripts genereren.

    Schermopname van Visual Studio Code, explorer-pictogram geselecteerd in het linkermenu, het logische app-project, het snelmenu voor het geopende projectvenster en de geselecteerde optie voor het genereren van implementatiescripts.

  2. Volg de aanwijzingen om deze stappen uit te voeren:

    1. Selecteer de bestaande Azure-resourcegroep die u wilt gebruiken voor uw logische app.

    2. Voer een unieke naam in voor uw logische app-resource.

    3. Voer een unieke naam in voor uw opslagaccountresource.

    4. Voer een unieke naam in die u voor uw App Service-plan wilt gebruiken.

    5. Selecteer de werkruimtemap waarin u de bestanden wilt genereren.

      Locatie van implementatiemap Beschrijving
      Nieuwe implementatiemap (standaard) Maak een nieuwe map in de huidige werkruimte.
      Een andere map kiezen Selecteer een andere map in de huidige werkruimte.

    Wanneer u klaar bent, maakt Visual Studio Code een map met de naam deployment/{logic-app-name} in de hoofdmap van uw werkruimte. In deze map wordt dezelfde logische app-naam gebruikt die u in deze stappen hebt opgegeven.

    Notitie

    De waarden van variabelen, app-instellingen en parameters in de volgende bestanden worden vooraf ingevuld op basis van de invoer die u in deze stappen hebt opgegeven. Wanneer u zich op een andere omgeving richt, moet u ervoor zorgen dat u de waarden voor de gemaakte parameters en variabele bestanden bijwerkt.

    Schermopname van Visual Studio Code, explorer-pictogram geselecteerd in het linkermenu, het logische app-project en de gemarkeerde map met implementatiescripts met inhoud.

    Onder de map {logic-app-name} hebt u de volgende structuur:

    Mapnaam Bestandsnaam en beschrijving
    ADOPipelineScripts - CD-pipeline.yml: De pijplijn voor continue levering die de instructies bevat voor het implementeren van de code van de logische app in de resource van de logische app in Azure.

    - CD-pipeline-variables.yml: een YAML-bestand dat de variabelen bevat die door het CD-pipeline.yml-bestand worden gebruikt.

    - CI-pipeline.yml: de pijplijn voor continue integratie die de instructies bevat voor het bouwen en genereren van de artefacten die nodig zijn om de logische app-resource in Azure te implementeren.

    - CI-pipeline-variables.yml: een YAML-bestand dat de variabelen bevat die worden gebruikt door het CI-pipeline.yml-bestand.

    - infrastructure-pipeline.yml: een YAML-pijplijn 'Infrastructuur als code' die de instructies bevat voor het laden van alle ARM-sjablonen in Azure en het uitvoeren van de stappen in het infrastructure-pipeline-template.yml-bestand.

    - infrastructure-pipeline-template.yml: een YAML-pijplijnbestand met de stappen voor het implementeren van een logische app-resource met alle vereiste afhankelijkheden en voor het implementeren van elke beheerde verbinding die is vereist door de broncode.

    - infrastructure-pipeline-variables.yml: een YAML-pijplijn die alle variabelen bevat die nodig zijn om de stappen in het infrastructure-pipeline-template.yml-bestand uit te voeren.
    ArmTemplates - {connection-type}.parameters.json: een Resource Manager-parameterbestand dat de parameters bevat die nodig zijn voor het implementeren van een door Azure gehoste verbinding met de naam {connection-type} in Azure. Dit bestand bestaat voor elke door Azure gehoste verbinding in uw werkstroom.

    - {connection-type}.template.json: een Resource Manager-sjabloonbestand dat een door Azure gehoste verbinding vertegenwoordigt met de naam {connection-reference} en bevat de informatie die wordt gebruikt om de bijbehorende verbindingsresource in Azure te implementeren. Dit bestand bestaat voor elke door Azure gehoste verbinding in uw werkstroom.

    - {logic-app-name}.parameters.json: een Resource Manager-parameterbestand met de parameters die nodig zijn om de resource voor de logische standaard-app met de naam {logic-app-name} te implementeren in Azure, inclusief alle afhankelijkheden.

    - {logic-app-name}.template.json: een Resource Manager-sjabloonbestand dat de resource van de standaard logische app vertegenwoordigt met de naam {logic-app-name} en de informatie bevat die wordt gebruikt voor het implementeren van de logische app-resource in Azure.
    WorkflowParameters parameters.json: Dit JSON-bestand is een kopie van het lokale parameterbestand en bevat een kopie van alle door de gebruiker gedefinieerde parameters plus de cloudversie van parameters die door de extensie zijn gemaakt om door Azure gehoste verbindingen te parameteriseren. Dit bestand wordt gebruikt om het pakket te bouwen dat in Azure wordt geïmplementeerd.

Uw werkruimte verbinden met uw Git-opslagplaats

  1. Volg deze stappen om uw opslagplaats te initialiseren:

    1. Selecteer in Visual Studio Code op de activiteitenbalk het pictogram Broncodebeheer .

    2. Selecteer Opslagplaats initialiseren in het venster Broncodebeheer.

    3. Selecteer Map kiezen in het promptmenu. Selecteer de hoofdmap van de werkruimte en selecteer vervolgens Opslagplaats initialiseren.

      Schermopname van Visual Studio Code, het venster Broncodebeheer en de geselecteerde optie met de naam Initialize Repository.

    4. Selecteer Opslagplaats openen in het venster Broncodebeheer.

    5. Selecteer in het promptmenu de opslagplaats die u zojuist hebt gemaakt.

    Zie Visual Studio Code- Initialiseer een opslagplaats in een lokale map voor meer informatie.

  2. Volg deze stappen om de URL voor uw Git-opslagplaats op te halen, zodat u een externe opslagplaats kunt toevoegen:

    1. Open in Azure DevOps het teamproject voor uw Azure DevOps-organisatie.

    2. Vouw in het linkermenu Opslagplaatsen uit en selecteer Bestanden.

    3. Selecteer Klonen op de werkbalk van het deelvenster Bestanden.

      Schermopname van het Azure DevOps-teamproject, de Git-opslagplaats en de geselecteerde optie Clone.

    4. Kopieer in het venster Opslagplaats klonen de HTTPS-versie van de URL van de kloon.

      Zie De kloon-URL voor uw Git-opslagplaats ophalen in Azure-opslagplaatsen voor meer informatie.

  3. Volg deze stappen om een externe opslagplaats toe te voegen voor uw Git-opslagplaats:

    1. Ga terug naar Visual Studio Code en naar het venster Broncodebeheer .

    2. Open onder Opslagplaatsen voor broncodebeheer op de werkbalk van uw opslagplaats het menu met weglatingstekens (...) en selecteer Externe toevoegen.>

      Schermopname van Visual Studio Code, broncodebeheervenster en geselecteerde optie met de naam Externe toevoegen.

  4. Plak bij de prompt de gekopieerde URL en voer een naam in voor de externe, meestal oorspronkelijke naam.

    U hebt nu een verbinding gemaakt tussen Visual Studio Code en uw opslagplaats.

  5. Voordat u de pijplijnen in de volgende sectie instelt, opent u het CD-pipeline.yml-bestand en wijzigt u de naam van de CI-pijplijn in het kenmerk zodat deze source overeenkomt met de naam van de CI-pijplijn die u wilt gebruiken.

    Schermopname van Visual Studio Code, venster Broncodebeheer, geopend CD-pipeline.yml bestand en gemarkeerd bronveld voor CI-pijplijnnaam.

  6. Voer uw wijzigingen door in het venster Broncodebeheer en publiceer ze naar de opslagplaats.

    Zie Fase- en doorvoercodewijzigingen voor meer informatie.

Pijplijnen maken in Azure DevOps

Als u de infrastructuur samen met de CI- en CD-pijplijnen in Azure DevOps wilt maken, herhaalt u de volgende stappen voor elk van de volgende pijplijnbestanden:

  • infrastructure-pipeline.yml voor de pijplijn Infrastructure-as-Code.
  • CI-pipeline.yml voor de pijplijn voor continue integratie.
  • CD-pipeline.yml voor de pijplijn continue levering.

Een pijplijn instellen

  1. Ga in Azure DevOps terug naar uw teamproject en naar het deelvenster Opslagplaatsbestanden>.

  2. Selecteer Build instellen in het deelvenster Bestanden.

    Schermopname van het Azure DevOps-teamproject, de Git-opslagplaats en de geselecteerde optie met de naam Build instellen.

  3. Bevestig in het deelvenster Inventaris uw pijplijn de gegevens van de opslagplaats en selecteer Pijplijn configureren.

    Schermopname van de pagina Inventaris met opslagplaatsgegevens voor uw pijplijn.

  4. Selecteer in het deelvenster Uw pijplijn configureren het YAML-bestand bestaande Azure Pipelines.

    Schermopname van de pagina Configureren voor het selecteren van een pijplijntype.

  5. Voer in het deelvenster Een bestaand YAML-bestand selecteren de volgende stappen uit om uw Infrastructure-pipeline.yml-bestand te selecteren:

    1. Selecteer voor Branch de vertakking waarin u uw wijzigingen hebt doorgevoerd, bijvoorbeeld hoofd- of releasebranch.

    2. Selecteer voor Pad het pad dat u voor uw pijplijn wilt gebruiken. Het volgende pad is de standaardwaarde:

      deployment/{logic-app-name}/ADOPipelineScripts/{infrastructure-pipeline-name}.yml

    3. Wanneer u klaar bent, selecteert u Doorgaan.

      Schermopname van het deelvenster voor Een bestaand YAML-bestand selecteren.

  6. Selecteer Pijplijn controleren in het deelvenster Uw pijplijn configureren.

  7. Geef in het deelvenster Uw beheerde pijplijn controleren de volgende informatie op:

    • Pijplijnnaam: Voer een naam in voor de pijplijn.
    • Pijplijnmap: Selecteer de map voor de locatie waar u uw pijplijn wilt opslaan, die de naam ./deployment/{logic-app-name}/pipelines heeft.

  8. Selecteer Opslaan als u klaar bent.

    Schermopname van het deelvenster Met de naam Beheerde pijplijn controleren.

Pijplijn weergeven en uitvoeren

Voer de volgende stappen uit om uw pijplijn te zoeken en uit te voeren:

  1. Vouw pijplijnen uit in het linkermenu van uw teamproject en selecteer Pijplijnen.

  2. Selecteer het tabblad Alles om alle beschikbare pijplijnen weer te geven. Zoek en selecteer uw pijplijn.

  3. Selecteer Pijplijn uitvoeren op de werkbalk van uw pijplijn.

    Schermopname van het deelvenster voor de gemaakte pijplijn en de geselecteerde optie voor Pijplijn uitvoeren.

Zie Uw eerste pijplijn maken voor meer informatie.

Zie ook