ALM paātrinātāja konveijeru konfigurēšana
Cauruļvadi ir ALM paātrinātāja dzinēji. Viņi automatizē ALM procesu Power Platform. Tie ir veidoti, izmantojot Azure cauruļvadus, kas ir projekta pakalpojums Azure DevOps, un tiek glabāti Azure DevOps projektā.
ALM procesa automatizēšanai tiek izmantoti četri galvenie cauruļvadi:
- Import
- Eksportēšana
- Delete
- Būvēšana/izvietošana
Cauruļvadi ir paredzēti lietošanai ar ALM Accelerator audekla lietotni. Jums nav jāizmanto lietotne, taču mēs to iesakām. Lietotne nodrošina vienkāršu saskarni konveijeru izsaukšanai un veidu, kā tos konfigurēt, nesaprotot pamatā esošos parametrus.
Bieži sastopamie ALM paātrinātāja konveijera scenāriji
ALM Accelerator konveijeriem un lietotnei ir noklusējuma konfigurācijas, kas ļauj ātri sākt darbu ar ALM for Power Platform. Konveijeri var aptvert daudzus dažādus ALM scenārijus, lai tie atbilstu jūsu organizācijas prasībām. Nākamajās sadaļās ir aprakstīti daži bieži sastopami scenāriji un tas, kā tos var aptvert, izmantojot konveijera konfigurāciju, izvietošanas profilus un darbības ALM paātrinātāja programmā vai tieši konveijerā.
Konveijeru instalēšana vienā projektā un pirmkoda instalēšana citā projektā
Programmā ALM Accelerator un izvietošanas profilos varat norādīt konveijera projektu un avota projektu. Iestatīšanas vedņa opcija ļauj norādīt atsevišķu konveijera projektu un repo. Šīs opcijas ir noderīgas, ja vēlaties segments tādu risinājumu glabāšanu, kuru pamatā ir lietotāji, korporatīvā struktūra vai citi faktori. Vairumā gadījumu konveijera YAML faili tiek glabāti konveijera projektā, un eksportēšanas, importēšanas un dzēšanas konveijeri tiek izveidoti projektā, kurā risinājums tiek kontrolēts no avota.
Palaidiet cauruļvadus bez ALM paātrinātāja
ALM Accelerator audekla lietotne nodrošina vienkāršu pogu slānis cauruļvadu darbināšanai. Tomēr jums nav nepieciešama programma, lai tos palaistu. Ja vēlaties izmantot no programmas neatkarīgus konveijerus, palaidiet tos tieši no komandrindas. Varat arī izveidot savu lietotni. Izmantojiet pielāgotu savienotāju Azure DevOps API, kas iekļauts ALM paātrinātāja risinājumā, lai izsauktu konveijerus, kas izmanto Power Automate vai citas Power Platform tehnoloģijas.
Jebkurā gadījumā, ja vēlaties izmantot cauruļvadus neatkarīgi, galvenais ir saprast parametrus, kas tiem tiek nodoti.
Cauruļvada parametri
Parametri import-unmanaged-to-dev-environment:Izmantojiet importēšanas risinājumu konveijeru, lai importētu nepārvaldītu risinājumu no avota vadīklas izstrādes vidē.
Tālāk esošajā tabulā ir aprakstīti importēšanas konveijera parametri.
| Parametrs | Piemērs | Apraksts |
|---|---|---|
| Project | Mans Azure DevOps projekts | Tā projekta nosaukums, kurā importēt risinājumu |
| Repo | Mans Azure DevOps Repo | Tā repozitorija nosaukums, no kura importēt risinājumu |
| SolutionName | MySolutionName | Importējamā risinājuma nosaukums |
| E-pasta adrese | me@example.com | Tā lietotāja e-pasta adrese, kurš importē risinājumu |
| UserName | Last, First | Tā lietotāja vārds, kurš importē risinājumu |
| Zars | main | Zars, kur būvēt risinājumu un no kura importēt |
| ServiceConnectionName | MyServiceConnection | Importēšanai izmantojamā pakalpojuma savienojuma nosaukums |
| ServiceConnectionUrl | example.crm.dynamics.com | Importēšanas veidotāja vides vietrādis URL |
| EnvironmentName | MyDevEnvironment | Tiek izmantota, lai atrastu izvietošanas iestatījumus izvietošanas konveijers; atgriež mapes nosaukumu risinājuma avota konfigurācijas direktorijā |
Parametri dzēšanai-nepārvaldītam-risinājumam un-komponentiem:Izmantojiet dzēšanas risinājumu konveijeru, lai izdzēstu nepārvaldītu risinājumu un visus tā komponentus no izstrādes vides.
Tālāk esošajā tabulā ir aprakstīti dzēšanas konveijera parametri.
| Parametrs | Piemērs | Apraksts |
|---|---|---|
| SolutionName | MySolutionName | Dzēšamā risinājuma nosaukums |
| ServiceConnectionName | MyServiceConnection | Dzēšanai paredzētajam risinājumam izmantojamā pakalpojuma savienojuma nosaukums |
| ServiceConnectionUrl | example.crm.dynamics.com | Dzēšamā risinājuma veidotāja vides vietrādis URL |
Parametri eksportam-solution-to-git:Izmantojiet eksporta risinājumu konveijeru, lai eksportētu risinājumu uz Git repozitoriju.
Tālāk esošajā tabulā ir aprakstīti eksportēšanas konveijera parametri.
| Parametrs | Piemērs | Apraksts |
|---|---|---|
| Project | Mans Azure DevOps projekts | Tā projekta nosaukums, uz kuru eksportēt risinājuma avota kodu |
| Repo | Mans Azure DevOps Repo | Tā repozitorija nosaukums, uz kuru eksportēt risinājuma avota kodu |
| SolutionName | MySolutionName | Eksportējamā risinājuma nosaukums |
| E-pasta adrese | me@example.com | Tā lietotāja e-pasta adrese, kurš eksportē risinājumu |
| UserName | Last, First | Tā lietotāja vārds, kurš eksportē risinājumu |
| CommitMessage | Labo #1234 kļūdu | To izmaiņu apraksts, kas repozitorijā tiek glabātas izpildei |
| Zars | main | Vai nu avota zars, no kura izveidot filiāli, vai esošais zars, no kura apņemties |
| BranchToCreate | feature-1234 | Jaunas filiāles unikālais nosaukums, kas jāizveido, pamatojoties uz Branch parametru, ja nepieciešams |
| ServiceConnectionName | MyServiceConnection | Risinājuma eksportēšanai izmantojamā pakalpojuma savienojuma nosaukums |
| ServiceConnectionUrl | example.crm.dynamics.com | Tās veidotāja vides vietrādis URL, kurā pastāv eksportējamais nepārvaldītais risinājums |
| Dati | [Izvietošanas iestatījumu JSON] | JSON virkne, kas satur izvietošanas iestatījumus , ko izmantot izvietošanas konveijeru eksportēšanai un konfigurēšanai |
| PortalSiteName | MyPortalSite | Ar eksportējamo risinājumu saistītās Power Pages vietnes nosaukums |
Risinājumu versiju pielāgošana, izmantojot ALM Accelerator konveijerus, lai tos eksportētu vai izvietotu
Pēc noklusējuma eksportētie un izvietotie risinājumi tiek piedāvāti, izmantojot nosaukumu, kas norādīts izvietošanas konveijers YAML failā. Tomēr ALM Accelerator konveijeri ļauj pielāgot risinājuma versiju izveidi, kad to eksportējat vai izvietojat. Nākamajās sadaļās ir aprakstītas metodes, kuras varat izmantot.
Eksportētās versijas
Izmantojiet konveijeru eksportēto versijas numuru kā versijas numuru visās izvietotajās vidēs. Izveidojiet mainīgo ar nosaukumu UseSolutionVersionFromDataverse savā eksporta konveijerā vai globālo mainīgo ALM paātrinātāja mainīgo bibliotēkā. Piešķiriet tai vērtību Patiess. Mainīgais nodrošina, ka risinājumā eksportētais versijas numurs tiek saglabāts pakārtotajās vidēs un tiek atspoguļots avota vadīklā, kad tiek izdarīts risinājuma avots.
Pielāgota versiju izveides loģika
Izmantojiet ALM Accelerator āķus, lai iestatītu risinājuma versiju. Pievienojiet veidnei savu pielāgoto loģiku, build-solution-pack-pre-hook.yml lai tieši manipulētu Solution.xml ar to vai izmantojot citus rīkus, piemēram , PAC risinājuma versiju.
Pielāgota savu veidņu versiju izveide
Iespēja atnest savas veidnes izvietošanas konveijeru ģenerēšanai nodrošina versiju izveides elastību risinājuma sākotnējās eksportēšanas laikā. Piemēram, izveidojiet a build-deploy-validation/test/prod-SampleSolution.yml kopiju un mainiet būvējuma nosaukumu no noklusējuma uz versiju izveides stratēģiju, pamatojoties uz izpildes vai būvējuma numuru konfigurēšanu:
build:
- name: 1.0.$(Date:yyyyMMdd)$(Rev:.r)
...
Kad veidnes ir ieviestas, atjauniniet izvietošanas darbības savā izvietošanas profilā, lai norādītu uz tām.
Pielāgojiet izvietošanas darbību skaitu konveijeros un mērķa vižu nosaukumus
Līdzīgi kā pielāgota versiju izveide ar veidnēm, iespēja atnest savas veidnes izvietošanas konveijeru ģenerēšanai nodrošina lielāku elastību risinājuma sākotnējās eksportēšanas laikā. Norādiet projektu, kurā pastāv jūsu veidnes, un ceļu uz veidni, kas jāizmanto izvietošanas konveijers ģenerēšanai. Projekta un ceļa iestatījumi atrodas izvietošanas profilā un tabulā Izvietošanas soļi ALM paātrinātāja administrēšanas programmā.
Ceļš uz veidni ir relatīvs attiecībā pret eksportēšanas konveijera atrašanās vietas sakni. Piemēram, ceļš uz noklusējuma validācijas vidi izvietošanas konveijers veidnēm ir /Pipelines/build-deploy-validation-SampleSolution.yml. Lai izmantotu veidni tajā pašā projektā, kur eksporta konveijers, norādiet ceļu kā /Pipelines/build-deploy-validation-MyCustomTemplate.yml.
Nākamajā tabulā ir aprakstīti vietturi veidnēs risinājumam specifiskām vērtībām, kas tiek aizstātas, ģenerējot izvietošanas konveijers.
| Vietturis | Apraksts |
|---|---|
| SampleSolutionName | Izvietojamā risinājuma nosaukums |
| RepositoryContainingTheBuildTemplates | Repozitorijs, kurā ir būvējuma veidnes, ko izmantot izvietošanas konveijeram |
| BranchContainingTheBuildTemplates | Zars, kurā ir būvējuma veidnes, ko izmantot izvietošanas konveijeram |
| alm-paātrinātājs-mainīgais-grupa | Globālā mainīgo grupa, ko būvējuma veidnes izmanto izvietošanas konveijers |
Ieteicams kopēt konveijera build-deploy-validation/test/prod-SampleSolution.yml veidni, lai sāktu darbu ar savu pielāgoto veidni.
Veiciet pielāgotas darbības savos konveijeros, nemodificējot noklusējuma veidnes
ALM paātrinātāja konveijera veidnēm ir vairāki paplašinājuma punkti jeb āķi, kurus varat izmantot, lai pielāgotu konveijerus, vienlaikus samazinot troksni, ko rada sapludināšanas konflikti jaunināšanas scenārijos. Uzziniet vairāk par ALM Accelerator āķiem.
Konkrētu darbību ieslēgšana vai izslēgšana konveijeros
Konveijeros tiek izmantoti mainīgie, lai noteiktu, vai uzdevums ir jāizpilda vai kurš uzdevums no vairākām iespējām ir jāizpilda. Šajā tabulā ir aprakstīti mainīgie, kurus var iestatīt atsevišķam konveijeram vai, izmantojot alm-paātrinātāja-mainīgo-grupu, visiem konveijeriem.
Piezīmes
Lai iestatītu šos mainīgos konkrētiem eksportēšanas risinājumiem, izveidojiet īpašu eksporta konveijeru, kura pamatā ir eksporta konveijera veidne. Nosauciet to export-solution-to-git-{SolutionName}. ALM Accelerator lietotne risinājumam izmanto šo eksporta konveijeru, nevis vispārējas nozīmes eksporta-risinājuma-git konveijeru.
| Mainīgais | Noklusējuma vērtība | Cauruļvadi | Apraksts |
|---|---|---|---|
| GenerateDeploymentSettings | Patiess | Eksportēšana | Ja tie ir aplami, izvietošanas iestatījumi netiek ģenerēti un saglabāti avota vadīklā. |
| UseDeploymentSettingsPlaceholders | Patiess | Eksportēšana | Ja izvietošanas iestatījumi ir aplami, tie neizmanto vietturus, un visas izvietošanas iestatījumu vērtības tiek saglabātas failos deploymentSettings.json un customDeploymentSettings.json failos.SVARĪGI: izvietošanas iestatījumos sensitīva informācija var tikt saglabāta vienkāršā tekstā. Visi lietotāji, kuriem ir piekļuve avota vadībai, var lasīt šīs vērtības. Uzmanieties, ja iestatāt šī mainīgā vērtību. |
| DisableFlows | Nepatiess | Eksportēšana | Ja tā ir patiesa, visas plūsmas tiek izslēgtas neiesaiņotajā pirmkodā pirms saistību veikšanas. |
| UseSolutionVersionFromDataverse | Nepatiess | Eksportēšana | Ja tā ir patiesa, jūsu risinājumā eksportētais versijas numurs tiek saglabāts pakārtotās vidēs. Versijas numurs tiek atspoguļots avota vadīklā, kad tiek izdarīts risinājuma avots. |
| DoNotExportCurrentEnvironmentVariableValues | Nepatiess | Eksportēšana | Ja tā ir patiesa, mainīgās vērtības pašreizējai videi tiek noņemtas no neiesaiņotā risinājuma avota koda. |
| PublishCustomizationsBeforeExport | Patiess | Eksportēšana | Ja pielāgojumi ir aplami, tie netiek publicēti pirms risinājuma eksportēšanas. Šī opcija ir noderīga, ja strādājat koplietojamā vidē un vēlaties eksportēt tikai jaunākos publicētos pielāgojumus. |
| CacheEnabled | Patiess | Eksportēšana/izvietošana | Ja tas ir nepatiess, PowerShell moduļu kešatmiņa ir atspējota. Šī opcija ir noderīga, ja jūsu cauruļvadi veic kešatmiņas direktorija tīrīšanu pēc konveijeru izpildes. |
| ProcessCanvasApps | Patiess | Eksportēšana/izvietošana | Ja audekls ir aplams, eksportēšanas laikā audekla programmas netiek izpakotas vai iepakotas būvējumu laikā. PIEZĪME: Kanvas izpakošanas un iepakošanas funkcionalitāte pašlaik ir priekšskatījums. Pašlaik to nav ieteicams izmantot ražošanas vidēs. Tomēr avota vadīklā nevar skatīt kanvas pirmkodu, ja vien šis mainīgais nav iestatīts uz Patiess. |
| DisableSolutionChecker | Nepatiess | Izvietot | Ja tā ir taisnība, risinājumu pārbaudītājs nedarbojas katram būvējumam, kas tiek uzsākts, izmantojot vilkšanas pieprasījumu. |
| SkipSolutionImport | Nepatiess | Izvietot | Ja tā ir patiesa, risinājuma importēšanas solis izvietošanas laikā tiek izlaista. Tomēr joprojām tiek veiktas citas darbības, piemēram, plūsmas aktivizēšana un koplietošana. |