ALM gyorsító folyamatok konfigurálása
A csővezetékek az ALM gyorsító motorjai. Automatizálják az ALM folyamatot Power Platform. Az Azure Pipelines használatával épülnek fel, amely egy projekt szolgáltatása Azure DevOps, és egy Azure DevOps projektben vannak tárolva.
Az ALM folyamat automatizálására négy fő csővezetéket használnak:
- Import
- Export
- Delete
- Build/üzembe helyezés
A folyamatok az ALM Accelerator vászonalkalmazással való használatra vannak tervezve. Nem kell használnia az alkalmazást, de javasoljuk. Az alkalmazás egyszerű felületet biztosít a folyamatok meghívásához, és lehetővé teszi azok konfigurálását anélkül, hogy meg kellene értenie a mögöttes paramétereket.
Gyakori ALM-gyorsító folyamatforgatókönyvek
Az ALM gyorsító folyamatok és alkalmazások alapértelmezett konfigurációi lehetővé teszik az ALM for gyors használatát Power Platform. A folyamatok számos különböző ALM-forgatókönyvet lefedhetnek, hogy megfeleljenek a szervezet követelményeinek. A következő szakaszok néhány gyakori forgatókönyvet ismertetnek, és azt, hogy ezek hogyan fedhetők le a folyamatkonfigurációval, az üzembe helyezési profilokkal és az ALM gyorsító alkalmazás lépéseivel vagy közvetlenül a folyamaton keresztül.
A folyamatok telepítése az egyik projektben és a forráskód telepítése egy másik projektben
Az ALM gyorsító alkalmazásban és az üzembe helyezési profilokban megadhat egy folyamatprojektet és egy forrásprojektet. A telepítővarázsló egyik beállításával külön folyamatprojektet és adattárat adhat meg. Ezek a beállítások akkor hasznosak, ha a megoldások tárolását felhasználók, vállalati struktúra vagy más tényezők alapján szeretné szegmentálni. A legtöbb esetben a folyamat YAML-fájljai a folyamatprojektben vannak tárolva, az exportálási, importálási és törlési folyamatok pedig abban a projektben jönnek létre, ahol a megoldás forrásvezérelt.
A folyamatok futtatása az ALM gyorsító nélkül
Az ALM Accelerator vászonalapú alkalmazás egyszerű gombréteget biztosít a folyamatok futtatásához. A futtatásukhoz azonban nincs szükség az alkalmazásra. Ha az alkalmazástól függetlenül szeretné használni a folyamatokat, futtassa őket közvetlenül a parancssorból. Saját alkalmazást is készíthet. Használjon egyéni összekötőt az Azure DevOps ALM gyorsító megoldásban található API-hoz a folyamatok meghívásához vagy más Power Automate technológiák használatával Power Platform .
Mindkét esetben, ha egymástól függetlenül szeretné használni a folyamatokat, a legfontosabb a nekik átadott paraméterek megértése.
Folyamat paraméterei
Az import-unmanaged-to-dev-environment paraméterei: Az importálási megoldási folyamat használatával importálhat egy nem felügyelt megoldást a verziókövetésből egy fejlesztési környezetbe.
Az alábbi táblázat az importálási folyamat paramétereit ismerteti.
| Paraméter | Példa | Description |
|---|---|---|
| Project | Saját Azure DevOps projekt | Annak a projektnek a neve, amelybe importálni kell a megoldást |
| Adattár | Saját Azure DevOps adattár | Annak az adattárnak a neve, amelyből importálni kell a megoldást |
| SolutionName | MySolutionName | Az importálni kívánt megoldás neve |
| me@example.com | A megoldást importáló felhasználó e-mail-címe | |
| UserName | Utónév, Vezetéknév | A megoldást importáló felhasználó neve |
| Elágazás | main | Az elágazás a megoldás buildeléséhez és importálásához |
| ServiceConnectionName | MyServiceConnection | Az importálásához használt szolgáltatáskapcsolat neve |
| ServiceConnectionUrl | example.crm.dynamics.com | Az importáláshoz használt készítői környezet URL-címe |
| EnvironmentName | MyDevEnvironment | Az üzembe helyezési folyamat üzembe helyezési beállításainak megkeresésére szolgál; Egy mappanevet ad vissza a megoldásforrás konfigurációs könyvtárában |
A delete-unmanaged-solution-and-components paraméterei: A megoldás törlési folyamatával törölhet egy nem felügyelt megoldást és annak összes összetevőjét egy fejlesztési környezetből.
Az alábbi táblázat a törlési folyamat paramétereit ismerteti.
| Paraméter | Példa | Description |
|---|---|---|
| SolutionName | MySolutionName | A törölni kívánt megoldás neve |
| ServiceConnectionName | MyServiceConnection | Az törölni kívánt megoldáshoz használt szolgáltatáskapcsolat neve |
| ServiceConnectionUrl | example.crm.dynamics.com | A törölni kívánt megoldás készítői környezetének URL-címe |
Az export-solution-to-git paraméterei: Az exportálási megoldási folyamat használatával exportálja a megoldást egy Git-adattárba.
Az alábbi táblázat az exportálási folyamat paramétereit ismerteti.
| Paraméter | Példa | Description |
|---|---|---|
| Project | Saját Azure DevOps projekt | Annak a projektnek a neve, amelybe exportálni kell a forráskódot |
| Adattár | Saját Azure DevOps adattár | Annak az adattárnak a neve, amelybe exportálni kell a forráskódot |
| SolutionName | MySolutionName | Az exportálni kívánt megoldás neve |
| me@example.com | A megoldást exportáló felhasználó e-mail-címe | |
| UserName | Utónév, Vezetéknév | A megoldást exportáló felhasználó neve |
| CommitMessage | Javít #1234 hibát | A véglegesítés során az adattárban tárolandó módosítások leírása |
| Elágazás | main | A forráság, amelyből ágat hoz létre, vagy a meglévő ág, amelyhez véglegesíteni kívánja a műveletet |
| BranchToCreate | feature-1234 | A paraméter alapján Branch létrehozandó új ág egyedi neve, ha szükséges |
| ServiceConnectionName | MyServiceConnection | A megoldás exportálásához használt szolgáltatáskapcsolat neve |
| ServiceConnectionUrl | example.crm.dynamics.com | Annak a készítői környezetnek az URL-címe, ahol az exportálni kívánt nem felügyelt megoldás létezik |
| Adat | [Telepítési beállítások JSON] | Egy JSON-sztring, amely az üzembe helyezési folyamatok exportálásához és konfigurálásához használt üzembe helyezési beállításokat tartalmazza |
| PortalSiteName | MyPortalSite | Az exportálandó megoldáshoz társított Power Pages-webhely neve |
A megoldások verziószámozásának testreszabása, amikor az ALM gyorsító folyamatok használatával exportálja vagy telepíti őket
Alapértelmezés szerint az exportált és üzembe helyezett megoldások verziószámozása az üzembe helyezési folyamat YAML-fájljában megadott nevet használja. Az ALM gyorsító folyamatok azonban lehetővé teszik a megoldás verziószámozásának testreszabását exportáláskor vagy üzembe helyezéskor. A következő szakaszok ismertetik a használható módszereket.
Exportált verziószámozás
Használja a folyamatok által exportált verziószámot verziószámként az összes üzembe helyezett környezetben. Hozzon létre egy UseSolutionVersionFromDataverse nevű változót az exportálási folyamatban, vagy egy globális változót az ALM gyorsító változókönyvtárában. Adja meg az Igaz értéket. A változó biztosítja, hogy a megoldásban exportált verziószám megmarad az alsóbb rétegbeli környezetekben, és tükröződik a verziókövetésben a megoldás forrásának véglegesítésekor.
Egyéni verziószámozási logika
Az ALM gyorsító horgok segítségével állítsa be a megoldás verzióját. Adja hozzá az egyéni logikát a build-solution-pack-pre-hook.yml sablonhoz a közvetlenül vagy más eszközökkel, például Solution.xml a pac-megoldás verziójával való manipuláláshoz.
Egyéni saját sablonok verziószámozása
Az üzembe helyezési folyamatok létrehozásához szükséges saját sablonok használatának lehetősége rugalmasságot biztosít a verziószámozáshoz a megoldás kezdeti exportálása során. Létrehozhat például egy build-deploy-validation/test/prod-SampleSolution.yml másolatot, és módosíthatja a build nevét az alapértelmezettről egy verziószámozási stratégiára a futtatási vagy buildszámok konfigurálása alapján:
build:
- name: 1.0.$(Date:yyyyMMdd)$(Rev:.r)
...
Miután a sablonok a helyükre kerültek, frissítse az üzembe helyezési profil üzembe helyezési lépéseit , hogy rájuk mutassanak.
A telepítési lépések számának és a célkörnyezetek nevének testreszabása a folyamatokban
A sablonokkal való egyéni verziószámozáshozhasonlóan az üzembe helyezési folyamatok létrehozásához szükséges saját sablonok használata nagyobb rugalmasságot biztosít a megoldás kezdeti exportálása során. Adja meg azt a projektet, amelyben a sablonok léteznek, valamint az üzembe helyezési folyamat létrehozásához használni kívánt sablon elérési útját. A projekt és az elérési út beállításai az üzembe helyezési profilban és az ALM gyorsító felügyeleti alkalmazás üzembe helyezési lépések táblázatában találhatók.
A sablon elérési útja az exportálási folyamat helyének gyökéréhez képest van meghatározva. Az érvényesítési környezet alapértelmezett üzembe helyezési folyamatsablonjainak elérési útja például a következő: /Pipelines/build-deploy-validation-SampleSolution.yml. Ha ugyanabban a projektben szeretne sablont használni, mint az exportálási folyamatot, adja meg az elérési utat /Pipelines/build-deploy-validation-MyCustomTemplate.yml.
Az alábbi táblázat az üzembe helyezési folyamat létrehozásakor lecserélt megoldásspecifikus értékek helyőrzőit ismerteti a sablonokban.
| Helyőrző | Description |
|---|---|
| SampleSolutionName | Az telepíteni kívánt megoldás neve |
| RepositoryContainingTheBuildTemplates | A telepítési folyamathoz használható buildsablonokat tartalmazó adattár |
| BranchContainingTheBuildTemplates | A telepítési folyamathoz használható buildsablonokat tartalmazó elágazás |
| ALM-gyorsító-változó-csoport | A globális változócsoport, amelyet a buildsablonok az üzembe helyezési folyamathoz használnak |
Javasoljuk, hogy másoljon egy folyamatsablont build-deploy-validation/test/prod-SampleSolution.yml a saját egyéni sablon használatának megkezdéséhez.
Egyéni lépések végrehajtása a folyamatokban az alapértelmezett sablonok módosítása nélkül
Az ALM gyorsító folyamatsablonjai számos bővítményponttal vagy horoggal rendelkeznek, amelyek segítségével testreszabhatja a folyamatokat, miközben minimalizálja az egyesítési ütközésekből származó zajt a frissítési forgatókönyvekben. Tudjon meg többet az ALM gyorsító horgokról.
Adott műveletek be- és kikapcsolása a folyamatokban
A folyamatok változók használatával határozzák meg, hogy egy feladatot végre kell-e hajtani, vagy több lehetőség közül melyiket kell végrehajtani. Az alábbi táblázat ismerteti az egyes folyamatokhoz vagy az alm-accelerator-variable-group segítségével az összes folyamathoz beállítható változókat.
Feljegyzés
Ha ezeket a változókat adott exportálási megoldásokhoz szeretné beállítani, hozzon létre egy adott exportálási folyamatot az exportálási folyamat sablonja alapján. Nevezze el export-solution-to-git-{SolutionName}. Az ALM gyorsító alkalmazás ezt az exportálási folyamatot használja a megoldáshoz az általános célú export-megoldás-git folyamat helyett.
| Változó | Default | Csővezetékek | Description |
|---|---|---|---|
| GenerateDeploymentSettings | Igaz | Export | Ha hamis, az üzembe helyezési beállítások nem jönnek létre és nem tárolódnak a verziókövetésben. |
| UseDeploymentSettingsPlaceholders | Igaz | Export | Ha hamis, az üzembe helyezési beállítások nem használnak helyőrzőket, és az üzembe helyezési beállítások összes értékét a és fájlokba menti a deploymentSettings.json rendszer customDeploymentSettings.json .FONTOS: A bizalmas adatok egyszerű szövegként menthetők az üzembe helyezési beállításokban. A verziókövetéshez hozzáféréssel rendelkező felhasználók olvashatják ezeket az értékeket. Ügyeljen arra, hogy értéket állítson be ehhez a változóhoz. |
| DisableFlows | Hamis | Export | Ha igaz, a véglegesítés előtt minden folyamat ki lesz kapcsolva a kicsomagolt forráskódban. |
| UseSolutionVersionFromDataverse | Hamis | Export | Ha igaz, a megoldásban exportált verziószám megmarad az alsóbb rétegbeli környezetekben. A verziószám megjelenik a verziókövetésben a megoldás forrásának véglegesítésekor. |
| DoNotExportCurrentEnvironmentVariableValues | Hamis | Export | Ha igaz, az aktuális környezet változóértékei törlődnek a kicsomagolt megoldás forráskódjából. |
| PublishCustomizationsBeforeExport | Igaz | Export | Ha hamis, a testreszabások nem lesznek közzétéve a megoldás exportálása előtt. Ez a beállítás akkor hasznos, ha megosztott környezetben dolgozik, és csak a legújabb közzétett testreszabásokat szeretné exportálni. |
| CacheEnabled | Igaz | Exportálás/üzembe helyezés | Ha hamis, a PowerShell-modulok gyorsítótárazása le van tiltva. Ez a beállítás akkor hasznos, ha a folyamatok a folyamatok végrehajtása után végrehajtják a gyorsítótár könyvtárának tisztítását. |
| ProcessCanvasApps | Igaz | Exportálás/üzembe helyezés | Ha hamis, a vászonalapú alkalmazások nem lesznek kicsomagolva az exportálás során, vagy a buildek során. MEGJEGYZÉS: A vászon kicsomagolása és csomagolása funkció jelenleg előzetes verzióban érhető el. Jelenleg nem ajánlott éles környezetekben használni. A vászon forráskódja azonban csak akkor tekinthető meg a verziókövetésben, ha ezt a változót True értékre állítja. |
| DisableSolutionChecker | Hamis | Üzembe helyezés | Ha igaz, a megoldás-ellenőrző nem fut minden lekéréses kérelemmel kezdeményezett builden. |
| SkipSolutionImport | Hamis | Üzembe helyezés | Ha igaz, a megoldás importálási lépése kimarad az üzembe helyezés során. Más tevékenységek, például az áramlásaktiválás és a megosztás azonban továbbra is végrehajtásra kerülnek. |