Dijeli putem

Ručno konfiguriranje alata ALM Accelerator

  • Članak

Komponente ALM Accelerator for Power Platform možete konfigurirati pomoću prateće aplikacije za administraciju ili ručno. Ovaj vas članak vodi kroz ručnu konfiguraciju aplikacije i strukturiran je u sedam odjeljaka:

Preduvjeti

Prije nego što instalirate ALM Accelerator for Power Platform, provjerite jeste li ispunili sljedeće preduvjete.

  • ALM ubrzivač mora biti instaliran u Power Platform okruženju koje ima Microsoft Dataverse bazu podataka. Sva okruženja koja koristite ALM ubrzivač za implementaciju rješenja koja zahtijevaju Dataverse i bazu podataka.

    Napomena

    ALM ubrzivač nije kompatibilan s Dataverse for Teams. I aplikacija ALM Accelerator i povezani cjevovodi pretpostavljaju da koristite punu verziju u Dataverse svim okruženjima.

    Preporučujemo da ALM akcelerator instalirate u istom okruženju kao i druga rješenja CoE Starter Kita. Saznajte više o tome kako odrediti najbolju strategiju za svoju tvrtku ili ustanovu:

  • ALM ubrzivač koristi Azure DevOps za kontrolu izvora i implementacije. Ako nemate Azure DevOps organizaciju, besplatno se prijavite za do pet korisnika na web-mjestu Azure DevOps .

  • Da biste dovršili korake u ovom odjeljku, potrebni su vam sljedeći korisnici i dozvole na servisu Azure,i Azure DevOps Power Platform:

    • Licencirani korisnik servisa Azure s dopuštenjima za stvaranje i prikaz Microsoft Entra grupa, stvaranje registracija aplikacija i davanje pristanka administratora za registracije aplikacija u Microsoft Entra ID-u
    • Licencirani Azure DevOps korisnik s dozvolama za stvaranje i upravljanje cjevovodima, servisnim vezama, repo ugovorima i proširenjima
    • Licencirani Power Platform korisnik s dozvolama za stvaranje korisnika aplikacije i dodjelu administrativnih dozvola

  • Sljedeći konektori moraju biti dostupni za zajedničko korištenje u okruženju u koje se uvozi ALM ubrzivač:

  • Instalirajte komplet za autore u okruženje u kojem instalirate ALM ubrzivač.

Osnovno postavljanje

Sljedeći koraci općeniti su funkcionalnosti ALM ubrzivača i nisu specifični za bilo koji projekt ili rješenje.

Stvaranje registracije aplikacije u okruženju Microsoft Entra

Izradite registraciju aplikacije za ALM ubrzivač da biste aplikaciji i povezanim cjevovodima dodijelili dopuštenja potrebna za izvođenje operacija u Azure DevOps i Power Apps ili Dataverse. To trebate učiniti samo jednom.

Sljedeći koraci pokazuju kako izraditi jednu registraciju aplikacije s dozvolama za Dataverse i Azure DevOps. Međutim, možda ćete htjeti izraditi zasebne registracije aplikacija kako biste podijelili odgovornosti. Trebali biste razmotriti kako zasebne registracije aplikacija utječu i na održavanje i na sigurnost prije nego što se odlučite za strategiju registracije aplikacije.

Stvaranje registracije aplikacije

  1. Prijavite se u Azure portal.

  2. Odaberite Microsoft Entra ID>registracije aplikacija.

  3. Odaberite + Nova registracija, a zatim registraciji dodijelite naziv, kao što je ALMAcceleratorServicePrincipal.

  4. Ostavite sve ostale mogućnosti na zadanim vrijednostima, a zatim odaberite Registriraj se.

Dodavanje dopuštenja registraciji aplikacije

  1. Na lijevoj bočnoj ploči odaberite API dozvole.

  2. Odaberite + Dodaj dozvolu.

  3. Odaberite Dynamics CRM, a zatim Delegirane dozvole i user_impersonation.

  4. Odaberite Dodaj dopuštenja da biste u registraciju aplikacije dodali dopuštenje Dynamics CRM API-ja user_impersonation.

  5. Odaberite + Ponovno dodajte dozvolu .

  6. Odaberite karticu API-ji koje koristi moja tvrtka ili ustanova. Potražite i odaberite PowerApps Savjetnik, a zatim odaberite Delegirane dozvole i Analiza.Sve (pristanak administratora nije potreban).

    To je dopuštenje potrebno za pokretanje statičke analize putem provjere aplikacije.

  7. Odaberite Dodaj dozvole da biste dodali analizu API-ja savjetnika.Sva dopuštenja PowerAppsza registraciju aplikacije.

  8. Odaberite + Ponovno dodajte dozvolu .

  9. Na kartici Microsoftovi API-ji ili API-ji koje koristi moja tvrtka ili ustanova odaberite, a Azure DevOps zatim Delegirane dozvole i user_impersonation.

    Ta je dozvola potrebna za povezivanje s Azure DevOps prilagođenim poveznikom u aplikaciji ALM ubrzivač.

  10. Ako ste dodali Azure DevOps dozvolu s kartice API-ji koje koristi moja tvrtka ili ustanova, kopirajte ID aplikacije (klijenta ) za korištenje kasnije u ovom postupku.

    Koristit ćete ga kao ID DevOps aplikacije (klijenta), koji se razlikuje od ID-a aplikacije (klijenta ) koji ćete kopirati kasnije u ovom postupku.

    Snimka zaslona prozora Dozvole API-ja zahtjeva s istaknutom karticom API-ji koje moja tvrtka ili ustanova koristi i ID-om aplikacije (klijenta).

    Ako ne možete pronaći Azure DevOps dozvolu na kartici API-ji koje koristi moja tvrtka ili ustanova, slijedite ove korake da biste dobili ID DevOps aplikacije (klijenta):

    1. Otvorite prozor privatnog preglednika i idite na https://dev.azure.com/<your devops organization>/_apis.
    2. Na stranici za prijavu kopirajte vrijednost parametra client_id u URL-u.

    Snimka zaslona stranice za prijavu u Azure DevOps tvrtku ili ustanovu s istaknutim parametrom client_id u URL-u.

  11. Odaberite Dodaj dopuštenja da biste u registraciju aplikacije dodali dopuštenje Azure DevOps API-ja user_impersonation.

  12. Odaberite Dodijeli pristanak administratora za <klijenta>.

Konfiguriranje tajne klijenta i preusmjeravanje URI-ja

  1. Na lijevoj bočnoj ploči odaberite Certifikati i tajne.

  2. Odaberite + Nova tajna klijenta.

  3. Odaberite datum isteka, a zatim Dodaj.

  4. Kopirajte tajnu vrijednost klijenta za kasniju upotrebu. Ovo je jedini put da možete kopirati vrijednost. Obavezno to učinite prije nego što napustite stranicu.

  5. Na lijevoj bočnoj ploči odaberite Pregled.

  6. Kopirajte ID aplikacije (klijenta ) i ID direktorija (klijenta).

  7. Odaberite Konfiguriraj.

Registracija aplikacije dala dopuštenje za upravljanje dodatkom Power App

Registraciji aplikacije dodijelite dozvole za upravljanje aplikacijama da bi kanali mogli izvršavati potrebne radnje u vašim okruženjima. Da biste to učinili, pokrenite sljedeći cmdlet komponente PowerShell kao interaktivni korisnik koji ima Power Apps administratorske ovlasti. Ovu naredbu trebate pokrenuti samo jednom, nakon što izradite registraciju aplikacije.

Važno

Sljedeći cmdlet komponente PowerShell daje registraciji aplikacije povišena dopuštenja kao što Power Platform je Admin. Sigurnosna pravila vaše tvrtke ili ustanove možda ne dopuštaju ove vrste dozvola. Provjerite jesu li dopuštene prije nego što nastavite. Ako nisu dopuštene, određene mogućnosti ne funkcioniraju u cjevovodima ALM akceleratora.

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>

Instaliranje proširenje za Azure DevOps

ALM Accelerator koristi nekoliko Azure DevOps proširenja, uključujući neka proširenja trećih strana koja su dostupna na Azure DevOps tržištu. Web stranica svakog proširenja treće strane i poveznica na njihov izvorni kod nalaze se u sljedećim uputama. Saznajte kako procijeniti izdavača proširenja za tržište.

  1. Prijavite se u Azure DevOps.

  2. Odaberite Postavke tvrtke ili ustanove.

  3. Odaberite Općenita>proširenja.

  4. Potražite i instalirajte sljedeća proširenja:

Klonirajte YAML kanale s GitHuba na svoju Azure DevOps instancu

  1. Idite na https://aka.ms/coe-alm-accelerator-templates-latest-release i kopirajte URL najnovijeg izdanja.

  2. Prijavite se u Azure DevOps.

  3. Stvorite projekt ili odaberite postojeći projekt.

  4. Odaberite Repo ugovori, a zatim na popisu spremišta odaberite Spremište uvoza.

  5. Zalijepite URL koji ste kopirali u korak 1 kao URL klona , a zatim odaberiteUvezi .

  6. Provjerite je li zadana grana za repo ugovor glavna. Odaberite Repo igrane i provjerite je li glavna grana označena kao zadana.

    Ako nije, odaberite tri okomite točke (⋮) koje odgovaraju glavnoj grani, a zatim na izborniku Dodatne mogućnosti odaberite Postavi kao zadanu granu.

    Napomena

    Na ovom repo ugovoru pokreću se predlošci kanala rješenja i izvozno/uvozni cjevovodi. Kasnije, kada stvorite cjevovode za svoja rješenja, možda ćete se morati pozvati na ovaj određeni projekt i repo ako odlučite koristiti drugi repo za kontrolu izvora za svoja rješenja.

Izrada kanala za uvoz, brisanje i izvoz rješenja

Stvorite kanale za uvoz, brisanje i izvoz na temelju YAML-a u Azure DevOps repou. Ti se kanali pokreću kada pomoću aplikacije postavite rješenje za Git, uvezete rješenje ili izbrišete rješenje.

Napomena

Ako očekujete da će sav vaš izvoz izvršiti iste radnje bez obzira na rješenje za koje cjevovod radi, možete stvoriti jedan izvozni cjevovod kako je opisano u ovom odjeljku. Međutim, možda će vam trebati različite izvozne akcije koje se temelje na rješenju. U tom slučaju možete dodati naziv rješenja cjevovodu export-solution-to-git, kao što je export-solution-to-git-samplesolution, kako bi aplikacija izvršila vaše određene cjevovode rješenja prilikom izvođenja radnji u aplikaciji.

Sljedeća tablica prikazuje korespondenciju između YAML datoteke u repo ugovoru i pratećeg kanala.

Datoteka YAML Naziv kanala
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. U Azure DevOps idite na Kanali>Izradi novi kanal.

  2. Odaberite Azure Repos Git za spremište kodova, a zatim pokažite na Azure DevOps repo koji ste stvorili i zasijali predlošcima cjevovoda u ranijim koracima.

  3. Na stranici Konfiguracija vlastitog kanala odaberite Postojeća Azure Pipelines YAML datoteka i usmjerite na /Pipelines/export-solution-to-git.yml, /Pipelines/import-unmanaged-to-dev-environment.yml ili /Pipelines/delete-unmanaged-solution-and-components.yml.

  4. Odaberite Nastavi, a zatim Spremi.

  5. Odaberite izbornik Više (...) pokraj mogućnosti Pokreni kanal, a zatim odaberite Preimenuj/premjesti.

  6. Promijenite naziv kanala u export-solution-to-git,import-unmanaged-to-dev-environment ili delete-unmanaged-solution-and-components, prema potrebi.

  7. Odaberite Spremi.

Izrada varijabli kanala izvoza (nije obavezno)

Možete postaviti varijable cjevovoda na cjevovodu izvoz-rješenje-git kako biste kontrolirali koje su informacije postojane za kontrolu izvora. Da biste primijenili te postavke na globalnoj razini, postavite varijable na kanalu export-solution-to-git. Da biste primijenili postavke na određena rješenja pri izvozu, stvorite izvozni kanal za svoje rješenje kao što je opisano u bilješci u prethodnom odjeljku i postavite varijable na tom kanalu.

Da biste bili sigurni da trenutne vrijednosti varijabli okruženja nikada nisu posvećene kontroli izvora tijekom postupka izvoza, stvorite DoNotExportCurrentEnvironmentVariableValues varijablu na kanalu izvoz-rješenje-git i postavite njezinu vrijednost na True.

Važno

Ova varijabla kanala preporučuje se kako biste mogli koristiti funkciju konfiguracije implementacije u ALM ubrzivaču.

Da biste bili sigurni da su vrijednosti određenih zadanih varijabli okruženja postavljene tijekom izvoza rješenja, stvorite VerifyDefaultEnvironmentVariableValues varijablu na kanalu export-solution-to-git i postavite njezinu vrijednost na True. Postavite vrijednosti zadanih varijabli okruženja u customDeploymentSettings.json kako je opisano u vodiču za konfiguriranje implementacije.

  1. U Azure DevOps odjeljku odaberite Biblioteka>cjevovoda>Stvorite novu grupu varijabli.

  2. Imenujte novu varijabilnu skupinu alm-akcelerator-varijabilna skupina, točno onako kako je ovdje navedeno.

    Cjevovodi se odnose na ovu specifičnu varijabilnu skupinu, tako da mora biti imenovana točno onako kako je prikazano. Ako odlučite koristiti drugu konvenciju imenovanja za svoju varijabilnu grupu, morate izmijeniti dijelove cjevovoda tako da se odnose na naziv koji koristite.

  3. Dodajte sljedeće varijable u grupu varijabli:

    Ime/naziv Opis Vrijednost
    AADHost Autorizacija Microsoft Entra krajnja točka Za javne oblake koristite login.microsoftonline.com. Za vladine oblake koristite odgovarajući URL za autorizaciju.
    ProcessCanvasApps Jesu li aplikacije od gotovih gradivnih elemenata raspakirane tijekom izvoza ili pakirane tijekom međuverzija Ako su false, aplikacije od gotovih gradivnih elemenata ne raspakiraju se tijekom izvoza niti pakiraju tijekom međuverzija. Funkcija raspakiranja i pakiranja aplikacije od gotovih gradivnih elemenata nalazi se u pretpregled i trenutno se ne preporučuje za upotrebu u proizvodnim okruženjima. Međutim, izvorni kod radnog područja ne možete prikazati u kontroli izvora ako ovu varijablu ne postavite na True.

  4. (Neobavezno) Ako u kanalima koristite automatizaciju testa studija radnog područja, dodajte sljedeće varijable u grupu varijabli:

    Ime/naziv Vrijednost
    TestAutomationLoginMethod CloudIdentity
    TestAutomationMakerPortalUrl URL s portala proizvođača Power Apps , obično *https://make.powerapps.com*
    TestAutomationUsername Korisnički račun koji se koristi za izvršavanje automatiziranih testova
    TestAutomationPassword Lozinka za korisnički račun koji se koristi za izvršavanje automatiziranih testova

  5. (Neobavezno) Prema zadanim postavkama globalne varijable su ograničene i morate konfigurirati pristup za svaki kanal. To možete pojednostaviti i dopustiti pristup bilo kojem cjevovodu. U grupi Variable( Pipelines Libraryalm-accelerator-variable-group>) na gornjem izborniku odaberite>Dozvole kanala, odaberite ( ... ), a zatimOtvori pristup.

Postavljanje dozvola za uslugu izrade projekta

Važno

Azure DevOps sadrži brojne račune "Usluga izrade" i to može biti zbunjujuće dok slijedite korake u ovom odjeljku. Obratite pozornost na nazive i format navedene u koracima 3 i 5. Možda ćete morati potražiti određeni račun ako se ne pojavi na početnom popisu.

  1. U Azure DevOps odjeljku odaberite Postavke projekta.

  2. Odaberite Repozitoriji>Sigurnost.

  3. U odjeljku Korisnici potražite i odaberite Servis za izgradnju zbirke projekata (naziv tvrtke ili ustanove).

    Napomena

    Možda nećete vidjeti naziv tvrtke ili ustanove nakon korisnika servisa za izgradnju zbirke projekata. To može biti samo jedinstveni identifikator. U tom slučaju upotrijebite funkciju pretraživanja da biste pronašli korisnika, a zatim ga odaberite.

  4. Postavite sljedeće dozvole za korisnika usluge sastavljanja:

    Dozvola Vrijednost
    Doprinesi Dopusti
    Doprinesite zahtjevima za povlačenje Dopusti
    Izradi granu Dopusti
    Uredi pravila Dopusti

  5. U odjeljku Korisnici potražite i odaberite servis za izgradnju naziva projekta (naziv tvrtke ili ustanove).

  6. Postavite iste vrijednosti kao u korak 4.

  7. Odaberite Pipelines, odaberite tri točke (...) u gornjem desnom kutu, a zatim odaberite Upravljanje sigurnošću.

  8. Postavite sljedeće dozvole za korisnika usluge izgradnje naziva projekta (naziv tvrtke ili ustanove):

    Dozvola Vrijednost
    Uredi kanal međuverzije Dopusti
    Uredite kvalitetu međuverzije Dopusti
    Upravljaj redom čekanja međuverzije Dopusti
    Nadjačaj provjeru valjanosti prijave prema međuverziji Dopusti
    Ažuriraj informacije o međuverziji Dopusti
    Prikaži međuverzije cjevovoda Dopusti
    Pregledaj međuverzije Dopusti

  9. Odaberite Postavke>projekta Grupe agenata, odaberite Sigurnost, a zatim Dodaj.

  10. Potražite i odaberite Servis za izradu naziva projekta (naziv tvrtke ili ustanove).

  11. Postavite ulogu na Čitatelj.

  12. Odaberite Dodaj.

  13. (Neobavezno) Prema zadanim postavkama, dozvole kanala za svako spremište su ograničene i morate ih konfigurirati pojedinačno. To možete pojednostaviti i dopustiti pristup bilo kojem cjevovodu. U odjeljku Spremišta> postavkiprojekta odaberite svako spremište. Na gornjem izborniku odaberite Sigurnost . Pronađite blok dozvola kanala , odaberite (...), a zatim Otvori pristup.

Postavljanje razvojnog projekta

Sljedeći odjeljak vodi vas kroz korake potrebne za postavljanje svakog od razvojnih projekata koje podržavate. U tom kontekstu, razvojni projekt obuhvaća infrastrukturu i konfiguraciju koja podržava zdravo upravljanje životnim ciklusom aplikacija (ALM), uključujući konfiguraciju okruženja Dataverse koje podržava sam ALM proces.

Stvaranje servisnih veza za Azure DevOps pristup Power Platform

Svako Dataverse okruženje – razvoj, provjera valjanosti, testiranje i proizvodnja – mora imati servisnu Power Platform vezu u Azure DevOps. Izvedite sljedeće korake za svako okruženje.

Napomena

Korisnici aplikacije ALM Accelerator vide samo okruženja u kojima imaju ulogu korisnika ili administratora na servisnoj vezi u Azure DevOps. Ako rade u okruženjima za osobni razvoj, proizvođači moraju imati ulogu korisnika ili administratora na servisnoj vezi za svoje osobno razvojno okruženje. Za veze servisa za provjeru valjanosti, testiranje i proizvodno okruženje, kao što je usluga izrade, potrebne su samo dozvole dodijeljene cjevovodima.

  1. Prijavite se u Azure DevOps, a zatim odaberite projekt.

  2. Odaberite Postavke>projekta Servisne veze, a zatim Stvori servisnu vezu.

  3. Potražite i odaberite vrstu veze sa servisom Power Platform .

  4. Odaberite Dalje.

  5. Za URL poslužitelja unesite URL okruženja; na primjer, https://myorg.crm.dynamics.com/.

    Važno

    U URL morate uključiti završnu kosu crtu (/), To jest, nakon .com u ovom primjeru.

  6. Za naziv veze saservisom unesite isti URL koji ste unijeli u korak 4, uključujući kosu crtu za vježbanje (/).

  7. Unesite ID klijenta, ID aplikacije (klijenta) itajnu klijenta iz Microsoft Entra koje ste kopirali prilikom izrade registracije aplikacije.

  8. Odaberite Dodjela dozvola za pristup svim kanalima.

  9. Odaberite Spremi.

Veze s uslugom moraju pružiti korisnička dopuštenja svim korisnicima u svim okruženjima kojima korisnici trebaju omogućiti pristup iz aplikacije (na primjer, okruženja za izrade).

  1. Na popisu Servisne veze odaberite vezu usluge koja će se zajednički koristiti s korisnicima.

  2. U gornjem desnom kutu odaberite Više(... ), a zatim Sigurnost.

  3. Na popisu Grupa ili Korisnik odaberite korisnika ili grupu kojoj želite dati korisničke dozvole.

  4. Odaberite Korisnika, odaberite Ulogu, a zatim odaberite Dodaj.

Ponovite korake u ovom odjeljku za svako razvojno, provjereno, testno i proizvodno okruženje.

Postavljanje dozvola za uslugu izrade projekta za korištenje servisnih veza

  1. U Azure DevOps odjeljku odaberite Postavke>projekta Servisne veze.

  2. U gornjem desnom kutu odaberite (...), odaberite Sigurnost, a zatim Dodaj.

  3. Potražite i odaberite Servis za izradu naziva projekta (naziv tvrtke ili ustanove).

  4. Postavite ulogu na Administrator, a zatim odaberite Dodaj.

Izradite korisnika aplikacija u svojim Dataverse okruženjima

Stvorite korisnika aplikacije u svojim okruženjima da biste omogućili povezivanje Dataverse cjevovoda. Učinite to u svakom okruženju u koje namjeravate koristiti ALM ubrzivač.

  1. Prijavite se u centar Power Platform za administratore.

  2. Odaberite razvojno okruženje, a zatim Postavke.

  3. Odaberite Korisnici + dozvole>Korisnici aplikacije.

  4. Odaberite + Novi korisnik aplikacije.

  5. Odaberite + Dodajte aplikaciju, odaberite registraciju aplikacije koju ste prethodno izradili, a zatim Dodaj.

  6. Odaberite poslovnu jedinicu .

  7. Odaberite ikonu olovke s desne strane sigurnosnih uloga, a zatim odaberite sigurnosne uloge za korisnika aplikacije.

    Preporučujemo da administratoru korisničkog sustava aplikacije date sigurnosna uloga ovlasti kako bi korisnik mogao obavljati potrebne funkcije u svakom okruženju.

  8. Kliknite Stvori.

Ponovite ove korake u okruženju provjere valjanosti, testiranja i proizvodnje.

Postavljanje rješenja

Kada stvarate rješenje u sustavu Dataverse, morate kreirati cjevovode posebno za to rješenje. Sljedeći ogledni cjevovodi uključeni su u direktorij Pipelines u spremištu predložaka coe-alm:

Ogledni kanali pružaju fleksibilnost organizacijama da pohrane svoje predloške kanala u zasebnom projektu ili repozitoriju iz YAML-y kanala određenog rješenja. Slijedite korake navedene u ovom odjeljku da biste konfigurirali kanal svog rješenja. Ponovite ove korake za svako rješenje za koje koristite ALM ubrzivač za kontrolu izvora.

Važno

YAML za vaš cjevovod rješenja uvijek se pohranjuje u istom repo ugovoru koji koristite za kontrolu izvora za svoje rješenje. Međutim, predlošci kanala – to jest mapa Pipeline\Templates — mogu postojati u istom repo ugovoru kao i YAML kanala rješenja ili u zasebnom repo ugovoru ili projektu.

Izrada međuverzije rješenja i kanala implementacije

Kanali rješenja koriste se za izgradnju i implementaciju vaših rješenja čijim izvorom upravljate u okruženja u vašem klijentu. Ogledni cjevovodi pretpostavljaju da koristite samo tri okruženja: provjeru valjanosti, testiranje i proizvodnju. Međutim, možete stvoriti onoliko cjevovoda rješenja koliko je potrebno na temelju strategije okruženja vaše tvrtke ili ustanove.

Cjevovodi za implementaciju uzorka pokreću se promjenama podružnice (tj. ispitivanja i proizvodnje) ili kao dio pravila podružnice u Azure DevOps (to jest, validaciji). Saznajte više o postavljanju pravila podružnice za provjeru valjanosti zahtjeva za povlačenjem. Cjevovode možete pokretati i ručno, bez okidača.

Slijedite korake u ovom odjeljku da biste stvorili kanale za implementaciju iz oglednog kanala YAML. U sljedećoj je tablici opisana konfiguracija kanala.

Važno

Naziv kanala mora biti točno onakav kakav je prikazan u sljedećoj tablici, s nazivom rješenja umjesto MyNewSolution.

Naziv datoteke YAML-a kanala Naziv kanala Pravila grane omogućena Obvezno
build-deploy-validation-MyNewSolution.yml deploy-validation-MyNewSolution Jest Jest
build-deploy-test-MyNewSolution.yml deploy-test-MyNewSolution No Jest
build-deploy-prod-MyNewSolution.yml deploy-prod-MyNewSolution No Ne (idi na sljedeći odjeljak)

Napomena

Sljedeći koraci stvaraju izgradnju i implementaciju cjevovoda za okruženje za provjeru valjanosti, testiranje i proizvodnju. Međutim, možda ćete htjeti izgraditi i implementirati na provjeru valjanosti i testiranje, a zatim rasporediti artefakte iz testne međuverzije u proizvodnju. Ako je to slučaj, slijedite korake u ovom odjeljku samo za okruženja za provjeru valjanosti i testiranje. Zatim prijeđite na Stvorite rješenje kanal za implementaciju da biste konfigurirali kanal za otpuštanje.

Stvaranje datoteke kanala

  1. U servisu Azure DevOps idite na repozitorij koji sadržava mapu kanala koju ste unijeli i odaberite mapu Kanali.

  2. Otvorite jedan od tri ogledna kanala za implementaciju i kopirajte YAML za upotrebu u novom kanalu.

  3. Zabilježite naziv repozitorija za korištenje u vašem kanalu.

  4. Idite na repozitorij koji želite koristiti za kontrolu izvora za svoje rješenje.

  5. Stvorite granu na temelju zadane grane i imenujte je za svoje rješenje; na primjer,MyNewSolution .

    Ova grana postaje sljedeća verzija (v-next) grana za vaše rješenje. Svi razvojni radovi moraju se razgranati od ove grane do osobne radne grane razvojnog programera, a zatim spojiti u v-sljedeću granu kako bi se poguralo do provjere i testiranja. Kasnije, kada je izdanje spremno, v-next grana može se spojiti u glavnu ili zadanu granu.

  6. Odaberite Novo iz gornjeg izbornika, a zatim odaberite Mapa.

  7. Dajte novoj mapi isti naziv kao i rješenje.

  8. Novoj YAML datoteci kanala dodijelite naziv, primjerice build-deploy-validation-SampleSolution.yml,build-deploy-test-SampleSolution.yml ili build-deploy-prod-SampleSolution.yml.

  9. Kliknite Stvori.

Ažuriranje i spremanje datoteke

  1. Zalijepite YAML koji ste kopirali u korak 2 u prethodnoj sekciji u novu datoteku kanala.

  2. Promijenite sljedeće vrijednosti u yaml-u novog kanala:

    • Promijenite naziv spremišta>resursa>u naziv repo ugovora koji sadrži predloške kanala.

      U ovom primjeru, repo naziv je coe-alm-accelerator-templates i postoji u istom projektu kao i MyNewSolution repo. Ako je spremište predložaka u drugom Azure DevOps projektu, koristite oblik ProjectName/RepoName. Ako je potrebno, pomoću parametra ref možete odrediti i granu za mjesto u kojoj žive predlošci.

    • Promijenite bilo koju vrijednost koja se odnosi na SampleSolutionName u jedinstveni naziv rješenja; na primjer,MyNewSolution .

  3. Odaberite Izvrši za spremanje izmjena.

  4. U servisu Azure DevOps idite na Kanali, a zatim odaberite Izradi novi kanal.

  5. Odaberite Azure Repos Git kao svoj repozitorij koda.

  6. Odaberite DevOps repozitorij koji sadržava YAML kanala implementacije.

  7. Na stranici Konfiguriranje kanala odaberite Postojeća YAML datoteka servisa Azure Pipelines, pokažite na YAML datoteku u repo ugovoru koji ste prethodno stvorili, a zatim odaberite Nastavi.

  8. Odaberite Spremi, odaberite (...) pokraj mogućnosti Pokreni kanal, a zatim odaberite Preimenuj/premjesti.

  9. Promijenite naziv kanala u deployment-validation-MyNewSolution,deploy-test-MyNewSolution ili deploy-prod-MyNewSolution, pri čemu je MyNewSolution naziv vašeg rješenja.

  10. Odaberite Spremi.

  11. Ako vaš novi kanal nije stvoren u zadanoj grani spremišta: Odaberite Uredi na cjevovodu. U gornjem desnom kutu odaberite (...), a zatim okidači. Odaberite karticu YAML, a zatim odaberite Dohvati izvore. Promijenite zadanu granu za ručne i planirane međuverzije tako da pokazuje na granu rješenja. Saznajte više o konfiguriranju okidača kanala.

  12. Ponovite prethodne korake da biste stvorili kanal za implementaciju za svako okruženje, pozivajući se na uzorak kanal za implementaciju YAML iz repo ugovora coe-alm-accelerator-templates (deploy-validation-SampleSolution.yml,deploy-test-SampleSolution.yml i deploy-prod-SampleSolution.yml).

  13. Odaberite Spremi i stavi u red čekanja, a zatim odaberite Spremi.

Izrada kanala implementacije rješenja (neobavezno)

Kao što je ranije spomenuto, koraci u prethodnom odjeljku stvaraju cjevovode koji grade i uvode se za validaciju, testiranje i proizvodno okruženje. Međutim, možete stvoriti zasebno rješenje kanal za implementaciju ako želite graditi i implementirati samo za provjeru valjanosti i testiranje, a zatim implementirati artefakte iz testne međuverzije u proizvodnju.

Slijedite korake u ovom odjeljku da biste stvorili kanal za implementaciju rješenja iz oglednog kanala YAML. U sljedećoj je tablici opisana konfiguracija kanala.

Važno

Naziv kanala mora biti točno onakav kakav je prikazan u sljedećoj tablici, s nazivom rješenja umjesto MyNewSolution.

Naziv datoteke YAML-a kanala Naziv kanala Pravila grane omogućena
deploy-prod-MyNewSolution.yml deploy-prod-MyNewSolution No

  1. U servisu Azure DevOps idite na repozitorij koji sadržava mapu kanala koju ste unijeli i odaberite mapu Kanali.

  2. Otvorite deploy-prod-pipelineartifact-SampleSolution.yml oglednog kanalaza implementaciju i kopirajte YAML za korištenje u novom kanalu.

  3. Zabilježite naziv repozitorija za korištenje u vašem kanalu.

  4. Idite na repozitorij koji želite koristiti za kontrolu izvora za svoje rješenje.

  5. Odaberite Novo iz gornjeg izbornika, a zatim odaberite Datoteka.

  6. Dodijelite naziv YAML datoteci novog kanala; na primjer,deploy-prod-MyNewSolution.yml , gdje je MyNewSolution naziv vašeg rješenja.

  7. Kliknite Stvori.

  8. Zalijepite YAML koji ste kopirali u korak 2 u novu datoteku kanala.

  9. Promijenite sljedeće vrijednosti u yaml-u novog kanala:

    • Promijeni grane>okidača>Uključite u grane u kojima bi promjene trebale potaknuti uvođenje u proizvodnju.

    • Promijenite naziv spremišta>resursa>u naziv repo ugovora koji sadrži predloške kanala.

      U ovom primjeru, repo naziv je coe-alm-accelerator-templates i postoji u istom projektu kao i MyNewSolution repo. Ako je spremište predložaka u drugom Azure DevOps projektu, koristite oblik ProjectName/RepoName. Ako je potrebno, pomoću parametra ref možete odrediti i granu za mjesto u kojoj žive predlošci.

    • Ažurirajte izvor cjevovoda>>resursa da biste odredili međuspremnik koji sadrži artefakte koje bi ovaj cjevovod trebao implementirati. U tom ćete slučaju rasporediti artefakte iz testnog cjevovoda koji ste ranije stvorili, a koji je izgradio i implementirao vaše rješenje u testno okruženje.

    • Promijenite bilo koju vrijednost koja se odnosi na SampleSolutionName u jedinstveni naziv rješenja; na primjer,MyNewSolution .

  10. Ponovite korake od 11 do 20 u prethodnom odjeljku za implementaciju-validaciju-ALMAcceleratorSampleSolution i deploy-test-ALMAcceleratorSampleSolution da biste stvorili cjevovod iz novog proizvodnog cjevovoda YAML pod nazivomdeploy-prod-ALMAcceleratorSampleSolution .

Postavljanje kanal za implementaciju varijabli

Za svaku kanal za implementaciju koju ste ranije konfigurirali morate postaviti vrijednosti varijabli EnvironmentName i ServiceConnection na temelju okruženja u koje se cjevovod uvodi. Također možete postaviti varijablu EnableFlows da isključi Power Automate tokove kao dio implementacije.

Izrada varijable okruženja i veze usluge (obavezno)

Svaki kanal za implementaciju zahtijeva varijablu okruženja i varijablu EnvironmentNameServiceConnection servisne veze.

  • EnvironmentName Određuje Azure DevOps okruženje koje se uvodi radi omogućavanja praćenja povijesti implementacije i postavljanja dozvola i odobrenja za uvođenje u određena okruženja. Postavite ovu vrijednost na Provjera valjanosti,Testiranje ili Proizvodnja, prema potrebi.

  • ServiceConnection Određuje kako se Power Platform kanal za implementaciju povezuje. Dopuštene vrijednosti nazivi su veza servisa koje ste ranije stvorili.

  1. Odaberite Uredi na svakom od kanala implementacije.

  2. Odaberite Varijable na definiciji kanal za implementaciju da biste otvorili uređivač varijabli.

  3. Da biste dodali varijablu, odaberite (+). Unesite naziv varijable i odgovarajuću vrijednost.

Ponovite ove korake da biste stvorili EnvironmentName varijable i ServiceConnection .

Izrada varijable EnableFlows (nije obavezno)

Vrijednost varijable kanala pod nazivom EnableFlows False možete postaviti na False da biste preskočili korake koji automatski omogućuju Power Automate tokove kao dio implementacije. Zadana vrijednost EnableFlows varijable je True.

Postavljanje pravila podružnice za provjeru valjanosti zahtjeva za povlačenjem

Stvorite pravilo grane da biste izvršili kanal koji ste stvorili ranije prilikom stvaranja zahtjeva za povlačenjem.

  1. U servisu Azure DevOps idite na Repozitoriji, a potom odaberite mapu Grane.

  2. Pronađite granu za koju želite stvoriti pravilo zahtjeva za povlačenjem. Odaberite (...) s desne strane grane, a zatim Pravila podružnice.

  3. Na stranici Pravila grane idite na Provjera valjanosti međuverzije.

  4. Odaberite + da biste dodali novo pravilo grane.

  5. Na popisu Build pipeline odaberite kanal koji ste ranije stvorili.

  6. Navedite filtar puta ako je primjenjivo kako biste bili sigurni da samo promjene navedenog puta pokreću cjevovod za zahtjev za povlačenjem.

  7. Postavite Okidač na Automatsko.

  8. Postavite Zahtjev za pravilom na Nužno.

  9. Postavite Istek međuverzije na Trenutačno.

  10. Postavite zaslonsko ime za pravila podružnice; na primjer,Provjera valjanosti PR međuverzije.

  11. Odaberite Spremi.

Snimka zaslona s odabirom postavki za pravila međuverzije provjere valjanosti.

Postavljanje dozvola za pristup resursima za cjevovode

Kanalima je potreban pristup potrebnim resursima, kao što su spremišta, varijabilne grupe i servisne veze, za pokretanje. Da biste dopustili pristup, imate tri mogućnosti.

Odobravanje pristupa tijekom prve vožnje

Možete dopustiti pristup potrebnom resursu tijekom prvog pokretanja kanala.

  1. Aktivirajte cjevovod i otvorite cjevovod Azure DevOps.
  2. Na natpisu "Potrebna je dozvola" odaberite Prikaz .
  3. Odaberite Dozvola za svaki traženi resurs.

Davanje izričitog dopuštenja

Možete dati izričito dopuštenje za cjevovod za pristup potrebnim repo ugovorima.

  1. U Azure DevOps otvorite postavke projekta.
  2. Odaberite Spremišta, a zatim spremište.
  3. Odaberite karticu Sigurnost.
  4. Pomaknite se prema dolje do odjeljka Dozvole kanala i odaberite +.
  5. Odaberite kanal kojem želite dodijeliti pristup repozitoriju.

Možete dati izričitu dozvolu kanalu za pristup potrebnim promjenjivim grupama.

  1. U Azure DevOps odjeljku odaberite Biblioteka> cjevovoda, a zatim odaberite grupu varijabli.
  2. Odaberite Dozvole kanala.
  3. Odaberite +, a zatim odaberite kanal koji želite dati pristupu grupi varijabli.

Možete dati izričitu dozvolu za kanal za pristup potrebnim servisnim vezama.

  1. U Azure DevOps otvorite postavke projekta.
  2. Odaberite Servisne veze, a zatim odaberite servisnu vezu.
  3. Odaberite Dodatne akcije (...), a zatim Sigurnost.
  4. Pomaknite se prema dolje do odjeljka Dozvole kanala i odaberite +.
  5. Odaberite kanal kojem želite dati pristup servisnoj vezi.

Omogućite pristup svim cjevovodima

Svim cjevovodima, i onima koje sada imate i svim koje stvorite u budućnosti, možete dopustiti pristup potrebnim spremištima.

  1. U Azure DevOps otvorite postavke projekta.
  2. Odaberite Spremišta, a zatim spremište.
  3. Odaberite karticu Sigurnost.
  4. Pomaknite se prema dolje do Dozvole kanala.
  5. Odaberite Dodatne akcije (...), odaberite Otvori pristup, a zatim potvrdite kada se to od vas zatraži.

Svim cjevovodima možete dopustiti pristup potrebnim promjenjivim grupama.

  1. U Azure DevOps odjeljku odaberite Biblioteka> cjevovoda, a zatim odaberite grupu varijabli.
  2. Odaberite Dozvole kanala.
  3. Odaberite Dodatne akcije (...), odaberite Otvori pristup, a zatim potvrdite kada se to od vas zatraži.

Svim kanalima možete dopustiti pristup potrebnim servisnim vezama.

  1. U Azure DevOps otvorite postavke projekta.
  2. Odaberite Servisne veze, a zatim odaberite servisnu vezu.
  3. Odaberite Dodatne akcije (...), a zatim Sigurnost.
  4. Odaberite servisnu vezu, odaberite Dodatne akcije (...), a zatim Sigurnost .
  5. Pomaknite se prema dolje do Dozvole kanala.
  6. Odaberite Dodatne akcije (...), odaberite Otvori pristup, a zatim potvrdite kada se to od vas zatraži.

Postavljanje opsega autorizacije posla

Opseg odobrenja za posao može se postaviti za cijelu Azure DevOps organizaciju ili za određeni projekt. Onemogućite postavku Ograničite opseg autorizacije posla na trenutni projekt za kanale izdanja ako odaberete drugi Azure DevOps projekt za instalaciju predložaka.

Postavljanje opsega autorizacije posla na razini organizacije za sve projekte

  1. U Azure DevOps odjeljku odaberite Postavke >> kanalapostavki tvrtke ili ustanove.
  2. Onemogućite postavku Ograničite opseg autorizacije posla na trenutni projekt za kanale izdanja.

Stvaranje konfiguracije implementacije (neobavezno)

Nakon implementacije rješenja morate stvoriti nekoliko konfiguracija u ciljnom okruženju. Te su konfiguracije specifične za okruženje i uključuju reference veze, varijable okruženja i dozvole za Microsoft Entra grupe i Dataverse timove, uz zajedničko korištenje aplikacija od gotovih gradivnih elemenata i ažuriranje vlasništva nad komponentama rješenja kao Power Automate što su tijekovi. Uz ove konfiguracije, ciljnom okruženju često su potrebni ogledni ili konfiguracijski podaci koji su povezani s Dataverse tablicama u rješenju kako bi se pružilo potpuno cjelovito ALM iskustvo.

Ako vaše rješenje zahtijeva te druge konfiguracije ili podatke, slijedite vodič za konfiguriranje implementacije da biste konfigurirali kanale na temelju okruženja u koja uvodite.

Uvoz rješenja i konfiguriranje aplikacije

Uvezite aplikaciju radnog područja ALM Accelerator u svoje Power Platform okruženje, a zatim konfigurirajte priloženi prilagođeni poveznik za Azure DevOps.

Instalirajte ALM ubrzivač u Dataverse

  1. Rješenje ALM akceleratora ovisi o kompletu za autore. Odmah instalirajte Creator Kit .

  2. Preuzmite najnoviju datoteku upravljano rješenje s GitHuba. Pomaknite se prema dolje do odjeljka Imovina i odaberite CenterofExcellenceALMAccelerator_ <najnovija verzija>_managed.zip.

  3. Prijavite se u Power Apps, a zatim odaberite okruženje u kojem želite smjestiti aplikaciju ALM Accelerator.

  4. Na lijevoj bočnoj ploči odaberite Rešenja.

  5. Odaberite Uvoz rješenja>Pregledaj, a zatim pronađite mjesto upravljano rješenje koje ste preuzeli i odaberite datoteku.

  6. Odaberite Dalje, a zatim ponovno Dalje.

  7. Na stranici Veze odaberite ili stvorite vezu s kojom ćete povezati vezu DataverseCDS DevOps.

    Kada stvorite vezu za HTTP s Microsoft Entra, koristite Microsoft Graph za oba parametra.

  8. Odaberite Uvezi.

Konfiguracija DevOps prilagođenog poveznika

  1. Odaberite Data>Custom Connectors>CustomAzureDevOps.

  2. Odaberite Uredi. Na stranici Sigurnost odaberite Uređivanje, a zatim postavite sljedeća polja:

    Ime/naziv Vrijednost
    Vrsta provjere autentičnosti OAuth 2.0
    Davatelj identiteta Azure Active Directory
    ID klijenta ID aplikacije (klijenta) koji ste kopirali prilikom izrade registracije aplikacije
    Tajna klijenta Tajna vrijednost aplikacije (klijenta) koju ste kopirali prilikom izrade registracije aplikacije
    ID klijenta Ostavi zadanu vrijednost,zajedničku
    URL resursa ID aplikacije DevOps (klijent) koji ste kopirali prilikom dodavanja dopuštenja registraciji aplikacije
    URL preusmjeravanja Autogenerira. Ako primijetite potvrdni okvir "Ažuriraj na jedinstveni URL preusmjeravanja" ispod potvrdnog okvira "Preusmjeri URL", potvrdite okvir.

  3. Odaberite Ažuriraj poveznik.

Dodavanje URL-a za preusmjeravanje kao "URI za preusmjeravanje"

Automatski generirani "URL preusmjeravanja" iz gornjeg odjeljka potrebno je dodati kao "URI za preusmjeravanje" u registraciju aplikacije.

  1. Vratite se na registraciju aplikacije koju ste izradili.

  2. Na lijevoj bočnoj ploči odaberite Pregled.

  3. Odaberite Dodaj URI za preusmjeravanje.

  4. Odaberite + Dodajte platformu, a zatim odaberite Web.

  5. U tekstni okvir URI-ji za preusmjeravanje zalijepite automatski generirani URL za preusmjeravanje kopiran iz gornjeg odjeljka.

  6. Odaberite Konfiguriraj.

Testiranje prilagođenog poveznika

  1. Otvara izbornik Test.

  2. Odaberite Nova veza, a zatim slijedite upute da biste stvorili vezu.

  3. U rješenju Power Apps odaberite svoje okruženje i potom odaberite Dataverse>Prilagođeni poveznici>CustomAzureDevOps.

  4. Odaberite Uređivanje, idite na stranicu Testiranje , a zatim pronađite operaciju GetOrganizations .

  5. Odaberite Probna operacija.

  6. Potvrdite odgovor vraćeni status je 200 i da odgovor Tijelo je JSON prikaz vaše organizacije. Azure DevOps

    Snimka zaslona s testnim sigurnosnim postavkama za prilagođeni Azure DevOps poveznik.

Postavite proizvođače da koriste aplikaciju ALM Accelerator

  • Konfiguriranje korisničkih dozvola za račun proizvođača u Dataverse i Azure DevOps.

  • Konfigurirajte korisničke postavke implementacije da biste postavili korisničko iskustvo aplikacije i omogućili pristup rješenjima i profilima implementacije.

Pročitajte više