opomba,
Dostop do te strani zahteva pooblastilo. Poskusite se vpisati alispremeniti imenike.
Dostop do te strani zahteva pooblastilo. Poskusite lahko spremeniti imenike.
opomba,
ALM pospeševalnik je zastarel in bo odstranjen v prihodnji izdaji. Uporabite Pipelines v Power Platform za prinašanje avtomatizacije ALM na Power Platform in Dynamics 365 storitve. Cevovode je mogoče uporabljati z integracijo izvorne kode ali razširiti za integracijo z drugimi ponudniki.
Komponente lahko konfigurirate s priloženo skrbniško aplikacijo ali ročno. ALM Accelerator for Power Platform Ta članek vas vodi skozi ročno konfiguracijo aplikacije in je razdeljen na sedem razdelkov:
- Predpogoji
- Temeljna postavitev
- Postavitev razvojnega projekta
- Nastavitev rešitve
- Uvoz rešitve in konfiguracija aplikacije
- Nastavitev ustvarjalcev za uporabo aplikacije ALM Accelerator
Predpogoji
Preden namestite ALM Accelerator for Power Platform, se prepričajte, da ste izpolnili naslednje pogoje.
ALM pospeševalnik mora biti nameščen v okolju Power Platform, ki ima Microsoft Dataverse bazo podatkov. Vsa okolja, v katerih uporabljate ALM Accelerator za uvajanje rešitev, zahtevajo tudi podatkovno bazo. Dataverse
opomba,
Pospeševalnik ALM ni združljiv z Dataverse for Teams. Tako aplikacija ALM Accelerator kot povezani cevovodi predpostavljajo, da v vseh okoljih uporabljate polno različico Dataverse .
Priporočamo, da namestite ALM Accelerator v isto okolje kot druge rešitve CoE Starter Kit. Več o tem, kako določiti najboljšo strategijo za vašo organizacijo:
ALM Accelerator uporablja Azure DevOps za nadzor virov in namestitve. Če nimate Azure DevOps organizacije, se brezplačno prijavite za do pet uporabnikov na Azure DevOps strani.
Za dokončanje korakov v tem razdelku potrebujete naslednje uporabnike in dovoljenja v Azure, Azure DevOps in Power Platform:
- Licencirani uporabnik Azure z dovoljenji za ustvarjanje in ogled Microsoft Entra skupin, ustvarjanje registracij aplikacij ter podeljevanje administratorskega soglasja za registracijo aplikacij v Microsoft Entra ID
- Licencirani uporabnik Azure DevOps z dovoljenji za ustvarjanje in upravljanje cevovoda, povezav storitev, repozitorijev in razširitev
- Licencirani uporabnik z dovoljenji za ustvarjanje uporabnikov aplikacije in dodeljevanje skrbniških dovoljenj le-tem Power Platform
V okolju, v katerega je uvožen pospeševalnik ALM, morajo biti na voljo naslednji konektorji za skupno uporabo:
- Dataverse (zapuščina)
- HTTP
- Power Apps za Makers
- HTTP z Microsoft Entra ID (s končnim dostopom do https://graph.microsoft.com)
- ALM Accelerator Custom DevOps (ta povezovalnik je ustvarjen kot del uvoza rešitve pospeševalnika )
- Office 365 uporabniki
- HTTP
Namestite komplet za ustvarjalce v okolje, kjer nameščate pospeševalnik ALM.
Temeljna postavitev
Naslednji koraki so splošni za funkcionalnost pospeševalnika ALM in niso specifični za noben projekt ali rešitev.
Ustvarite registracijo aplikacije v svojem okolju Microsoft Entra
Ustvarite registracijo aplikacije za ALM pospeševalnik, da aplikaciji in pripadajočim cevovodom podelite dovoljenja, potrebna za izvajanje operacij v Azure DevOps in Power Apps ali Dataverse. To morate storiti samo enkrat.
Naslednji koraki prikazujejo, kako ustvariti eno registracijo aplikacije z dovoljenji tako za Dataverse kot za Azure DevOps. Vendar pa boste morda želeli ustvariti ločene registracije aplikacij, da si razdelite odgovornosti. Preden se odločite za strategijo registracije aplikacij, morate upoštevati, kako ločene registracije aplikacij vplivajo na vzdrževanje in varnost .
Ustvarite registracijo aplikacije
Prijavite se v portal Azure .
Izberite Microsoft Entra ID>App registrations.
Izberite + Nova registracija in nato registraciji dodelite ime, na primer ALMAcceleratorServicePrincipal.
Vse ostale možnosti pustite pri privzetih vrednostih in izberite Registriraj.
Dodajte dovoljenja za registracijo aplikacije
V levi stranski plošči izberite Dovoljenja API.
Izberite + Dodaj dovoljenje.
Izberite Dynamics CRM in nato izberite Delegirana dovoljenja in user_impersonation.
Izberite Dodaj dovoljenja za dodajanje Dynamics CRM API-ja user_impersonation dovoljenja za registracijo aplikacije.
Ponovno izberite + Dodaj dovoljenje .
Izberite zavihek API-ji, ki jih uporablja moja organizacija . Poiščite in izberite PowerApps-Advisor, nato pa izberite Prenesena dovoljenja in Analysis.All (soglasje skrbnika ni potrebno).
To dovoljenje je potrebno za izvajanje statične analize prek preverjevalnika aplikacij. ...
Izberite Dodaj dovoljenja , da dodate dovoljenje PowerApps-Advisor API Analysis.All za registracijo aplikacije.
Ponovno izberite + Dodaj dovoljenje .
Na zavihku Microsoft APIs ali na zavihku API, ki ga uporablja moja organizacija, izberite Azure DevOps in nato izberite Delegirana dovoljenja in user_impersonation.
To dovoljenje je potrebno za povezavo z Azure DevOps preko prilagojenega konektorja v aplikaciji ALM Accelerator.
Če ste dovoljenje za Azure DevOps dodali iz zavihka API-je, kopirajte Application (client) ID za kasnejšo uporabo v tem postopku.
Uporabili ga boste kot ID aplikacije (odjemalca) DevOps, ki se razlikuje od ID-ja aplikacije (odjemalca), ki ga boste kopirali pozneje v tem postopku.
Če ne najdete dovoljenja za Azure DevOps na zavihku API, ki ga uporablja moja organizacija, sledite tem korakom za pridobitev DevOps Application (client) ID:
- Odprite zasebno okno brskalnika in pojdite na
https://dev.azure.com/<your devops organization>/_apis. - Na strani za prijavo kopirajte vrednost parametra client_id v URL-ju.
- Odprite zasebno okno brskalnika in pojdite na
Izberite Dodaj dovoljenja za dodajanje Azure DevOps API-ja user_impersonation dovoljenja za registracijo aplikacije.
Izberite Podeli skrbniško soglasje za <svojega najemnika>.
Konfigurirajte skrivnost odjemalca in URI za preusmeritev
V levi stranski plošči izberite Potrdila in skrivnosti.
Izberite + Nova skrivnost odjemalca.
Izberite datum poteka veljavnosti in nato izberite Dodaj.
Kopirajte vrednost skrivne kode odjemalca Vrednost za kasnejšo uporabo. To je edini čas, ko lahko vrednost kopirate. To obvezno storite, preden zapustite stran.
V levi stranski plošči izberite Pregled.
Kopirajte ID aplikacije (odjemalca) in ID imenika (najemnika) .
Izberite Konfiguriraj.
Dodelite dovoljenje za upravljanje aplikacij Power App Management za registracijo vaše aplikacije
Dodelite dovoljenja za registracijo aplikacije Power App Management , da lahko prodajni cevovodi izvajajo potrebna dejanja v vaših okoljih. Za to zaženite naslednji PowerShell cmdlet kot interaktivni uporabnik, ki ima Power Apps administratorske pravice. Ta ukaz morate zagnati samo enkrat, ko ustvarite registracijo aplikacije.
Pomembno
Naslednji ukaz »cmdlet« PowerShell podeli registraciji aplikacije povišana dovoljenja, kot je Power Platform Admin. Varnostni pravilniki vaše organizacije morda ne dovoljujejo teh vrst dovoljenj. Preden nadaljujete, se prepričajte, da so dovoljeni. Če niso dovoljene, nekatere zmogljivosti ne delujejo v cevovodih pospeševalnika ALM.
Install-Module -Name Microsoft.PowerApps.Administration.PowerShell
Install-Module -Name Microsoft.PowerApps.PowerShell -AllowClobber
New-PowerAppManagementApp -ApplicationId <the Application (client) ID you copied when you created the app registration>
Install Azure DevOps extensions
ALM Accelerator uporablja več razširitev za Azure DevOps, vključno z nekaterimi razširitvami tretjih oseb, ki so na voljo v tržnici Azure DevOps. Spletna stran vsake razširitve tretjih oseb in povezava do njihove izvorne kode sta navedeni v naslednjih navodilih. Naučite se oceniti založnika razširitve Marketplace.
Prijavite se v Azure DevOps.
Izberite Nastavitve organizacije.
Izberite Splošno>Razširitve.
Poiščite in namestite naslednje razširitve:
Power Platform Orodja za gradnjo (obvezno): Ta razširitev vsebuje Microsoftove naloge gradnje za Power Platform. ()https://marketplace.visualstudio.com/items?itemName=microsoft-IsvExpTools.PowerPlatform-BuildTools
Zamenjaj žetone (obvezno): Cevovodi uporabljajo to razširitev za zamenjavo žetonov v konfiguracijskih datotekah in shranjevanje varnih vrednosti v zasebnih spremenljivkah, konfiguriranih za cevovod. ()https://marketplace.visualstudio.com/items?itemName=qetza.replacetokens | https://github.com/qetza/vsts-replacetokens-task
Zavihek SARIF SAST Scans (neobvezno): Uporabite to razširitev za vizualizacijo datotek SARIF, ki jih preverjevalnik rešitev ustvari med gradnjo. (SARIF SAST Scans zavihek - Visual Studio Marketplace)
Klonirajte YAML cevovode iz GitHub na vašo Azure DevOps instanco
Pojdite na https://aka.ms/coe-alm-accelerator-templates-latest-release in kopirajte URL najnovejše izdaje.
Prijavite se v Azure DevOps.
Ustvarite projekt ali izberite obstoječega projekta.
Izberite Repos in nato v seznamu repozitorija izberite Import repozitorij
Prilepite URL, ki ste ga kopirali v 1. koraku, kot Kloniraj URL in nato izberite Uvozi.
Potrdite, da je privzeta veja za repozitorij main. Izberite Repos in Branches ter poskrbite, da je main branch označen kot privzeta.
Če ni, izberite tri navpične pike (⋮), ki ustrezajo glavni veji, in v meniju Več možnosti izberite Nastavi kot privzeto vejo.
opomba,
V tem repozitoriju se izvajajo predloge cevovoda rešitev in cevovodi izvoza/uvoza. Kasneje, ko boste ustvarili prodajne poti za svoje rešitve, se boste morda morali sklicevati na ta specifični projekt in repozitorij, če se odločite za uporabo drugega repozitorija za nadzor izvorne kode za svoje rešitve.
Ustvarjanje prodajnih lijakov za uvažanje, brisanje in izvažanje rešitev
Ustvarite uvozne, izbrisane in izvozne cevovode na podlagi YAML v repozitoriju Azure DevOps. Ti cevovodi se zaženejo, ko uporabite aplikacijo za potrditev rešitve v Git, uvoz rešitve ali brisanje rešitve.
opomba,
Če pričakujete, da bodo vsi vaši izvozi izvajali enaka dejanja ne glede na rešitev, za katero se izvaja cevovod, lahko ustvarite en sam izvozni cevovod, kot je opisano v tem razdelku. Vendar pa boste morda potrebovali različna dejanja izvoza, odvisno od rešitve. V tem primeru lahko ime rešitve dodate cevovodu export-solution-to-git, na primer export-solution-to-git-SampleSolution, da aplikacija izvede vaše specifične cevovode rešitev, ko izvedete dejanja v aplikaciji.
Naslednja tabela prikazuje ujemanje med datoteko YAML v repozitoriju in pripadajočim cevovodom.
| Datoteka YAML | Ime prodajnega lijaka |
|---|---|
| export-solution-to-git.yml | export-solution-to-git |
| import-unmanaged-to-dev-environment.yml | import-unmanaged-to-dev-environment |
| delete-unmanaged-solution-and-components.yml | delete-unmanaged-solution-and-components |
V Azure DevOps pojdite na Pipelines>Create a New Pipeline.
Izberite Azure Repos Git za svoj repozitorij kode in nato pokažite na Azure DevOps repozitorij, ki ste ga ustvarili in zasejali s predlogami cevovoda v zgodnjih korakih.
Na strani Konfiguriraj svoj cevovod izberi Obstoječo Azure Pipelines YAML datoteko in pokaži na /Pipelines/export-solution-to-git.yml, /Pipelines/import-unmanaged-to-dev-environment.yml ali /Pipelines/delete-unmanaged-solution-and-components.yml.
Izberite Nadaljuj in nato izberite Shrani.
Izberite meni Več (…) poleg možnosti Zaženi cevovod in nato izberite Preimenuj/Premakni.
Spremenite ime cevovoda v export-solution-to-git, import-unmanaged-to-dev-environment ali delete-unmanaged-solution-and-components, kot je ustrezno.
Izberite možnost Shrani.
Ustvarjanje izvoznih spremenljivk prodajnega lijaka (izbirno)
V cevovodu export-solution-to-git lahko nastavite spremenljivke cevovoda, da nadzorujete, katere informacije se shranijo v nadzor izvorne kode. Če želite te nastavitve uporabiti globalno, nastavite spremenljivke v cevovodu export-solution-to-git. Če želite nastavitve uporabiti za določene rešitve pri izvozu, ustvarite izvozni cevovod za svojo rešitev, kot je opisano v opombi v prejšnjem razdelku, in nastavite spremenljivke v tem cevovodu.
Če želite zagotoviti, da trenutne vrednosti okoljskih spremenljivk med izvozom nikoli ne bodo poslane v nadzor izvorne kode, ustvarite spremenljivko DoNotExportCurrentEnvironmentVariableValues v svojem cevovodu export-solution-to-git in jo nastavite na True.
Pomembno
Ta spremenljivka cevovoda je priporočljiva, da lahko uporabite funkcionalnost konfiguracije uvajanja v pospeševalniku ALM.
Če želite zagotoviti, da so vrednosti določenih privzetih okoljskih spremenljivk nastavljene med izvozom rešitve, ustvarite spremenljivko VerifyDefaultEnvironmentVariableValues v svojem cevovodu export-solution-to-git in jo nastavite na True. Vrednosti privzetih okoljskih spremenljivk nastavite v datoteki customDeploymentSettings.json, kot je opisano v vodniku za konfiguracijo uvajanja.
V Azure DevOps izberite Pipelines>Library>Ustvarite novo skupino spremenljivk.
Novo skupino spremenljivk alm-accelerator-variable-group poimenujte natančno tako, kot je navedeno tukaj.
Cevovodi se nanašajo na to specifično skupino spremenljivk, zato jo je treba poimenovati natančno tako, kot je prikazano. Če se odločite za uporabo drugačnega načina poimenovanja za skupino spremenljivk, morate dele cevovodov spremeniti tako, da se bodo sklicevali na ime, ki ga uporabljate.
V skupino spremenljivk dodajte naslednje spremenljivke:
Imenu Description Vrednost AADHost Avtorizacijski endpoint Microsoft Entra Za javne oblake uporabite login.microsoftonline.com. Za vladne oblake uporabite ustrezen URL za avtorizacijo. ProcessCanvasApps Ali se aplikacije platna razpakirajo med izvozom ali zapakirajo med gradnjo Če je vrednost False, se aplikacije platna med izvozom ne razpakirajo ali zapakirajo med gradnjo. Funkcija razpakiranja in pakiranja v aplikaciji canvas je v predogledni različici in trenutno ni priporočljiva za uporabo v produkcijskih okoljih. ... Vendar pa si izvorne kode platna ne morete ogledati v nadzoru izvorne kode, razen če te spremenljivke ne nastavite na True. (Neobvezno) Če v svojih cevovodih uporabljate avtomatizacijo testiranja Canvas Studio, v skupino spremenljivk dodajte naslednje spremenljivke:
Imenu Vrednost TestAutomationLoginMethod CloudIdentity TestAutomationMakerPortalUrl URL iz portala Power Apps maker, običajno *https://make.powerapps.com*TestAutomationUsername Uporabniški račun, ki se uporablja za izvajanje avtomatiziranih testov TestAutomationPassword Geslo za uporabniški račun, ki se uporablja za izvajanje avtomatiziranih testov (Neobvezno) Globalne spremenljivke so privzeto omejene in dostop morate konfigurirati za vsak cevovod. To lahko poenostavite in omogočite dostop za kateri koli cevovod. V skupini spremenljivk Cevovodi (Cevovodi>Knjižnica>alm-accelerator-variable-group) v zgornjem meniju izberite Dovoljenja cevovoda , izberite (…) in nato izberite Odpri dostop.
Nastavitev dovoljenj za storitev gradnje projekta
Pomembno
Azure DevOps vsebuje več računov "Build Service", kar je lahko zmedeno, ko sledite korakom v tem razdelku. Bodite pozorni na imena in obliko, določene v 3. in 5. koraku. Morda boste morali poiskati določen račun, če ni prikazan na začetnem seznamu.
V Azure DevOps izberite Nastavitve projekta.
Izberite Shrambe>Varnost.
V razdelku Uporabniki poiščite in izberite Storitev gradnje zbirke projektov (Ime vaše organizacije).
opomba,
Morda ne boste videli imena vaše organizacije za uporabnikom Storitev gradnje zbirke projektov . Lahko je le edinstven identifikator. V tem primeru uporabite funkcijo iskanja, da poiščete uporabnika, in ga nato izberite.
Za uporabnika storitve gradnje nastavite naslednja dovoljenja:
Dovoljenje Vrednost Prispevanje Dovoli Prispevanje zahtevkom za uveljavitev sprememb Dovoli Ustvarjanje veje Dovoli Urejanje pravilnikov Dovoli V razdelku Uporabniki poiščite in izberite Ime vašega projekta Storitev gradnje (Ime vaše organizacije).
Nastavite enake vrednosti kot v 4. koraku.
Izberite Cevovodi, izberite tri pike (…) v zgornjem desnem kotu in nato izberite Upravljanje varnosti.
Nastavite naslednja dovoljenja za uporabnika Vaše ime projekta Storitev gradnje (Ime vaše organizacije) :
Dovoljenje Vrednost Urejanje prodajnega lijaka gradnje Dovoli Urejanje kakovosti gradnje Dovoli Upravljanje čakalne vrste gradnje Dovoli Preglasitev preverjanje veljavnosti prijave glede na gradnjo Dovoli Posodobitev informacij o gradnji Dovoli Ogled gradenj Dovoli Ogled gradenj Dovoli Izberite Nastavitve projekta>Zbirke agentov, izberite Varnost in nato izberite Dodaj.
Poiščite in izberite Ime vašega projekta Storitev gradnje (Ime vaše organizacije).
Vlogo Nastavite na Bralec.
Izberite Dodaj.
(Neobvezno) Privzeto so dovoljenja cevovoda za vsako skladišče omejena in jih morate konfigurirati posamično. To lahko poenostavite in omogočite dostop za kateri koli cevovod. V razdelku Nastavitve projekta>Repozitoriji izberite vsako repozitorij posebej. V zgornjem meniju izberite Varnost . Poiščite blok Dovoljenja cevovoda , izberite (…) in nato izberite Odpri dostop.
Postavitev razvojnega projekta
Naslednji razdelek vas vodi skozi korake, potrebne za vzpostavitev vsakega od razvojnih projektov, ki jih podpirate. V tem kontekstu razvojni projekt obsega infrastrukturo in konfiguracijo, ki podpira zdravo upravljanje življenjskega cikla aplikacij (ALM), vključno s konfiguracijo okolja, ki podpira sam proces ALM. Dataverse
Ustvarite povezave s storitvami za Azure DevOps dostop do Power Platform
Vsako okolje Dataverse—razvoj, validacija, testiranje in produkcija—mora imeti povezavo s storitvijo Power Platform v Azure DevOps. Za vsako od svojih okolij izvedite naslednje korake.
opomba,
Uporabniki ALM Accelerator aplikacije vidijo le okolja, kjer imajo uporabniško ali skrbniško vlogo na povezavi storitve v Azure DevOps. Če delajo v okoljih za osebni razvoj, morajo imeti ustvarjalci vlogo uporabnika ali skrbnika v povezavi s storitvijo za svoje okolje za osebni razvoj. Povezave storitev preverjanja veljavnosti, testiranja in produkcijskega okolja, kot je storitev gradnje, potrebujejo le dovoljenja, dodeljena cevovodom.
Prijavite se v Azure DevOps in nato izberite svoj projekt.
Izberite Nastavitve projekta>Povezave storitev in nato izberite Ustvari povezavo storitev.
Poiščite in izberite vrsto povezave storitve. Power Platform
Izberite Naprej.
Za URL strežnika vnesite URL svojega okolja, na primer
https://myorg.crm.dynamics.com/.Pomembno
V URL morate vključiti poševno črtico naprej (/); v tem primeru torej za .com .
Za Ime povezave storitve vnesite isti URL, kot ste ga vnesli v 4. koraku, vključno z učno poševnico (/).
Vnesite Tenant ID, Application (client) ID in Client Secret ste kopirali iz Microsoft Entra, ko ste ustvarili registracijo aplikacije.
Izberite Dodeli dovoljenja za dostop vsem cevovodom.
Izberite možnost Shrani.
Povezave storitev morajo zagotavljati uporabniška dovoljenja vsem uporabnikom v vseh okoljih, do katerih morajo imeti uporabniki dostop iz aplikacije (na primer okolja ustvarjalcev).
Na seznamu Povezave storitev izberite povezavo storitve, ki jo želite deliti z uporabniki.
V zgornjem desnem kotu izberite Več (…) in nato izberite Varnost.
Na seznamu Skupina ali uporabnik izberite uporabnika ali skupino, ki ji želite dodeliti uporabniška dovoljenja.
Izberite Uporabnik, izberite Vlogo in nato izberite Dodaj.
Ponovite korake v tem razdelku za vsako od vaših razvojnih, validacijskih, testnih in produkcijskih okolij.
Nastavite dovoljenja za storitev gradnje projekta za uporabo povezav storitev
V Azure DevOps izberite Nastavitve projekta>povezave s storitvami.
V zgornjem desnem kotu izberite (…), izberite Varnost in nato izberite Dodaj.
Poiščite in izberite Ime vašega projekta Storitev gradnje (Ime vaše organizacije).
Vlogo Nastavite na Skrbnik in nato izberite Dodaj.
Ustvarite uporabnika aplikacije v okolju Dataverse
V svojih okoljih ustvarite uporabnika aplikacije, ki bo cevovodom omogočil povezavo z Dataverse. To storite v vsakem okolju, v katerem nameravate uporabiti pospeševalnik ALM za uvedbo.
Vpišite se v skrbniško središče za Power Platform.
Izberite svoje razvojno okolje in nato izberite Nastavitve .
Izberite Uporabniki in dovoljenja>Uporabniki aplikacije.
Izberite + Nov uporabnik aplikacije.
Izberite + Dodaj aplikacijo, izberite registracijo aplikacije, ki ste jo ustvarili prej, in nato izberite Dodaj.
Izberite poslovno enoto.
Izberite ikono svinčnika desno od možnosti Varnostne vloge in nato izberite varnostne vloge za uporabnika aplikacije.
Priporočamo, da uporabniku aplikacije podelite varnostne pravice skrbnika sistema, da bo lahko uporabnik izvajal zahtevane funkcije v posameznem okolju.
izberite Ustvari.
Te korake ponovite v okoljih za validacijo, testiranje in produkcijo.
Nastavitev rešitve
Ko ustvarite rešitev v Dataverse, morate ustvariti prodajne poti posebej za to rešitev. Naslednji vzorčni cevovodi so vključeni v imenik Cevovodi v repozitoriju coe-alm-templates :
- https://github.com/microsoft/coe-alm-accelerator-templates/blob/main/Pipelines/build-deploy-validation-SampleSolution.yml
- https://github.com/microsoft/coe-alm-accelerator-templates/blob/main/Pipelines/build-deploy-test-SampleSolution.yml
- https://github.com/microsoft/coe-alm-accelerator-templates/blob/main/Pipelines/build-deploy-prod-SampleSolution.yml
Vzorci prodajnih lijakov zagotavljajo prilagodljivost organizacijam, da lahko predloge svojih prodajnih lijakov shranijo v ločenem projektu ali shrambi iz YAML-ja prodajnega lijaka specifične rešitve. Sledite korakom v tem razdelku, da konfigurirate prodajni lijak rešitve. Te korake ponovite za vsako rešitev, za katero uporabljate ALM Accelerator za nadzor izvorne kode.
Pomembno
Datoteka YAML za vaš prodajni cevovod rešitev je vedno shranjena v istem repozitoriju, ki ga uporabljate za nadzor izvorne kode za svojo rešitev. Vendar pa lahko predloge prodajnega cevovoda – torej mapa Pipeline\Templates – obstajajo bodisi v istem repozitoriju kot datoteka YAML vašega prodajnega cevovoda rešitve bodisi v ločenem repozitoriju ali projektu.
Ustvarjanje prodajnih lijakov za gradnjo in uvajanje rešitev
Prodajni lijaki rešitev se uporabljajo za gradnjo in uvajanje vaših rešitev, ki imajo nadzorovano izvorno kodo, v okoljih vašega najemnika. Vzorčni cevovodi predpostavljajo, da uporabljate samo tri okolja: validacijsko, testno in produkcijsko. Vendar pa lahko ustvarite poljubno število prodajnih poti rešitev glede na strategijo okolja vaše organizacije.
Vzorčni pipeline za nameščanje se sprožijo s spremembami v veji (to je testiranje in produkcija) ali kot del politike veje v Azure DevOps (torej validacija). Več o nastavljanju pravilnikov vej za preverjanje zahtev za vlečenje. Cevovode lahko zaženete tudi ročno, brez sprožilca.
Sledite korakom v tem razdelku, da ustvarite cevovode uvajanja iz vzorčnega cevovoda YAML. Naslednja tabela opisuje konfiguracijo cevovoda.
Pomembno
Ime prodajnega cevovoda mora biti natančno tako, kot je prikazano v naslednji tabeli, z imenom vaše rešitve namesto MojaNovaRešitev.
| Ime datoteke YAML prodajnega lijaka | Ime prodajnega lijaka | Pravilnik veje omogočen | Zahtevano |
|---|---|---|---|
| gradnja-uvajanje-validacija-MojaNovaRešitev.yml | uvajanje-validacije-MojaNovaRešitev | Da | Da |
| gradnja-uvajanje-test-MojaNovaRešitev.yml | deploy-test-MyNewSolution | No | Da |
| build-deploy-prod-MojaNovaRešitev.yml | deploy-prod-MojaNovaRešitev | No | Ne (Premakni se na naslednji razdelek) |
opomba,
Naslednji koraki ustvarijo cevovode za gradnjo in uvajanje za okolja za preverjanje veljavnosti, testiranje in produkcijo. Vendar pa boste morda želeli najprej zgraditi in namestiti za preverjanje in testiranje ter nato artefakte iz testne gradnje namestiti v produkcijo. Če je temu tako, sledite korakom v tem razdelku samo za okolja za preverjanje veljavnosti in testiranje. Nato preskočite na Ustvarjanje cevovoda za uvajanje rešitve za konfiguracijo cevovoda za izdajo.
Ustvarite datoteko cevovoda
V Azure DevOps pojdite v repozitorij, ki vsebuje mapo pipelines, ki ste jo vložili, in izberite mapo Pipelines.
Odprite enega od treh vzorčnih cevovodov za uvajanje in kopirajte datoteko YAML, ki jo boste uporabili v svojem novem cevovodu.
Zabeležite si ime shrambe za uporabo v vašem prodajnem lijaku.
Pojdite v shrambo, ki jo želite uporabiti za nadzor izvorne kode za rešitev.
Ustvarite vejo na podlagi privzete veje in jo poimenujte za svojo rešitev; na primer MojaNovaRešitev.
Ta veja postane veja naslednje različice (v-next) za vašo rešitev. Vse razvojno delo mora biti razvejano iz te veje v osebno delovno vejo razvijalca in nato združeno v vejo v-next, da se prenese na validacijo in testiranje. Pozneje, ko je izdaja pripravljena, lahko vejo v-next združite z glavno ali privzeto vejo.
V zgornjem meniju izberite Novo in nato izberite Mapa.
Novi mapi dajte isto ime kot vaši rešitvi.
Poimenujte novo datoteko YAML cevovoda, na primer build-deploy-validation-SampleSolution.yml, build-deploy-test-SampleSolution.yml ali build-deploy-prod-SampleSolution.yml.
izberite Ustvari.
Posodobi in shrani datoteko
Prilepite datoteko YAML, ki ste jo kopirali v 2. koraku prejšnjega razdelka, v novo datoteko cevovoda.
V novem YAML cevovoda spremenite naslednje vrednosti:
Spremenite ime repozitorijev virov v ime repozitorija, ki vsebuje predloge vaših prodajnih poti. >>
V tem primeru se repozitorij imenuje coe-alm-accelerator-templates in obstaja v istem projektu kot repozitorij MyNewSolution . Če je vaš repozitorij predlog v drugem Azure DevOps projektu, uporabite format ProjectName/RepoName. Po potrebi lahko s parametrom
refdoločite tudi vejo, kjer se nahajajo vaše predloge.Spremenite katero koli vrednost, ki se nanaša na SampleSolutionName , v enolično ime vaše rešitve; na primer MyNewSolution.
Izberite Potrdi, da shranite spremembe.
V Azure DevOps pojdite v Pipelines in nato izberite Create a New Pipeline.
Izberite Azure Repos Git za svoj repozitorij kode.
Izberite shrambo DevOps, ki vsebuje YAML prodajnega lijaka za uvedbo.
Na strani Konfiguriraj svoj cevovod izberi Obstoječo Azure Pipelines YAML datoteko, pokaži na YAML datoteko v svojem repozitoriju, ki si jo ustvaril prej, in nato izberi Continue.
Izberite Shrani, izberite (…) poleg Zaženi prodajni cevovod in nato izberite Preimenuj/Premakni.
Spremenite ime prodajnega procesa v deploy-validation-MyNewSolution, deploy-test-MyNewSolution ali deploy-prod-MyNewSolution, kjer je MyNewSolution ime vaše rešitve.
Izberite možnost Shrani.
Če vaš novi cevovod ni bil ustvarjen v privzeti veji repozitorija: v cevovodu izberite Uredi . V zgornjem desnem kotu izberite (…) in nato izberite Sprožilci. Izberite zavihek YAML, nato pa izberite Pridobi vire. Spremenite privzeto vejo za ročne in načrtovane gradnje, da bo kazala na vašo vejo rešitve. Več o tem, kako konfigurirati sprožilce prodajnega cevovoda.
Ponovite prejšnje korake, da ustvarite cevovod uvajanja za vsako od svojih okolij, pri čemer se sklicujte na vzorčni YAML cevovoda uvajanja iz repozitorija coe-alm-accelerator-templates (deploy-validation-SampleSolution.yml, deploy-test-SampleSolution.yml in deploy-prod-SampleSolution.yml).
Izberite Shrani in se postavi v čakalno vrsto in nato še Shrani.
Ustvarjanje prodajnega lijaka za uvajanje rešitev (izbirno)
Kot smo že omenili, koraki v prejšnjem razdelku ustvarijo cevovode, ki gradijo in uvajajo okolja za validacijo, testiranje in produkcijo. Lahko pa ustvarite ločen cevovod za uvajanje rešitev, če želite graditi in uvajati samo za preverjanje veljavnosti in testiranje, nato pa artefakte iz testne gradnje uvajati v produkcijo.
Sledite korakom v tem razdelku, da ustvarite cevovod za uvajanje rešitve iz vzorčnega cevovoda YAML. Naslednja tabela opisuje konfiguracijo cevovoda.
Pomembno
Ime prodajnega cevovoda mora biti natančno tako, kot je prikazano v naslednji tabeli, z imenom vaše rešitve namesto MojaNovaRešitev.
| Ime datoteke YAML prodajnega lijaka | Ime prodajnega lijaka | Pravilnik veje omogočen |
|---|---|---|
| deploy-prod-MojaNovaRešitev.yml | deploy-prod-MojaNovaRešitev | No |
V Azure DevOps pojdite v repozitorij, ki vsebuje mapo pipelines, ki ste jo vložili in izberite mapo Pipelines.
Odprite vzorčni cevovod za uvajanje deploy-prod-pipeleinartifact-SampleSolution.yml in kopirajte datoteko YAML, ki jo boste uporabili v novem cevovodu.
Zabeležite si ime shrambe za uporabo v vašem prodajnem lijaku.
Pojdite v shrambo, ki jo želite uporabiti za nadzor izvorne kode za rešitev.
V zgornjem meniju izberite Novo in nato izberite Datoteka.
Poimenujte novo datoteko YAML cevovoda; na primer deploy-prod-MyNewSolution.yml, kjer je MyNewSolution ime vaše rešitve.
izberite Ustvari.
Prilepite datoteko YAML, ki ste jo kopirali v 2. koraku, v novo datoteko cevovoda.
V novem YAML cevovoda spremenite naslednje vrednosti:
Spremembe Sprožilec>Veje>Vključi med veje, v katerih naj spremembe sprožijo uvajanje v produkcijo.
Spremenite ime repozitorijev virov v ime repozitorija, ki vsebuje predloge vaših prodajnih poti. >>
V tem primeru se repozitorij imenuje coe-alm-accelerator-templates in obstaja v istem projektu kot repozitorij MyNewSolution . Če je vaš repozitorij predlog v drugem Azure DevOps projektu, uporabite format ProjectName/RepoName. Po potrebi lahko s parametrom
refdoločite tudi vejo, kjer se nahajajo vaše predloge.Posodobite Viri>Cevovodi>Vir , da določite cevovod gradnje, ki vsebuje artefakte, ki jih mora ta cevovod namestiti. V tem primeru boste namestili artefakte iz testnega cevovoda, ki ste ga ustvarili prej in s katerim ste zgradili in namestili svojo rešitev v testno okolje.
Spremenite katero koli vrednost, ki se nanaša na SampleSolutionName , v enolično ime vaše rešitve; na primer MyNewSolution.
Ponovite korake od 11 do 20 v prejšnjem razdelku za deploy-validation-ALMAcceleratorSampleSolution in deploy-test-ALMAcceleratorSampleSolution, da ustvarite cevovod iz novega produkcijskega cevovoda YAML z imenom deploy-prod-ALMAcceleratorSampleSolution.
Nastavitev spremenljivk cevovoda za uvajanje
Za vsak cevovod uvajanja, ki ste ga konfigurirali prej, morate nastaviti vrednosti spremenljivk EnvironmentName in ServiceConnection glede na okolje, v katerega se cevovod uvaja. Lahko tudi nastavite spremenljivko EnableFlows, da izklopi Power Automate tokove kot del namestitve.
Ustvarjanje spremenljivk okolja in povezave storitve (obvezno)
Vsak uvajalni cevovod zahteva spremenljivko okolja EnvironmentName in spremenljivko povezave storitve ServiceConnection.
EnvironmentNamedoloča Azure DevOps okolje ki se namešča za sledenje zgodovini uvajanja ter nastavitev dovoljenj in odobritev za uvajanje v določena okolja. To vrednost nastavite na Preveri, Testiraj ali Produkcija, kot je ustrezno.ServiceConnectiondoloča, kako se cevovod uvajanja poveže z Power Platform. Dovoljene vrednosti so imena povezav s storitvami, ki ste jih ustvarili prej. ...
Izberite Uredi za vsakega od prodajnih lijakov za uvajanje.
V definiciji cevovoda uvajanja izberite Spremenljivke , da odprete urejevalnik spremenljivk.
Če želite dodati spremenljivko, izberite (+). Vnesite ime spremenljivke in ustrezno vrednost.
Ponovite te korake, da ustvarite spremenljivki EnvironmentName in ServiceConnection .
Ustvarjanje spremenljivke EnableFlows variable (izbirno)
Vrednost cevovodne spremenljivke z imenom EnableFlows lahko nastavite na False, da preskočite korake, ki samodejno omogočajo Power Automate tokove kot del namestitve. Privzeta vrednost spremenljivke EnableFlows je True.
Nastavitev pravilnikov vej za potrjevanje zahtev za vlečenje
Ustvarite **pravilnik veje**, ki bo izvedla cevovod, ki ste ga ustvarili prej, ko je ustvarjena zahteva za prevzem. ...
V Azure DevOps pojdi na Repos in nato izberi mapo Branches.
Poiščite vejo, za katero želite ustvariti pravilnik zahteve za vlečenje. Izberite (…) desno od veje in nato izberite Pravilniki veje.
Na strani Pravilniki vej pojdite na možnost Preverjanje gradnje.
Izberite +, da dodate nov pravilnik veje.
Na seznamu Zgradi cevovod izberite cevovod, ki ste ga ustvarili prej.
Če je primerno, določite filter poti , da zagotovite, da cevovod za zahtevo za vlečenje sprožijo samo spremembe navedene poti.
Nastavite Sprožilec na Samodejen.
Nastavite Zahteva pravilnika na Zahtevan.
Nastavite Potek gradnje na Takoj.
Nastavite Prikazno ime za pravilnik veje; na primer Preverjanje gradnje PR.
Izberite možnost Shrani.
Nastavitev dovoljenj za dostop do virov za cevovode
Cevovodi za delovanje potrebujejo dostop do potrebnih virov, kot so repozitoriji, skupine spremenljivk in storitvene povezave. Za omogočanje dostopa imate tri možnosti.
Omogočite dostop med prvim zagonom
Dostop do zahtevanega vira lahko dovolite med prvim zagonom cevovoda.
- Sproži cevovod in odpri cevovod zaženi v Azure DevOps.
- V pasici »zahtevano dovoljenje« izberite Ogled .
- Za vsak zahtevani vir izberite Dovoli .
Daj izrecno dovoljenje
Cevovodu lahko daste izrecno dovoljenje za dostop do zahtevanih repozitorijev.
- V Azure DevOps odpri nastavitve Projekt.
- Izberite Repozitoriji in nato izberite repozitorij.
- Izberite zavihek Varnost.
- Pomaknite se navzdol do Dovoljenja cevovoda in izberite +.
- Izberite prodajni lijak, kateremu želite omogočiti dostop do shrambe.
Cevovodu lahko daste izrecno dovoljenje za dostop do zahtevanih skupin spremenljivk.
- V Azure DevOps izberite Pipelines>Library in nato izberite skupino spremenljivk.
- Izberite Dovoljenja za prodajne lijake.
- Izberite + in nato izberite prodajni cevovod, ki mu želite omogočiti dostop do skupine spremenljivk.
Cevovodu lahko daste izrecno dovoljenje za dostop do zahtevanih servisnih povezav.
- V Azure DevOps odpri nastavitve Projekt.
- Izberite Povezave storitev in nato izberite povezavo storitve.
- Izberite Več dejanj (…) in nato izberite Varnost.
- Pomaknite se navzdol do Dovoljenja cevovoda in izberite +.
- Izberite cevovod, ki mu želite omogočiti dostop do servisne povezave.
Omogočite dostop do vseh cevovodov
Vsem cevovodom, tako tistim, ki jih imate zdaj, kot tistim, ki jih boste ustvarili v prihodnosti, lahko dovolite dostop do zahtevanih repozitorijev.
- V Azure DevOps odpri nastavitve Projekt.
- Izberite Repozitoriji in nato izberite repozitorij.
- Izberite zavihek Varnost.
- Premaknite se navzdol do možnosti Dovoljenja za prodajne lijake.
- Izberite Več dejanj (…), izberite Odpri dostop in nato potrdite, ko ste pozvani.
Vsem cevovodom lahko dovolite dostop do zahtevanih skupin spremenljivk.
- V Azure DevOps izberite Pipelines>Library in nato izberite skupino spremenljivk.
- Izberite Dovoljenja za prodajne lijake.
- Izberite Več dejanj (…), izberite Odpri dostop in nato potrdite, ko ste pozvani.
Vsem cevovodom lahko dovolite dostop do zahtevanih servisnih povezav.
- V Azure DevOps odpri nastavitve Projekt.
- Izberite Povezave storitev in nato izberite povezavo storitve.
- Izberite Več dejanj (…) in nato izberite Varnost.
- Izberite povezavo storitve, izberite Več dejanj (…) in nato izberite Varnost.
- Premaknite se navzdol do možnosti Dovoljenja za prodajne lijake.
- Izberite Več dejanj (…), izberite Odpri dostop in nato potrdite, ko ste pozvani.
Nastavitev obsega avtorizacije opravila
Obseg avtorizacije delovnih mest je mogoče nastaviti za celotno organizacijo Azure DevOps ali za določen projekt. Onemogoči Omeji obseg avtorizacije nalog na trenutni projekt za release pipelines nastavitev, če izbereš drug Azure DevOps projekt za namestitev predlog.
Nastavitev obsega avtorizacije dela na ravni organizacije za vse projekte
- V Azure DevOps izberite nastavitve Organizacijske nastavitve > Cevovodi > Nastavitve.
- Onemogočite nastavitev Omeji obseg avtorizacije opravila na trenutni projekt za cevovode izdaje .
Ustvarjanje konfiguracije uvajanja (neobvezno)
Po uvedbi rešitve morate v ciljnem okolju ustvariti več konfiguracij. Te konfiguracije so specifične za okolje in vključujejo reference povezav, okoljske spremenljivke ter dovoljenja za Microsoft Entra skupine in ekipe Dataverse, poleg deljenja canvas aplikacij in posodabljanja lastništva komponent rešitve, kot so Power Automate tokovi. Poleg teh konfiguracij ciljno okolje pogosto potrebuje vzorčne ali konfiguracijske podatke, ki so povezani s tabelami v rešitvi, da se zagotovi celovita izkušnja ALM. Dataverse
Če vaša rešitev zahteva te druge konfiguracije ali podatke, sledite navodilom v vodniku za konfiguracijo uvajanja za konfiguriranje cevovodov glede na okolja, v katera uvajate.
Uvoz rešitve in konfiguracija aplikacije
Uvozite aplikacijo ALM Accelerator canvas v svoje okolje Power Platform in nato nastavite priloženi prilagojeni konektor za Azure DevOps.
Namestite pospeševalnik ALM v Dataverse
Rešitev ALM Accelerator je odvisna od kompleta Creator Kit. ... Namestite komplet za ustvarjalce zdaj.
Prenesite najnovejšo datoteko upravljane rešitve z GitHub. Pomaknite se navzdol do Sredstva in izberite CenterofExcellenceALMAccelerator_<najnovejšo različico>_managed.zip.
Prijavite se v Power Apps in nato izberite okolje, kjer želite gostiti aplikacijo ALM Accelerator.
V levi stranski plošči izberite Rešitve.
Izberite Uvozi rešitev>Prebrskaj, nato pa poiščite lokacijo prenesene upravljane rešitve in izberite datoteko.
Izberite Naprej in nato ponovno Naprej.
Na strani Povezave izberite ali ustvarite povezavo, da povežete povezavo CDS DevOps z Dataverse.
Ko ustvarite povezavo za HTTP z Microsoft Entra, uporabite Microsoft Graph za oba parametra.
Izberite Uvozi.
Konfiguriranje priključka po meri DevOps
Izberite Podatki>Povezovalniki po meri>CustomAzureDevOps.
Izberite Uredi. Na strani Varnost izberite Uredi in nato nastavite naslednja polja:
Imenu Vrednost Vrsta preverjanja pristnosti OAuth 2.0 Ponudnik identitete Azure Active Directory ID stranke ID aplikacije (odjemalca), ki ste ga kopirali pri ustvarjanju registracije aplikacije ... Skrivnost odjemalca Skrivna vrednost aplikacije (odjemalca), ki ste jo kopirali pri ustvarjanju registracije aplikacije ... ID najemnika Pustite privzeto vrednost, common URL vira ID aplikacije DevOps (odjemalca), ki ste ga kopirali, ko ste registraciji aplikacije dodali dovoljenja ... URL za preusmeritev Samodejno generira. Če pod možnostjo »URL za preusmeritev« opazite potrditveno polje »Posodobi na edinstven URL za preusmeritev«, ga označite. Izberite Posodobi priključek.
Dodajte »URL preusmeritve« kot »URI preusmeritve«
Samodejno generiran »URL za preusmeritev« iz zgornjega razdelka je treba dodati kot »URI za preusmeritev« v registracijo aplikacije.
V levi stranski plošči izberite Pregled.
Izberite Dodaj URI za preusmeritev.
Izberite + Dodaj platformo in nato izberite Splet.
V besedilno polje URI-ji za preusmeritev prilepite samodejno ustvarjen »URL za preusmeritev«, kopiran iz zgornjega razdelka.
Izberite Konfiguriraj.
Preizkusite konektor po meri
Odprite meni Test.
Izberite Nova povezava in nato sledite pozivom za ustvarjanje povezave.
V Power Apps izberite svoje okolje in nato izberite Dataverse>Custom Connectors>CustomAzureDevOps.
Izberite Uredi, pojdite na stran Preizkus in nato poiščite operacijo Pridobi organizacije .
Izberite Testno delovanje.
Potrdite, da je Response Status vrnjen 200 in da je Response Body JSON predstavitev vaše Azure DevOps organizacije.
Nastavitev ustvarjalcev za uporabo aplikacije ALM Accelerator
Nastavite uporabniška dovoljenja za ustvarjalčev račun v Dataverse in Azure DevOps.
Konfigurirajte nastavitve uporabnika za uvajanje , da nastavite uporabniško izkušnjo aplikacije in omogočite dostop do rešitev in profilov uvajanja.