ALM Accelerator -putkien määrittäminen
Putket ovat ALM Acceleratorin koneet. Ne automatisoivat ALM-prosessin Power Platformille. Ne on luotu käyttämällä Azure-putkia, Azure DevOpsin palvelu ja tallennettu Azure DevOps -projektiin.
ALM-prosessin automatisointiin käytetään neljää pääputkea:
- Import
- Export
- Delete
- Koonti/käyttöönotto
Putket on suunniteltu käytettäviksi ALM Acceleratorin pohjaan perustuvan sovelluksen kanssa. Sovellusta ei tarvitse käyttää, mutta suosittelemme sitä. Sovellus tarjoaa yksinkertaisen käyttöliittymän putkien käynnistämiseen ja määrityksen ilman, että sinun tarvitsee ymmärtää taustalla olevia parametreja.
Yleiset ALM Accelerator -putkiskenaariot
ALM Accelerator -putkilla ja -sovelluksilla on oletusarvoiset kokoonpanot, joiden avulla pääset nopeasti alkuun ALM:n käyttämisessä Power Platformille. Putket voivat kattaa monia erilaisia ALM-skenaarioita organisaatiosi vaatimusten täyttämiseksi. Seuraavissa osissa on kuvattu joitakin yleisiä skenaarioita ja niiden kattamia putkien määrityksiä, käyttöönottoprofiileja ja vaiheita, jotka on kuvattu ALM Accelerator -sovelluksessa tai suoraan putken kautta.
Putkien asentaminen yhteen projektiin ja lähdekoodi toiseen projektiin
ALM Accelerator -sovelluksessa ja käyttöönottoprofiileissa voit määrittää putkiprojektin ja lähdeprojektin. Ohjatun asennustoiminnon vaihtoehdon avulla voit määrittää erillisen putkiprojektin ja säilön. Nämä vaihtoehdot ovat hyödyllisiä, jos haluat segmentoida ratkaisujen tallennustilan käyttäjien, yrityksen rakenteen tai muiden tekijöiden perusteella. Useimmissa tapauksissa putken YAML-tiedostot tallennetaan putkiprojektiin, ja putkien vienti-, tuonti- ja poistoputket luodaan projektissa, jossa ratkaisua hallitaan lähdeohjaamalla.
Putkien suoritaminen ilman ALM Acceleratoria
ALM Acceleratorin pohjaan perustuva sovellus tarjoaa helpon painiketason putkien suorittamiselle. Sovelluksen käyttäminen ei kuitenkaan ole tarpeen. Jos haluat käyttää putkia sovelluksesta riippumattomasti, suorita ne suoraan komentoriviltä. Voit myös luoda oman sovelluksesi. Käytä mukautettua yhdistintä Azure DevOps -ohjelmointirajapinnalle, joka sisältyy ALM Accelerator -ratkaisuun, putkien käynnistämiseksi käyttämällä Power Automatea tai muuta Power Platform -tekniikkaa.
Jos haluat käyttää putkia itsenäisesti, kummassakin tapauksessa on tärkeää ymmärtää, mitä parametreja niille on välitetty.
Putkiparametrit
Import-unmanaged-to-dev-environmentin parametrit: Käytä tuontiratkaisuputkea ei-hallitun ratkaisun tuomiseen lähteen hallinnasta kehitysympäristöön.
Seuraavassa taulukossa on kuvattu tuontiputken parametrit.
| Parametri | Esimerkki: | Kuvaus |
|---|---|---|
| Project | Oma Azure DevOps -projekti | Sen projektin nimi, johon ratkaisu tuodaan |
| Säilö | Oma Azure DevOps -säilö | Sen säilön nimi, josta ratkaisu tuodaan |
| SolutionName | OmanRatkaisunNimi | Tuotavan ratkaisun nimi |
| me@example.com | Ratkaisun tuovan käyttäjän sähköpostiosoite | |
| UserName | Sukunimi, Etunimi | Ratkaisun tuovan käyttäjän käyttäjänimi |
| Branch | main | Haara, johon ratkaisu rakennetaan ja josta se tuodaan |
| ServiceConnectionName | OmaPalveluyhteys | Tuontiin käytetyn palveluyhteyden nimi |
| ServiceConnectionUrl | esimerkki.crm.dynamics.com | Tuonnin tekijäympäristön URL-osoite |
| EnvironmentName | OmaKehitysymparisto | Tätä käytetään käyttöönottoasetusten etsimiseksi käyttöönottoputkesta; palauttaa kansion nimen ratkaisun lähteen config-hakemistossa |
Parametrit delete-unmanaged-solution-and-components: Poista ei-hallittu ratkaisu ja kaikki sen osat kehitysympäristöstä poistoratkaisun putken avulla.
Seuraavassa taulukossa on kuvattu poistoputken parametrit.
| Parametri | Esimerkki: | Kuvaus |
|---|---|---|
| SolutionName | OmanRatkaisunNimi | Poistettavan ratkaisun nimi |
| ServiceConnectionName | OmaPalveluyhteys | Poistettavalle ratkaisulle käytetyn palveluyhteyden nimi |
| ServiceConnectionUrl | esimerkki.crm.dynamics.com | Poistettavan ratkaisun tekijäympäristön URL-osoite |
Parametrit export-solution-to-git: Käytä vientiratkaisuputkea viedäksesi ratkaisun Git-säilöön.
Seuraavassa taulukossa on kuvattu vientiputken parametrit.
| Parametri | Esimerkki: | Kuvaus |
|---|---|---|
| Project | Oma Azure DevOps -projekti | Sen projektin nimi, johon ratkaisun lähdekoodi viedään |
| Säilö | Oma Azure DevOps -säilö | Sen säilön nimi, johon ratkaisun lähdekoodi viedään |
| SolutionName | OmanRatkaisunNimi | Vietävän ratkaisun nimi |
| me@example.com | Ratkaisun vievän käyttäjän sähköpostiosoite | |
| UserName | Sukunimi, Etunimi | Ratkaisun vievän käyttäjän käyttäjänimi |
| CommitMessage | Korjaa bugin #1234 | Säilöön tallennettavien muutosten kuvaus |
| Branch | main | Joko lähdehaara, josta haara luodaan, tai olemassa oleva haara, johon sitoudut |
| BranchToCreate | ominaisuus-1234 | Branch-parametrin perusteella luotavan uuden haaran yksilöllinen nimi tarvittaessa |
| ServiceConnectionName | OmaPalveluyhteys | Ratkaisun vientiin käytetyn palveluyhteyden nimi |
| ServiceConnectionUrl | esimerkki.crm.dynamics.com | Sen tekijäympäristön URL-osoite, joka sisältää vietävän ei-hallitun ratkaisun |
| Tiedot | [Käyttöönottoasetusten JSON] | JSON-merkkijono, joka sisältää käyttöönottoasetukset, joita on käytettävä viennissä ja käyttöönottoputkien määrittämisessä |
| PortalSiteName | OmaPortaalisivusto | Vietävään ratkaisuun liittyvän Power Pages -sivuston nimi |
Mukauta ratkaisujen versiointia, kun käytät ALM Accelerator -putkistoja niiden viemiseen tai käyttöönottoon
Viedyt ja käyttöön otetut ratkaisut versioitetaan oletusarvoisesti käyttämällä käyttöönottoputken YAML-tiedostossa määritettyä nimeä. Kuitenkin ALM Accelerator -putkilinjojen avulla voit mukauttaa ratkaisun versiointia, kun viet tai otat sen käyttöön. Seuraavissa osissa on kuvattu käytettävissä olevat menetelmät.
Viedyt versioinnit
Käytä putkien viemää versionumeroa versionumerona kaikissa käyttöönotetuissa ympäristöissä. Luo UseSolutionVersionValvojaDataverse-niminen muuttuja vientiputkeen tai yleinen muuttuja ALM Acceleratorin muuttujakirjastoon. Anna arvoksi Tosi. Muuttuja varmistaa, että ratkaisuusi viety versionumero säilyy loppupään ympäristöissä ja näkyy lähdehallinnassa, kun ratkaisulähde on sitoutunut.
Mukautettu versiologiikka
Aseta ratkaisun versio ALM Accelerator -koukkujen avulla. Lisää mukautettu logiikka build-solution-pack-pre-hook.yml-malliin, jotta kohdetta Solution.xml voi muokata suoraan tai käyttämällä muita työkaluja, kuten pakettiratkaisuversiota.
Mukautettu bring-your-own-templates -versiointi
Mahdollisuus tuoda omia malleja käyttöönottoputkien luomiseen tarjoaa joustavuutta versiointiin ratkaisun ensimmäisen viennin aikana. Luo esimerkiksi kopio kohteesta build-deploy-validation/test/prod-SampleSolution.yml ja muuta koontiversion nimi oletusarvoisesta versiostrategiaksi suoritus- tai koontiversion lukujen määrittämisen perusteella:
build:
- name: 1.0.$(Date:yyyyMMdd)$(Rev:.r)
...
Kun mallit on päivitetty, päivitä käyttöönottovaiheet käyttöönottoprofiilissa osoittamaan niihin.
Putkiesi käyttöönottovaiheiden määrän ja kohdeympäristöjen nimien mukauttaminen
Mukautetun versioinnin mallien kanssa kaltaisesti mahdollisuus tuoda omia malleja käyttöönottoputkien luomiseen tarjoaa joustavuutta ratkaisun ensimmäisen viennin aikana. Määritä projekti, jossa malleja on olemassa, ja polku malliin, jota käytetään käyttöönottoputken luomisessa. Projektin ja polun asetukset ovat ALM Accelerator -hallintasovelluksen käyttöönottoprofiilissa ja Käyttöönottovaiheet-taulukossa.
Mallin polku on suhteellinen vientiputken sijainnin pääsijainnin kanssa. Esimerkiksi polku oletusarvoisen vahvistusympäristön käyttöönottoputkimalleihin on /Pipelines/build-deploy-validation-SampleSolution.yml. Jos haluat käyttää mallia samassa projektissa kuin vientiputki, määritä polku nimellä /Pipelines/build-deploy-validation-MyCustomTemplate.yml.
Seuraavassa taulukossa on kuvattu niiden ratkaisukohtaisten arvojen paikkamerkkejä, jotka korvataan käyttöönottoputken luonnin yhteydessä.
| Paikkamerkki | Kuvaus |
|---|---|
| SampleSolutionName | Käyttöön otettavan ratkaisun nimi |
| RepositoryContainingTheBuildTemplates | Varasto, joka sisältää käyttöönottoputkessa käytettävät koontimallit |
| BranchContainingTheBuildTemplates | Haara, joka sisältää käyttöönottoputkessa käytettävät koontimallit |
| alm-accelerator-variable-group | Yleinen muuttujaryhmä, jota koontimallit käyttävät käyttöönottoputkessa |
On suositeltavaa kopioida build-deploy-validation/test/prod-SampleSolution.yml-putkimalli, jotta pääset alkuun oman mukautetun mallin kanssa.
Mukautettujen vaiheiden suorittaminen putkissa muokkaamatta oletusmalleja
ALM Accelerator -putkimalleissa on useita laajennuspisteitä tai koukkuja, joiden avulla voit mukauttaa putkia samalla kun minimoit yhdistämisristiriitojen aiheuttaman melun päivitysskenaarioissa. Lue lisää ALM Accelerator -koukuista.
Tiettyjen putkien toimintojen kytkeminen käyttöön tai pois käytöstä
Putket määrittävät muuttujien avulla, tulisiko tehtävä suorittaa vai mikä useiden mahdollisuuksien tehtävä tulee suorittaa. Seuraavassa taulukossa on kuvattu muuttujat, jotka voit määrittää yksittäiselle putkelle tai kaikki putket alm-accelerator-variable-groupin kautta.
Muistiinpano
Jos haluat määrittää nämä muuttujat tietyille viennin ratkaisuille, luo erityinen vientiprosessi vientiputkimallin perusteella. Anna nimeksi export-solution-to-git-{SolutionName} ALM Accelerator -sovellus käyttää tätä vientiputkea ratkaisuun yleisen export-solution-to-git-putken sijaan.
| Muuttuja | Oletus | Putket | Kuvaus |
|---|---|---|---|
| GenerateDeploymentSettings | Tosi | Export | Jos arvo on epätosi, käyttöönottoasetuksia ei luoda ja tallenneta lähteen ohjausobjektiin. |
| UseDeploymentSettingsPlaceholders | Tosi | Export | Jos arvo on epätosi, käyttöönottoasetukset eivät käytä paikkamerkkejä ja kaikki käyttöönottoasetusten arvot tallennetaan deploymentSettings.json- ja customDeploymentSettings.json-tiedostoihin.TÄRKEÄÄ: Arkaluontoiset tiedot voidaan tallentaa vain teksti -muodossa käyttöönottoasetuksiin. Kaikki käyttäjät, joilla on lähdeohjausobjektin käyttöoikeus, voivat lukea nämä arvot. Määritä tälle muuttujalle arvo huolella. |
| DisableFlows | Epätosi | Export | Jos arvo on tosi, kaikki työnkulut on poistettu käytöstä pakkaamattomassa lähdekoodissa ennen vahvistusta. |
| UseSolutionVersionFromDataverse | Epätosi | Export | Jos arvo on tosi, ratkaisuun viety versionumero säilyy ympäristön loppupäässä. Versionumero näkyy lähteen ohjausobjektissa, kun ratkaisulähde on sitoutunut. |
| DoNotExportCurrentEnvironmentVariableValues | Epätosi | Export | Jos arvo on tosi, nykyisen ympäristön muuttuja-arvot poistetaan pakkaamattoman ratkaisun lähdekoodista. |
| PublishCustomizationsBeforeExport | Tosi | Export | Jos arvo on epätosi, mukautuksia ei julkaista ennen ratkaisun vientiä. Tämä vaihtoehto on hyödyllinen, jos työskentelet jaetussa ympäristössä ja haluat viedä vain uusimmat julkaistut mukautukset. |
| CacheEnabled | Tosi | Vienti/käyttöönotto | Jos se on epätosi, PowerShell-moduulien välimuisti on poistettu käytöstä. Tämä vaihtoehto on hyödyllinen, jos putket suorittavat välimuistihakemiston siivouksen putken suorittamisen jälkeen. |
| ProcessCanvasApps | Tosi | Vienti/käyttöönotto | Jos arvo on epätosi, pohjaan perustuvia sovelluksia ei pureta viennin aikana tai pakata koonnin aikana. HUOMAUTUS: Kankaan pakkauksen purku- ja pakkaustoiminto on tällä hetkellä esiversio. Sitä ei vielä suositella käytettäväksi tuotantoympäristöissä. Et voi kuitenkaan tarkastella kaavion lähdekoodia lähdeohjausobjektin avulla, ellet määritä tämän muuttujan arvoksi Tosi. |
| DisableSolutionChecker | Epätosi | Käyttöönotto | Jos arvo on tosi, ratkaisun tarkistus ei käynnisty jokaisessa hakupyynnöllä käynnistetyssä koontiversiossa. |
| SkipSolutionImport | Epätosi | Käyttöönotto | Jos arvo on tosi, ratkaisun tuontivaihe ohitetaan käyttöönoton aikana. Muita aktiviteetteja, kuten työnkulkujen aktivointeja ja jakamista, suoritetaan kuitenkin edelleen. |