Konfigurere ALM Accelerator-pipelines
Pipelines er ALM Accelerators maskiner. De automatiserer ALM-processen for Power Platform. De er bygget ved hjælp af Azure-pipelines, en tjeneste til Azure DevOps og gemt i et Azure DevOps-projekt.
Der bruges fire hovedpipelines til at automatisere ALM-processen:
- Import
- Export
- Delete
- Opbyg/installer
Pipelinerne er udviklet til brug sammen med appen ALM Accelerator. Du behøver ikke at bruge appen, men vi anbefaler den. Appen indeholder en enkel brugergrænseflade til aktivering af pipelines og en måde at konfigurere dem på uden at skulle forstå de underliggende parametre.
Almindelige scenarier for ALM Accelerator-pipeline
ALM Accelerator-pipelines og -app har standardkonfigurationer, der giver dig mulighed for at komme hurtigt i gang med ALM til Power Platform. Pipelinerne kan dække over mange forskellige ALM-scenarier, så de lever op til din organisations behov. Her følger en beskrivelse af nogle almindelige scenarier, og hvordan de kan dækkes via konfigurationen af pipelines og de relaterede udrulningsprofiler og trin i ALM Accelerator-appen eller via pipelinen direkte.
Installation af pipelines i ét projekt og én kildekode i et andet projekt
Fra ALM Accelerator-appen og i udrulningsprofilerne er det nu muligt at angive et pipelineprojekt ud over kildeprojektet. En funktion i installationsguiden giver mulighed for separat at angive et separat pipelineprojekt og et repo. Disse muligheder er nyttige, hvis du vil segmentere lagringen af løsninger baseret på brugere, virksomhedsstruktur eller andre faktorer. I de fleste tilfælde gemmes pipeline-YAML-filerne i pipelineprojektet, og eksport-, import- og sletningspipelines oprettes i det projekt, hvor løsningen er kildekontrolleret.
Kør pipelinerne uden ALM Accelerator
ALM Accelerator-lærredsappen er et let knaplag til kørsel af pipelines. Du behøver dog ikke appen for at køre dem. Hvis du vil bruge pipelines uafhængigt af appen, skal du køre dem direkte fra kommandolinjen. Du kan også bygge din egen app. Brug en brugerdefineret connector til Azure DevOps API, der er inkluderet i ALM Accelerator-løsningen for at aktivere pipelines via Power Automate eller andre Power Platform-teknologier.
I alle tilfælde kan du bruge pipelines uafhængigt, og det er vigtigt at forstå de parametre, der overføres til dem.
Pipelineparametre
Parametre for import-ikke-administreret-til-udviklingsmiljø: Brug importløsningspipelinen til at importere en ikke-administreret løsning fra kildekontrolelementet til et udviklingsmiljø.
Følgende tabel beskriver import af pipeline-parametre.
| Parameter | Eksempel | Beskrivelse |
|---|---|---|
| Project | Mine Azure DevOps-projekter | Navnet på det projekt, løsningen skal importeres til |
| Lager | Mit Azure DevOps repo | Navnet på det lager, løsningen skal importeres fra |
| Løsningsnavn | MySolutionName | Navnet på den løsning, der skal importeres |
| me@example.com | Den brugers mailadresse, der importerer løsningen | |
| UserName | Sidst, Først | Brugernavnet på den bruger, der importerer løsningen |
| Gren | hoved | Den gren, der skal bygge løsningen og importere fra |
| ServiceConnectionName | MyServiceConnection | Navnet på tjenesteforbindelsen, der skal bruges til import |
| ServiceConnectionUrl | example.crm.dynamics.com | URL-adressen til udviklermiljøet for importen |
| EnvironmentName | MyDevEnvironment | Bruges til at finde installationsindstillingerne i installationspipelinen. Returnerer et mappenavn under konfigurationsmappen i løsningskilden |
Parametre for sletning-ikke-administreret løsning-og-komponenter: Brug pipelinen til at slette en ikke-administreret løsning og alle dens komponenter fra et udviklingsmiljø.
Følgende tabel beskriver sletning af pipeline-parametre.
| Parameter | Eksempel | Beskrivelse |
|---|---|---|
| Løsningsnavn | MySolutionName | Navnet på den løsning, der skal slettes |
| ServiceConnectionName | MyServiceConnection | Navnet på tjenesteforbindelsen, der skal bruges til at slette løsningen |
| ServiceConnectionUrl | example.crm.dynamics.com | URL-adressen til udviklermiljøet for den løsning, der skal slettes |
Parametre for eksport-løsning-til-Git: Brug eksportløsningspipelinen til at eksportere løsningen til et Git-lager.
Følgende tabel beskriver eksport af pipeline-parametre.
| Parameter | Eksempel | Beskrivelse |
|---|---|---|
| Project | Mine Azure DevOps-projekter | Navnet på det projekt, løsningens kildekode skal eksporteres til |
| Lager | Mit Azure DevOps repo | Navnet på det lager, løsningens kildekode skal eksporteres til |
| Løsningsnavn | MySolutionName | Navnet på den løsning, der skal eksporteres |
| me@example.com | Den brugers mailadresse, der eksportere løsningen | |
| UserName | Sidst, Først | Brugernavnet på den bruger, der eksporterer løsningen |
| CommitMessage | Fejlrettelser #1234 Bug | En beskrivelse af de ændringer, der skal gemmes i bekræftelsen i lager |
| Gren | hoved | Det er enten den kildegren, som en gren skal oprettes fra, eller den eksisterende gren, der skal oprettes til |
| BranchToCreate | funktion-1234 | Det entydige navn på en ny gren, der skal oprettes, baseret på parameteren Branch, hvis det er nødvendigt |
| ServiceConnectionName | MyServiceConnection | Navnet på tjenesteforbindelsen, der skal bruges til løsningseksport |
| ServiceConnectionUrl | example.crm.dynamics.com | URL-adressen til udviklermiljøet, hvor den ikke-administrerede løsning skal eksporteres til, findes |
| Data | [Installationsindstillinger JSON] | En JSON-streng, der indeholder de udrulningsindstillinger, der skal bruges til eksport og konfiguration af udrulningspipelines |
| PortalSiteName | MyPortalSite | Navnet på det Power Pages-websted, der er knyttet til den løsning, som skal eksporteres |
Tilpasse versioner af løsninger, når du bruger ALM Accelerator-pipelines til eksport eller udrulning
Eksporterede og udrullede løsninger versioneres som standard ved hjælp af det navn, der er angivet i installationspipelinen, YAML-filen. Men ALM Accelerator-pipelines tillader, at du tilpasser versionen af løsningen, når du eksporterer eller udruller løsningen. Metoderne beskrives i følgende sektioner.
Eksporterede versioner
Brug det versionsnummer, der eksporteres af pipelines, som versionsnummer i alle installerede miljøer. Opret en variabel ved navn UseSolutionVersionFromDataverse i eksportpipelinen eller en global variabel i variabelbiblioteket for ALM Accelerator. Giv den værdien Sand. Variablen sikrer, at det versionsnummer, der eksporteres i din løsning, bevares i downstreammiljøer og også afspejles i dit kildekontrolelement, når løsningskilden anvendes.
Brugerdefineret versionslogik
Brug ALM Accelerator-løsninger til at angive versionen af løsningen. Føj din brugerdefinerede logik til build-solution-pack-pre-hook.yml-skabelonen for at manipulere den Solution.xml direkte eller ved hjælp af andre værktøjer, f.eks. pac-versionen af løsningen.
Tilpas din egen skabelonversion
Muligheden for at medbringe dine egne skabeloner til oprettelse af udrulningspipelines giver fleksibilitet, når der oprettes udrulningspipelines under den første eksport af en løsning. Du kan f.eks. oprette en kopi af en build-deploy-validation/test/prod-SampleSolution.yml og ændre build-navnet fra standardnavnet til en versionsstrategi, der er baseret på konfiguration af kørsels- eller buildnumre:
build:
- name: 1.0.$(Date:yyyyMMdd)$(Rev:.r)
...
Når du har installeret skabelonerne, skal du opdatere installationstrinnene i installationsprofilen, så de peger på dem.
Tilpasse antallet af installationstrin i dine pipelines og navnene på destinationsmiljøerne
Tilsvarende giver brugerdefineret versionering med skabeloner muligheden for at medbringe dine egne skabeloner til oprettelse af udrulningspipelines fleksibilitet, når der oprettes udrulningspipelines under den første eksport af en løsning. Specificer projektet hvor din skabelon findes, og stien til den skabelon, der skal bruges til at oprette udrulningspipelines. Indstillingen for projektet og stien vises i tabellen Udrulningsprofil og Udrulningstrin i appen ALM Accelerator Administration.
Stien til skabelonen er relativ i forhold til roden af placeringen af eksportpipelinen. Stien til standardskabelonerne til udrulningspipeline for valideringsmiljøet er /Pipelines/build-deploy-validation-SampleSolution.yml. Hvis du vil bruge en skabelon i samme projekt som eksportpipelinen, skal du angive stien som /Pipelines/build-deploy-validation-MyCustomTemplate.yml.
Skabelonerne indeholder pladsholdere for følgende løsningsspecifikke værdier, der erstattes, når udrulningspipelinen oprettes.
| Pladsholder | Beskrivelse |
|---|---|
| SampleSolutionName | Navnet på den løsning, der skal udrulles |
| RepositoryContainingTheBuildTemplates | Det lager, der indeholder de buildskabeloner, der skal bruges til installationspipelinen |
| BranchContainingTheBuildTemplates | Den forgrening, der indeholder de buildskabeloner, der skal bruges til installationspipelinen |
| alm-accelerator-variable-group | Den globale variabelgruppe de buildskabeloner, der bruges til installationspipelinen |
Det anbefales, at du kopierer en build-deploy-validation/test/prod-SampleSolution.yml-pipelineskabelon for at komme i gang med din egen brugerdefinerede skabelon.
Udfør brugerdefinerede trin i pipelines uden at ændre standardskabelonerne
ALM Accelerator-pipelineskabeloner har flere udvidelsespunkter – også kaldet hooks – som du kan tilpasse til pipelines, samtidig med at du minimerer fletningskonflikter i opgraderingsscenarier. Få mere at vide om ALM Accelerator-kroge.
Slå bestemte handlinger i pipelines til eller fra
Pipelinerne bruger variabler til at bestemme, om en opgave skal udføres, eller hvilken opgave med flere muligheder der skal udføres. Her følger en liste over variabler, der enten kan indstilles på en enkelt pipeline eller via en alm-accelerator-variabelgruppe, som kan anvendes på alle pipelines.
Bemærk
Hvis du vil angive disse variabler for specifikke eksportløsninger, skal du oprette en bestemt eksportpipeline baseret på skabelonen til eksportpipeline. Navngiv det export-solution-to-git-{SolutionName}. ALM Accelerator-appen bruger denne eksportpipeline til din løsning i stedet for den generelle export-solution-to-git pipeline.
| Variabel | Standard | Pipeline(s) | Beskrivelse |
|---|---|---|---|
| GenerateDeploymentSettings | True | Export | Hvis falsk, oprettes og gemmes udrulningsindstillingerne ikke i kildekontrolelementet. |
| UseDeploymentSettingsPlaceholders | True | Export | Hvis falsk, bruger udrulningsindstillingerne ikke pladsholdere, og alle værdier for installationsindstillingerne gemmes i filerne deploymentSettings.json og customDeploymentSettings.json.VIGTIGT: Følsomme oplysninger kan gemmes i almindelig tekst i dine implementeringsindstillinger. Alle brugere med adgang til kildekontrolelementet kan læse disse værdier. Vær forsigtig, hvis du angiver en værdi for denne variabel. |
| DisableFlows | False | Export | Hvis sand, deaktiveres alle flows i kildekoden for den udpakkede løsning, inden der allokeres. |
| UseSolutionVersionFromDataverse | False | Export | Hvis det er tilfældet, bevares det versionsnummer, der eksporteres i løsningen, i downstreammiljøer. Versionsnummeret afspejles i kildekontrolelementet, når løsningskilden bruges. |
| DoNotExportCurrentEnvironmentVariableValues | False | Export | Hvis sand, fjernes de aktuelle miljøvariabelværdier fra kildekoden til den udpakkede løsning. |
| PublishCustomizationsBeforeExport | True | Export | Hvis falsk, publiceres tilpasningerne ikke, før løsningen eksporteres. Denne mulighed er praktisk, hvis du arbejder i et delt miljø og kun vil eksportere de senest publicerede tilpasninger. |
| CacheEnabled | True | Eksportér/udrul | Hvis false, er cachelagringen af PowerShell-moduler deaktiveret. Denne indstilling er nyttig, hvis dine pipelines udfører oprydning af cachemappen, når pipelinerne er udført. |
| ProcessCanvasApps | True | Eksportér/udrul | Hvis false, pakkes lærredsappene ikke ud under eksport eller på arbejde under builds. BEMÆRK: Funktionen til udpakning og pakning af lærred er i øjeblikket i forhåndsversion. Det anbefales ikke til brug i produktionsmiljøer i øjeblikket. Du kan dog ikke få vist lærreds kildekode i kildekontrolelementet, medmindre du angiver denne variabel til Sand. |
| DisableSolutionChecker | False | Installer | Hvis det er tilfældet, køres løsningskontrollen ikke på alle de builds, der er startet via en pullanmodning. |
| SkipSolutionImport | False | Installer | Hvis det er tilfældet, springes trinnet til løsningsimport over under installationen. Der udføres dog stadig andre aktiviteter, f.eks. flowaktivering og deling. |