Deli z drugimi prek

Ročno konfiguriranje storitve ALM Accelerator

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:

Zahteve

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

  • Pospeševalnik ALM mora biti nameščen v okolju, ki ima podatkovno bazo. Power Platform Microsoft Dataverse 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:

  • Pospeševalnik ALM uporablja za nadzor izvorne kode in uvajanje. Azure DevOps Če nimate organizacije, se brezplačno registrirajte za do pet uporabnikov na spletnem mestu. Azure DevOps Azure DevOps

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

    • Licencirani uporabnik Azure z dovoljenji za ustvarjanje in ogled skupin, ustvarjanje registracij aplikacij in podeljevanje skrbniškega soglasja za registracije aplikacij v ID-ju Microsoft Entra Microsoft Entra
    • Licencirani uporabnik z dovoljenji za ustvarjanje in upravljanje cevovodov, servisnih povezav, repozitorijev in razširitev Azure DevOps
    • 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:

  • Namestite komplet za ustvarjalce v okolje, kjer nameščate pospeševalnik ALM.

Osnovna nastavitev

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 Accelerator, da aplikaciji in povezanim prodajnim 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, 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

  1. Vpišite se v portal Azure.

  2. Izberite Microsoft Entra ID>Registracije aplikacij.

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

  4. Vse ostale možnosti pustite pri privzetih vrednostih in izberite Registriraj.

Dodajte dovoljenja za registracijo aplikacije

  1. V levi stranski plošči izberite Dovoljenja API.

  2. Izberite + Dodaj dovoljenje.

  3. Izberite Dynamics CRM in nato izberite Prenesena dovoljenja in user_impersonation.

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

  5. Ponovno izberite + Dodaj dovoljenje .

  6. 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. ...

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

  8. Ponovno izberite + Dodaj dovoljenje .

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

    To dovoljenje je potrebno za povezavo z Azure DevOps prek prilagojenega konektorja v aplikaciji ALM Accelerator.

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

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

    Posnetek zaslona okna Zahteva za dovoljenja API-ja z označenim zavihkom API-ji, ki jih uporablja moja organizacija, in ID-jem aplikacije (odjemalca).

    Če na zavihku API-ji, ki jih uporablja moja organizacija, ne najdete dovoljenja, sledite tem korakom, da pridobite ID aplikacije DevOps (odjemalca) DevOps: Azure 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-ju.

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

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

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

Konfigurirajte skrivnost odjemalca in URI za preusmeritev

  1. V levi stranski plošči izberite Potrdila in skrivnosti.

  2. Izberite + Nova skrivnost odjemalca.

  3. Izberite datum poteka veljavnosti in nato izberite Dodaj.

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

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

  6. Kopirajte ID aplikacije (odjemalca) in ID imenika (najemnika) .

  7. 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. To storite tako, da zaženete naslednji ukaz »cmdlet« PowerShell kot interaktivni uporabnik s skrbniškimi pravicami. Power Apps 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>

Namestitev razširitev Azure DevOps

Pospeševalnik ALM uporablja več razširitev, vključno z nekaterimi razširitvami drugih ponudnikov, ki so na voljo na trgu. Azure DevOps 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.

  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čega projekta.

  4. Izberite Repozitorij in nato na seznamu repozitorijev izberite Uvozi repozitorij .

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

  6. Potrdite, da je privzeta veja za repozitorij main. Izberite Repozitorij in Veje in se prepričajte, da je glavna veja označena 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 cevovode za uvoz, brisanje in izvoz 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

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

  2. Izberite Azure Repos Git za repozitorij kode in nato pokažite na Azure DevOps repozitorij, ki ste ga ustvarili in napolnili s predlogami prodajnega 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 Nadaljuj in nato izberite Shrani.

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

  6. Spremenite ime cevovoda v export-solution-to-git, import-unmanaged-to-dev-environment ali delete-unmanaged-solution-and-components, kot je ustrezno.

  7. 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.

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

  2. 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.

  3. V skupino spremenljivk dodajte naslednje spremenljivke:

    Imenu Description Vrednost
    AADHost Končna točka avtorizacije 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.

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

    Imenu Vrednost
    TestAutomationLoginMethod CloudIdentity
    TestAutomationMakerPortalUrl URL iz portala za ustvarjalce, običajno Power Apps *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

  5. (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«, zato je lahko sledenje korakom v tem razdelku zmedeno. 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 razdelku Azure DevOps izberite Nastavitve projekta.

  2. Izberite Shrambe>Varnost.

  3. 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.

  4. Za uporabnika storitve gradnje nastavite naslednja dovoljenja:

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

  5. V razdelku Uporabniki poiščite in izberite Ime vašega projekta Storitev gradnje (Ime vaše organizacije).

  6. Nastavite enake vrednosti kot v 4. koraku.

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

  8. 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

  9. Izberite Nastavitve projekta>Zbirke agentov, izberite Varnost in nato izberite Dodaj.

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

  11. Vlogo Nastavite na Bralec.

  12. Izberite Dodaj.

  13. (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.

Nastavitev 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 storitvene povezave za dostop Azure DevOps Power Platform

Vsako okolje – razvojno, validacijsko, testno in produkcijsko – mora imeti povezavo s storitvijo v okolju *.* Dataverse Power Platform Azure DevOps Za vsako od svojih okolij izvedite naslednje korake.

opomba,

Uporabniki aplikacije ALM Accelerator vidijo samo okolja, v katerih imajo v povezavi s storitvijo v Azure DevOps uporabniško ali skrbniško vlogo. Č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.

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

  2. Izberite Nastavitve projekta>Povezave storitev in nato izberite Ustvari povezavo storitev.

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

  4. Izberite Naprej.

  5. 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 .

  6. Za Ime povezave storitve vnesite isti URL, kot ste ga vnesli v 4. koraku, vključno z učno poševnico (/).

  7. Vnesite ID najemnika, ID aplikacije (odjemalca) in Skrivnost odjemalca , ki ste jih kopirali iz Microsoft Entra pri ustvarjanju registracije aplikacije.

  8. Izberite Dodeli dovoljenja za dostop vsem cevovodom.

  9. 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).

  1. Na seznamu Povezave storitev izberite povezavo storitve, ki jo želite deliti z uporabniki.

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

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

  4. 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

  1. V Azure DevOpsizberite Nastavitve projekta>Povezave storitev.

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

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

  4. 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.

  1. Prijavite se v skrbniški center Power Platform .

  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 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.

  8. 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 :

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čne cevovode uvajanja sprožijo spremembe veje (torej testna in produkcijska) ali kot del pravilnika veje v Azure DevOps (torej preverjanje veljavnosti). 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

  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 datoteko YAML, ki jo boste uporabili v svojem 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 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.

  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.

Posodobi in shrani datoteko

  1. Prilepite datoteko YAML, ki ste jo kopirali v 2. koraku prejšnjega razdelka, v novo datoteko cevovoda.

  2. 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še skladišče predlog v drugem projektu, uporabite obliko zapisa Azure DevOps ImeProjekta/ImeSkladišča . Po potrebi lahko s parametrom ref določ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.

  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 Konfiguracija prodajnega cevovoda izberite Obstoječa datoteka YAML za prodajne cevovode Azure, pokažite na datoteko YAML v repozitoriju, ki ste ga ustvarili prej, in nato izberite Nadaljuj.

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

  9. Spremenite ime prodajnega procesa v deploy-validation-MyNewSolution, deploy-test-MyNewSolution ali 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: 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.

  12. 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).

  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 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

  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-pipeleinartifact-SampleSolution.yml in kopirajte datoteko YAML, ki jo boste uporabili 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 novo datoteko YAML cevovoda; na primer deploy-prod-MyNewSolution.yml, kjer je MyNewSolution ime vaše rešitve.

  7. izberite Ustvari.

  8. Prilepite datoteko YAML, ki ste jo kopirali v 2. koraku, v novo datoteko cevovoda.

  9. 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še skladišče predlog v drugem projektu, uporabite obliko zapisa Azure DevOps ImeProjekta/ImeSkladišča . Po potrebi lahko s parametrom ref določ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.

  10. 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. Spremenljivko EnableFlows lahko nastavite tudi tako, da izklopite Power Automate poteke kot del uvajanja.

Ustvarjanje spremenljivk okolja in povezave storitve (obvezno)

Vsak uvajalni cevovod zahteva spremenljivko okolja EnvironmentName in spremenljivko povezave storitve ServiceConnection.

  • EnvironmentName določa okolje, ki se uvaja, da se omogoči sledenje zgodovine uvajanja ter nastavijo dovoljenja in odobritve za uvajanje v določena okolja. Azure DevOps To vrednost nastavite na Preveri, Testiraj ali Produkcija, kot je ustrezno.

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

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

  2. V definiciji cevovoda uvajanja izberite Spremenljivke , 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 poteke kot del uvajanja. 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. ...

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

  2. Poiščite vejo, za katero želite ustvariti pravilnik zahteve za vlečenje. Izberite (…) desno od 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 Zgradi cevovod izberite cevovod, ki ste ga ustvarili prej.

  6. Če je primerno, določite filter poti , da zagotovite, da cevovod za zahtevo za vlečenje sprožijo samo spremembe navedene poti.

  7. Nastavite Sprožilec na Samodejen.

  8. Nastavite Zahteva pravilnika na Zahtevan.

  9. Nastavite Potek gradnje na Takoj.

  10. Nastavite Prikazno ime za pravilnik veje; na primer Preverjanje gradnje PR.

  11. Izberite možnost Shrani.

Posnetek zaslona izbire nastavitev za pravilnik gradnje za preverjanje veljavnosti.

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.

  1. Sprožite cevovod in odprite potek cevovoda v Azure DevOps.
  2. V pasici »zahtevano dovoljenje« izberite Ogled .
  3. Za vsak zahtevani vir izberite Dovoli .

Daj izrecno dovoljenje

Cevovodu lahko daste izrecno dovoljenje za dostop do zahtevanih repozitorijev.

  1. V Azure DevOpsodprite Nastavitve projekta.
  2. Izberite Repozitoriji in nato izberite repozitorij.
  3. Izberite zavihek Varnost.
  4. Pomaknite se navzdol do Dovoljenja cevovoda 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 DevOpsizberite Knjižnica cevovodov>in nato izberite skupino spremenljivk.
  2. Izberite Dovoljenja za prodajne lijake.
  3. 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.

  1. V Azure DevOpsodprite Nastavitve projekta.
  2. Izberite Povezave storitev in nato izberite povezavo storitve.
  3. Izberite Več dejanj (…) in nato izberite Varnost.
  4. Pomaknite se navzdol do Dovoljenja cevovoda in izberite +.
  5. 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.

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

Vsem cevovodom lahko dovolite dostop do zahtevanih skupin spremenljivk.

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

Vsem cevovodom lahko dovolite dostop do zahtevanih servisnih povezav.

  1. V Azure DevOpsodprite Nastavitve projekta.
  2. Izberite Povezave storitev in nato izberite povezavo storitve.
  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 Odpri dostop in nato potrdite, ko ste pozvani.

Nastavitev obsega avtorizacije opravila

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

Nastavitev obsega avtorizacije dela na ravni organizacije za vse projekte

  1. V razdelku Azure DevOpsizberite Nastavitve organizacije > Cevovodi > Nastavitve.
  2. 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, spremenljivke okolja in dovoljenja za skupine in ekipe, poleg tega pa še skupno rabo aplikacij platna in posodabljanje lastništva komponent rešitve, kot so poteki. Microsoft Entra Dataverse Power Automate 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 in nato konfigurirajte vključeni povezovalnik po meri za Power Platform . Azure DevOps

Namestite pospeševalnik ALM v Dataverse

  1. Rešitev ALM Accelerator je odvisna od kompleta Creator Kit. ... Namestite komplet za ustvarjalce zdaj.

  2. Prenesite najnovejšo datoteko upravljane rešitve z GitHub. Pomaknite se navzdol do Sredstva in izberite CenterofExcellenceALMAccelerator_<najnovejšo različico>_managed.zip.

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

  4. V levi stranski plošči izberite Rešitve.

  5. Izberite Uvozi rešitev>Prebrskaj, nato pa poiščite lokacijo prenesene upravljane rešitve in izberite datoteko.

  6. Izberite Naprej in nato ponovno Naprej.

  7. 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.

  8. Izberite Uvozi.

Konfiguriranje priključka po meri DevOps

  1. Izberite Podatki>Povezovalniki po meri>CustomAzureDevOps.

  2. 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 dodajali 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.

  3. 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.

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

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

  3. Izberite Dodaj URI za preusmeritev.

  4. Izberite + Dodaj platformo in nato izberite Splet.

  5. V besedilno polje URI-ji za preusmeritev prilepite samodejno ustvarjen »URL za preusmeritev«, kopiran iz zgornjega razdelka.

  6. Izberite Konfiguriraj.

Preizkusite konektor po meri

  1. Odprite meni Test.

  2. Izberite Nova povezava in nato sledite pozivom 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 Preizkus in nato poiščite operacijo Pridobi organizacije .

  5. Izberite Testno delovanje.

  6. Potrdite, da je vrnjeno stanje odgovora 200 in da je telo odgovora JSON vaše organizacije. Azure DevOps

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

Nastavitev ustvarjalcev za uporabo aplikacije ALM Accelerator

Več informacij

  • Last updated on