ALM kiirendi käsitsi seadistamine (aegunud)

Märkus

ALM kiirendi on aegunud ja uusi funktsioone ei lisata. Probleeme enam ei vaadata ega lahendata.

Kui tuvastate võimaliku turvaprobleemi, palun teatage sellest Microsofti küberturbe reageerimiskeskus-le.

Kasuta pipelines Power Platformis et tuua ALM-i automatiseerimise võimalused Power Platformi ja Dynamics 365 teenustesse. Torujuhtmeid saab kasutada lähtekoodi integratsiooniga või extended abil integreeruda Azure DevOps, GitHub ja teiste pakkujatega.

Komponente saab konfigureerida kas kaasasoleva haldusrakenduse ALM Accelerator for Power Platform abil või käsitsi. ... See artikkel juhendab teid rakenduse käsitsi seadistamisel ja on jagatud seitsmeks osaks:

eeltingimused

Enne ALM Accelerator for Power Platform installimist veenduge, et olete täitnud järgmised eeltingimused.

  • ALM Accelerator peab olema paigaldatud Power Platformi keskkonda, kus on Microsoft Dataverse'i andmebaas. Kõik keskkonnad, kus lahenduste juurutamiseks ALM Acceleratorit kasutate, vajavad ka andmebaasi. Dataverse

    Märkus

    ALM Accelerator ei ole ühilduv teenusega Dataverse for Teams. Nii ALM Acceleratori rakendus kui ka seotud torujuhtmed eeldavad, et kasutate kõigis keskkondades rakenduse Dataverse täisversiooni.

    Soovitame teil ALM Acceleratori installida samasse keskkonda teiste CoE alustuskomplekti lahendustega. Lisateavet selle kohta, kuidas oma organisatsiooni jaoks parim strateegia leida:

  • ALM Accelerator kasutab Azure DevOps'i lähtekoodi haldamiseks ja juurutamiseks. Kui sul pole Azure DevOps organisatsiooni, registreeru tasuta kuni viiele kasutajale saidil Azure DevOps saidil.

  • Selle jaotise sammude läbimiseks vajate järgmisi kasutajaid ja õigusi Azure'is, Azure DevOps'is ja Power Platformis:

    • Litsentseeritud Azure kasutaja, kellel on õigused luua ja vaadata Microsoft Entra gruppe, luua rakenduste registreerimisi ning anda administraatori nõusolek rakenduste registreerimiseks Microsoft Entra ID-s
    • Litsentseeritud Azure DevOps kasutaja, kellel on õigused luua ja hallata torujuhtmeid, teenuseühendusi, reposid ja laiendusi
    • Litsentseeritud kasutaja, kellel on õigused luua rakenduse kasutajaid ja anda neile administraatoriõigused Power Platform

  • Keskkonnas, kuhu ALM Accelerator imporditakse, peavad koos kasutamiseks olema saadaval järgmised konnektorid:

  • Paigalda Creator Kit keskkonda, kuhu installid ALM Acceleratori.

Põhiline seadistus

Järgmised sammud on üldised ALM Acceleratori funktsionaalsuse kohta ega ole ühegi projekti ega lahenduse spetsiifilised.

Loo rakenduse registreerimine oma Microsoft Entra keskkonnas

Loo ALM Acceleratorile rakenduse registreerimine, et anda rakendusele ja sellega seotud torujuhtmetele õigused, mis on vajalikud operatsioonide tegemiseks Azure DevOps ja Power Apps või Dataverse'is. Peate seda tegema ainult üks kord.

Järgnevad sammud näitavad, kuidas luua ühe rakenduse registreerimine koos õigustega nii Dataverse'ile kui ka Azure DevOps'ile. Siiski võiksite vastutuse jagamiseks luua eraldi rakenduste registreeringud. Enne rakenduse registreerimisstrateegia valimist peaksite kaaluma, kuidas eraldi rakenduste registreerimised mõjutavad nii hooldust kui ka turvalisust .

Loo rakenduse registreerimine

  1. Logige sisse Azure’i portaali.

  2. Vali Microsoft Entra ID>App registrations.

  3. Valige + Uus registreerimine ja seejärel andke registreeringule nimi, näiteks ALMAcceleratorServicePrincipal.

  4. Jätke kõik muud valikud vaikeväärtustele ja valige Registreeru.

Rakenduse registreerimisele õiguste lisamine

  1. Valige vasakpoolsel paneelil API õigused.

  2. Valige + Lisa luba.

  3. Valige Dynamics CRM ja seejärel valige delegeeritud õigused ja user_impersonation.

  4. Valige Add permissions et lisada Dynamics CRM API user_impersonation õigus rakenduse registreerimisele.

  5. Valige uuesti + Lisa luba .

  6. Valige vahekaart Minu organisatsiooni kasutatavad API-d . Otsige üles ja valige PowerApps-Nõustaja ning seejärel valige Delegeeritud õigused ja Analysis.All (administraatori nõusolekut pole vaja).

    See luba on vajalik staatilise analüüsi käivitamiseks rakenduse kontrollija kaudu.

  7. Rakenduse registreerimisele õiguse Lisa õigused lisamiseks valige PowerApps-Advisor API Analysis.All“.

  8. Valige uuesti + Lisa luba .

  9. Kas Microsoft APIs vahekaardil või APIs vahekaardil valige Azure DevOps ning seejärel delegeeritud õigused ja user_impersonation.

    See luba on vajalik Azure DevOps-iga ühendamiseks ALM Accelerator rakenduse kohandatud pistiku kaudu.

  10. Kui lisasid Azure DevOps õiguse API-dest, mida minu organisatsioon kasutab vahekaardilt, kopeeri rakenduse (kliendi) ID hilisemaks kasutamiseks selles protseduuris.

    Kasutate seda **DevOps** rakenduse (kliendi) ID-na**, mis erineb **rakenduse (kliendi) ID-st**, mille kopeerite selle protseduuri hilisemas etapis.

    Kuvatõmmis aknast „API õiguste taotlemine”, kus on esile tõstetud vahekaart „API-d, mida minu organisatsioon kasutab” ja rakenduse (kliendi) ID.

    Kui sa ei leia Azure DevOps õigust API-del, mida minu organisatsioon kasutab vahekaardil, järgi neid samme, et saada DevOps rakenduse (kliendi) ID:

    1. Ava privaatne brauseriaken ja mine aadressile https://dev.azure.com/<your devops organization>/_apis.
    2. Sisselogimislehel kopeeri URL-ist parameetri ``client_id`` väärtus.

    Ekraanipilt Azure DevOps organisatsiooni sisselogimise lehelt, kus URL-is on esile tõstetud client_id parameeter.

  11. Valige Add permissions et lisada rakenduse registreerimisele Azure DevOps API user_impersonation õigus.

  12. Valige Anna oma üürnikule <administraatori nõusolek>.

Kliendi saladuse ja ümbersuunamise URI seadistamine

  1. Valige vasakpoolsel paneelil Sertifikaadid ja saladused.

  2. Valige + Uus kliendisaladus.

  3. Valige aegumiskuupäev ja seejärel valige Lisa.

  4. Kopeeri kliendi salakood Väärtus hilisemaks kasutamiseks. See on ainus kord, kui saate väärtust kopeerida. Tehke seda kindlasti enne lehelt lahkumist.

  5. Valige vasakpoolsel paneelil Ülevaade.

  6. Kopeeri rakenduse (kliendi) ID ja kataloogi (üürniku) ID.

  7. Valige Konfigureeri.

Andke oma rakenduse registreerimisele Power App Managementi luba

Andke oma rakenduse registreerimisele Power App Managementi õigused, et torujuhtmed saaksid teie keskkondades vajalikke toiminguid teha. ... Selleks käivita järgmine PowerShelli käskkäsk interaktiivse kasutajana, kellel on Power Apps'i administraatori õigused. Seda käsku peate käivitama ainult üks kord, pärast rakenduse registreerimise loomist.

Oluline

Järgmine PowerShelli cmdlet-käsk annab rakenduse registreerimisele kõrgendatud õigused, näiteks Power Platform Admin. Teie organisatsiooni turbepoliitikad ei pruugi seda tüüpi õigusi lubada. Enne jätkamist veendu, et neil on lubatud. Kui need pole lubatud, siis teatud funktsioonid ALM Acceleratori torujuhtmetes ei tööta.

Install-Module -Name Microsoft.PowerApps.Administration.PowerShell
Install-Module -Name Microsoft.PowerApps.PowerShell -AllowClobber
New-PowerAppManagementApp -ApplicationId <the Application (client) ID you copied when you created the app registration>

Install Azure DevOps extensions

ALM Accelerator kasutab mitmeid Azure DevOps laiendusi, sealhulgas mõningaid kolmanda osapoole laiendusi, mis on saadaval Azure DevOps turul. Iga kolmanda osapoole laienduse veebisait ja link nende lähtekoodile on toodud järgmistes juhistes. Siit saate teada, kuidas hinnata Marketplace’i laienduse avaldajat.

  1. Logi sisse aadressil Azure DevOps.

  2. Valige Organisatsiooni seaded.

  3. Valige Üldine>Laiendused.

  4. Otsige ja installige järgmised laiendused:

Klooni YAML torujuhtmed GitHub'ist oma Azure DevOps instantsi

  1. Mine aadressile https://aka.ms/coe-alm-accelerator-templates-latest-release ja kopeeri uusima versiooni URL.

  2. Logi sisse aadressil Azure DevOps.

  3. Looge projekt või valige olemasolev projekt.

  4. Valige Repos ja seejärel valige Import repository repositooriumi nimekirjas.

  5. Kleepige 1. juhises kopeeritud URL kloonimise URL-ina ja seejärel valige Impordi.

  6. Veenduge, et hoidla vaikeharu on peamine. Vali Repos ja Branches ning veendu, et main haru oleks vaikimisi märgistatud.

    Kui see pole nii, valige kolm vertikaalset punkti (⋮), mis vastavadpõhiharule , ja valige menüüst Rohkem suvandeid käsk Sea vaikeharuks .

    Märkus

    Selles hoidlas töötavad lahenduse konveieri mallid ja ekspordi-/impordikonveierid. Hiljem, kui loote oma lahenduste jaoks konveiereid, peate võib-olla viitama sellele konkreetsele projektile ja hoidlale, kui otsustate oma lahenduste allika juhtimiseks kasutada mõnda muud hoidlat.

Konveierite loomine lahenduste importimiseks, kustutamiseks ja eksportimiseks

Loo YAML-i põhjal Azure DevOps repos impordi, kustuta ja ekspordi torujuhtmeid. Need konveierid käivituvad, kui kasutate rakendust lahenduse kinnitamiseks Giti, lahenduse importimiseks või lahenduse kustutamiseks.

Märkus

Kui eeldate, et kõik teie ekspordid teevad samu toiminguid, olenemata lahendusest, mille jaoks konveier töötab, saate luua ühe ekspordikonveieri, nagu selles jaotises kirjeldatud. Siiski võib teil vaja minna erinevaid eksporditoiminguid, mis põhinevad lahendusel. Sel juhul saate lisada lahenduse nime konveierile export-solution-to-git (nt export-solution-to-git-SampleSolution), et rakendus käivitaks teie konkreetse lahenduse konveierid, kui teete rakenduses toiminguid.

Järgmises tabelis on näidatud repos oleva YAML-faili ja sellega kaasneva konveieri vastavus.

YAML-fail Konveieri nimi
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. Azure DevOps. aastal mine Pipelines>Create a New Pipeline.

  2. Vali Azure Repos Git oma koodihoidla jaoks ja osuta seejärel Azure DevOps repositooriumile, mille oled loonud ja varasemates sammudes pipeline'i mallidega külvanud.

  3. Lehel Seadista pipeline vali Existing Azure Pipelines YAML fail ja osuta /Pipelines/export-solution-to-git.yml, /Pipelines/import-unmanaged-to-dev-environment.yml või /Pipelines/delete-unmanaged-solution-and-components.yml.

  4. Valige Jätka ja seejärel valige Salvesta.

  5. Valige valiku Käivita konveier kõrval menüü Rohkem (...) ja seejärel valige Nimeta ümber/teisalda.

  6. Muutke konveieri nimeks export-solution-to-git , import-unmanaged-to-dev-environment võidelete-unmanaged-solution-and-components , vastavalt vajadusele.

  7. Valige käsk Salvesta.

Eksportimise konveieri muutujate loomine (valikuline)

Saate määrata konveieri muutujad ekspordilahenduse git-konveieris, et juhtida, millist teavet allika juhtelemendile säilitatakse. Nende sätete globaalseks rakendamiseks määrake muutujad oma ekspordilahenduse git-konveieris. Sätete rakendamiseks eksportimisel konkreetsetele lahendustele looge oma lahenduse jaoks ekspordikonveier, nagu on kirjeldatud eelmise jaotise märkuses, ja määrake selle konveieri muutujad.

Veendumaks, et keskkonnamuutujate praegused väärtused ei ole ekspordiprotsessi ajal kunagi allika juhtimisega seotud, looge DoNotExportCurrentEnvironmentVariableValues muutuja oma ekspordilahenduse git-konveieris ja määrake selle väärtuseks Tõene.

Oluline

See konveieri muutuja on soovitatav, et saaksite kasutada juurutamise konfiguratsiooni funktsiooni ALM Acceleratoris.

Veendumaks, et lahenduse eksportimise ajal on määratud konkreetsete vaikekeskkonnamuutujate väärtused, looge VerifyDefaultEnvironmentVariableValues muutuja oma ekspordilahenduse konveieris ja määrake selle väärtuseks Tõene. Määrake customDeploymentSettings.json keskkonna vaikemuutujate väärtused, nagu on kirjeldatud juurutamise konfiguratsioonijuhendis.

  1. Azure DevOps-s vali Pipelines>Library>Loo uus muutujate grupp.

  2. Pange uuele muutujarühmale nimeks alm-accelerator-variable-group, täpselt nii, nagu siin on antud.

    Konveierid viitavad sellele konkreetsele muutujarühmale, seega peab see olema täpselt nii, nagu näidatud. Kui otsustate oma muutujarühma jaoks kasutada teistsugust nimetamiskonventsiooni, peate muutma konveierite osi, et viidata selle asemel kasutatavale nimele.

  3. Lisage muutujarühma järgmised muutujad:

    Nimi Kirjeldus Väärtus
    AADHost Microsoft Entra autoriseerimise lõpp-punkt Avalike pilvede puhul kasuta # login.microsoftonline.com. Riigiasutuste pilvede puhul kasutage sobivat autoriseerimise URL-i.
    ProcessCanvasApps Kas lõuendirakendused pakitakse ekspordi ajal lahti või järgu ajal Kui Väär, siis lõuendirakendusi ei pakita ekspordi ajal ega järgu ajal lahti. Lõuendirakenduse lahtipakkimise ja pakkimise funktsioon on eelvaates ja seda ei soovitata praegu tootmiskeskkondades kasutada. Kuid te ei saa lõuendi lähtekoodi lähtejuhtimises vaadata, kui te pole määranud selle muutuja väärtuseks Tõene.

  4. (Valikuline) Kui kasutate oma torujuhtmetes lõuendistuudio testimise automatiseerimist, lisage muutujarühma järgmised muutujad:

    Nimi Väärtus
    TestAutomationLoginMethod CloudIdentity
    TestAutomationMakerPortalUrl URL Power Apps makeri portaalist, tavaliselt *https://make.powerapps.com*
    TestAutomationUsername Automatiseeritud testide tegemiseks kasutatav kasutajakonto
    TestAutomationPassword Automaatsete testide tegemiseks kasutatud kasutajakonto parool

  5. (Valikuline) Vaikimisi on globaalsed muutujad piiratud ja peate konfigureerima juurdepääsu iga konveieri jaoks. Saate seda lihtsustada ja lubada juurdepääsu mis tahes konveierile. Valige jaotises Muutuja (Pipelines>Library>alm-accelerator-variable-group) ülamenüüst Konveieri õigused , valige (...) ja seejärel valige Ava juurdepääs.

Projekti koostamisteenuse õiguste määramine

Oluline

Azure DevOps sisaldab mitmeid "Build Service" kontosid ja see võib olla segane, kui järgida selle jaotise samme. Pöörake tähelepanu 3. ja 5. etapis määratud nimedele ja vormingule. Võimalik, et peate otsima konkreetset kontot, kui seda esialgses loendis ei kuvata.

  1. Azure DevOps-s vali Projekti seaded.

  2. Valige hoidlate>turve.

  3. Otsige jaotises Kasutajad üles ja valige Projektikogumi koostamise teenus (teie organisatsiooni nimi).

    Märkus

    Te ei pruugi näha oma organisatsiooni nime pärast projektikogumi koostamisteenuse kasutajat. See võib olla lihtsalt kordumatu identifikaator. Sel juhul kasutage kasutaja leidmiseks otsingufunktsiooni ja seejärel valige see.

  4. Määrake järguteenuse kasutajale järgmised õigused.

    Õigus Väärtus
    Panusta Luba
    Tõmbepäringute kaastöö Luba
    Haru loomine Luba
    Poliitikate redigeerimine Luba

  5. Otsige jaotises Kasutajad üles ja valige Oma projekti nimi Koostamisteenus (teie organisatsiooni nimi).

  6. Määrake samad väärtused, mis 4. juhises.

  7. Valige Konveierid, valige paremas ülanurgas kolm punkti (...) ja seejärel valige Halda turvalisust.

  8. Määrake oma projekti nime koostamise teenuse (teie organisatsiooni nimi) kasutajale järgmised õigused.

    Õigus Väärtus
    Järgu konveieri redigeerimine Luba
    Järgu kvaliteedi redigeerimine Luba
    Järgu järjekorra haldamine Luba
    Sisseregistreerimise valideerimise alistamine järgu abil Luba
    Värskendage järgu teavet Luba
    Vaata väljaannete konveierit Luba
    Vaadake järke Luba

  9. Valige Projektisätted>Agendikaustad, valige Turvalisus ja seejärel valige Lisa.

  10. Otsige üles ja valige oma projekti nimi Koosta teenus (teie organisatsiooni nimi).

  11. Määrake rolliks Lugeja.

  12. Valige Lisa.

  13. (Valikuline) Vaikimisi on iga hoidla konveieri õigused piiratud ja peate need eraldi konfigureerima. Saate seda lihtsustada ja lubada juurdepääsu mis tahes konveierile. Valige jaotises Projektisätete>hoidlad iga hoidla kordamööda. Valige ülamenüüst Turvalisus . Otsige üles plokk Konveieri õigused , valige (...) ja seejärel valige Avatud juurdepääs.

Arendusprojekti seadistamine

Järgmine jaotis juhendab teid iga toetatava arendusprojekti seadistamiseks vajalike sammude kaudu. Selles kontekstis hõlmab arendusprojekt infrastruktuuri ja konfiguratsiooni, mis toetab tervet rakenduse elutsükli haldust (ALM), sealhulgas ALM-protsessi toetava keskkonna konfiguratsiooni Dataverse .

Loo teenuseühendused, et Azure DevOps pääseksid ligi Power Platform

Iga Dataverse'i keskkond—arendus, valideerimine, testimine ja tootmine—peab omama Power Platformi teenuseühendust Azure DevOps-is. Tehke iga keskkonna jaoks järgmised toimingud.

Märkus

ALM Acceleratori rakenduse kasutajad näevad ainult keskkondi, kus neil on kas kasutaja või administraatori roll teenuseühenduses Azure DevOps-is. Kui tegijad töötavad isiklikes arenduskeskkondades, peab neil olema isikliku arenduskeskkonna teenuseühenduses kasutaja või administraatori roll. Valideerimis-, testimis- ja tootmiskeskkonna teenuseühendused, nagu järguteenus, vajavad ainult konveieritele antud õigusi.

  1. Logi sisse Azure DevOps ja vali oma projekt.

  2. Valige Projekti sätted>Teenuseühendused ja seejärel valige Loo teenuseühendus.

  3. Otsige üles ja valige Power Platform teenuseühenduse tüüp.

  4. Valige Edasi.

  5. Sisestage väljale Serveri URL oma keskkonna URL, näiteks https://myorg.crm.dynamics.com/.

    Oluline

    URL-i peate lisama lõpukaldkriipsu (/); see tähendab, pärast .com selles näites.

  6. Sisestage väljale Teenuseühenduse nimi sama URL, mille sisestasite 4. juhises, sealhulgas koolituse kaldkriips (/).

  7. Sisesta Tenant ID, Application (client) ID ja Client Secret mille kopeerisid Microsoft Entra-st, kui lõid rakenduse registreerimise.

  8. Valige Andke juurdepääsuõigused kõigile konveieritele.

  9. Valige käsk Salvesta.

Teenuseühendused peavad andma kasutajaõigused kõigile kasutajatele kõigis keskkondades, millele kasutajatel peab olema juurdepääs rakendusest (nt tegijate keskkondades).

  1. Valige loendist Teenuseühendused teenuseühendus, mida soovite kasutajatega ühiskasutusse anda.

  2. Valige paremas ülanurgas Veel(...) ja seejärel valige Turvalisus.

  3. Valige loendist Rühm või Kasutaja kasutaja kasutaja või rühm, kellele soovite kasutajaõigusi anda.

  4. Valige Kasutaja, valige Roll ja seejärel valige Lisa.

Korrake selle jaotise juhiseid iga arendus-, valideerimis-, testimis- ja tootmiskeskkonna puhul.

Määrake projekti koostamise teenusele õigused teenuseühenduste kasutamiseks

  1. Azure DevOps. aastal vali Project settings>Service connections.

  2. Valige (...) paremas ülanurgas, valige Turvalisus ja seejärel valige Lisa.

  3. Otsige üles ja valige oma projekti nimi Koosta teenus (teie organisatsiooni nimi).

  4. Määrake rolliks Administraator ja seejärel valige Lisa.

Looge enda Dataverse-i keskkonnas rakenduse kasutaja

Looge oma keskkondades rakenduse kasutaja, et lubada konveieritel ühendust luua Dataverse. Tehke seda igas keskkonnas, kuhu kavatsete juurutamiseks kasutada ALM Acceleratorit.

  1. Logige sisse Power Platformi halduskeskusesse.

  2. Valige oma arenduskeskkond ja seejärel valige Sätted.

  3. Valige Kasutajad + õigused>Rakenduse kasutajad.

  4. Vali+ Uus rakenduse kasutaja.

  5. Valige + Lisa rakendus, valige varem loodud rakenduse registreering ja seejärel valige Lisa.

  6. Valige äriüksus.

  7. Valige suvandist Turberollid paremal asuv pliiatsiikoon ja seejärel valige rakenduse kasutaja turberollid.

    Soovitame anda rakenduse kasutajale süsteemiadministraatori turberolli õigused, et kasutaja saaks igas keskkonnas vajalikke funktsioone täita.

  8. Valige Loo.

Korrake neid samme valideerimis-, testimis- ja tootmiskeskkondades.

Lahenduse seadistamine

Kui loote lahenduse Dataverse, peate looma spetsiaalselt selle lahenduse jaoks konveierid. Järgmised näidiskonveierid sisalduvad hoidla coe-alm-templates kataloogis Pipelines :

Näidiskonveierid annavad organisatsioonidele paindlikkuse oma konveiermalle talletada konkreetse lahenduse konveieri YAML-ist eraldi projektis või repos. Lahenduse konveieri konfigureerimiseks järgige selles jaotises toodud etappe. Korrake neid samme iga lahenduse puhul, mille jaoks kasutate allika juhtimiseks ALM-kiirendit.

Oluline

Teie lahenduse konveieri YAML talletatakse alati samas hoidlas, mida kasutate oma lahenduse allika juhtimiseks. Konveieri mallid – st kaust Konveier\Mallid – võivad siiski eksisteerida kas teie lahenduse konveieriga YAML-iga samas hoidlas või eraldi hoidlas või projektis.

Looge lahenduse loomise ja juurutuse konveierid

Lahenduste konveiereid kasutatakse teie allika juhitud lahenduste loomiseks ja juurutamiseks teie rentniku keskkondades. Näidiskonveierid eeldavad, et kasutate ainult kolme keskkonda: valideerimist, testimist ja tootmist. Siiski saate luua nii palju lahenduse konveiereid kui vaja, lähtudes teie organisatsiooni keskkonnastrateegiast.

Näidisjuurutuse torujuhtmed käivituvad haru muutmisel (st testimisel ja tootmisel) või osana harupoliitikast Azure DevOps-is (st valideerimine). Lisateave tõmbetaotluse valideerimiseks harupoliitikate määramise kohta. Torujuhtmeid saate käivitada ka käsitsi, ilma päästikuta.

Järgige selles jaotises toodud juhiseid, et luua juurutuskonveiereid näidiskonveieri YAML-ist. Järgmises tabelis kirjeldatakse konveieri konfiguratsiooni.

Oluline

Konveieri nimi peab olema täpselt selline, nagu on näidatud järgmises tabelis, ja teie lahenduse nimi peab olema MyNewSolution asemel.

Konveieri YAML-i failinimi Konveieri nimi Harupoliitika on lubatud Nõutav
build-deploy-validation-MyNewSolution.yml juurutamine-valideerimine-Minu UusLahendus Jah Jah
ehita-juuruta-test-MyNewSolution.yml deploy-test-MyNewSolution Ei Jah
build-deploy-prod-MyNewSolution.yml deploy-prod-MyNewSolution Ei Ei (Mine järgmisesse jaotisesse)

Märkus

Järgmiste sammudega luuakse valideerimis-, testimis- ja tootmiskeskkondade jaoks konveierid, koostatakse ja juurutatakse. Siiski võite soovida koostada ja juurutada valideerimiseks ja testimiseks ning seejärel juurutada artefaktid testjärgust tootmisse. Sel juhul järgige selles jaotises toodud juhiseid ainult valideerimis- ja testimiskeskkondade puhul. Seejärel minge väljalaskekonveieri konfigureerimiseks jaotisse Lahenduse juurutamise konveieri loomine.

Konveieri faili loomine

  1. Azure DevOps-s mine repositsiooni, mis sisaldab pipelines kausta, mille sa committesid ja vali kaust Pipelines.

  2. Avage üks kolmest juurutamise näidiskonveierist ja kopeerige YAML, et seda uues konveieris kasutada.

  3. Pange tähele konveieris kasutatava repo nime.

  4. Minge repole, mida soovite oma lahenduse lähte juhtelemendis kasutada.

  5. Looge oma vaikeharul põhinev haru ja nimetage see oma lahenduse jaoks; näiteks,MyNewSolution .

    Sellest harust saab teie lahenduse järgmise versiooni (v-next) haru. Kogu arendustöö peab olema hargnenud sellest harust arendaja isiklikku tööharusse ja seejärel liita v-next harusse, et viia valideerimisse ja testimisse. Hiljem, kui väljaanne on valmis, saab järgmise haru ühendada põhi- või vaikeharuga.

  6. Valige ülemisest menüüst Uus ja seejärel klõpsake Kaust.

  7. Andke uuele kaustale lahendusega sama nimi.

  8. Andke uuele konveieri YAML-failile nimi, näiteks build-deploy-validation-SampleSolution.yml, build-deploy-test-SampleSolution.yml või build-deploy-prod-SampleSolution.yml.

  9. Valige Loo.

Faili värskendamine ja salvestamine

  1. Kleepige eelmise jaotise 2. etapis kopeeritud YAML uude konveierifaili.

  2. Muutke uues konveieri YAML-is järgmisi väärtusi.

    • Muutke ressursside>hoidlate>nimi teie konveieri malle sisaldava hoidla nimeks.

      Selles näites on hoidla nimi coe-alm-accelerator-templates ja see on samas projektis kui MyNewSolutioni hoidla. Kui sinu mallide hoidla asub mõnes teises Azure DevOps projektis, kasuta vormingut ProjectName/RepoName. Vajadusel saate parameetri abil ref määrata ka haru, kus teie mallid asuvad.

    • Muutke mis tahes väärtust, mis viitab väärtusele SampleSolutionName, oma lahenduse kordumatuks nimeks, näiteks MyNewSolution.

  3. Valige Kinnitamine, et enda muudatused salvestada.

  4. Azure DevOps-s mine Pipelines ja vali Create a New Pipeline.

  5. Valige Azure Repos Git oma koodihoidla jaoks.

  6. Valige DevOps repo, mis sisaldab juurutamise konveieri YAML-i.

  7. Lehel Configure your pipeline vali Existing Azure Pipelines YAML fail, osuta oma repositooriumis varem loodud YAML-failile ja vali Continue.

  8. Valige Salvesta, valige valikuKäivita konveier kõrval ( ...) ja seejärel valige Nimeta ümber/teisalda.

  9. Muutke konveieri nimeks deploy-validation-MyNewSolution , deploy-test-MyNewSolution või deploy-prod-MyNewSolution, kus MyNewSolution on teie lahenduse nimi.

  10. Valige käsk Salvesta.

  11. Kui teie uut konveierit ei loodud hoidla vaikeharus: valige konveieris Redigeeri . Valige paremas ülanurgas (...) ja seejärel valige Päästikud. Valige vahekaart YAML ja seejärel valige Hangi allikad. Muutke käsitsi ja ajastatud väljaannete vaikeharu nii, et see osutaks teie lahenduse harule. Lisateave konveieri päästikute konfigureerimise kohta.

  12. Korrake eelmisi samme, et luua juurutuskonveier iga keskkonna jaoks, viidates juurutuskonveieri YAML-i näidisele hoidlast coe-alm-accelerator-templates (deploy-validation-SampleSolution.yml, deploy-test-SampleSolution.yml ja deploy-prod-SampleSolution.yml).

  13. Valige Salvesta ja lisa järjekorda ja seejärel valige Salvesta.

Looge lahenduse juurutamise konveier (valikuline)

Nagu varem mainitud, loovad eelmise jaotise juhised konveiereid, mis koostavad ja juurutavad valideerimis-, testimis- ja tootmiskeskkondade jaoks. Siiski saate luua eraldi lahenduse juurutamise konveieri, kui soovite koostada ja juurutada ainult valideerimiseks ja testimiseks ning seejärel juurutada artefaktid testjärgust tootmisse.

Järgige selles jaotises toodud juhiseid, et luua lahenduse juurutamise konveier näidiskonveierist YAML. Järgmises tabelis kirjeldatakse konveieri konfiguratsiooni.

Oluline

Konveieri nimi peab olema täpselt selline, nagu on näidatud järgmises tabelis, ja teie lahenduse nimi peab olema MyNewSolution asemel.

Konveieri YAML-i failinimi Konveieri nimi Harupoliitika on lubatud
deploy-prod-MyNewSolution.yml deploy-prod-MyNewSolution Ei

  1. Azure DevOps-s mine repositsiooni, mis sisaldab pipelines kausta, mille sa committesid ja vali Pipelines kaust.

  2. Avage juurutamise konveieri näidis deploy-prod-pipelineartifact-SampleSolution.yml ja kopeerige YAML, mida uues konveieris kasutada.

  3. Pange tähele konveieris kasutatava repo nime.

  4. Minge repole, mida soovite oma lahenduse lähte juhtelemendis kasutada.

  5. Valige ülemisest menüüst Uus ja seejärel klõpsake Fail.

  6. Andke uuele konveieri YAML-failile nimi; näiteks deploy-prod-MyNewSolution.yml , kus MyNewSolution on teie lahenduse nimi.

  7. Valige Loo.

  8. Kleepige 2. etapis kopeeritud YAML uude konveierifaili.

  9. Muutke uues konveieri YAML-is järgmisi väärtusi.

    • Muuda päästikuharusid>>Kaasake harud, kus muudatused peaksid käivitama juurutamise tootmisse.

    • Muutke ressursside>hoidlate>nimi teie konveieri malle sisaldava hoidla nimeks.

      Selles näites on hoidla nimi coe-alm-accelerator-templates ja see on samas projektis kui MyNewSolutioni hoidla. Kui sinu mallide hoidla asub mõnes teises Azure DevOps projektis, kasuta vormingut ProjectName/RepoName. Vajadusel saate parameetri abil ref määrata ka haru, kus teie mallid asuvad.

    • Värskendage ressursside>konveierite>allikat , et määrata järgukonveier, mis sisaldab artefakte, mille see konveier peaks juurutama. Sel juhul juurutate artefaktid varem loodud testkonveierist, mis koostas ja juurutas teie lahenduse testkeskkonnas.

    • Muutke mis tahes väärtust, mis viitab väärtusele SampleSolutionName, oma lahenduse kordumatuks nimeks, näiteks MyNewSolution.

  10. Korrake eelmise jaotise juhiseid 11 kuni 20 rakendustega deploy-validation-ALMAcceleratorSampleSolution ja deploy-test-ALMAcceleratorSampleSolution , et luua uuest tootmiskonveierist YAML konveier nimega deploy-prod-ALMAcceleratorSampleSolution .

Juurutamise konveieri muutujate määramine

Iga varem konfigureeritud juurutuskonveieri jaoks peate määrama muutujate EnvironmentName väärtused ja ServiceConnection lähtuma keskkonnast, kuhu konveier juurutatakse. Saad ka määrata EnableFlows muutuja nii, et Power Automate vood välja lülitatakse juurutuse osana.

Keskkonna- ja teenuseühenduse muutujate loomine (nõutav)

Iga juurutuskonveier nõuab keskkonnamuutujat EnvironmentName ja teenuseühenduse muutujat ServiceConnection.

  • EnvironmentName määrab Azure DevOps keskkonna mis on juurutatud, et võimaldada juurutusajalugu jälgida ning määrata load ja kinnitused konkreetsetesse keskkondadesse. Määrake selle väärtuse väärtuseks Kinnita, Testi või Tootmine, vastavalt vajadusele.

  • ServiceConnection Määrab, kuidas juurutuskonveier ühendub Power Platform. Lubatud väärtused on varem loodud teenuseühendustenimed.

  1. Valige iga juurutustoru puhul käsk Redigeeri.

  2. Valige juurutuskonveieri definitsioonis Muutujad, et avada muutujate redaktor.

  3. Muutuja lisamiseks valige (+). Sisestage muutuja nimi ja sobiv väärtus.

Korrake neid samme muutujate ja loomiseks EnvironmentNameServiceConnection .

Muutuja EnableFlows loomine (valikuline)

Võid määrata torujuhtme muutuja väärtuseks nimega EnableFlows väärtuseks Vale, et vahele jätta sammud, mis automaatselt võimaldavad Power Automate vooge juurutamise osana. Muutuja vaikeväärtus EnableFlows on True.

Tõmbetaotluse valideerimiseks harupoliitikate määramine

Looge harupoliitika , et käivitada varem loodud konveier, kui tõmbetaotlus luuakse.

  1. Azure DevOps. aastal mine Repos ja vali siis kaust Branches.

  2. Otsige üles haru, mille jaoks soovite tõmbetaotluse poliitika luua. Valige harust paremal (...) ja seejärel valige Filiaalipoliitikad.

  3. Lehel Harupoliitikad, minge Järgu valideerimine.

  4. Uue harupoliitika lisamiseks valige +.

  5. Valige loendist Konveieri koostamine varem loodud konveier.

  6. Määrake vajaduse korral teefilter , et veenduda, et tõmbetaotluse konveieri käivitavad ainult määratud tee muudatused.

  7. Seadke Päästik väärtusele Automaatne.

  8. Seadke Poliitikanõue väärtusele Nõutav.

  9. Seadke Järgu aegumine väärtusele Koheselt.

  10. Määrake oma harupoliitika jaoks kuvatav nimi , näiteks PR Build Validation.

  11. Valige käsk Salvesta.

Kuvatõmmis valideerimisjärgu poliitika sätete valimisest.

Torujuhtmete ressursile juurdepääsu õiguste määramine

Konveierid vajavad töötamiseks juurdepääsu vajalikele ressurssidele (nt hoidlad, muutujarühmad ja teenuseühendused). Juurdepääsu lubamiseks on teil kolm võimalust.

Juurdepääsu andmine esimesel käitamisel

Saate lubada juurdepääsu nõutavale ressursile konveieri esimese käitamise ajal.

  1. Käivita torujuhtme ja ava torujuhtme käivitamine Azure DevOps-is.
  2. Valige ribal "Luba nõutav" Vaade .
  3. Valige iga nõutava ressursi jaoks Luba .

Selgesõnalise loa andmine

Saate anda konveierile selgesõnalise loa vajalikele hoidlatele juurdepääsuks.

  1. Azure DevOps. aastal ava Project settings.
  2. Valige Hoidlad ja seejärel valige hoidla.
  3. Valige vahekaart Turve.
  4. Kerige alla jaotiseni Konveieri õigused ja valige +.
  5. Valige konveier, millele soovite hoidlale juurdpääsu anda.

Saate anda konveierile selgesõnalise loa vajalikele muutujarühmadele juurdepääsuks.

  1. Azure DevOps-s vali Pipelines>Library ja seejärel vali muutujate grupp.
  2. Valige Konveieri õigused.
  3. Valige + ja seejärel valige konveier, millele soovite muutujarühmale juurdepääsu anda.

Saate anda konveierile selgesõnalise loa vajalikele teenuseühendustele juurdepääsuks.

  1. Azure DevOps. aastal ava Project settings.
  2. Valige Teenuseühendused ja seejärel valige teenuseühendus.
  3. Valige Veel toiminguid (...) ja seejärel valige Turvalisus.
  4. Kerige alla jaotiseni Konveieri õigused ja valige +.
  5. Valige konveier, millele soovite teenuseühendusele juurdepääsu anda.

Kõigile torujuhtmetele juurdepääsu andmine

Saate lubada kõigil konveieritel, nii praegustel kui ka tulevikus loodavilla, juurdepääsu vajalikele hoidlatele.

  1. Azure DevOps. aastal ava Project settings.
  2. Valige Hoidlad ja seejärel valige hoidla.
  3. Valige vahekaart Turve.
  4. Liikuge alla Konveieriõigusteni.
  5. Valige Veel toiminguid (...), valige Avatud juurdepääs ja seejärel kinnitage, kui seda küsitakse.

Saate lubada kõigil konveieritel juurdepääsu nõutavatele muutujarühmadele.

  1. Azure DevOps-s vali Pipelines>Library ja seejärel vali muutujate grupp.
  2. Valige Konveieri õigused.
  3. Valige Veel toiminguid (...), valige Avatud juurdepääs ja seejärel kinnitage, kui seda küsitakse.

Saate lubada kõigil konveieritel juurdepääsu vajalikele teenuseühendustele.

  1. Azure DevOps. aastal ava Project settings.
  2. Valige Teenuseühendused ja seejärel valige teenuseühendus.
  3. Valige Veel toiminguid (...) ja seejärel valige Turvalisus.
  4. Valige teenuseühendus, valige Veel toiminguid (...) ja seejärel valige Turvalisus.
  5. Liikuge alla Konveieriõigusteni.
  6. Valige Veel toiminguid (...), valige Avatud juurdepääs ja seejärel kinnitage, kui seda küsitakse.

Töö autoriseerimise ulatuse määramine

Tööde autoriseerimise ulatust saab määrata kogu Azure DevOps organisatsiooni või konkreetse projekti jaoks. Keela Piira tööde autoriseerimise ulatus praegusele projektile väljalasketorude jaoks seadistus, kui valid teise Azure DevOps projekti mallide paigaldamiseks.

Töö autoriseerimise ulatuse määramine organisatsiooni tasemel kõigi projektide jaoks

  1. Azure DevOps-s vali Organization settings > Pipelines > Settings.
  2. Keelake säte Piira töö autoriseerimise ulatust praeguse projektiga väljalaskekonveierite jaoks.

Juurutuskonfiguratsiooni loomine (valikuline)

Pärast lahenduse juurutamist peate sihtkeskkonnas looma mitu konfiguratsiooni. Need konfiguratsioonid on spetsiifilised keskkonnale ning hõlmavad ühenduse viiteid, keskkonnamuutujaid ja õigusi Microsoft Entra gruppidele ja Dataverse'i meeskondadele, lisaks lõuendirakenduste jagamisele ja lahenduskomponentide, nagu Power Automate'i voogude, omandiõiguse uuendamisele. Lisaks nendele konfiguratsioonidele vajab sihtkeskkond sageli näidis- või konfiguratsiooniandmeid, mis on seotud Dataverse lahenduse tabelitega, et pakkuda täielikku ALM-i kogemust.

Kui teie lahendus nõuab neid muid konfiguratsioone või andmeid, järgige juurutamise konfiguratsioonijuhendit , et konfigureerida oma konveierid keskkondade põhjal, kuhu juurutate.

Lahenduse importimine ja rakenduse konfigureerimine

Impordi ALM Acceleratori lõuendirakendus oma Power Platformi keskkonda ja seejärel seadista kaasas olev kohandatud ühendus Azure DevOps jaoks.

Installige ALM-kiirendi Dataverse

  1. ALM Acceleratori lahendus sõltub Creator Kitist. Installige Creator Kit kohe.

  2. Laadi alla uusim hallatud lahenduse fail aadressilt GitHub. Kerige alla jaotiseni Varad ja valige CenterofExcellenceALMAccelerator_<uus versioon>_managed.zip.

  3. Logi sisse Power Apps ja vali keskkond, kuhu soovid ALM Accelerator rakendust majutada.

  4. Valige vasakpoolsel paneelil Lahendused.

  5. Valige Impordi lahendus>Sirvi ja seejärel sirvige allalaaditud hallatava lahenduse asukohta ning valige fail.

  6. Valige Edasi ja seejärel uuesti Edasi.

  7. Valige või looge lehel Ühendused ühendus, millega CDS DevOpsi ühendus Dataverseühendada.

    Kui lood ühenduse HTTP jaoks Microsoft Entra-ga, kasuta mõlema parameetri jaoks Microsoft Graph.

  8. Valige Impordi.

Seadistage DevOpsi kohandatud konnektor

  1. Valige Andmed>Kohandatud ühendused>KohandatudAzureDevOps.

  2. Valige suvand Redigeeri. Valige lehel Turvalisus Redigeeri ja seejärel määrake järgmised väljad.

    Nimi Väärtus
    Autentimise tüüp OAuth 2.0
    Identiteedi pakkuja Azure Active Directory
    Kliendi ID Rakenduse (kliendi) ID , mille kopeerisite rakenduse registreerimise loomisel
    Kliendi saladus Rakenduse (kliendi) saladuse väärtus , mille kopeerisite rakenduse registreerimise loomisel
    Rentniku ID Jätke vaikeväärtus,common
    Ressursi URL DevOpsi rakenduse (kliendi) ID , mille kopeerisite rakenduse registreerimisele õiguste lisamisel
    Ümbersuunamise URL Genereerib automaatselt. Kui märkate "Ümbersuunamise URL" all märkeruutu "Värskenda kordumatule ümbersuunamise URL-ile", märkige ruut.

  3. Valige Konnektori värskendamine.

Lisage "Ümbersuunamise URL" kui "Ümbersuunamise URI"

Ülaltoodud jaotise automaatselt loodud ümbersuunamise URL tuleb lisada rakenduse registreerimisele ümbersuunamise URI-na.

  1. Naaske loodud rakenduse registreerimise juurde.

  2. Valige vasakpoolsel paneelil Ülevaade.

  3. Valige Lisa ümbersuunamise URI.

  4. Valige + Lisa platvorm ja seejärel valige Veeb.

  5. Kleepige tekstikasti Ümbersuunamise URI-d ülaltoodud jaotisest kopeeritud automaatselt loodud ümbersuunamise URL.

  6. Valige Konfigureeri.

Kohandatud konnektori testimine

  1. Avage menüü Test.

  2. Valige Uus ühendus ja seejärel järgige ühenduse loomiseks viipasid.

  3. Power Apps vali oma keskkond ja seejärel Dataverse>Custom Connectors>CustomAzureDevOps.

  4. Valige Redigeeri, minge lehele Test ja seejärel leidke toiming GetOrganizations .

  5. Valige Testi toimingut.

  6. Kinnitage, et tagastatud Response Status on 200 ning et Response Body on JSON-i esindaja teie Azure DevOps organisatsioonist.

    Ekraanipilt kohandatud Azure DevOps pistiku testturbeseadetest.

ALM Acceleratori rakenduse kasutamiseks loojate seadistamine

Lisateave

  • Last updated on