Deli z drugimi prek

Ročno konfiguriranje storitve ALM Accelerator

  • Članek

Komponente ALM Accelerator for Power Platform lahko konfigurirate bodisi z uporabo priložene administratorske aplikacije ali ročno. Ta članek vas vodi skozi ročno konfiguriranje aplikacije in je razdeljen na sedem razdelkov:

Zahteve

Preden namestite ALM Accelerator for Power Platform, se prepričajte, da ste izpolnili naslednje predpogoje.

  • ALM Accelerator mora biti nameščen v Power Platform okolje, ki ima Microsoft Dataverse zbirko podatkov. Vsa okolja, v katerih uporabljate ALM Accelerator za uvajanje rešitev, zahtevajo tudi Dataverse zbirko podatkov.

    opomba,

    ALM Accelerator ni združljiv z Dataverse for Teams. Tako aplikacija ALM Accelerator kot povezani cevovodi predvidevajo, da uporabljate polno različico Dataverse v vseh okoljih.

    Priporočamo, da ALM Accelerator namestite v isto okolje kot druge rešitve CoE Starter Kit. Več o tem, kako določiti najboljšo strategijo za svojo organizacijo:

  • ALM Accelerator uporablja Azure DevOps za nadzor vira in uvajanja. Če nimate Azure DevOps organizacije, se brezplačno prijavite za do pet uporabnikov na Azure DevOps spletnem mestu.

  • Za dokončanje korakov v tem razdelku potrebujete naslednje uporabnike in dovoljenja v Azure, Azure DevOps in Power Platform:

    • Uporabnik z licenco Azure z dovoljenji za ustvarjanje in ogled Microsoft Entra skupin, ustvarjanje registracij aplikacij in odobritev skrbniškega soglasja za registracije aplikacij v Microsoft Entra ID
    • Licencirani Azure DevOps uporabnik z dovoljenji za ustvarjanje in upravljanje cevovodov, povezav storitev, skladišč in razširitev
    • Licencirani Power Platform uporabnik z dovoljenji za ustvarjanje uporabnikov aplikacije in jim dodeljevanje skrbniških dovoljenj

  • Za skupno uporabo v okolju, v katerega je uvožen ALM Accelerator, morajo biti na voljo naslednji priključki:

  • Namestite Creator Kit v okolje, kjer namestite ALM Accelerator.

Osnovna nastavitev

Naslednji koraki so splošni za funkcionalnost ALM Acceleratorja in niso specifični za noben projekt ali rešitev.

Ustvarite registracijo aplikacije v svojem Microsoft Entra okolju

Ustvarite registracijo aplikacije za ALM Accelerator, da aplikaciji in povezanim 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 za Dataverse in Azure DevOps. Vendar pa boste morda želeli ustvariti ločene registracije aplikacij za razdelitev odgovornosti. Razmislite o tem, kako ločene registracije aplikacij vplivajo na vzdrževanje in varnost preden se odločite za strategijo registracije aplikacij.

Ustvarite registracijo aplikacije

  1. Vpišite se v portal Azure.

  2. Izberite Microsoft Entra ID>Registracije aplikacij.

  3. Izberite + Nova registracija in nato registraciji dajte ime, na primer ALMAcceleratorServicePrincipal.

  4. Vse druge možnosti pustite na privzetih vrednostih in izberite Registracija.

Dodajte dovoljenja za registracijo aplikacije

  1. V levem stranskem podoknu izberite Dovoljenja API-ja.

  2. Izberite + Dodaj dovoljenje.

  3. Izberite Dynamics CRM, nato pa izberite Delegirana dovoljenja in user_impersonation.

  4. Izberite Dodaj dovoljenja , da registraciji aplikacije dodate dovoljenje Dynamics CRM API user_impersonation.

  5. Znova izberite + Dodaj dovoljenje .

  6. Izberite zavihek API-ji, ki jih uporablja moja organizacija . Poiščite in izberite PowerApps-Svetovalec, nato pa izberite Delegirana dovoljenja in Analiza. Vse (soglasje skrbnika ni potrebno).

    To dovoljenje je potrebno za izvajanje statične analize prek preverjevalnika aplikacij.

  7. Izberite Dodaj dovoljenja , da registraciji aplikacije dodate dovoljenje PowerApps-Advisor API Analysis.All.

  8. Znova izberite + Dodaj dovoljenje .

  9. Na zavihku Microsoft API-ji ali API-ji, ki jih uporablja moja organizacija izberite Azure DevOps in nato izberite Delegirana dovoljenja in user_impersonation.

    To dovoljenje je potrebno za povezovanje z Azure DevOps prek priključka po meri v aplikaciji ALM Accelerator.

  10. Če ste dodali Azure DevOps dovoljenje z zavihka API-ji, ki jih uporablja moja organizacija , kopirajte ID aplikacije (odjemalca) za kasnejšo uporabo v tem postopku.

    Uporabili ga boste kot ID (odjemalca) aplikacije DevOps, ki se razlikuje od ID-ja (odjemalca) aplikacije kopirali boste kasneje v tem postopku.

    Posnetek zaslona okna z dovoljenji API-ja za zahtevo z označeno kartico API-ji, ki jih uporablja moja organizacija, in ID-jem aplikacije (odjemalca).

    Če ne najdete Azure DevOps dovoljenja na zavihku API-ji, ki jih uporablja moja organizacija , sledite tem korakom za pridobitev ID aplikacije (odjemalca) DevOps:

    1. Odprite zasebno okno brskalnika in pojdite na https://dev.azure.com/<your devops organization>/_apis.
    2. Na strani za prijavo kopirajte vrednost parametra client_id v URL.

    Posnetek zaslona Azure DevOps strani za prijavo organizacije z označenim parametrom client_id v URL-ju.

  11. Izberite Dodaj dovoljenja , da registraciji aplikacije dodate dovoljenje Azure DevOps API user_impersonation.

  12. Izberite Podeli skrbniško soglasje za <vašega najemnika>.

Konfigurirajte skrivnost odjemalca in preusmerite URI

  1. Na levi stranski plošči izberite Certificates & skrivnosti.

  2. Izberite + Nova skrivnost odjemalca.

  3. Izberite datum poteka in nato izberite Dodaj.

  4. Kopirajte skrivnost odjemalca Vrednost za kasnejšo uporabo. To je edini čas, ko lahko kopirate vrednost. To storite, preden zapustite stran.

  5. V levi stranski plošči izberite Pregled.

  6. Kopirajte ID aplikacije (odjemalec) in ID imenika (najemnik).

  7. Izberite Konfiguriraj.

Dajte Power App dovoljenje za upravljanje za registracijo aplikacije

Dodelite Power App dovoljenja za upravljanje za registracijo vaše aplikacije, tako da lahko cevovodi izvajajo dejanja, ki jih potrebujejo v vaših okoljih. Če želite to narediti, zaženite naslednji PowerShell cmdlet kot interaktivni uporabnik, ki ima Power Apps skrbniške pravice. Ta ukaz morate zagnati samo enkrat, potem ko ustvarite registracijo aplikacije.

Pomembno

Naslednji cmdlet PowerShell daje 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, določene zmožnosti ne delujejo v cevovodih ALM Accelerator.

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>

Namestitev razširitev Azure DevOps

ALM Accelerator uporablja več Azure DevOps razširitev, vključno z nekaterimi razširitvami tretjih oseb, ki so na voljo na Azure DevOps tržnici. Spletno mesto vsake razširitve tretje osebe in povezava do njihove izvorne kode sta na voljo v naslednjih navodilih. Naučite se oceniti izdajatelja razširitve Marketplace.

  1. Prijavite se v Azure DevOps.

  2. Izberite Nastavitve organizacije.

  3. Izberite Splošno>Razširitve.

  4. Poiščite in namestite naslednje razširitve:

Kloniranje prodajnih lijakov YAML iz GitHub v primerek Azure DevOps

  1. Pojdite na https://aka.ms/coe-alm-accelerator-templates-latest-release in kopirajte URL najnovejše izdaje.

  2. Prijavite se v Azure DevOps.

  3. Ustvarite projekt ali izberite obstoječi projekt.

  4. Izberite Repozitorijin nato izberite Uvozi repozitorij na seznamu repozitorija.

  5. Prilepite URL, ki ste ga kopirali v korak 1, kot Kloniraj URL in nato izberite Uvozi.

  6. Potrdite, da je privzeta veja za repo main. Izberite Repozitorije in Podružnice in se prepričajte, da glavni veja je označena kot privzeta.

    Če ni, izberite tri navpične pike (⋮), ki ustrezajo glavni veji, in od v meniju Več možnosti izberite Nastavi kot privzeto podružnica.

    opomba,

    Ta repo je mesto, kjer se izvajajo predloge cevovoda rešitev in izvozno/uvozni cevovodi. Pozneje, ko ustvarite cevovode za svoje rešitve, se boste morda morali sklicevati na ta določen projekt in repo, če se odločite za uporabo drugega repoja za nadzor vira za svoje rešitve.

Ustvarjanje prodajnih lijakov za uvažanje, brisanje in izvažanje rešitev

Ustvarite cevovode za uvoz, brisanje in izvoz na podlagi YAML v Azure DevOps repoju. Ti cevovodi se izvajajo, ko uporabljate aplikacijo za objavo 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 drugačna izvozna dejanja glede na rešitev. V tem primeru lahko pripnete ime rešitve cevovodu export-solution-to-git, na primer export-solution-to-git-SampleSolution, da imate aplikacijo izvajajo vaše posebne cevovode rešitev, ko izvajate dejanja v aplikaciji.

Naslednja tabela prikazuje ujemanje med datoteko YAML v repoju in njenim spremljajoč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

  1. V Azure DevOps odprite Prodajni lijaki>Ustvari nov prodajni lijak.

  2. Izberite Azure Repos Git za vaš repozitorij kode in nato pokažite na Azure DevOps repo, ki ste ga ustvarili in zasejali s predlogami cevovoda v prejšnjih korakih.

  3. Na strani Konfiguriranje prodajnega lijaka izberite obstoječo datoteko YAML prodajnih lijakov Azure in pokažite na /Pipelines/export-solution-to-git.yml, /Pipelines/import-unmanaged-to-dev-environment.yml ali /Pipelines/delete-unmanaged-solution-and-components.yml.

  4. Izberite Nadaljujin nato izberite Shrani.

  5. Izberite meni Več (…) poleg Zaženi cevovod in nato izberite Preimenuj/Premakni.

  6. Spremenite ime cevovoda v export-solution-to-git, import-unmanaged-to-dev-environment, ali izbrišite-neupravljane-rešitve-in-komponente, kot je ustrezno.

  7. Izberite možnost Shrani.

Ustvarjanje izvoznih spremenljivk prodajnega lijaka (izbirno)

Spremenljivke cevovoda lahko nastavite v cevovodu export-solution-to-git, da nadzorujete, katere informacije se ohranijo za nadzor vira. Če želite te nastavitve uporabiti globalno, nastavite spremenljivke v cevovodu izvozne rešitve v git. Če želite uporabiti nastavitve 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 spremenljivk okolja med postopkom izvoza nikoli niso dodeljene nadzoru vira, ustvarite spremenljivko DoNotExportCurrentEnvironmentVariableValues v cevovodu izvozne rešitve v git in nastavite njeno vrednost na True.

Pomembno

Ta spremenljivka cevovoda je priporočljiva, da lahko uporabite funkcionalnost konfiguracije razmestitve v pospeševalniku ALM.

Če želite zagotoviti, da so vrednosti določenih privzetih spremenljivk okolja nastavljene med izvozom rešitve, ustvarite spremenljivko VerifyDefaultEnvironmentVariableValues v cevovodu izvozne rešitve-v-git in nastavite njeno vrednost na True. Nastavite vrednosti privzetih spremenljivk okolja v customDeploymentSettings.json, kot je opisano v vodniku za konfiguracijo uvajanja.

  1. V Azure DevOps izberite Cevovodi>Knjižnica>Ustvari novo skupino spremenljivk.

  2. Poimenujte novo skupino spremenljivk alm-accelerator-variable-group, natančno tako, kot je navedeno tukaj.

    Cevovodi se nanašajo na to specifično skupino spremenljivk, zato mora biti poimenovana točno tako, kot je prikazano. Če se odločite za uporabo drugačnega dogovora o poimenovanju za vašo skupino spremenljivk, morate spremeniti dele cevovodov, da se namesto tega nanašajo na ime, ki ga uporabljate.

  3. V skupino spremenljivk dodajte naslednje spremenljivke:

    Imenu Description Vrednost
    AADHost Pooblastilo Microsoft Entra končna točka Za javne oblake uporabite login.microsoftonline.com. Za vladne oblake uporabite ustrezen avtorizacijski URL.
    ProcessCanvasApps Ali so aplikacije platna razpakirane med izvozom ali pakirane med gradnjo Če je False, potem se aplikacije platna ne razpakirajo med izvozom ali zapakirajo med gradnjo. Funkcija razpakiranja in pakiranja aplikacije Canvas je v predogledna različica in je trenutno ne priporočamo za uporabo v produkcijskih okoljih. Vendar pa si v nadzoru vira ne morete ogledati izvorne kode platna, razen če to spremenljivko nastavite na True.

  4. (Izbirno) Če v svojih cevovodih uporabljate avtomatizacijo preskusov Canvas Studio, v skupino spremenljivk dodajte naslednje spremenljivke:

    Imenu Vrednost
    TestAutomationLoginMethod CloudIdentity
    TestAutomationMakerPortalUrl URL s portala Power Apps maker, običajno *https://make.powerapps.com*
    TestAutomationUsername Uporabniški račun, ki se uporablja za izvajanje samodejnih testov
    TestAutomationPassword Geslo za uporabniški račun, ki se uporablja za izvajanje samodejnih testov

  5. (Izbirno) Privzeto so globalne spremenljivke omejene in morate konfigurirati dostop za vsak cevovod. To lahko poenostavite in dovolite dostop kateremu koli cevovodu. Pod Skupino spremenljivk (Cevovodi>Knjižnica>alm-accelerator-variable-group), izberite Cevovod dovoljenja v zgornjem meniju izberite (…) in nato izberite Odprti dostop.

Nastavite dovoljenja za storitev gradnje projekta

Pomembno

Azure DevOps vsebuje številne račune »Build Service«, zato bo morda 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.

  1. V Azure DevOps izberite Nastavitve projekta.

  2. Izberite Shrambe>Varnost.

  3. Pod Uporabniki poiščite in izberite Project Collection Build Service (Ime vaše organizacije).

    opomba,

    Morda ne boste videli Imena vaše organizacije za Project Collection Build Service uporabnikom. Lahko je samo edinstven identifikator. V tem primeru uporabite funkcijo iskanja, da poiščete uporabnika in ga nato izberete.

  4. Nastavite naslednja dovoljenja za uporabnika storitve gradnje:

    Dovoljenje Vrednost
    Prispevanje Dovoli
    Prispevanje zahtevkom za uveljavitev sprememb Dovoli
    Ustvarjanje veje Dovoli
    Urejanje pravilnikov Dovoli

  5. Pod Uporabniki poiščite in izberite Ime vašega projekta Build Service (Vaša organizacija Ime).

  6. Nastavite enake vrednosti kot v korak 4.

  7. Izberite Pipelines, izberite tri pike (…) v zgornjem desnem kotu in nato izberite Upravljanje varnosti.

  8. Nastavite naslednja dovoljenja za Ime vašega projekta Storitev gradnje (Ime vaše organizacije) uporabnik:

    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
    Pogled gradi cevovod Dovoli
    Ogled gradenj Dovoli

  9. Izberite Nastavitve projekta>posrednik pools, izberite Varnostin nato izberite Dodaj.

  10. Poiščite in izberite Ime vašega projekta Storitev gradnje (Ime vaše organizacije).

  11. Nastavite Vlogo na Uporabnik z dovoljenjem za branje.

  12. Izberite Dodaj.

  13. (Izbirno) Privzeto so dovoljenja za cevovod za vsako skladišče omejena in jih morate konfigurirati posebej. To lahko poenostavite in dovolite dostop kateremu koli cevovodu. V razdelku Nastavitve projekta>Repozitoriji po vrsti izberite vsako skladišče. V zgornjem meniju izberite Varnost . Poiščite blok Pipeline permissions , izberite (…) in nato izberite Odpri dostop.

Nastavitev razvojnega projekta

Naslednji razdelek vas vodi skozi korake, potrebne za nastavitev vsakega od razvojnih projektov, ki jih podpirate. V tem kontekstu razvojni projekt obsega infrastrukturo in konfiguracijo, ki podpira zdravo upravljanje življenjskega cikla aplikacije (ALM), vključno s konfiguracijo Dataverse okolja, ki podpira sam proces ALM.

Ustvarite storitvene povezave za Azure DevOps dostop Power Platform

Vsako Dataverse okolje – razvoj, validacija, testiranje in proizvodnja – mora imeti Power Platform storitveno povezavo v Azure DevOps. Izvedite naslednje korake za vsako od svojih okolij.

opomba,

Uporabniki aplikacije ALM Accelerator vidijo samo okolja, v katerih imajo vlogo uporabnika ali skrbnika na povezavi storitve v Azure DevOps. Če delajo v osebnih razvojnih okoljih, morajo imeti izdelovalci uporabniško ali skrbniško vlogo na servisni povezavi za svoje osebno razvojno okolje. Povezave storitev validacije, testiranja in produkcijskega okolja, kot je storitev gradnje, potrebujejo samo dovoljenja, dodeljena cevovodom.

  1. Prijavite se v Azure DevOps in nato izberite svoj projekt.

  2. Izberite Nastavitve projekta>Storitvene povezavein nato izberite Ustvari storitveno povezavo.

  3. Poiščite in izberite Power Platform vrsto storitvene povezave.

  4. Izberite Naprej.

  5. Za URL strežnika vnesite URL vašega okolja; na primer https://myorg.crm.dynamics.com/.

    Pomembno

    V URL morate vključiti končno poševnico (/); to je po .com v tem primeru.

  6. Za Ime storitvene povezave vnesite isti URL, kot ste ga vnesli v korak 4, vključno s poševnico za usposabljanje (/).

  7. Vnesite ID najemnika, ID aplikacije (odjemalca)in Skrivnost odjemalca ko ste kopirali Microsoft Entra ko ste ustvarili registracijo aplikacije.

  8. Izberite Dodeli dovoljenja za dostop vsem cevovodom.

  9. Izberite možnost Shrani.

Storitvene povezave morajo zagotoviti uporabniška dovoljenja za vse uporabnike v vseh okoljih, do katerih morajo uporabniki imeti dostop iz aplikacije (na primer okolja izdelovalcev).

  1. Na seznamu Storitvene povezave izberite storitevno povezavo, ki jo želite deliti z uporabniki.

  2. Izberite Več (…) v zgornjem desnem kotu in nato izberite Varnost.

  3. Na seznamu Skupina ali Uporabnik izberite uporabnika ali skupino, ki ji želite zagotoviti uporabniška dovoljenja.

  4. Izberite Uporabnik, izberite Vlogo in nato izberite Dodaj.

Ponovite korake v tem razdelku za vsako vaše razvojno, validacijsko, testno in produkcijsko okolje.

Nastavite dovoljenja za storitev gradnje projekta za uporabo povezav storitve

  1. V Azure DevOps izberite Nastavitve projekta>Storitvene povezave.

  2. Izberite (…) v zgornjem desnem kotu, izberite Varnost in nato izberite Dodaj.

  3. Poiščite in izberite Ime vašega projekta Storitev gradnje (Ime vaše organizacije).

  4. Nastavite Vlogo na Administratorin nato izberite Dodaj.

Ustvarite uporabnika aplikacije v okolju Dataverse

Ustvarite uporabnika aplikacije v svojih okoljih, da omogočite povezavo cevovodov z Dataverse. To storite v vsakem okolju, v katerem nameravate uporabiti pospeševalnik ALM za uvajanje.

  1. Prijavite se v Power Platform skrbniško središče.

  2. Izberite svoje razvojno okolje in nato izberite Nastavitve.

  3. Izberite Uporabniki in dovoljenja>Uporabniki aplikacije.

  4. Izberite + Nov uporabnik aplikacije.

  5. Izberite + Dodaj aplikacijo, izberite registracijo aplikacije, ki ste jo ustvarili prej, in nato izberite Dodaj.

  6. Izberite poslovno enoto.

  7. Izberite ikono svinčnika na desni strani Varnostne vloge in nato izberite varnostne vloge za uporabnika aplikacije.

    Priporočamo, da uporabniku aplikacije dodelite privilegije sistemskega skrbnika varnostna vloga, tako da lahko uporabnik izvaja zahtevane funkcije v vsakem okolju.

  8. izberite Ustvari.

Ponovite te korake v validacijskem, testnem in produkcijskem okolju.

Nastavitev rešitve

Ko ustvarite rešitev v Dataverse, morate ustvariti cevovode posebej za to rešitev. Naslednji vzorčni cevovodi so vključeni v imenik Pipelines v coe-alm-templates repozitoriju:

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. Ponovite te korake za vsako rešitev, za katero uporabljate ALM Accelerator za nadzor vira.

Pomembno

YAML za vaš cevovod rešitev je vedno shranjen v istem skladišču, ki ga uporabljate za nadzor vira za svojo rešitev. Vendar lahko predloge cevovoda – to je mapa Pipeline\Templates – obstajajo v istem repo-ju kot vaš cevovod YAML rešitve ali v ločenem repo-ju 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. Vzorci cevovodov predvidevajo, da uporabljate samo tri okolja: preverjanje, testiranje in proizvodnjo. Vendar pa lahko glede na strategijo okolja vaše organizacije ustvarite poljubno število cevovodov rešitev.

Cevovodi za vzorčno uvajanje se sprožijo s spremembami veje (to je preizkus in proizvodnja) ali kot del politike veje v Azure DevOps (to je validacija). Izvedite več o nastavitvi pravilnikov podružnice za preverjanje zahtev po vleku. Cevovode lahko zaženete tudi ročno, brez sprožilca.

Sledite korakom v tem razdelku, da ustvarite cevovode za uvajanje iz vzorčnega cevovoda YAML. Naslednja tabela opisuje konfiguracijo cevovoda.

Pomembno

Ime cevovoda mora biti točno tako, kot je prikazano v naslednji tabeli, z imenom vaše rešitve namesto MyNewSolution.

Ime datoteke YAML prodajnega lijaka Ime prodajnega lijaka Pravilnik veje omogočen Zahtevano
build-deploy-validation-MyNewSolution.yml deploy-validation-MyNewSolution Da Da
build-deploy-test-MyNewSolution.yml deploy-test-MyNewSolution No Da
build-deploy-prod-MyNewSolution.yml deploy-prod-MyNewSolution No Ne (Premakni se na naslednji razdelek)

opomba,

Naslednji koraki ustvarijo gradbene in razmestitvene cevovode za validacijsko, testno in produkcijsko okolje. Vendar pa boste morda želeli zgraditi in razmestiti za validacijo in preizkus ter nato razmestiti artefakte iz testne gradnje v proizvodnjo. Če je temu tako, sledite korakom v tem razdelku samo za svoja okolja za preverjanje veljavnosti in preizkusa. Nato preskočite na Ustvarite rešitev cevovod uvajanja da konfigurirate svoj cevovod izdaje.

Ustvarite datoteko cevovoda

  1. V Azure DevOps pojdite na shrambo, ki vsebuje mapo prodajnih lijakov, ki ste jih odobrili, in izberite mapo Prodajni lijaki.

  2. Odprite enega od treh vzorčnih cevovodov za uvajanje in kopirajte YAML za uporabo v novem cevovodu.

  3. Zabeležite si ime shrambe za uporabo v vašem prodajnem lijaku.

  4. Pojdite v shrambo, ki jo želite uporabiti za nadzor izvorne kode za rešitev.

  5. Ustvarite vejo na podlagi vaše 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 je treba razvejati iz te veje v osebno delovno vejo razvijalca in nato združiti v vejo v-next, da se potisne v validacijo in testiranje. Pozneje, ko je izdaja pripravljena, lahko vejo v-next združite z glavno ali privzeto vejo.

  6. V zgornjem meniju izberite Novo in nato izberite Mapa.

  7. Novi mapi dajte isto ime kot vaši rešitvi.

  8. Poimenujte novo datoteko YAML cevovoda, na primer build-deploy-validation-SampleSolution.yml, build-deploy-test-SampleSolution. yml, ali build-deploy-prod-SampleSolution.yml.

  9. izberite Ustvari.

Posodobite in shranite datoteko

  1. Prilepite YAML, ki ste ga kopirali v korak 2 v prejšnjem razdelku, v novo datoteko cevovoda.

  2. Spremenite naslednje vrednosti v novem cevovodu YAML:

    • Spremenite Vire>Repozitorije>Ime v ime repoja, ki vsebuje vaše predloge cevovoda.

      V tem primeru se repo imenuje coe-alm-accelerator-templates in obstaja v istem projektu kot MyNewSolution repo. Če je vaše skladišče predlog v drugem Azure DevOps projektu, uporabite obliko ProjectName/RepoName. Po potrebi lahko s parametrom ref določite tudi vejo, kjer živijo vaše predloge.

    • Spremenite katero koli vrednost, ki se nanaša na SampleSolutionName v edinstveno ime vaše rešitve; na primer MojaNovaRešitev.

  3. Izberite Potrdi, da shranite spremembe.

  4. V Azure DevOps pojdite na Prodajni lijaki in nato izberite Ustvari nov prodajni lijak.

  5. Izberite Azure Repos Git za shrambo kode.

  6. Izberite shrambo DevOps, ki vsebuje YAML prodajnega lijaka za uvedbo.

  7. Na strani Configure your pipeline izberite Existing Azure Pipelines YAML file, pokažite na datoteko YAML v repo, ki ste ga ustvarili prej, in nato izberite Nadaljuj.

  8. Izberite Shrani, izberite (…) poleg Zaženi cevovod in nato izberite Preimenuj/Premakni.

  9. Spremenite ime cevovoda v deploy-validation-MyNewSolution, deploy-test-MyNewSolutionali deploy-prod-MyNewSolution, kjer je MyNewSolution ime vaše rešitve.

  10. Izberite možnost Shrani.

  11. Če vaš novi cevovod ni bil ustvarjen v privzeti veji repozitorija: izberite Uredi na cevovodu. Izberite (…) v zgornjem desnem kotu 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 cevovoda.

  12. Ponovite prejšnje korake, da ustvarite cevovod uvajanja za vsako od svojih okolij, pri čemer se sklicujete na vzorec cevovod uvajanja YAML iz coe-alm-accelerator-templates repoja (deploy-validation-SampleSolution.yml, deploy-test-SampleSolution.yml, in deploy-prod-SampleSolution.yml).

  13. 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 za validacijska, preskusna in produkcijska okolja. Vendar pa lahko ustvarite ločeno rešitev cevovod uvajanja, če želite zgraditi in razmestiti samo za preverjanje veljavnosti in preizkus ter nato razmestiti artefakte iz preskusne gradnje v proizvodnjo.

Sledite korakom v tem razdelku, da ustvarite rešitev cevovod uvajanja iz vzorčnega cevovoda YAML. Naslednja tabela opisuje konfiguracijo cevovoda.

Pomembno

Ime cevovoda mora biti točno tako, kot je prikazano v naslednji tabeli, z imenom vaše rešitve namesto MyNewSolution.

Ime datoteke YAML prodajnega lijaka Ime prodajnega lijaka Pravilnik veje omogočen
deploy-prod-MyNewSolution.yml deploy-prod-MyNewSolution No

  1. V Azure DevOps pojdite v shrambo, ki vsebuje mapo prodajnih lijakov, ki ste jih potrdili in izberite mapo Prodajni lijaki.

  2. Odprite vzorčni cevovod za uvajanje deploy-prod-pipelineartifact-SampleSolution.yml in kopirajte YAML za uporabo v novem cevovodu.

  3. Zabeležite si ime shrambe za uporabo v vašem prodajnem lijaku.

  4. Pojdite v shrambo, ki jo želite uporabiti za nadzor izvorne kode za rešitev.

  5. V zgornjem meniju izberite Novo in nato izberite Datoteka.

  6. Poimenujte datoteko YAML novega cevovoda; na primer deploy-prod-MyNewSolution.yml, kjer je MyNewSolution ime vaše rešitve.

  7. izberite Ustvari.

  8. Prilepite YAML, ki ste ga kopirali v korak 2, v novo datoteko cevovoda.

  9. Spremenite naslednje vrednosti v novem cevovodu YAML:

    • Spremenite Sprožilec>Veje>Vključite veje, v katerih bi morale spremembe sprožiti razmestitev v proizvodnjo.

    • Spremenite Vire>Repozitorije>Ime v ime repoja, ki vsebuje vaše predloge cevovoda.

      V tem primeru se repo imenuje coe-alm-accelerator-templates in obstaja v istem projektu kot MyNewSolution repo. Če je vaše skladišče predlog v drugem Azure DevOps projektu, uporabite obliko ProjectName/RepoName. Po potrebi lahko s parametrom ref določite tudi vejo, kjer živijo vaše predloge.

    • Posodobite Vire>Cevovodi>Vir , da določite cevovod gradnje, ki vsebuje artefakte, ki naj bi jih ta cevovod razmestil. V tem primeru boste razmestili artefakte iz preskusnega cevovoda, ki ste ga ustvarili prej, ki je zgradil in razmestil vašo rešitev v preskusno okolje.

    • Spremenite katero koli vrednost, ki se nanaša na SampleSolutionName v edinstveno ime vaše rešitve; na primer MojaNovaRešitev.

  10. Ponovite korake od 11 do 20 v prejšnjem razdelku za deploy-validation-ALMAcceleratorSampleSolution in deploy-test-ALMAcceleratorSampleSolution, ustvariti cevovod iz novega proizvodnega cevovoda YAML z imenom deploy-prod-ALMAcceleratorSampleSolution.

Nastavite cevovod uvajanja spremenljivke

Za vsak cevovod uvajanja, ki ste ga konfigurirali prej, morate nastaviti vrednosti spremenljivk EnvironmentName in ServiceConnection glede na okolje, v katerem se izvaja cevovod. Spremenljivko EnableFlows lahko nastavite tudi tako, da izklopi Power Automate tokove kot del razmestitve.

Ustvarjanje spremenljivk okolja in povezave storitve (obvezno)

Vsak cevovod uvajanja zahteva spremenljivko okolja EnvironmentName in spremenljivko storitvene povezave ServiceConnection.

  • EnvironmentName določa Azure DevOps okolje ki se uvaja, da se omogoči sledenje zgodovini uvajanja in nastavite dovoljenja in odobritve za uvajanje v določena okolja. To vrednost nastavite na Validate, Testali Production, kot je primerno.

  • ServiceConnection določa, kako se cevovod uvajanja poveže z Power Platform. Dovoljene vrednosti so imena storitvenih povezav, ki ste jih ustvarili prej.

  1. Izberite Uredi za vsakega od prodajnih lijakov za uvajanje.

  2. Izberite Spremenljivke v definiciji cevovod uvajanja, da odprete urejevalnik spremenljivk.

  3. Č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 spremenljivke cevovoda z imenom EnableFlows lahko nastavite na False, da preskočite korake, ki samodejno omogočijo Power Automate tokove kot del razmestitve. Privzeta vrednost spremenljivke EnableFlows je True.

Nastavite pravilnike podružnice za preverjanje zahtev po vleku

Ustvarite načelo veje za izvedbo cevovoda, ki ste ga ustvarili prej, ko je ustvarjena zahteva za vlečenje.

  1. V Azure DevOps pojdite na možnost Shrambe in nato izberite mapo Veje.

  2. Poiščite vejo, za katero želite ustvariti politiko zahteve po vleku. Izberite (…) na desni strani veje in nato izberite Pravilniki veje.

  3. Na strani Pravilniki vej pojdite na možnost Preverjanje gradnje.

  4. Izberite +, da dodate nov pravilnik veje.

  5. Na seznamu Build pipeline izberite cevovod, ki ste ga ustvarili prej.

  6. Določite Filter poti če je na voljo, da zagotovite, da samo spremembe podane poti sprožijo cevovod za zahtevo po vleki.

  7. Nastavite Sprožilec na Samodejen.

  8. Nastavite Zahteva pravilnika na Zahtevan.

  9. Nastavite Potek gradnje na Takoj.

  10. Nastavite prikazno ime za svojo podružnico; na primer Preverjanje gradnje PR.

  11. Izberite možnost Shrani.

Posnetek zaslona izbire nastavitev za pravilnik gradnje za preverjanje veljavnosti.

Nastavite dovoljenja za dostop do virov za cevovode

Cevovodi za delovanje potrebujejo dostop do potrebnih virov, kot so repozitoriji, skupine spremenljivk in storitvene povezave. Če želite omogočiti dostop, imate tri možnosti.

Odobrite dostop med prvim zagonom

Med prvim zagonom cevovoda lahko dovolite dostop do zahtevanega vira.

  1. Sprožite cevovod in odprite cevovod v Azure DevOps.
  2. V pasici »potrebno dovoljenje« izberite Pogled .
  3. Izberite Dovoljenje za vsak zahtevani vir.

Dajte izrecno dovoljenje

Cevovodu lahko daste izrecno dovoljenje za dostop do zahtevanih skladišč.

  1. V Azure DevOps odprite Nastavitve projekta.
  2. Izberite Repozitorijiin nato izberite repozitorij.
  3. Izberite zavihek Varnost.
  4. Pomaknite se navzdol do Dovoljenja za cevovod in izberite +.
  5. Izberite prodajni lijak, kateremu želite omogočiti dostop do shrambe.

Cevovodu lahko daste izrecno dovoljenje za dostop do zahtevanih skupin spremenljivk.

  1. V Azure DevOps izberite Cevovodi>Knjižnica in nato izberite skupino spremenljivk.
  2. Izberite Dovoljenja za prodajne lijake.
  3. Izberite + in nato izberite cevovod, ki mu želite omogočiti dostop do skupine spremenljivk.

Cevovodu lahko daste izrecno dovoljenje za dostop do zahtevanih povezav storitev.

  1. V Azure DevOps odprite Nastavitve projekta.
  2. Izberite Storitvene povezave in nato izberite storitev.
  3. Izberite Več dejanj (…) in nato izberite Varnost.
  4. Pomaknite se navzdol do Dovoljenja za cevovod in izberite +.
  5. Izberite cevovod, ki mu želite omogočiti dostop do storitvene povezave.

Dovolite dostop vsem cevovodom

Vsem cevovodom, tako tistim, ki jih imate zdaj, kot tistim, ki jih ustvarite v prihodnosti, lahko dovolite dostop do zahtevanih skladišč.

  1. V Azure DevOps odprite Nastavitve projekta.
  2. Izberite Repozitorijiin nato izberite repozitorij.
  3. Izberite zavihek Varnost.
  4. Premaknite se navzdol do možnosti Dovoljenja za prodajne lijake.
  5. Izberite Več dejanj (…), izberite Odprt dostop in nato potrdite, ko ste pozvani.

Vsem cevovodom lahko dovolite dostop do zahtevanih skupin spremenljivk.

  1. V Azure DevOps izberite Cevovodi>Knjižnica in nato izberite skupino spremenljivk.
  2. Izberite Dovoljenja za prodajne lijake.
  3. Izberite Več dejanj (…), izberite Odprt dostop in nato potrdite, ko ste pozvani.

Vsem cevovodom lahko dovolite dostop do zahtevanih povezav storitev.

  1. V Azure DevOps odprite Nastavitve projekta.
  2. Izberite Storitvene povezave in nato izberite storitev.
  3. Izberite Več dejanj (…) in nato izberite Varnost.
  4. Izberite povezavo storitve, izberite Več dejanj (…) in nato izberite Varnost.
  5. Premaknite se navzdol do možnosti Dovoljenja za prodajne lijake.
  6. Izberite Več dejanj (…), izberite Odprt dostop in nato potrdite, ko ste pozvani.

Nastavite obseg pooblastila za delo

Obseg pooblastila za delo je mogoče nastaviti za celotno Azure DevOps organizacijo ali za določen projekt. Če za namestitev predlog izberete drug projekt, onemogočite nastavitev Omeji obseg pooblastila za opravila na trenutni projekt za cevovode izdaje Azure DevOps .

Za nastavitev obsega pooblastila za delo na ravni organizacije za vse projekte

  1. V Azure DevOpsizberite Organizacijske nastavitve > Cevovodi > Nastavitve.
  2. Onemogočite nastavitev Omeji obseg pooblastila za opravila na trenutni projekt za cevovode izdaje .

Ustvarite konfiguracijo uvajanja (neobvezno)

Po uvedbi rešitve morate ustvariti več konfiguracij v ciljnem okolju. Te konfiguracije so specifične za okolje in vključujejo reference povezav, spremenljivke okolja in dovoljenja za Microsoft Entra skupine in Dataverse ekipe, poleg skupne rabe aplikacij platna in posodabljanja lastništva komponent rešitve, kot so kot Power Automate teče. Skupaj s temi konfiguracijami ciljno okolje pogosto potrebuje vzorčne ali konfiguracijske podatke, ki so povezani s Dataverse tabelami v rešitvi, da zagotovi popolno izkušnjo ALM od konca do konca.

Če vaša rešitev zahteva te druge konfiguracije ali podatke, sledite vodniku za konfiguracijo uvajanja da konfigurirate svoje cevovode glede na okolja, v katera uvajate.

Uvozite rešitev in konfigurirajte aplikacijo

Uvozite aplikacijo Canvas ALM Accelerator v svoje Power Platform okolje in nato konfigurirajte vključeni priključek po meri za Azure DevOps.

Namestite pospeševalnik ALM Dataverse

  1. Rešitev ALM Accelerator je odvisna od Creator Kit. Namestite Creator Kit zdaj.

  2. Prenesite najnovejšo datoteko upravljana rešitev z GitHub. Pomaknite se navzdol do Sredstva in izberite CenterofExcellenceALMAccelerator_<najnovejša različica>_managed.zip.

  3. Prijavite se v Power Apps in nato izberite okolje, v katerem želite gostiti aplikacijo ALM Accelerator.

  4. V levem stranskem podoknu izberite Rešitve.

  5. Izberite Uvozi rešitev>Prebrskajin nato poiščite lokacijo upravljana rešitev, ki ste jo prenesli, in izberite datoteko.

  6. Izberite Naprej in nato ponovno Naprej.

  7. Na strani Povezave izberite ali ustvarite povezavo za povezavo povezave CDS DevOps z Dataverse.

    Ko ustvarite povezavo za HTTP z Microsoft Entra, uporabite Microsoft Graph za oba parametra.

  8. Izberite Uvozi.

Konfiguriranje priključka po meri DevOps

  1. Izberite Podatki>Povezovalniki po meri>CustomAzureDevOps.

  2. Izberite Uredi. Na strani Varnost izberite Urediin nato nastavite naslednja polja:

    Imenu Vrednost
    Vrsta avtentikacije OAuth 2.0
    Ponudnik identitete Azure Active Directory
    ID stranke ID aplikacije (odjemalca), ki ste ga kopirali, ko ste ustvarili registracijo aplikacije
    Skrivnost stranke Skrivna vrednost aplikacije (odjemalca), ki ste jo kopirali, ko ste ustvarili registracijo aplikacije
    ID najemnika Pustite privzeto vrednost, common
    URL vira ID Aplikacije DevOps (odjemalca) ki ste ga kopirali, ko ste dodali dovoljenja za registracijo aplikacije
    URL preusmeritve Samodejno ustvarja. Če opazite potrditveno polje »Posodobi edinstven URL za preusmeritev« pod »URL za preusmeritev«, označite potrditveno polje.

  3. Izberite Posodobi priključek.

Dodajte 'URL preusmeritve' kot 'URI preusmeritve'

Samodejno ustvarjeni 'URL za preusmeritev' iz zgornjega razdelka je treba dodati kot 'URI za preusmeritev' registraciji aplikacije.

  1. Vrnite se na registracijo aplikacije, ki ste jo ustvarili.

  2. V levi stranski plošči izberite Pregled.

  3. Izberite Dodaj URI preusmeritve.

  4. Izberite + Dodaj platformo in nato izberite Splet.

  5. Pod besedilno polje URI-ji preusmeritve prilepite samodejno ustvarjen 'URL preusmeritve', kopiran iz zgornjega razdelka.

  6. Izberite Konfiguriraj.

Preizkusite priključek po meri

  1. Odprite meni Test.

  2. Izberite Nova povezavain nato sledite navodilom za ustvarjanje povezave.

  3. V Power Apps izberite svoje okolje in nato izberite Dataverse>Priključki po meri>CustomAzureDevOps.

  4. Izberite Uredi, pojdite na stran Test in nato poiščite GetOrganizations delovanje.

  5. Izberite Preskusi delovanje.

  6. Potrdite, da je odgovor Status vrnjeno 200 in da je odgovor Body je predstavitev JSON vaša Azure DevOps organizacija.

    Posnetek zaslona testnih varnostnih nastavitev za konektor po meri Azure DevOps .

Nastavite izdelovalce za uporabo aplikacije ALM Accelerator

Več informacij