Del via

Konfigurer ALM Accelerator manuelt

  • Artikkel

Du kan konfigurere komponentene i ALM Accelerator for Power Platform ved hjelp av den tilhørende administrasjonsappen eller manuelt. Denne artikkelen veileder deg gjennom konfigurasjon av appen manuelt og er strukturert i sju deler:

Forutsetning

Pass på at du har oppfylt følgende forhåndskrav før du installerer ALM Accelerator for Power Platform.

  • ALM Accelerator må installeres i et Power Platform-miljø med en Microsoft Dataverse-database. Alle miljøene der du bruker ALM Accelerator til å distribuere løsninger, krever også en Dataverse-database.

    Obs!

    ALM Accelerator er ikke kompatibel med Dataverse for Teams. Både ALM Accelerator for appen og de tilknyttede kanalene forutsetter at du bruker den fullstendige versjonen av Dataverse i alle miljøer.

    Vi anbefaler at du installerer ALM Accelerator i samme miljø som andre CoE-startpakkeløsninger. Finn ut mer om hvordan du finner den beste strategien for organisasjonen:

  • ALM Accelerator bruker Azure DevOps for kildekontroll og distribusjoner. Hvis du ikke har en Azure DevOps-organisasjon, kan du registrere deg for opptil fem brukere på Azure DevOps-nettstedet.

  • For å fullføre trinnene nedenfor trenger du følgende brukere og tillatelser i Azure, Azure DevOps og Power Platform:

    • En lisensiert Azure-bruker med tillatelser til å opprette og vise Microsoft Entra-grupper, opprette appregistreringer og gi administratorsamtykke til appregistreringer i Microsoft Entra ID
    • En lisensiert Azure DevOps-bruker med tillatelser til å opprette og administrere pipeliner, servicetilkoblinger, repositorier og utvidelser
    • En lisensiert Power Platform-bruker med tillatelser til å opprette programbrukere og gi vedkommende administrative tillatelser

  • Følgende koblinger må være tilgjengelige for bruk sammen i miljøet ALM Accelerator importeres til:

  • Installer Creator Kit i miljøet der du installerer ALM Accelerator.

Grunnleggende oppsett

Følgende fremgangsmåte er generelle for funksjonaliteten til ALM Accelerator og er ikke spesifikke til et prosjekt eller en løsning.

Opprette en appregistrering i Microsoft Entra-miljøet

Opprett en appregistrering for ALM Accelerator for å gi tillatelser til appen og de tilknyttede kanaltillatelsene som kreves for å utføre operasjoner i Azure DevOps og Power Apps eller Dataverse. Du trenger bare å gjøre dette én gang.

Følgende trinnene viser hvordan du oppretter én enkelt appregistrering med tillatelser for både Dataverse og Azure DevOps. Det kan imidlertid være lurt å opprette separate appregistreringer for å skille ansvarsområder. Du bør vurdere hvordan separate appregistreringer påvirker både vedlikehold og sikkerhet før du bestemmer deg for en strategi for appregistrering.

Opprett appregistreringen

  1. Logg deg på Azure-portalen.

  2. Velg Microsoft Entra ID>Appregistreringer.

  3. Velg + Ny registrering, og gi deretter registreringen et navn, for eksempel ALMAcceleratorServicePrincipal.

  4. La alle andre alternativer ha standardverdier, og velg Registrer.

Legg til tillatelser i appregistreringen

  1. Velg API-tillatelser i venstre sidepanel.

  2. Velg + Legg til en tillatelse.

  3. Velg Dynamics CRM og deretter Delegerte tillatelser og user_impersonation.

  4. Velg Legg til tillatelser for å legge til Dynamics CRM API user_impersonation-tillatelsen i appregistreringen.

  5. Velg + Legg til en tillatelse på nytt.

  6. Velg fanen API-er som organisasjonen min bruker. Søk etter PowerApps-Advisor og velg Delegerte tillatelser og Analysis.All (administratorsamtykke kreves ikke).

    Denne tillatelsen kreves for å kjøre statisk analyse via appkontrollen.

  7. Velg Legg til tillatelser for å legge til PowerApps-Advisor API Analysis.All-tillatelsen i appregistreringen.

  8. Velg + Legg til en tillatelse på nytt.

  9. På enten API-fanen eller API-ene organisasjonen bruker Microsoft , Velg og deretter Velg Delegerte tillatelser og Azure DevOpsuser_impersonation .

    Denne tillatelsen kreves for tilkobling til Azure DevOps via den egendefinerte koblingen i ALM Accelerator-appen.

  10. Hvis du la til Azure DevOps-tillatelsen fra listen API-er som organisasjonen min bruker, må du kopiere app-ID-en (klient-ID-en) til senere bruk i denne prosedyren.

    Du bruker den opp som DevOps-program-ID (klient), som er forskjellig fra Program-ID (klient) som du kopierer senere i denne prosedyren.

    Skjermbilde av vinduet Be om API-tillatelser med fanen API-er som organisasjonen min bruker og Program-ID (klient) uthevet.

    Hvis du ikke finner Azure DevOps-tillatelsen i fanen API-er som organisasjonen min bruker, kan du følge fremgangsmåten for å hente DevOps-program-ID-en (klient):

    1. Åpne et privat nettleservindu og gå til https://dev.azure.com/<your devops organization>/_apis.
    2. Kopier verdien for client_id i nettadressen på påloggingssiden.

    Skjermbilde av en Azure DevOps-organisasjons påloggingsside med client_id-parameteren i nettadressen uthevet.

  11. Velg Legg til tillatelser for å legge til Azure DevOps API user_impersonation-tillatelsen i appregistreringen.

  12. Velg Gi administratorsamtykke for <leideren din>.

Konfigurer klienthemmeligheten og omdirigerings-URI-en

  1. Velg Sertifikater og hemmeligheter i venstre panel.

  2. Velg + Ny klienthemmelighet.

  3. Velg en utløpsdato og deretter Legg til.

  4. Kopier klienthemmeligheten Verdi til senere bruk. Dette er den eneste gangen du kan kopiere verdien. Pass på at du gjør dette før du forlater siden.

  5. Velg Oversikt i venstre sidepanel.

  6. Kopier Program-ID (klient) og Katalog-ID (leier).

  7. Velg Konfigurer.

Gi Power App Management-tillatelse til appregistreringen

Gi Power App Management-tillatelser til appregistreringen slik at kanaler kan utføre handlingene de trenger, i miljøene dine. Dette gjør du ved å kjøre følgende PowerShell-cmdlet som en interaktiv bruker som har administrative rettigheter for Power Apps. Du trenger bare å kjøre denne kommandoen én gang etter at du har opprettet appregistreringen.

Viktig

Følgende PowerShell-cmdlet gir appregistreringen opphøyede tillatelser, for eksempel Power Platform-administrator. Det kan hende at organisasjonens sikkerhetspolicyer ikke tillater denne typen tillatelser. Kontroller at de er tillatt før du fortsetter. Hvis de ikke er tillatt, fungerer ikke enkelte funksjoner i ALM Accelerator-kanalene.

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>

Installere Azure DevOps-utvidelser

ALM Accelerator bruker flere Azure DevOps-utvidelser, inkludert noen tredjepartsutvidelser som er tilgjengelige på Azure DevOps Marketplace. Du finner nettstedet for hver tredjepartsutvidelse og en koblingen til kildekoden i følgende instruksjoner. Finn ut hvordan du evaluerer en Marketplace-utvidelsesutgiver.

  1. Logg på Azure DevOps.

  2. Velg Organisasjonsinnstillinger.

  3. Velg Generelt>Utvidelser.

  4. Søk etter og installer følgende utvidelser:

Klone YAML-pipelinene fra GitHub til Azure DevOps-forekomsten

  1. Gå til https://aka.ms/coe-alm-accelerator-templates-latest-release og kopier nettadressen til den nyeste versjonen.

  2. Logg på Azure DevOps.

  3. Opprett et prosjekt, eller velg et eksisterende prosjekt.

  4. Velg Repositorier, og velg deretter Importer repositorium i repositoriumslisten.

  5. Lim inn nettadressen du kopierte i trinn 1, som Nettadressen for klone, og velg deretter Importer.

  6. Bekreft at standardgrenen for repositoriet er hoved. Velg Repositorier og Grener, og kontroller at hovedgrenen er merket som standard.

    Hvis den ikke er det, velger du de tre loddrette prikkene (⋮) som tilsvarer hovedgrenen, og fra menyen Flere alternativer velger du Angi som standardgren.

    Obs!

    Dette repositoriet er stedet der malene for løsningskanalen og eksport-/importkanaler kjører. Når du senere oppretter kanaler for løsningene, kan det hende du må henvise til dette bestemte prosjektet og repositoriet hvis du velger å bruke et annet repositorium for kildekontroll for løsningene.

Opprette pipeliner for import, sletting og eksport av løsninger

Opprett import-, slette- og eksportkanaler basert på YAML-en i Azure DevOps-respositoriet. Disse kanalene kjøres når du bruker appen til å utføre en løsning til Git, importere en løsning eller slette en løsning.

Obs!

Hvis du forventer at alle eksportene utfører de samme handlingene uavhengig av løsningen som kanalen kjører for, kan du opprette én enkel eksportkanal som beskrevet i denne delen. Det kan imidlertid hende du trenger ulike eksporthandlinger basert på løsningen. Hvis det er tilfelle, kan du legge til løsningsnavnet i kanalen for eksporter-løsning-til-git-kanalen, som export-solution-to-git-SampleSolution for å få appen til å kjøre de spesifikke løsningskanalene når du utfører handlingene i appen.

Tabellen nedenfor viser korrespondansen mellom YAML-filen i repositoriet og den tilhørende kanalen.

YAML-fil Navn på pipeline
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. I Azure DevOps går du til Forløp>Opprett et nytt forløp.

  2. Velg Azure Repos Git for koderepositoriet, og pek deretter på Azure DevOps-repositoriet du opprettet og sendte med kanalmalene i tidligere trinn.

  3. På siden Konfigurer pipelinen velger du Eksisterende YAML-fil for Azure-pipeliner og peker på /Pipelines/export-solution-to-git.yml, /Pipelines/import-unmanaged-to-dev-environment.yml eller /Pipelines/delete-unmanaged-solution-and-components.yml.

  4. Velg Fortsett, og velg deretter Lagre.

  5. Velg Mer-menyen (...) ved siden av Kjør kanal, og velg deretter Gi nytt navn/flytt.

  6. Endre kanalnavnet til export-solution-to-git, import-unmanaged-to-dev-environment eller delete-unmanaged-solution-and-components etter behov.

  7. Velg Lagre.

Opprette eksportpipelinesvariabler (valgfritt)

Du kan angi kanalvariabler i export-solution-to-git-pipeline for å styre hvilken informasjon som beholdes i kildekontrollen. Hvis du vil bruke disse innstillingene globalt, kan du angi følgende variabler på export-solution-to-git-kanal. Hvis du vil bruke innstillingene på spesifikke løsninger ved eksport, kan du også opprette en bestemt eksportkanal for løsningen som beskrevet i den forrige delen, og angi følgende variabler på kanalen.

Hvis du vil kontrollere at de nåværende verdiene for miljøvariablene aldri utføres til kildekontroll under eksportprosessen, oppretter du DoNotExportCurrentEnvironmentVariableValues-variabelen i export-solution-to-git-kanalen og angir verdien til Sann.

Viktig

Denne pipelinevariabelen anbefales slik at du kan bruke funksjonen for distribusjonskonfigurasjon i ALM Accelerator.

Hvis du vil kontrollere at verdiene for bestemte standardmiljøvariabler er angitt under eksport av en løsning, oppretter VerifyDefaultEnvironmentVariableValues-variabelen i export-solution-to-git-kanalen og angir verdien til Sann. Angi verdiene for standardmiljøvariabler i den egendefinerte DeploymentSettings.json som beskrevet i distribusjonskonfigurasjonsveiledningen.

  1. I Azure DevOps velger du Kanaler>Bibliotek>Opprett en ny variabelgruppe.

  2. Gi den nye variabelgruppen navnet alm-accelerator-variable-group, nøyaktig som angitt her.

    Kanalene henviser til denne bestemte variabelgruppen, slik at den må gis navn nøyaktig slik det vises. Hvis du bestemmer deg for å bruke en annen navnekonvensjon for variabelgruppen, må du endre deler av kanalene, slik at de henviser til navnet du bruker i stedet.

  3. Legg til variablene nedenfor i variabelgruppen:

    Name Bekrivelse Verdi
    AADHost Microsoft Entra-godkjenningsendepunktet Bruk login.microsoftonline.com for offentlige skyer. Bruk den riktige godkjenningsnettadressen for offentlige skyer.
    ProcessCanvasApps Om lerretsapper pakkes ut under eksport eller pakkes under builds Hvis Usann pakkes ikke lerretsapper ut under eksport eller pakkes under builds. Funksjonen for utpakking og pakking er i forhåndsversjon, og den anbefales ikke for bruk i produksjonsmiljøer akkurat nå. Du kan imidlertid ikke vise kildekoden for lerret i kildekontrollen med mindre du angir Sann for denne variabelen.

  4. (Valgfri) Hvis du bruker testautomatisering for lerretsstudio i kanalene, legger du til følgende variabler i variabelgruppen:

    Name Verdi
    TestAutomationLoginMethod Cloud-identitet
    TestAutomationMakerPortalUrl Nettadressen fra Power Apps Maker Portal, vanligvis *https://make.powerapps.com*
    TestAutomationUsername Brukerkontoen som brukes til å kjøre de automatiske testene
    TestAutomationPassword Passordet for brukerkontoen som brukes til å kjøre de automatiske testene

  5. (Valgfritt) Som standard er de globale variablene begrenset og du må konfigurere tilgang for hver kanal. Du kan forenkle det og gi tilgang til alle kanaler. Under Variabelgruppe (Kanal>Bibliotek>alm-accelerator-variable-group) velg Kanaltillatelser i menyen øverst (...) og velger Åpne tilgang.

Angi tillatelser for prosjektbyggingstjenesten

Viktig

Azure DevOps-inneholder en rekke Byggservice-kontoer, og det kan føre til forvirring når du følger fremgangsmåten i denne delen. Vær oppmerksom på navnene og formatet angitt i trinn 3 og 5. Det kan hende du må søke etter den bestemte forretningsforbindelsen hvis den ikke vises i den første listen.

  1. I Azure DevOps velger du Prosjektinnstillinger.

  2. Velg Repositorier>Sikkerhet.

  3. Under Brukere søker du etter og velger Buildtjeneste for prosjektsamling (Ditt organisasjonsnavn).

    Obs!

    Du ser kanskje ikke Organisasjonsnavnet etter brukeren Buildtjeneste for prosjektsamling. Det kan være bare en unik identifikator. I dette tilfellet bruker du søkefunksjonen til å finne brukeren og velger den.

  4. Angi tillatelsene nedenfor for byggetjenestebrukeren:

    Tillatelse Verdi
    Bidrag Tillat
    Bidra til henteforespørsler Tillat
    Opprett gren Tillat
    Rediger policyer Tillat

  5. Under Brukere søker du etter og velger Buildtjeneste for prosjektnavnet ditt (Ditt organisasjonsnavn).

  6. Angi de samme verdiene som i trinn 4.

  7. Velg Kanaler, velg de tre prikkene øverst (...) i øvre høyre hjørne, og velg deretter Administrer sikkerhet.

  8. Angi tillatelsene nedenfor for brukeren Prosjektnavnet-byggtjeneste (organisasjonsnavnet):

    Tillatelse Verdi
    Redigere kompileringskontroll Tillat
    Redigere byggkvalitet Tillat
    Administrere byggkø Tillat
    Overstyre innsjekkingsvalidering av bygg Tillat
    Oppdatere bygginformasjon Tillat
    Vis byggpipeline Tillat
    Vise bygg Tillat

  9. Velg Prosjektinnstillinger>Agentutvalg, velg Sikkerhet, og velg deretter Legg til.

  10. Søk etter og velg Buildtjeneste for prosjektnavnet ditt (Ditt organisasjonsnavn).

  11. Sett rollen til Leser.

  12. Velg Legg til.

  13. (Valgfritt) Som standard er pipelinetillatelsene for hvert repositorium begrenset, og du må konfigurere dem individuelt. Du kan forenkle det og gi tilgang til alle kanaler. Under Prosjektinnstillinger>Repositorier velger du hver respositorier etter tur. Velg Sikkerhet på den øverste menyen. Finn blokken Kanaltillatelser, og velg (...) og velg deretter Åpne tilgang.

Konfigurere utviklingsprosjekt

Delen nedenfor veileder deg gjennom trinnene som kreves for å konfigurere hvert av utviklingsprosjektene du skal støtte. I denne sammenhengen består et utviklingsprosjekt av infrastrukturen og konfigurasjonen som støtter en sunn administrasjon av applivssyklus, inkludert konfigurasjonen av Dataverse-miljøet som støtter selve prosessen for administrasjon av applivssyklus.

Opprett servicetilkoblinger for Azure DevOps for tilgang til Power Platform

Hvert Dataverse-miljø, for eksempel utvikling, validering, test og produksjon, må ha en Power Platform-tjenestetilkobling i Azure DevOps. Utfør fremgangsmåten nedenfor for hvert av miljøene.

Obs!

ALM Accelerator-appbrukere ser bare miljøer som de har enten en bruker eller en administratorrolle i tjenestetilkoblingen i Azure DevOps. Hvis de arbeider i personlige utviklingsmiljøer, må utviklere ha en bruker- eller administratorrolle for tjenestetilkoblingen for sitt eget personlige utviklingsmiljø. Servicetilkoblinger for validerings-, test- og produksjonsmiljø som buildtjenesten trenger bare tillatelser som gis til pipeliner.

  1. Logg deg på Azure DevOps, og velg deretter prosjektet.

  2. Velg Prosjektinnstillinger>Servicetilkoblinger, og velg deretter Opprett tjenestetilkobling.

  3. Søk etter og velg Power Platform-tjenestetilkoblingstypen.

  4. Velg Neste.

  5. For Servernettadressen angir du miljønettadressen, for eksempel https://myorg.crm.dynamics.com/.

    Viktig

    Du må inkludere den etterfølgende skråstreken (/) etter nettadressen, dvs. .com i dette eksemplet.

  6. Angi den samme nettadressen som i trinn 4 for Tjenestetilkoblingsnavn, inkludert skråstreken for opplæring (/).

  7. Angi Leier-ID, Program-ID (klient) og Klienthemmelighet du kopierte fra Microsoft Entra da du opprettet appregistreringen.

  8. Velg Gi tilgangstillatelser til alle kanaler.

  9. Velg Lagre.

Tjenestetilkoblingen må gi brukertillatelser til alle brukere i alle miljøer som brukere trenger, for å få tilgang fra ppen (f.eks. utviklermiljøer).

  1. I listen tjenestetilkoblinger velger du tjenestetilkoblingen som skal deles med brukere.

  2. Velg Mer (...) øverst i høyre hjørne, og velg deretter Sikkerhet.

  3. I listen Gruppe eller bruker velger du gruppen eller brukeren du vil gi brukertillatelser til.

  4. Velg Bruker, velg en Rolle, og velg deretter Legg til.

Gjenta trinnene i denne delen for hvert av miljøene, for eksempel utvikling, validering, test og produksjonsmiljøer.

Angi tillatelser for prosjektbyggingstjenesten for å bruke tjenestetilkoblingene

  1. I Azure DevOps velger du Prosjektinnstillinger>Tjenestetilkoblinger.

  2. Velg (...) øverst til høyre velger du Sikkerhet og velger Legg til.

  3. Søk etter og velg Buildtjeneste for prosjektnavnet ditt (Ditt organisasjonsnavn).

  4. Angi rollen til Administrator, og velg deretter Legg til.

Opprette en appbruker i Dataverse-miljøene

Opprett en programbruker i miljøene slik at kanaler kan kobles til Dataverse. Gjør dette i hvert miljø du planlegger å bruke ALM Accelerator til å distribuere i.

  1. Logg på Power Platform-administrasjonssenteret.

  2. Velg utviklermiljøet, og velg deretter Innstillinger.

  3. Velg Brukere + tillatelser>Programbrukere.

  4. Velg + Ny appbruker.

  5. Velg + Legg til en app, velg appregistreringen du opprettet tidligere og deretter Legg til.

  6. Velg forretningsenheten.

  7. Velg blyantikonet til høyre for Sikkerhetsroller, og velg deretter sikkerhetsroller for appbrukeren.

    Vi anbefaler at du gir denne appbrukeren administratorsikkerhetsrollerettigheter slik at du brukeren kan utføre de nødvendige funksjonene i hvert miljø.

  8. Velg Opprett.

Gjenta denne fremgangsmåten i validerings-, test- og produksjonsmiljøene.

Konfigurere løsning

Når du oppretter en løsning i Dataverse, må du opprette pipeliner spesielt for den løsningen. Følgende eksempelkanaler er inkludert i Kanaler-katalogen i coe-alm-templates-repositoriet:

Eksempelpipelinene gjør det mulig for organisasjoner å lagre pipeline-malene sine i et separat prosjekt, eller repositoriet fra den spesifikke YAML-en for løsningspipeline. Følg fremgangsmåten i denne delen for å konfigurere løsningspipelinen. Gjenta disse trinnene for hver løsning der du bruker ALM Accelerator for kildekontroll.

Viktig

YAML-en for løsningskanalen lagres alltid i samme repositorium som du bruker for kildekontroller for løsningen. Pipelinemalene, det vil si mappen Pipeline\Templates, kan eksistere i enten samme repositorium som løsningsforløpet for YAML eller i et eget repositorium eller prosjekt.

Opprette løsningsbygg- og distribusjonspipeliner

Løsningspipeliner brukes til å bygge og distribuere kildekontrollerte løsninger til miljøer i leieren. De angitte eksempelkanalene forutsetter at du bare bruker tre miljøer: validering, test og produksjon. Du kan imidlertid opprette så mange løsningsforløp du trenger, basert på organisasjonens miljøstrategi.

Eksempeldistribusjonspipelinene utløses av endringer i en gren (det vil si test og produksjon) eller som en del av en grenpolicy i Azure DevOps (det vil si validering). Finn ut mer om hvordan du angir grenpolicyer for validering av pull-forespørsler. Du kan også kjøre kanaler manuelt, uten en utløser.

Følg fremgangsmåten i denne delen for å opprette utrullingskanaler fra YAML for eksempelkanal. Tabellen nedenfor beskriver kanalkonfigurasjonen.

Viktig

Kanalnavnet må være nøyaktig som vist i tabellen nedenfor, med navnet på løsningen i stedet for MyNewSolution.

Filnavn for pipeline-YAML Navn på pipeline Aktivert grenpolicy Kreves
build-deploy-validation-MyNewSolution.yml deploy-validation-MyNewSolution Ja Ja
build-deploy-test-MyNewSolution.yml deploy-test-MyNewSolution Nei Ja
build-deploy-prod-MyNewSolution.yml deploy-prod-MyNewSolution Nei Nei (gå til neste del)

Obs!

Fremgangsmåten nedenfor oppretter build og distribuerer kanaler for validerings-, test- og produksjonsmiljøer. Det kan imidlertid hende du vil bygge og distribuere for validering og test, og deretter distribuere artefaktene fra testbyggingen til produksjon. Hvis det er tilfelle, følger du fremgangsmåten i denne delen bare for validerings- og testmiljøene. Hopp deretter til Opprett løsningsutrullingskanalen for å konfigurere utgivelseskanalen.

Opprett kanalfilen

  1. I Azure DevOps går du til repositoriet som inneholder pipelinemappen du registrerte, og velg Pipeliner-mappen.

  2. Åpne en av de tre eksempelutrullingskanalene og kopier YAML-en som skal brukes i den nye kanalen.

  3. Noter deg navnet på repositoriet for bruk i pipelinen.

  4. Gå til repositoriet som du vil bruke for kildekontrollen for løsningen.

  5. Opprett en gren basert på standardgrenen og gi den navnet til løsningen, for eksempel MyNewSolution.

    Denne grenen blir den neste versjonsgrenen (v-neste) for løsningen. Alt utviklingsarbeid må forgrenes fra denne grenen til en utviklerens personlige arbeidsområdegren og deretter flettes inn i den neste grenen for å gå videre til validering og testing. Når en versjon senere er klar, kan den neste grenen slås sammen til hoved- eller standardgrenen.

  6. Velg Ny på den øverste menyen, og velg deretter Mappe.

  7. Gi den nye mappen samme navn som løsningen.

  8. Gi den ny YAML-filen for kanalen et navn, for eksempel build-deploy-validation-SampleSolution.yml, build-deploy-test-SampleSolution.yml eller build-deploy-prod-SampleSolution.yml.

  9. Velg Opprett.

Oppdater og lagre filen

  1. Lim inn YAML-en du kopierte i trinn 2 i forrige del, i den nye kanalfilen.

  2. Endre følgende verdier i den nye YAML-en for kanal:

    • Endre Ressurser>Repositorium>Navn til navnet på respositoriet som inneholder kanalmalene.

      I dette eksemplet kalles repositoriet for coe-alm-akselerator-maler, og det finnes i samme prosjekt som MyNewSolution-repositoriet. Hvis malrepositoriet er i et annet Azure DevOps-prosjekt, kan du bruke formatet prosjektnavn/repositorienavn. Du kan også angi en gren der malene dine bor, ved hjelp av ref-parameteren om nødvendig.

    • Endre verdier som henviser til SampleSolutionName til det unike løsningsnavnet, for eksempel MyNewSolution.

  3. Velg Lagre for å ta i bruk endringene.

  4. I Azure DevOps går du til Pipeliner og velger deretter Opprett ny pipeline.

  5. Velg Azure Repos Git for koderepositoriet.

  6. Velg DevOps-repositoriet, som inneholder YAMLen for distribusjonsforløpet.

  7. På siden Konfigurer kanalen velger du Eksisterende YAML-fil for Azure-kanaler, peker på YAML-filen i repositoriet du opprettet tidligere, og deretter velger du Fortsett.

  8. Velg Lagre, velg (...) ved siden av Kjør kanal, og velg deretter Gi nytt navn/flytt.

  9. Endre kanalnavnet til deploy-validation-MyNewSolution, deploy-test-MyNewSolution eller deploy-prod-MyNewSolution, der MyNewSolution er navnet på løsningen.

  10. Velg Lagre.

  11. Hvis den nye kanalen ikke ble opprettet i standardgrenen for lageret: Velg Rediger på kanalen. Velg (...) øverst i høyre hjørne, og velg deretter Utløsere. Velg fanen YAML, og velg deretter Hent kilder. Endre Standardgren for manuelle og planlagte bygg, slik at de peker til løsningsgrenen. Finn ut mer om hvordan du konfigurerer pipelineutløsere.

  12. Gjenta de foregående trinnene for å opprette en distribusjonspipeline for hvert miljø som refererer til eksempeldistribusjonspipelinen YAML fra coe-alm-accelerator-templates repo (deploy-validation-SampleSolution.yml, deploy-test-SampleSolution.yml og deploy-prod-SampleSolution.yml).

  13. Velg Lagre og kø, og velg deretter Lagre.

Opprette løsningsdistribusjonspipeline (valgfritt)

Som nevnt tidligere oppretter trinnene i forrige del kanaler som bygger og distribuerer for validerings-, test- og produksjonsmiljøer. Du kan imidlertid opprette en egen løsningsutrullingskanal hvis du bare vil bygge og distribuere for validering og test, og deretter distribuere artefaktene fra testbyggingen til produksjon.

Følg fremgangsmåten i denne delen for å opprette en løsningsutrullingskanal fra YAML for eksempelkanal. Tabellen nedenfor beskriver kanalkonfigurasjonen.

Viktig

Kanalnavnet må være nøyaktig som vist i tabellen nedenfor, med navnet på løsningen i stedet for MyNewSolution.

Filnavn for pipeline-YAML Navn på pipeline Aktivert grenpolicy
deploy-prod-MyNewSolution.yml deploy-prod-MyNewSolution Nei

  1. I Azure DevOps går du til repositoriet som inneholder pipelinemappen du registrerte, og velg Pipeliner-mappen.

  2. Åpne eksempelutrullingskanal deploy-prod-pipelineartifact-SampleSolution.yml, og kopier YAML-en som skal brukes i den nye kanalen.

  3. Noter deg navnet på repositoriet for bruk i pipelinen.

  4. Gå til repositoriet som du vil bruke for kildekontrollen for løsningen.

  5. Velg Ny på den øverste menyen, og velg deretter Fil.

  6. Gi den nye YAML-filen for kanalen et navn, for eksempel deploy-prod-MyNewSolution.yml, der MyNewSolution er navnet på løsningen din.

  7. Velg Opprett.

  8. Lim inn YAML-en du kopierte i trinn 2, i den nye kanalfilen.

  9. Endre følgende verdier i den nye YAML-en for kanal:

    • Endre Utløser>Grener>Inkluder til grenene der endringene skal utløse en distribusjon til produksjon.

    • Endre Ressurser>Repositorium>Navn til navnet på respositoriet som inneholder kanalmalene.

      I dette eksemplet kalles repositoriet for coe-alm-akselerator-maler, og det finnes i samme prosjekt som MyNewSolution-repositoriet. Hvis malrepositoriet er i et annet Azure DevOps-prosjekt, kan du bruke formatet prosjektnavn/repositorienavn. Du kan også angi en gren der malene dine bor, ved hjelp av ref-parameteren om nødvendig.

    • Oppdater Ressurser>Kanaler>Kilde for å angi kompileringskontrollen som inneholder artefaktene som denne kanalen skal distribuere. I dette tilfellet skal du distribuere artefaktene fra testkanalen du opprettet tidligere, som bygde og distribuerte løsningen i testmiljøet.

    • Endre verdier som henviser til SampleSolutionName til det unike løsningsnavnet, for eksempel MyNewSolution.

  10. Gjenta trinn 11 til 20 i forrige del for deploy-validation-ALMAcceleratorSampleSolution og deploy-test-ALMAcceleratorSampleSolution for å opprette en kanal fra den nye produksjonskanalen YAML kalt deploy-prod-ALMAcceleratorSampleSolution.

Angi variabler for utrullingskanal

For hver utrullingskanal du konfigurerte tidligere, må du angi verdiene EnvironmentName og ServiceConnection basert på miljøet som kanalene distribueres til. Du kan også angi at EnableFlows-variabelen skal deaktivere Power Automate-flyter som en del av en distribusjon.

Opprette miljø- og tjenestetilkoblingsvariabler (obligatorisk)

Alle utrullingskanaler krever miljøvariabelen EnvironmentName og variabelen for tjenestetilkobling ServiceConnection.

  • EnvironmentName Angir Azure DevOps miljøet som distribueres for å aktivere sporing av distribusjonslogg og angi tillatelser og godkjenninger for distribusjon til bestemte miljøer. Sett denne verdien til Valider, Test eller Produksjon etter behov.

  • ServiceConnection Angir hvordan utrullingskanalen kobles til Power Platform. Tillatte verdier er navnene på tjenestetilkoblingene du opprettet tidligere.

  1. Velg Rediger for hvert distribusjonsforløp.

  2. Velg Variabler i definisjonen av utrullingskanal for å åpne redigeringsprogrammet for variabler.

  3. Velg (+) for å legge til en variabel. Skriv inn navnet på variabelen og riktig verdi.

Gjenta denne fremgangsmåten for å opprette variablene EnvironmentName og ServiceConnection.

Opprette EnableFlows-variabel (valgfri)

Du kan angi verdien til en kanalvariabel med navnet EnableFlows til Usann for å hoppe over trinnene som automatisk aktiverer Power Automate-flyter som en del av en distribusjon. Standardverdien for EnableFlows-variabelen er Sann.

Angi grenpolicyer for validering av henteforespørsel

Opprett en grenpolicy for å kjøre kanalen du opprettet tidligere da en hente-forespørsel ble opprettet.

  1. I Azure DevOps går du til Repositorier og velger deretter Grener-mappen.

  2. Finn grenen som du vil opprette henteforespørselspolicyen for. Velg (...) til høyre for grenen, og velg deretter Grenpolicyer.

  3. På siden Grenpolicyer går du til Bygg validering.

  4. Velg + for å legge til en ny grenpolicy.

  5. Velg kanalen du opprettet tidligere, fra listen for Buildkanal.

  6. Angi et banefilter hvis aktuelt for å sikrer at bare endringer i den angitte banen utløser kanalen for henteforespørselen.

  7. Sett Utløseren til Automatisk.

  8. Sett Policykrav til Kreves.

  9. Sett Byggutløp til Umiddelbart.

  10. Angi et visningsnavn for grenpolicyen, for eksempel Validering av PR-build.

  11. Velg Lagre.

Skjermbilde av valg av innstillinger for en valideringsbuildpolicy.

Angi tilgangstillatelser for ressurser for kanaler

Kanaler må ha tilgang til nødvendige ressurser, for eksempel lager, variabelgrupper og tjenestetilkoblinger, for å kunne kjøres. Du har tre alternativer for å gi tilgang.

Gi tilgang i løpet av første kjøring

Du kan gi tilgang til en nødvendig ressurs i første kjøring av kanalen.

  1. Utløs kanalen og åpne kanalkjøringen i Azure DevOps.
  2. Velg Vis i banneret for tillatelse kreves.
  3. Velg Tillat for hver nødvendige ressurs.

Gi eksplisitt tillatelse

Du kan gi eksplisitt tillatelse til en kanal for å få tilgang til nødvendige repositorier.

  1. I Azure DevOps åpner du Prosjektinnstillinger.
  2. Velg Repositorier og velg et repositorium.
  3. Velg Sikkerhet-fanen.
  4. Rull ned til Kanaltillatelser, og velg +.
  5. Velg pipelinen du vil gi tilgang til repositoriet.

Du kan gi eksplisitt tillatelse til en kanal for å få tilgang til nødvendige variabelgrupper.

  1. I Azure DevOps velger du Kanaler>Bibliotek og velg en variabelgruppe.
  2. Velg Pipelinetillatelser.
  3. Velg + og deretter kanalen du vil gi tilgang til variabelgruppen.

Du kan gi eksplisitt tillatelse til en kanal for å få tilgang til nødvendige tjenestetilkoblinger.

  1. I Azure DevOps åpner du Prosjektinnstillinger.
  2. Velg Tjenestetilkoblinger, og velg en deretter Opprett tjenestetilkobling.
  3. Velg Flere handlinger (...), og velg deretter Sikkerhet.
  4. Rull ned til Kanaltillatelser, og velg +.
  5. Velg kanalen du vil gi tilgang til tjenestetilkoblingen.

Gi alle kanaler tilgang

Du kan tillate alle kanaler, både de du har nå og eventuelle du oppretter i fremtiden, for å få tilgang til nødvendige repositorier.

  1. I Azure DevOps åpner du Prosjektinnstillinger.
  2. Velg Repositorier og velg et repositorium.
  3. Velg Sikkerhet-fanen.
  4. Rull ned til Pipelinetillatelser.
  5. Velg Flere handlinger (...), velg Åpne tilgang, og bekreft deretter når du blir bedt om det.

Du kan gi alle kanaler tilgang til nødvendige variabelgrupper.

  1. I Azure DevOps velger du Kanaler>Bibliotek og velg en variabelgruppe.
  2. Velg Pipelinetillatelser.
  3. Velg Flere handlinger (...), velg Åpne tilgang, og bekreft deretter når du blir bedt om det.

Du kan gi alle kanaler tilgang til nødvendige tjenestetilkoblinger.

  1. I Azure DevOps åpner du Prosjektinnstillinger.
  2. Velg Tjenestetilkoblinger, og velg en deretter Opprett tjenestetilkobling.
  3. Velg Flere handlinger (...), og velg deretter Sikkerhet.
  4. Velg en tjenestetilkobling, velg Flere handlinger (...) og velg deretter Sikkerhet.
  5. Rull ned til Pipelinetillatelser.
  6. Velg Flere handlinger (...), velg Åpne tilgang, og bekreft deretter når du blir bedt om det.

Angi jobbgodkjenningsområde

Jobbgodkjenningsområde kan angis for hele Azure DevOps-organisasjonen eller for et spesifikt prosjekt. Deaktiver innstillingen Begrens jobbgodkjenningsområdet til nåværende prosjekt for utgivelseskanaler hvis du velger et annet Azure DevOps-prosjekt for å installere malene.

Slik angir du jobbgodkjenningsområde på organisasjonsnivå for alle prosjekter

  1. I Azure DevOps velger du Organisasjonsinnstillinger > Kanaler > Innstillinger.
  2. Deaktiver innstillingen Begrens jobbgodkjenningsområdet til nåværende prosjekt for utgivelseskanaler.

Opprett en distribusjonskonfigurasjon (valgfritt)

Du må opprette flere konfigurasjoner i et målmiljø etter at en løsning er distribuert. Disse konfigurasjonene er bestemte for miljøet og inkluderer tilkoblingsreferanser, miljøvariabler og angivelse av tillatelser for Microsoft Entra-grupper og Dataverse-team i tillegg til deling av lerretsapper og oppdatering av eierskapet til løsningskomponenter, for eksempel Power Automate-flyter. Sammen med disse konfigurasjonene trenger ofte et målmiljø eller konfigurasjonsdata tilknyttet Dataverse-tabeller i løsningen i et målmiljø for å gi fullstendig administrasjon av applivssyklus.

Hvis løsningen krever de andre konfigurasjoner eller data, følger du distribusjonskonfigurasjonsveiledningen for å konfigurere kanalene basert på miljøene du distribuerer.

Importer løsningen og konfigurer appen

Importer ALM Accelerator-lerretsappen i Power Platform-miljøet, og konfigurer deretter den inkluderte egendefinerte koblingen for Azure DevOps.

Installere ALM Accelerator i Dataverse

  1. ALM Accelerator-løsningen avhenger av oppretterpakken. Installer Creator Kit nå.

  2. Last ned den nyeste administrerte løsningsfilen fra GitHub. Rull ned til Ressurser, og velg CenterofExcellenceALMAccelerator_<nyeste versjon>_managed.zip.

  3. Logg deg på Power Apps, og velg miljøet du vil bruke som vert for ALM Accelerator-appen.

  4. Velg Løsninger i venstre sidepanel.

  5. Velg Importer løsning>Bla gjennom, og bla deretter til plasseringen for den administrerte løsningen du lastet ned, og velg filen.

  6. Velg Neste, og velg deretter Neste på nytt.

  7. På siden Tilkoblinger velger eller oppretter du en ny tilkobling for å koble CDS DevOps-tilkoblingen til Dataverse.

    Når du oppretter en tilkobling for HTTP med Microsoft Entra, bruker Microsoft du Graph for begge parameterne.

  8. Velg Importer.

Konfigurere den egendefinerte DevOps-tilkoblingen

  1. Velg Data>Egendefinerte koblinger>CustomAzureDevOps.

  2. Velg Rediger. På siden Sikkerhet og velg Rediger, og angi følgende felter:

    Name Verdi
    Type godkjenning OAuth 2.0
    Identitetsleverandør Azure Active Directory
    Klient-ID Program-ID (klient) du kopierte da du opprettet appregistreringen
    Klientens hemmelighet Programhemmelighetsverdi (klient) du kopierte da du opprettet appregistreringen
    Leier-ID La være som standardverdi, felles
    URL-adresse til ressurs DevOps-program-ID (klient) du kopierte da du la til tillatelser i appregistreringen
    URL-adresse for omdirigering Autogenereres. Hvis du ser boksen for Oppdater til unik omdirigerings-URI" under Nettadresse for omadressering, merker du av i boksen.

  3. Velg Oppdater kobling.

Legg til Nettadresse for omadressering som URI for omdirigering

Den autogenererte Nettadresse for omadressering fra delen over må legges til som "URI for omdirigering" i appregistreringen.

  1. Gå tilbake til appregistreringen du opprettet.

  2. Velg Oversikt i venstre sidepanel.

  3. Velg Legg til en omdirigerings-URI.

  4. Velg + Legg til en plattform, og velg deretter Nett.

  5. Under tekstboksen URI-er for omdirigering limer du inn den autogenererte Nettadresse for omadressering som ble kopiert fra delen over.

  6. Velg Konfigurer.

Test den egendefinerte koblingen

  1. Åpne Test-menyen.

  2. Velg Ny tilkobling, og følg deretter ledeteksten for å opprette en tilkobling.

  3. I Power Apps velger du miljøet, og deretter velger du Dataverse>Egendefinerte koblinger>CustomAzureDevOps.

  4. Velg Rediger, gå til Test-siden, og finn GetOrganizations-operasjonen.

  5. Velg Testoperasjon.

  6. Bekreft at Svarstatusen som returneres, er 200, og at Svarteksten er en JSON-representasjon av Azure DevOps-organisasjonen.

    Skjermbilde av testsikkerhetsinnstillinger for en egendefinert Azure DevOps-kobling.

Angi at utviklere skal bruke ALM Accelerator-app

Les mer