Jagamisviis:

Rakenduse ALM Accelerator konfigureerimine käsitsi

  • Artikkel

Saate konfigureerida kas kaasasoleva ALM Accelerator for Power Platform haldusrakenduse abil või käsitsi. See artikkel juhendab teid rakenduse käsitsi konfigureerimisel ja on üles ehitatud seitsmesse jaotisse.

eeltingimused

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

  • ALM Accelerator tuleb installida Power Platform keskkonda, kus on Microsoft Dataverse andmebaas. Kõik keskkonnad, mida kasutate ALM Acceleratorit lahenduste juurutamiseks, vajavad Dataverse ka andmebaasi.

    Märkus.

    ALM Accelerator ei ühildu. Dataverse for Teams Nii rakendus ALM Accelerator kui ka sellega seotud müügitorud eeldavad, et kasutate kõigis keskkondades selle Dataverse täisversiooni.

    Soovitame paigaldada ALM Acceleratori samasse keskkonda nagu teised CoE Starter Kit lahendused. Vaadake lisateavet selle kohta, kuidas määrata oma organisatsiooni jaoks parim strateegia.

  • ALM Accelerator kasutab Azure DevOps allika juhtimiseks ja juurutamiseks. Kui teil pole Azure DevOps organisatsiooni, registreeruge saidil tasuta kuni viiele kasutajale Azure DevOps .

  • Selles jaotises toodud juhiste täitmiseks vajate Azure’is Azure DevOps järgmisi kasutajaid ja õigusi ning Power Platform järgmisi õigusi.

    • Litsentsitud Azure’i kasutaja, kellel on õigus luua ja vaadata Microsoft Entra rühmi, luua rakenduse registreerimisi ja anda administraatori nõusolek rakenduse ID-s Microsoft Entra registreerimiseks
    • Litsentsitud Azure DevOps kasutaja, kellel on õigus luua ja hallata konveiereid, teenuseühendusi, reposid ja laiendusi
    • Litsentsitud Power Platform kasutaja, kellel on õigused rakenduse kasutajate loomiseks ja neile haldusõiguste andmiseks

  • Järgmised konnektorid peavad olema kättesaadavad, et neid saaks kasutada koos keskkonnas, kuhu ALM Accelerator imporditakse:

  • Installige Creator Kit keskkonda, kuhu installite ALM Acceleratori.

Alustusseadistus

Järgmised sammud on üldised ALM Acceleratori funktsionaalsuse seisukohast ega ole seotud ühegi projekti ega lahendusega.

Looge rakenduses registreerimine oma Microsoft Entra keskkonnas

Looge ALM Acceleratori jaoks rakenduse registreerimine, et anda rakendusele ja sellega seotud müügitorudele õigused, mis on vajalikud toimingute tegemiseks või Azure DevOps või Power Apps Dataverse või. Peate seda tegema ainult üks kord.

Järgmised etapid näitavad, kuidas luua üks rakenduse registreerimine, millel on õigused nii Dataverse'i kui Azure DevOps'i jaoks. Kohustuste jagamiseks võiksite siiski luua eraldi rakenduse registreerimised. Enne rakenduse registreerimisstrateegia üle otsustamist peaksite kaaluma , kuidas rakenduse eraldi registreerimine mõjutab nii hooldus kui ka turvalisust .

Rakenduse registreerimise loomine

  1. Logige sisse Azure’i portaali.

  2. Valige Microsoft Entra ID-rakenduse>registreerimised.

  3. Valige + Uus registreerimine ja seejärel pange registreerimisele nimi, näiteks ALMAcceleratorServicePrincipal.

  4. Jätke kõik muud suvandid vaikeväärtuste juurde ja valige Registreeri.

Rakenduse registreerimisele lubade lisamine

  1. Valige vasakpoolsel külgpaneelil API õigused.

  2. Select + Lisa õigus.

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

  4. Valige Lisa õigused , et lisada Dynamics CRM API user_impersonation luba rakenduse registreerimisele.

  5. Select + Lisage uuesti õigus .

  6. Valige API-d, mida minu organisatsioon kasutab . Otsige ja valige PowerApps nõustaja ning seejärel valige Delegeeritud õigused ja Analüüs.Kõik (administraatori nõusolek pole nõutav).

    Seda luba on vaja staatilise analüüsi käitamiseks rakenduse kontrollija kaudu.

  7. Valige Lisa õigused, et lisada nõustaja PowerAppsAPI analüüs.Kõik õigused rakenduse registreerimisele.

  8. Select + Lisage uuesti õigus .

  9. Valige vahekaardil Microsofti API-d või API-d, mida minu organisatsioon kasutab , vahekaart Azure DevOps ja seejärel valige Delegeeritud õigused ja user_impersonation.

    See luba on vajalik ühenduse Azure DevOps loomiseks rakenduse ALM Accelerator kohandatud konnektori kaudu.

  10. Kui lisasite Azure DevOps loa API-delt, mida minu organisatsioon kasutab , kopeerige rakenduse (kliendi) ID , et seda hiljem selles protseduuris kasutada.

    Kasutate seda DevOpsi rakenduse (kliendi) ID-na , mis erineb rakenduse (kliendi) ID-st , mille kopeerite hiljem selle protseduuri käigus.

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

    Kui te ei leia Azure DevOps luba vahekaardilt API-d, mida minu organisatsioon kasutab , tehke DevOps-rakenduse (kliendi) ID saamiseks järgmist.

    1. Avage privaatne brauseriaken ja minge aadressile https://dev.azure.com/<your devops organization>/_apis.
    2. Kopeerige sisselogimislehel URL-i parameetri client_id väärtus .

    Kuvatõmmis Azure DevOps organisatsiooni sisselogimislehest, kus URL-i parameeter client_id on esile tõstetud.

  11. Valige Lisa õigused , et lisada Azure DevOps API user_impersonation luba rakenduse registreerimisele.

  12. Valige Anna rentnikule < administraatori nõusolek>.

Kliendi saladuse konfigureerimine ja URI suunamine

  1. Valige vasakpoolsel külgpaneelil Sertifikaadid ja saladused.

  2. Valige + Uus kliendisaladus.

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

  4. Kopeerige kliendi salajane väärtus hilisemaks kasutamiseks. See on ainus kord, kui saate väärtuse kopeerida. Tehke seda kindlasti enne lehelt lahkumist.

  5. Valige vasakpoolsel külgpaneelil Ülevaade .

  6. Kopeerige rakenduse (kliendi) ID ja kataloogi (rentniku) ID.

  7. Tehke valik Konfigureeri.

Power App Managementile rakenduse registreerimiseks loa andmine

Andke Power App Managementi õigused oma rakenduse registreerimisele, et müügitorud saaksid teie keskkondades vajalikke toiminguid teha. Selleks käivitage järgmine PowerShelli cmdlet-käsk interaktiivse kasutajana, kellel on Power Apps administraatoriõigused. Selle käsu peate käivitama ainult ühe korra, pärast rakenduse registreerimise loomist.

Oluline

Järgmine PowerShelli cmdlet-käsk annab rakenduse registreerimisele kõrgendatud õigused (nt Power Platform Administraator). Teie organisatsiooni turbepoliitikad ei pruugi seda tüüpi õigusi lubada. Enne jätkamist veenduge, et need on lubatud. Kui need pole lubatud, ei tööta teatud võimalused ALM Acceleratori torujuhtmetes.

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>

Installige Azure DevOps’i laiendid

ALM Accelerator kasutab mitmeid Azure DevOps laiendusi, sealhulgas mõningaid kolmanda osapoole laiendusi, mis on turul saadaval Azure DevOps . Iga kolmanda osapoole laienduse veebisait ja linkima nende lähtekoodile on toodud järgmistes juhistes. Vaadake, kuidas turuplatsilaiendi avaldajat hinnata.

  1. Logi sisse Azure DevOps.

  2. Valige Organisatsiooni sätted.

  3. Valige Üldised>laiendid.

  4. Otsige ja installige järgmised laiendused.

Kloonige YAML-i konveierid GitHub-st enda Azure DevOps eksemplari

  1. Minge ja https://aka.ms/coe-alm-accelerator-templates-latest-release kopeerige uusima väljaande URL.

  2. Logi sisse Azure DevOps.

  3. Looge projekt või valige olemasolev projekt.

  4. Valige Repos ja seejärel valige hoidla loendist Impordi hoidla .

  5. Kleepige samm 1-s kopeeritud URL kloonimise URL-iks ja seejärel valige Impordi.

  6. Kinnitage, et repo vaikeharu on peamine. Valige Repos ja oksad ning veenduge, et põhiharu oleks vaikimisi sildistatud.

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

    Märkus.

    See repo on koht, kus töötavad lahenduse torujuhtme mallid ja ekspordi/ impordi torujuhtmed. Hiljem, kui loote oma lahenduste jaoks torujuhtmeid, peate võib-olla viitama sellele konkreetsele projektile ja repole, kui otsustate oma lahenduste allika juhtimiseks kasutada mõnda muud repot.

Konveierite loomine lahenduste importimiseks, kustutamiseks ja eksportimiseks

Looge impordi-, kustutamis- ja eksporditorusid, mis põhinevad repo YAML-il Azure DevOps . Need müügitorud käivituvad, kui kasutate rakendust lahenduse Gitile sidumiseks, lahenduse importimiseks või lahenduse kustutamiseks.

Märkus.

Kui eeldate, et kõik teie ekspordid teevad samu toiminguid, olenemata lahendusest, mille jaoks müügitoru töötab, saate luua ühe eksporditoru, nagu on kirjeldatud selles jaotises. Siiski võib teil lahenduse põhjal vaja minna erinevaid eksporditoiminguid. Sellisel juhul saate lisada lahenduse nime ekspordi-lahenduse-git-torujuhtmele (nt export-solution-to-git-SampleSolution), et rakendus käivitaks rakenduses toimingute tegemisel teie konkreetse lahenduse konveierid.

Järgmine tabel näitab repo YAML-faili ja sellega kaasneva torujuhtme vahelist vastavust.

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. Minge Azure DevOps-is jaotisesse Konveierid>Loo uus konveier.

  2. Valige oma koodihoidla jaoks Azure Repos Git ja seejärel osutage Azure DevOps varasemates etappides loodud repole ja külvatud konveieri mallidega.

  3. Valige Konveieri konfigureerimine lehel Olemasolevad Azure’i konveieri YAML-failid ja valige käsk /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 Run Pipeline (Käivita müügitoru ) kõrval menüüMore( ...) ja seejärel valige Rename/Move (Nimeta ümber/teisalda).

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

  7. Valige käsk Salvesta.

Eksportimise konveieri muutujate loomine (valikuline)

Võite määrata konveieri muutujad ekspordi-lahenduse-git-torujuhtmele, et kontrollida, millist teavet allika juhtimiseks säilitatakse. Nende sätete globaalseks rakendamiseks määrake muutujad oma ekspordi-lahenduse-git-torujuhtmes. Sätete rakendamiseks konkreetsetele ekspordilahendustele looge oma lahenduse jaoks eksporditoru, nagu on kirjeldatud eelmises jaotises olevas märkuses, ja määrake selle müügitoru muutujad.

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

Oluline

See konveierimuutuja on soovitatav, et saaksite kasutada ALM Acceleratoris juurutuse konfiguratsiooni funktsiooni.

Veendumaks, et konkreetsete keskkonna vaikemuutujate väärtused on lahenduse eksportimise ajal seatud, looge VerifyDefaultEnvironmentVariableValues muutuja oma ekspordilahendusest git-torujuhtmesse ja määrake selle väärtuseks Tõene. Määrake customDeploymentSettings.json vaikekeskkonnamuutujate väärtused, nagu on kirjeldatud juurutuse konfiguratsioonijuhendis.

  1. Azure DevOpsValige Pipelines Library (Torujuhtmete > teek>) Looge uus muutujate rühm.

  2. Nimetage uus muutujarühm alm-kiirendi-muutuja-rühm, täpselt nii, nagu siin näidatud.

    Torujuhtmed viitavad sellele konkreetsele muutuvale rühmale, seega tuleb seda nimetada täpselt nii, nagu näidatud. Kui otsustate oma muutuva rühma jaoks kasutada teistsugust nimereeglit, peate muutma torujuhtmete osi, et viidata selle asemel kasutatavale nimele.

  3. Lisage muutujate rühma järgmised muutujad:

    Nimetus Kirjeldus Väärtus
    AADHost Autoriseerimise Microsoft Entra lõpp-punkt Avalike pilvede puhul kasutage login.microsoftonline.com. Riigipilvede puhul kasutage sobivat autoriseerimise URL-i.
    ProcessCanvasApps Kas lõuendirakendused pakitakse ekspordi ajal lahti või pakitakse järkude ajal Kui väärtus on väär, ei pakita lõuendirakendusi eksportimise ajal lahti ega pakita järkude ajal. Lõuendirakenduse lahtipakkimise ja pakkimise funktsionaalsus on eelversioon 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 testide automatiseerimist, lisage muutujate rühma järgmised muutujad:

    Nimetus Väärtus
    TestAutomationLoginMethod CloudIdentity
    TestAutomationMakerPortalUrl Tavaliselt on tegijaportaali URL Power Apps *https://make.powerapps.com*
    TestAutomationUsername Automaattestide tegemiseks kasutatud kasutajakonto;
    TestAutomationPassword Automaattestide tegemiseks kasutatud kasutajakonto parool

  5. (Valikuline) Vaikimisi on globaalsed muutujad piiratud ja peate konfigureerima juurdepääsu igale torujuhtmele. Saate seda lihtsustada ja lubada juurdepääsu igale müügitorule. Valige jaotises Muutuja(PipelinesLibrary>alm-accelerator-variable-group>) ülemisest menüüst suvandPipeline permissions (Torujuhtme õigused), valige ( ...) ja seejärel valigeAva juurdepääs .

Projekti järguteenusele õiguste seadmine

Oluline

Azure DevOps sisaldab mitmeid "Koostamisteenuse" kontosid ja see võib selles jaotises toodud juhiseid järgides segadust tekitada. 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. Jaotises valige Azure DevOpsProjekti sätted.

  2. Valige hoidlate>turve.

  3. Otsige jaotises Kasutajad üles ja valige Project Collection Build Service (teie organisatsiooni nimi)).

    Märkus.

    Te ei pruugi näha oma organisatsiooni nime pärast projektikogumi järguteenuse kasutajat . See võib olla lihtsalt unikaalne identifikaator. Sellisel juhul kasutage kasutaja leidmiseks otsingufunktsiooni ja valige see.

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

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

  5. Otsige ja valige jaotises Kasutajad oma projekti nimi Järguteenus ( teie organisatsiooni nimi)).

  6. Määrake samad väärtused nagu samm 4.

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

  8. Määrake kasutaja Teie projekti nime järguteenus ( teie organisatsiooni nimi) jaoks 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 ehitab müügitoru Luba
    Vaadake järke Luba

  9. Valige Projecti sätted>Agentide kogumid, valige Turvalisus ja seejärel valige Lisa.

  10. Otsige ja valige oma projekti nimi Järguteenus (teie organisatsiooni nimi).

  11. Määrake rolliks Reader.

  12. Valige suvand Lisa.

  13. (Valikuline) Vaikimisi on iga hoidla müügitoru õigused piiratud ja peate need eraldi konfigureerima. Saate seda lihtsustada ja lubada juurdepääsu igale müügitorule. Valige jaotises Projektisätete>hoidlad iga hoidla järgemööda. Valige ülemisest menüüst Turvalisus . Leidke konveieri õiguste plokk, valige (...) ja seejärel valige Ava juurdepääs.

Arendusprojekti seadistamine

Järgmises jaotises juhendatakse teid iga toetatava arendusprojekti seadistamiseks vajalike sammude kaudu. Selles kontekstis hõlmab arendusprojekt infrastruktuuri ja konfiguratsiooni, mis toetab tervisliku rakenduse elutsükli haldamist (ALM), sealhulgas ALM-protsessi toetava keskkonna konfiguratsiooni Dataverse .

Juurdepääsuks Azure DevOps teenuseühenduste loomine Power Platform

Igas Dataverse keskkonnas – arenduses, valideerimises, testimises ja tootmises – peab olema Power Platform teenuseühendus Azure DevOps. Tehke iga keskkonna puhul järgmised toimingud.

Märkus.

Rakenduse ALM Accelerator kasutajad näevad ainult keskkondi, kus neil on teenuseühenduses Azure DevOps kas kasutaja või administraatori roll. Kui nad töötavad isikliku arengu keskkondades, peab tegijatel olema oma isikliku arengukeskkonna jaoks teenuseühenduses kasutaja või administraatori roll. Valideerimis-, testimis- ja tootmiskeskkonna teenuseühendusteks, nagu järguteenus, on vaja ainult torujuhtmetele antud õigusi.

  1. Logige sisse ja Azure DevOps seejärel valige oma projekt.

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

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

  4. Tehke valik Edasi.

  5. Sisestage serveri URL-i jaoksoma keskkonna URL; näiteks. https://myorg.crm.dynamics.com/

    Oluline

    Peate URL-i lisama kaldkriipsu (/); see tähendab, et pärast .com selles näites.

  6. Väljale Teenuseühenduse nimi sisestage sama URL, mille sisestasite samm 4, sh treeningu kaldkriips (/).

  7. Sisestage rentniku ID, rakenduse (kliendi) ID ja kliendi saladus , millest Microsoft Entra kopeerisite rakenduse registreerimise ajal.

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

  9. Valige käsk Salvesta.

Teenuseühendused peavad andma kasutajaõigused kõigile kasutajatele kõigis keskkondades, millele kasutajad peavad rakendusest juurde pääsema (nt koostaja keskkonnad).

  1. Valige loendist Teenuseühendused kasutajatega jagatav teenuseühendus.

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

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

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

Korrake selles jaotises olevaid juhiseid iga oma arendus-, valideerimis-, testimis- ja tootmiskeskkonna puhul.

Projekti järguteenusele teenuseühenduste kasutamiseks õiguste seadmine

  1. Jaotises Azure DevOps valige Projekti sätted Teenuseühendused>.

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

  3. Otsige ja valige oma projekti nimi Järguteenus (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 võimaldada torujuhtmetega ühenduse loomist Dataverse. Tehke seda igas keskkonnas, kuhu kavatsete ALM Acceleratorit juurutada.

  1. Logige sisse Power Platform halduskeskusesse.

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

  3. Valige Kasutajad + õigused>Rakenduse kasutajad.

  4. Valige + Uus rakenduse kasutaja.

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

  6. Valige äriüksus.

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

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

  8. Valige käsk Loo.

Korrake neid samme oma valideerimis-, testimis- ja tootmiskeskkonnas.

Lahenduse seadistus

Kui loote lahenduse sisse Dataverse, peate looma spetsiaalselt selle lahenduse jaoks torujuhtmed. Järgmised näidiskonveierid on lisatud coe-alm-templates hoidla torujuhtmete kataloogi :

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 juhiseid iga lahenduse puhul, mille jaoks kasutate ALM Acceleratorit allika juhtimiseks.

Oluline

Teie lahenduse müügitoru YAML salvestatakse alati samasse reposse, mida kasutate oma lahenduse allika juhtimiseks. Kuid müügitoru mallid — st kaust Pipeline\Templates — võivad eksisteerida kas samas repos kui teie lahenduse konveier YAML või eraldi repos 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: valideerimine, testimine ja tootmine. Siiski saate luua nii palju lahendusetorusid kui vaja, lähtudes oma organisatsiooni keskkonnastrateegiast.

Näidisjuurutustorud käivitatakse haru muudatustega (st testimine ja tootmine) või harupoliitika Azure DevOps osana (st valideerimine). Lugege lisateavet selle kohta, kuidas määrata harupoliitikad tõmbetaotluse valideerimiseks. Torujuhtmeid saate käivitada ka käsitsi, ilma päästikuta.

Järgige selles jaotises toodud juhiseid juurutuskonveierite loomiseks näidiskonveierist YAML. Järgmine tabel kirjeldab müügitoru konfiguratsiooni.

Oluline

Müügitoru nimi peab olema täpselt selline, nagu on näidatud järgmises tabelis, koos teie lahenduse nimega MyNewSolutioni asemel.

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

Märkus.

Järgmised sammud loovad ja juurutavad konveiereid valideerimis-, testimis- ja tootmiskeskkondade jaoks. Siiski võite soovida luua ja juurutada valideerimiseks ja testimiseks ning seejärel juurutada artefaktid testjärgust tootmisse. Kui see on nii, järgige selles jaotises olevaid juhiseid ainult oma valideerimis- ja testkeskkondade puhul. Seejärel liikuge lahenduse loomise juurde juurutuskonveier väljalasketoru konfigureerimiseks.

Müügitoru faili loomine

  1. Minge Azure DevOps-i jaotisesse repo, mis sisaldab teie konveierite kausta, ja valige kaust Konveierid.

  2. Avage üks kolmest juurutuskonveoni näidiskonveierist ja kopeerige YAML, et seda uues müügitorus kasutada.

  3. Pange tähele konveieris kasutatava repo nime.

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

  5. Looge haru oma vaikeharu põhjal ja pange sellele oma lahendusele nimi; näiteks MyNewSolution.

    Sellest harust saab teie lahenduse järgmine versiooni (v-järgmine) haru. Kogu arendustöö tuleb hargneda sellest harust arendaja isikliku tööharuni ja seejärel ühendada v-järgmise haruga, et suruda valideerimisele ja testimisele. 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 müügitoru YAML-failile nimi, näiteks build-deploy-validation-SampleSolution.yml,build-deploy-test-SampleSolution.yml või build-deploy-prod-SampleSolution.yml.

  9. Valige käsk Loo.

Faili värskendamine ja salvestamine

  1. Kleepige eelmises jaotises samm 2 kopeeritud YAML uude torujuhtmefaili.

  2. Muutke uues müügitorus YAML järgmisi väärtusi.

    • Ressursside hoidlate>muutmine>Nimi repo nimele, mis sisaldab teie müügitoru malle.

      Selles näites nimetatakse repo nimeks coe-alm-accelerator-templates ja see eksisteerib samas projektis kui MyNewSolution repo. Kui teie mallihoidla on mõnes muus Azure DevOps projektis, kasutage vormingut ProjectName/RepoName. Vajadusel saate parameetri abil ref määrata ka haru, kus teie mallid asuvad.

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

  3. Valige Kinnitamine, et enda muudatused salvestada.

  4. Avage Azure DevOps jaotises Konveierid ja seejärel valige Uue konveieri loomine.

  5. Valige oma koodihoidla jaoks Azure Repos Git.

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

  7. Valige lehel Müügitoru konfigureerimine suvand Olemasolevad Azure’i torujuhtmete YAML-fail, osutage oma repos olevale YAML-failile, mille varem lõite, ja seejärel valige Jätka.

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

  9. Muutke müügitoru 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 müügitoru ei loodud hoidla vaikeharus: valige müügitorus käsk Redigeeri . Valige paremas ülanurgas (...) ja seejärel valige Päästikud. Valige vahekaart YAML ja seejärel valige Hangi allikad. Muutke käsitsi ja ajastatud järkude vaikeharu nii, et see osutaks teie lahenduse harule. Vaadake lisateavet torujuhtme päästikute konfigureerimise kohta.

  12. Korrake eelmisi samme, et luua iga keskkonna jaoks juurutuskonveier, viidates näidisele YAML-juurutuskonveier coe-alm-kiirendi-mallide repo (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 eelmises jaotises toodud sammud müügitorusid, mis ehitavad ja juurutavad valideerimis-, testimis- ja tootmiskeskkondade jaoks. Siiski saate luua eraldi lahenduse juurutuskonveier, kui soovite luua ja juurutada ainult valideerimiseks ja testimiseks ning seejärel juurutada artefaktid testjärgust tootmisse.

Järgige selles jaotises toodud juhiseid, et luua lahendus juurutuskonveier näidiskonveierist YAML. Järgmine tabel kirjeldab müügitoru konfiguratsiooni.

Oluline

Müügitoru nimi peab olema täpselt selline, nagu on näidatud järgmises tabelis, koos teie lahenduse nimega MyNewSolutioni asemel.

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

  1. Minge Azure DevOps-i jaotisesse repo, mis sisaldab teie konveierite kausta ja valige kaust Konveierid.

  2. Avage deploy-prod-pipelineartifact-SampleSolution.yml juurutustorunäidis ja kopeerige YAML, et seda uues müügitorus 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 torujuhtme YAML-failile nimi; näiteks deploy-prod-MyNewSolution.yml, kus MyNewSolution on teie lahenduse nimi.

  7. Valige käsk Loo.

  8. Kleepige samm 2-s kopeeritud YAML uude torujuhtmefaili.

  9. Muutke uues müügitorus YAML järgmisi väärtusi.

    • Muuda päästiku>harusid>Kaasa harud, kus muudatused peaksid käivitama juurutamise tootmisse.

    • Ressursside hoidlate>muutmine>Nimi repo nimele, mis sisaldab teie müügitoru malle.

      Selles näites nimetatakse repo nimeks coe-alm-accelerator-templates ja see eksisteerib samas projektis kui MyNewSolution repo. Kui teie mallihoidla on mõnes muus Azure DevOps projektis, kasutage vormingut ProjectName/RepoName. Vajadusel saate parameetri abil ref määrata ka haru, kus teie mallid asuvad.

    • Värskendage ressursside>torujuhtmete>allikat , et määrata ehituskonveier, mis sisaldab artefakte, mida see konveier peaks juurutama. Sellisel juhul juurutate artefaktid varem loodud testtorust, mis ehitas ja juurutas teie lahenduse testkeskkonda.

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

  10. Korrake eelmises jaotises juurutus-valideerimine-ALMAcceleratorSampleSolution ja deploy-test-ALMAcceleratorSampleSolution juhiseid 11 kuni 20, et luua konveier uuest tootmistorust YAML nimegadeploy-prod-ALMAcceleratorSampleSolution .

Juurutuskonveier muutujate määramine

Iga varem konfigureeritud juurutuskonveier puhul peate määrama muutujate EnvironmentName väärtused ja ServiceConnection põhinema keskkonnal, kuhu müügitoru juurutatakse. Samuti saate määrata, EnableFlows et muutuja lülitaks vood juurutuse osana välja Power Automate .

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

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

  • EnvironmentName Määrab Azure DevOps juurutatava keskkonna juurutusajaloo jälgimise lubamiseks ning konkreetsetes keskkondades juurutamiseks õiguste ja kinnituste määramiseks. Määrake selle väärtuse väärtuseks Valideeri, Test või Tootmine, vastavalt vajadusele.

  • ServiceConnection Määrab juurutuskonveier ühendumisviisi Power Platform. Lubatud väärtused on varem loodud teenuseühenduste nimed.

  1. Valige iga juurutustoru puhul käsk Redigeeri.

  2. Valige juurutuskonveier definitsioonist Muutujad , et avada muutujate redaktor.

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

Muutujate EnvironmentName ja ServiceConnection loomiseks korrake neid samme.

Muutuja EnableFlows loomine (valikuline)

Võite määrata müügitorumuutuja EnableFlows väärtuseks Väär, et jätta vahele etapid, mis lubavad Power Automate vood juurutuse osana automaatselt. Muutuja vaikeväärtus EnableFlows on Tõene.

Harupoliitikate seadmine tõmbetaotluse valideerimiseks

Looge harupoliitika , et käivitada müügitoru, mille lõite varem tõmbetaotluse loomisel.

  1. Minge Azure DevOps jaotisesse Repos ja valige siis kaust Harud.

  2. Leidke haru, mille jaoks soovite tõmbetaotluse poliitika luua. Valige (...) harust paremal ja seejärel valige Harupoliitikad.

  3. Lehel Harupoliitikad, minge Järgu valideerimine.

  4. Uue harupoliitika lisamiseks valige +.

  5. Valige loendist Müügitoru koostamine varem loodud müügitoru.

  6. Määrake teefilter (kui see on kohaldatav), veendumaks, et ainult määratud tee muudatused käivitavad tõmbetaotluse torujuhtme.

  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 harupoliitikale kuvatav nimi ; näiteks PR-järgu valideerimine.

  11. Valige käsk Salvesta.

Kuvatõmmis valideerimise järgupoliitika sätete valimisest.

Ressursside juurdepääsuõiguste määramine torujuhtmetele

Torujuhtmete käitamiseks on vaja juurdepääsu vajalikele ressurssidele, nagu hoidlad, muutuvate rühmade ja teenuseühendused. Juurdepääsu lubamiseks on teil kolm võimalust.

Juurdepääsu andmine esimese jooksu ajal

Saate lubada juurdepääsu vajalikule ressursile torujuhtme esimese käitamise ajal.

  1. Käivitage torujuhe ja avage torujuhe Azure DevOps.
  2. Valige bänneril "nõutav luba" vaade .
  3. Valige iga vajaliku ressursi jaoks Luba .

Selgesõnalise loa andmine

Saate anda selgesõnalise loa, et konveier pääseks juurde vajalikele repodele.

  1. Jaotises Azure DevOps avage Projekti sätted.
  2. Valige Hoidlad ja seejärel valige hoidla.
  3. Valige vahekaart Turve.
  4. Kerige alla jaotiseni Müügitoru õigused ja valige +.
  5. Valige konveier, millele soovite hoidlale juurdpääsu anda.

Saate anda konveierile selgesõnalise loa juurdepääsuks nõutavatele muutuvatele rühmadele.

  1. Valige Jaotises Azure DevOps Pipelines Library (Torujuhtmete>teek) ja seejärel valige muutuv rühm.
  2. Valige Konveieri õigused.
  3. Valige + ja seejärel valige müügitoru, millele soovite muutujarühmale juurdepääsu anda.

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

  1. Jaotises Azure DevOps avage Projekti sätted.
  2. Valige Teenuseühendused ja seejärel valige teenuseühendus.
  3. Valige Veel toiminguid (...) ja seejärel valige Turve.
  4. Kerige alla jaotiseni Müügitoru õigused ja valige +.
  5. Valige torujuhe, millele soovite anda juurdepääsu teenuseühendusele.

Andke kõigile torujuhtmetele juurdepääs

Saate lubada kõigil torujuhtmetel, nii neil, mis teil praegu on, kui ka kõigil, mida loote tulevikus, juurdepääsu vajalikele hoidlatele.

  1. Jaotises Azure DevOps avage Projekti sätted.
  2. Valige Hoidlad ja seejärel valige hoidla.
  3. Valige vahekaart Turve.
  4. Liikuge alla Konveieriõigusteni.
  5. Valige Veel toiminguid (...), valige Ava juurdepääs ja seejärel kinnitage, kui seda palutakse.

Saate lubada kõigil torujuhtmetel juurdepääsu nõutavatele muutuvatele rühmadele.

  1. Valige Jaotises Azure DevOps Pipelines Library (Torujuhtmete>teek) ja seejärel valige muutuv rühm.
  2. Valige Konveieri õigused.
  3. Valige Veel toiminguid (...), valige Ava juurdepääs ja seejärel kinnitage, kui seda palutakse.

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

  1. Jaotises Azure DevOps avage Projekti sätted.
  2. Valige Teenuseühendused ja seejärel valige teenuseühendus.
  3. Valige Veel toiminguid (...) ja seejärel valige Turve.
  4. Valige teenuseühendus, valige Veel toiminguid (...) ja seejärel valige Turve.
  5. Liikuge alla Konveieriõigusteni.
  6. Valige Veel toiminguid (...), valige Ava juurdepääs ja seejärel kinnitage, kui seda palutakse.

Määrake tööõiguste ulatus

Töö autoriseerimise ulatuse saab määrata kogu Azure DevOps organisatsioonile või konkreetsele projektile. Keelake säte Piira töö autoriseerimise ulatust praegusele projektile väljalasketorude jaoks, kui valite mallide installimiseks mõne muu Azure DevOps projekti.

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

  1. Azure DevOpsValige jaotises Organisatsiooni sätted > Torujuhtmete > sätted.
  2. Keelake säte Piira töö autoriseerimise ulatust praegusele projektile väljalasketorude jaoks.

Juurutuse konfiguratsiooni loomine (valikuline)

Pärast lahenduse juurutamist peate sihtkeskkonnas looma mitu konfiguratsiooni. Need konfiguratsioonid on keskkonnaspetsiifilised ja sisaldavad ühenduseviiteid, keskkonnamuutujaid ning rühmade ja Microsoft Entra meeskondade õigusi Dataverse , lisaks lõuendirakenduste jagamisele ja lahendusekomponentide, näiteks Power Automate voogude omandiõiguse värskendamisele. Koos nende konfiguratsioonidega vajab sihtkeskkond sageli näidis- või konfiguratsiooniandmeid, mis on seostatud lahenduse tabelitega Dataverse , et pakkuda täielikku täielikku ALM-i kogemust.

Kui teie lahendus nõuab neid muid konfiguratsioone või andmeid, järgige juurutuse konfigureerimisjuhendit , et konfigureerida konveiereid keskkondade põhjal, milles juurutate.

Lahenduse importimine ja rakenduse konfigureerimine

Importige lõuendirakendus ALM Accelerator oma Power Platform keskkonda ja konfigureerige seejärel kaasasolev kohandatud konnektor Azure DevOps.

Installige ALM Accelerator Dataverse

  1. ALM Accelerator lahendus sõltub Creator Kitist. Installige loojakomplekt kohe.

  2. Laadige GitHubist alla uusim hallatav lahendus fail. Kerige alla jaotiseni Varad ja valige CenterofExcellenceALMAccelerator_<uusim versioon>_managed.zip.

  3. Logige sisse ja Power Apps valige seejärel keskkond, mida soovite rakendust ALM Accelerator majutada.

  4. Tehke vasakpoolsel külgpaneelil valik Lahendused.

  5. Valige Impordi lahendus>Sirvige ja seejärel sirvige allalaaditud hallatav lahendus asukohani ning valige fail.

  6. Valige Edasi ja seejärel uuesti Edasi.

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

    Kui loote HTTP-ühenduse Microsoft Entra, kasutage mõlema parameetri jaoks Microsoft Graphi .

  8. Valige Impordi.

Seadistage DevOpsi kohandatud konnektor

  1. Valige Data>Custom Connectors>CustomAzureDevOps.

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

    Nimetus Väärtus
    Autentimise tüüp OAuth 2.0
    Identiteedi pakkuja Azure Active Directory
    Kliendi ID Rakenduse (kliendi) ID , mille kopeerisite rakenduse registreerimise loomisel
    Kliendisaladus Rakenduse (kliendi) salajane väärtus , mille kopeerisite rakenduse registreerimise loomisel
    Rentniku ID Jätke vaikeväärtus tavaliseks
    Ressursi URL DevOps rakenduse (kliendi) ID , mille kopeerisite, kui lisasite rakenduse registreerimisele õigused
    Ümbersuunamise URL Genereerib automaatselt. Kui märkate märkeruutu "Värskenda kordumatule ümbersuunamis-URL-ile" "Ümbersuunamis-URL", märkige palun märkeruut.

  3. Valige Konnektori värskendamine.

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

Ülaltoodud jaotisest automaatselt genereeritud ümbersuunamis-URL tuleb lisada rakenduse registreerimisele kui "Ümbersuunamis-URI".

  1. Naaske loodud rakenduse registreerimisele.

  2. Valige vasakpoolsel külgpaneelil Ülevaade .

  3. Valige Lisa ümbersuunamise URI.

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

  5. Kleepige tekstikasti Ümbersuunamis-URI-d ülalolevast jaotisest kopeeritud automaatselt genereeritud ümbersuunamis-URL.

  6. Tehke valik Konfigureeri.

Kohandatud konnektori testimine

  1. Avage menüü Test.

  2. Valige Uus ühendus ja järgige ühenduse loomiseks kuvatavaid juhiseid.

  3. Valige jaotises Power Apps oma keskkond ja seejärel Dataverse>Kohandatud konnektorid>CustomAzureDevOps.

  4. Valige Redigeeri, mingelehele Test ja otsige üles toiming Hangi_organisatsioonid .

  5. Valige Testi toiming.

  6. Kinnitage vastus Tagastatud olek on 200 ja vastus Keha on teie Azure DevOps organisatsiooni JSON-i esindus.

    Kohandatud Azure DevOps konnektori turvasätete testimise kuvatõmmis.

Seadistage tegijad kasutama rakendust ALM Accelerator

Lisateave