Dela via

Konfigurera ALM Accelerator manuellt

  • Artikel

Du kan konfigurera komponenterna i ALM Accelerator for Power Platform antingen med den medföljande administrationsappen eller manuellt. I den här artikeln beskrivs hur du konfigurerar appen manuellt och är strukturerad i sju avsnitt:

Förutsättningar

Innan du installerar ALM Accelerator for Power Platform ser du till att du har uppfyllt följande krav.

  • ALM Accelerator måste installeras i en Power Platform-miljö med en Microsoft Dataverse-databas. Alla miljöer du använder ALM Accelerator för att distribuera lösningar till kräver också en Dataverse-databas.

    Kommentar

    ALM Accelerator är inte kompatibel med Dataverse for Teams. Både ALM Accelerator för -appen och de tillhörande pipelines antar att du använder den fullständiga versionen av Dataverse i alla miljöer.

    Vi rekommenderar att du installerar ALM Accelerator i samma miljö som andra CoE startpaketslösningar. Lär dig mer om hur du fastställer den bästa strategin för din organisation:

  • ALM Accelerator använder Azure DevOps för källkontroll och distributioner. Om du inte har någon Azure DevOps organisation kan du registrera dig gratis för upp till fem användare på Azure DevOps webbplatsen.

  • För att slutföra stegen i detta avsnitt behöver du följande användare och behörigheter i Azure Azure DevOps och Power Platform:

    • En licensierad Azure-användare med behörighet att skapa och visa Microsoft Entra grupper, skapa appregistreringar och ge administratörsmedgivande till appregistreringar i Microsoft Entra ID
    • En licensierad Azure DevOps-användare med behörighet att skapa och hantera pipelines, tjänstanslutningar, lagringsplatser och tillägg
    • En licensierad Power Platform-användare med behörighet att skapa programanvändare och bevilja administratörsbehörigheter

  • Följande anslutningar finnas tillgängliga för användning tillsammans i den miljö där ALM Accelerator-lösningen importeras:

  • Installera Creator Kit i den miljö där du installerar ALM Accelerator.

Grundläggande inställning

Följande steg är generella för funktionaliteten hos ALM Accelerator och är inte specifika för något projekt eller någon lösning.

Skapa en programregistrering i din Microsoft Entra miljö

Skapa en programregistrering för ALM Accelerator för att ge behörigheter till programmet och de tillhörande pipelines de behörigheter som krävs för att utföra åtgärder i Azure DevOps och Power Apps eller Dataverse. Du behöver bara göra detta en gång.

I stegen nedan visas hur du skapar en enskild programregistrering med behörighet för både Dataverse och Azure DevOps. Du kanske vill skapa separata appregistreringar för att fördela ansvaret. Du bör fundera på hur separata appregistreringar påverkar underhåll och säkerhet innan du bestämmer dig för en registreringsstrategi för appen.

Skapa en programregistrering

  1. Logga in på Azure-portal.

  2. Välj Microsoft Entra ID>App-registreringar.

  3. Välj + Ny registrering och ange sedan ett namn för registreringen, t.ex. ALMAcceleratorServicePrincipal.

  4. Lämna alla andra alternativ som standardvärden och välj Registrera.

Lägg till behörigheter till appregistreringen

  1. Välj API-behörigheter på den sidopanelen.

  2. Välj + Lägg till behörighet.

  3. Välj Dynamics CRM och välj Delegerade behörigheter och user_impersonation.

  4. Välj Lägg till behörigheter för att lägga till Dynamics CRM API-behörighet user_impersonation till appregistreringen.

  5. Välj + Lägg till behörighet igen.

  6. Välj fliken API:er som min organisation använder. Sök och välj PowerApps-Advisor och välj sedan Delegerade behörigheter och Analysis.All (administratörsmedgivande krävs inte).

    Denna tillstånd krävs för att köra statisk analys genom appkontroll.

  7. Välj Lägg till behörigheter för att lägga till PowerApps-Advisor API analys. Alla behörighet till appregistreringen.

  8. Välj + Lägg till behörighet igen.

  9. På fliken Microsoft API:er eller fliken API:er som min organisation använder Välj Azure DevOps och sedan Välj Delegerade behörigheter och user_impersonation.

    Denna behörighet krävs för att ansluta till Azure DevOps via den anpassade anslutningen i ALM Accelerator-appen.

  10. Om du lägger till Azure DevOps behörighet från fliken API:er som används av min organisation ska du kopiera program-ID:t (klient) för senare användning.

    Du använder det här värdet senare, och kallar det DevOps app-ID (klient), som skiljer sig från DevOps-program(klient)-ID du kopierade tidigare.

    Skärmbild av fönstret med API-behörigheter för förfrågan där API:erna används av tabb- och klient-ID:t för min organisation.

    Om du inte hittar Azure DevOps-behörigheterna på fliken API:er som min organisation använderföljer du stegen för att få DevOps-program-ID (klient) genom att följa stegen nedan.

    1. Öppna en privat webbläsarfönster och gå till https://dev.azure.com/<your devops organization>/_apis
    2. På inloggningssidan kopierar du värdet för parametern client_id i URL:en.

    Skärmbild på en Azure DevOps inloggningssida för en organisation med client_id parametern i URL:en.

  11. Välj Lägg till behörigheter för att lägga till Azure DevOps API-behörighet user_impersonation till appregistreringen.

  12. Välj Bevilja administratörsmedgivande för <din klientorganisation>.

Konfigurera klienthemligheten och omdirigerings-URI

  1. Välj i den vänstra sidopanelen Certifikat och hemligheter.

  2. Välj + Ny klienthemlighet.

  3. Välj ett utgångsdatum och välj sedan Lägg till.

  4. Kopiera klienthemligheten Värdet för senare användning. Det är den enda gången du kan kopiera värdet. Se till att du gör det innan du lämnar sidan.

  5. Välj Översikt på den sidopanelen.

  6. Kopiera App-ID (klient) och Katalog-ID (innehavare).

  7. Välj Konfigurera.

Ge Power App hanteringsbehörighet till din appregistrering

Bevilja Power App hanteringsbehörigheter till din appregistrering så att pipelines kan utföra de åtgärder de behöver i dina miljöer. För att kunna göra detta måste du köra följande PowerShell-cmdlet som en interaktiv användare med Power Apps administratörsbehörighet. Du behöver bara köra kommandot en gång när du har skapat din appregistrering.

Viktigt!

Följande PowerShell-cmdlet ger appregistrering utökade behörigheter som Power Platform admin. Organisationens säkerhetspolicyer kanske inte tillåter den här typen av behörigheter. Kontrollera att de är tillåtna innan du fortsätter. Om de inte är tillåtna fungerar vissa funktioner inte i ALM Accelerator-pipelines.

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>

Installera Azure DevOps tillägg

ALM Accelerator använder flera Azure DevOps-tillägg, bland annat några tredjepartstillägg som är tillgängliga på Azure DevOps Marketplace. Webbplatsen för varje tredjepartstillägg och en länk till deras källkod finns i följande instruktioner. Lär dig hur du utvärderar en utgivare av ett Marketplace-tillägg.

  1. Logga in på Azure DevOps.

  2. Välj Organisationsinställningar.

  3. Välj Allmänt>tillägg.

  4. Sök efter och installera följande tillägg:

Klona YAML-pipelines från GitHub till din Azure DevOps-instans

  1. Gå till https://aka.ms/coe-alm-accelerator-templates-latest-release och kopiera URL:en till den senaste versionen.

  2. Logga in på Azure DevOps.

  3. Skapa ett projekt eller välj ett befintligt projekt.

  4. Välj Lagringsplatser och välj sedan Importera lagringsplats i lagringsplatslistan.

  5. Klistra in den URL-adress du kopierade i steg 1 som klonad URL och välj sedan Importera.

  6. Bekräfta att standardgrenen för lagringsplatsen är huvud. Välj lagringsplatser och grenar och se til att huvud förgreningen är taggad som standard.

    I annat fall markerar du de tre stående prickarna (⋮) som motsvarar huvud gren och från menyn Fler alternativ välj Ange som standardgren.

    Kommentar

    Denna lagringsplats som du skapade kommer att vara där lösningspipelinemallarna och export/importpipelines kommer att köras. Senare, när du skapar pipelines för dina lösningar, kan du behöva hänvisa till det här specifika projektet/lagringsplatsen om du väljer att källkontrollera dina lösningar i en annan lagringsplats för källkontroll för dina lösningar.

Skapa pipelines för import, ta bort och exportera lösningar

Skapa import-, borttagnings- och exportpipelines baserat på YAML i Azure DevOps lagringsplatsen. Dessa pipelines körs när du använder appen för att skicka en lösning till Git, importera en lösning eller ta bort en lösning.

Kommentar

Om du förväntar dig att alla dina exporter utför samma åtgärder oavsett vilken lösning pipelinen körs för räcker det att skapa en enda exportpipeline enligt beskrivningen nedan. Du kan emellertid behöva olika exportåtgärder baserat på lösningen. I så fall kan du lägga till lösningsnamnet till export-solution-to-git pipeline export-solution-to-git-SampleSolution, för att få appen att exekvera dina specifika lösningspipelines när du utför åtgärderna i appen.

I följande tabell visas korrespondensen mellan YAML-filen på lagringsplats och den medföljande pipelinen.

YAML-fil Pipelinenamn
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å till Pipelines>Skapa en ny pipeline.

  2. Välj Azure lagringsplats Git för din kodlagringsplats och peka på Azure DevOps-lagringsplats som du skapade och seedade med pipelinemallarna i stegen ovan.

  3. På sidan Konfigurera din pipeline välj Befintlig Azure Pipelines YAML-fil och peka på /Pipelines/export-solution-to-git.yml, /Pipelines/import-unmanaged-to-dev-environment.yml eller /Pipelines/delete-unmanaged-solution-and-components.yml.

  4. Välj Fortsätt och välj sedan Spara.

  5. Välj menyn Fler (…) bredvid Kör pipeline och välj Byt namn/flytta.

  6. Ändra pipelinenamnet till export-solution-to-git, import-unmanaged-to-dev-environment eller delete-unmanaged-solution-and-components.

  7. Välj Spara.

Skapa variabler för exportpipeline (valfritt)

Du kan ange pipelinevariabler som kan anges på pipelinen export-solution-to-git för att kontrollera vilken information som bevaras i källkontroll. Om du vill tillämpa dessa inställningar globalt kan du ange följande variabler i pipelinen för exportlösning till pipelinen. För att använda dessa inställningar för specifika lösningar vid export, skapa en exportpipeline för lösningen enligt beskrivningen i anteckningen i föregående avsnitt och ange variabler på den pipelinen.

För att säkerställa att de aktuella värdena för miljövariabler aldrig är förpliktade till källkontroll under exportprocessen, skapa DoNotExportCurrentEnvironmentVariableValues variabel på din export-solution-to-git pipeline och ställ in dess värde till True.

Viktigt!

Den här pipelinevariabeln rekommenderas för att du ska kunna använda distributionskonfiguration funktionerna i ALM Accelerator.

För att säkerställa att de specifika standard miljövariablerna som anges under exportprocessen för en lösning, skapa VerifyDefaultEnvironmentVariableValues variabel på din export-solution-to-git pipeline och ställ in dess värde till True. Ställ in värdena för standardmiljövariabler i customDeploymentSettings.json enligt beskrivningen i distributionskonfigurationsguiden.

  1. I Azure DevOps, välj Pipelines>Bibliotek>Skapa en ny variabelgrupp.

  2. Ge nya variabelgruppen namnet alm-accelerator-variable-group precis som det anges här.

    Pipelines refererar till den specifika variabelgruppen så att den måste namnges exakt som den som visas. Om du vill använda en annan namnkonvention för variabelgruppen måste du ändra delar av pipelines så att de refererar till det namn du använder i stället.

  3. Lägg till följande variabler i variabelgruppen:

    Namn Beskrivning Värde
    AADHost Microsoft Entra auktoriseringsslutpunkt För offentliga moln använder du login.microsoftonline.com. För myndighetsmoln, använd lämplig auktoriserings-URL.
    ProcessCanvasApps Om arbetsyteappar ska packas upp under export eller inte under versioner Om falsk, ska arbetsyteappar inte packas upp under export eller inte under versioner. Funktionen för att packa upp och packa arbetsyteappar är i förhandsversion och rekommenderas inte för användning i produktionsmiljöer just nu. Däremot kan du inte visa arbetsytans källkod i källkontrollen om du inte anger variabeln som Sant.

  4. (Valfri) Om du använder arbetsytestudio testautomation i dina pipelines, lägg till följande variabler till variabelgruppen:

    Namn Värde
    TestAutomationLoginMethod CloudIdentity (på engelska)
    TestAutomationMakerPortalUrl URL:en från Power Apps-tillverkarportal, vanligtvis *https://make.powerapps.com*
    TestAutomationUsername Användarkontot som användes för att köra de automatiska testerna
    TestAutomationPassword Lösenord för användarkontot som användes för att köra de automatiska testerna

  5. (Valfritt) Som standard är de globala variablerna begränsade och åtkomsten för varje pipeline måste konfigureras. Det går att förenkla och tillåta åtkomst till alla pipelines. Under Variabelgrupp (Pipelines>Bibliotek>alm-accelerator-variable-group), välj Pipeline-behörigheter i översta menyn, välj (…) och välj Öppen åtkomst.

Ange behörigheter för projektbyggtjänst

Viktigt!

Azure DevOps innehåller ett antal konton för "Bygg-tjänst" det kan vara förvirrande när du följer stegen i detta avsnitt. Var uppmärksam på de namn och format som anges i steg 3 och 5. Du kan behöva söka efter kontot om det inte visas i den första listan.

  1. I Azure DevOps välj Projektinställningar.

  2. Välj Lagringsplats>Säkerhet.

  3. Under Användare, sök efter och välj Byggtjänst för projektsamling (Ditt organisationsnamn).

    Kommentar

    Du kanske inte ser Ditt organisationsnamn efter att användaren har Byggtjänst för projektsamling. Det kan bara vara en unik identifierare. Använd i så fall sökfunktionen för att hitta användaren och välj den sedan.

  4. Ange följande behörigheter för byggtjänstanvändaren:

    Behörighet Värde
    Deltaga Tillåt
    Bidra till att hämta förfrågningar Tillåt
    Skapa förgrening Tillåt
    Redigera policyer Tillåt

  5. Under Användare, sök efter och välj Ditt projektnamn Byggtjänst (Ditt organisationsnamn).

  6. Ange samma värden som i steg 4.

  7. Välj Pipelines, markera de tre prickarna (…) längst upp till höger och välj sedan Hantera säkerhet.

  8. Ange följande behörigheter för användaren Ditt projektnamn Byggtjänst (Ditt organisationsnamn):

    Behörighet Värde
    Redigera bygg-pipeline Tillåt
    Redigera byggkvaliteten Tillåt
    Hantera byggkö Tillåt
    Åsidosätta validering av incheckning efter version Tillåt
    Uppdatera versionsinformation Tillåt
    Visa bygg-pipeline Tillåt
    Visa versioner Tillåt

  9. Välj Projektinställningar>Agent-pooler och sedan Säkerhet och välj Lägg till.

  10. Sök efter och välj Ditt projektnamn Byggtjänst (Ditt organisationsnamn).

  11. Ange att rollen ska Läsare.

  12. Markera Lägga till.

  13. (Valfritt) Som standard är pipelinebehörigheterna för varje lagringsplats begränsade och du måste konfigurera dem individuellt. Det går att förenkla och tillåta åtkomst till alla pipelines. Under Projektinställningar>lagringsplats, välj varje lagringsplats i tur och ordning. Välj Säkerhet i den översta menyn. Hitta blocket Pipeline-behörigheter, välj (…) och sedan Öppen åtkomst.

Konfigurera utvecklingsprojekt

I följande avsnitt guidar du dig genom de konfigurationssteg som krävs för alla utvecklingsprojekt som du kommer att stödja. I detta sammanhang omfattar ett utvecklingsprojekt infrastrukturen och konfigurationen som stöder hälsosam hantering av applikationslivscykeln (ALM), inklusive konfigurationen av Dataverse miljö som stödjer ALM-process.

Skapa tjänstanslutningar för Azure DevOps att komma åt Power Platform

Varje Dataverse miljö, till exempel utveckling, validering, test och produktion, måste ha en Power Platform tjänstanslutning i Azure DevOps. Utför följande steg för varje miljö.

Kommentar

Användare av ALM Accelerator-app ser endast miljöer som de har en användare eller administratör för på tjänstanslutningen i Azure DevOps. Om man använder personliga utvecklingsmiljöer bör alla utvecklare ha en användar- eller administratörsroll för tjänsteanslutningen för sin egen utvecklingsmiljö. Anslutningarna till validerings-, test- och produktionsmiljön behöver bara behörigheter för pipelines till exempel byggtjänsten.

  1. Logga in på Azure DevOps och välj sedan ditt projekt.

  2. Välj Tjänstanslutningar>Projektinställningar och välj sedan Skapa tjänstanslutning.

  3. Sök efter och välj Power Platform tjänstanslutningstyp.

  4. Välj Nästa.

  5. För Server-URL, ange till exempel din miljö-URL, t.ex. https://myorg.crm.dynamics.com/.

    Viktigt!

    Du måste ta med den efterföljande vidarebefordran (/) i URL; efter .com i detta exempel.

  6. För tjänstanslutningsnamnet, ange samma URL som du angavs i steg 4, inklusive utbildning snedstrecket (/).

  7. Ange klientorganisations-ID, App-ID (klient) och klienthemlighet du kopierade från Microsoft Entra när du skapade appregistreringen.

  8. Välj Bevilja åtkomstbehörigheter till alla pipelines.

  9. Välj Spara.

Tjänstanslutningarna måste ge användarbehörigheter till alla användare i alla miljöer som användare behöver för att kunna komma åt från appen (till exempel skaparmiljöer).

  1. I listan Tjänstanslutningar, välj tjänstanslutningen som ska delas med användare.

  2. Markera Mer (…) längst upp till höger och välj Säkerhet.

  3. I listan Grupp eller användare markera den grupp eller användare du vill ge användarbehörigheter till.

  4. Välj Användare, välj Roll och välj sedan Lägg till.

Upprepa stegen i detta avsnitt för de olika miljöerna, t.ex. utveckling, validering, test- och produktionsmiljöer.

Ange behörigheter för projektbyggtjänst för att använda tjänstanslutningarna

  1. I Azure DevOps, välj Projektinställningar>Tjänsteanslutningar.

  2. Markera (…) längst upp till höger och välj Säkerhet och sedan Lägg till.

  3. Sök efter och välj Ditt projektnamn Byggtjänst (Ditt organisationsnamn).

  4. Välj Roll, välj Administratör och välj sedan Lägg till.

Skapa en programanvändare i din Dataverse miljö

Skapa en programanvändare i dina miljöer så att pipelines kan anslutas till Dataverse. Gör detta i alla miljöer som du tänker använda ALM Accelerator för att distribuera till.

  1. Logga in på Power Platform administratörscenter.

  2. Välj utvecklingsmiljö och välj Inställningar.

  3. Välj Användare + behörigheter>Appanvändare.

  4. Välj + Ny appanvändare.

  5. Välj + Lägg till en app, välj appregistreringen du skapade tidigare och välj sedan Lägg till.

  6. Välj verksamhetsenhet.

  7. Välj pennikonen till höger för Säkerhetsroller och välj sedan säkerhetsroller för appanvändaren.

    Vi rekommenderar att du ger appanvändare systemadministratör säkerhetsrollprivilegier för att kunna utföra de nödvändiga funktionerna i var och en av miljöerna.

  8. Välj Skapa.

Upprepa dessa steg i din validerings-, test- och produktionsmiljöerna.

Konfigurera lösning

När du skapar en lösning i Dataverse måste du skapa pipelines specifikt för den lösningen. Följande exempelpipelines ingår i Pipelines i lagringsplatsen för coe-alm-templates:

Exempelpipelines ger organisationer flexibilitet att lagra sina pipelinemallar i ett separat projekt eller spara från den specifika lösningspipelinen YAML. Följ anvisningarna nedan för att konfigurera lösningspipelinen. Upprepa dessa steg för varje lösning som du använder ALM Accelerator för källkontroll.

Viktigt!

YAML för lösningspipelinen kommer alltid att lagras i samma lagringsplats som du kommer att styra lösningen från källan till. Däremot pipelinemallarna, det vill säga mappen Pipeline\mallar, kan finnas i antingen samma lagringsplats som din lösningspipeline YAML eller i en separat lagringsplats och/eller projekt.

Skapa pipelines för lösningsversion och distribution

Lösningspipelines används för att skapa och distribuera dina källkontrollerade lösningar i miljöer i klientorganisationen. De medföljande exempelpipelinen förutsätter endast tre miljöer: validering, test och produktion. Du kan skapa så många lösningspipelines som behövs utifrån organisationens miljöstrategi.

Exempel på distributionspipelinen utlöser ändringar i en förgrening (d.v.s. test och produktion) eller som en del av en förgreningspolicy i Azure DevOps (d.v.s. validering). Läs mer om hur du ställer in förgreningsprinciper för validering av pull-begäranden. Du kan också köra pipelines manuellt utan en utlösare.

Följ stegen i det här avsnittet för att skapa distributionspipelines från exempelpipeline YAML. I följande tabell beskrivs pipelinekonfiguration.

Viktigt!

Pipelinenamnet måste vara exakt som det visas i följande tabell, med namnet på lösningen i stället för MyNewSolution.

Pipeline YAML-filnamn Pipelinenamn Grenpolicy aktiverad Obligatoriskt
build-deploy-validation-MyNewSolution.yml deploy-validation-MyNewSolution Ja Ja
build-deploy-test-MyNewSolution.yml deploy-test-MyNewSolution Nej Ja
build-deploy-prod-MyNewSolution.yml deploy-prod-MyNewSolution Nej Nej (Gå till föregående avsnitt)

Kommentar

Följande steg skapar version och distribuera pipelines för validerings-, test- och produktionsmiljöer. Du kanske vill skapa och distribuera för validering och test och sedan distribuera testerna från testbygget till produktion. Om så är fallet följer du instruktionerna i det här avsnittet endast för validerings- och testmiljöerna. Gå sedan till Skapa pipeline för lösningsdistribution för att konfigurera din versionspipeline.

Skapa en pipelinefil

  1. I Azure DevOps, gå till lagringsplats som innehåller pipelines mapp du har bekräftat och välj mappen Pipelines.

  2. Öppna en av tre exempel distributionspipelinen och kopiera YAML för att använda i din nya pipeline.

  3. Notera namnet på lagringsplats som ska användas i din pipeline.

  4. Gå till den lagringsdatabas där du vill källkontrollera lösningen.

  5. Skapa en gren utifrån standardförgreningen och ange namnet för lösningen. till exempel MyNewSolution.

    Den här förgreningen blir din nästa version (v-next)-förgrening för lösningen. Allt utvecklingsarbete bör förgrenad från den här förgreningen till en personlig arbetsgren för utvecklare och sedan sammanfogas till v-next-förgreningen för att kunna fortsätta validera och testa. Senare, när en version är klar, kan v-next-förgreningen sammanfogas till huvudgrenen eller standardgrenen.

  6. Välj Ny på menyn och välj sedan Mapp.

  7. Ge den nya mappen samma namn som lösningen.

  8. Ge ny pipeline YAML-filen ett namn t.ex. build-deploy-validation-SampleSolution.yml, build-deploy-test-SampleSolution.yml eller build-deploy-prod-SampleSolution.yml.

  9. Välj Skapa.

Uppdatera och spara filen

  1. Klistra in den YAML du kopierade i steg 2 i föregående avsnitt i den nya pipelinefilen.

  2. Ändra följande värden i den nya pipelinen YAML:

    • Ändra Resurs>Lagringsplats>Namn till lagringsplatsnamnet som innehåller dina pipelinemallar.

      I detta exempel kallas lagringsplatsen coe-alm-accelerator-templates och finns i samma projekt som vår lagringsplats MyNewSolution. Om din lagringsplats för mallar finns i ett annat Azure DevOps-projekt kan du använda formatet ProjectName/RepoName. Du kan även ange en gren där mallarna finns med parametern ref om det behövs.

    • Ändra ett värde som refererar SampleSolutionName till lösningens unika namn ( detta exempel MyNewSolution)..

  3. Välj Bekräfta för att spara dina ändringar.

  4. I Azure DevOps, gå till Pipelines och välj sedan Skapa en ny pipeline.

  5. Välj Azure lagringsplats Git för din koddatabas.

  6. Välj DevOps lagringsplats, som innehåller distributionspipeline YAML.

  7. På sidan Konfigurera din pipeline, välj Befintlig Azure Pipelines YAML-fil, peka på YAML-filen i din lagringsplats som du skapade tidigare och välj sedan Fortsätt.

  8. Välj Spara, välj (…) bredvid Kör pipeline och välj Byt namn/flytta.

  9. Ändra pipelinenamnet så att deploy-validation-MyNewSolution, deploy-test-MyNewSolution eller deploy-prod-MyNewSolution där MyNewSolution är namnet på din lösning.

  10. Välj Spara.

  11. Om den nya pipelinen inte skapas i databasens standardgren: Välj Redigera på pipelinen. Markera (…) längst upp till höger och välj utlösare. Välj fliken YAML och välj sedan Hämta källor. Ändra standardgren för manuella och schemalagda versioner så att den pekar till lösningsförgreningen. Läs mer om hur du konfigurerar pipelineutlösare.

  12. Upprepa stegen ovan för att skapa en distributionspipeline för var och en av dina miljöer med hänvisning till exempel implementeringspipelinen YAML från coe-alm-accelerator-templates lagringsplatsen (deploy-validation-SampleSolution.yml, deploy-test-SampleSolution.yml och deploy-prod-SampleSolution.yml).

  13. Välj Spara och Kö och välj sedan Spara .

Skapa pipeline för lösningsdistribution (valfritt)

Som vi nämnt tidigare skapar stegen i föregående avsnitt pipelines som bygger och distribuerar för validerings-, test- och produktionsmiljöer. Du kan emellertid skapa en separat distributionspipeline för lösning om du bara vill bygga och distribuera för validering och test och sedan distribuera artefakterna från testbygget till produktion.tion.

Följ stegen i det här avsnittet för att skapa distributionspipeline för lösning från exempelpipeline YAML. I följande tabell beskrivs pipelinekonfiguration.

Viktigt!

Pipelinenamnet måste vara exakt som det visas i följande tabell, med namnet på lösningen i stället för MyNewSolution.

Pipeline YAML-filnamn Pipelinenamn Grenpolicy aktiverad
deploy-prod-MyNewSolution.yml deploy-prod-MyNewSolution Nej

  1. I Azure DevOps, gå till lagringsplats som innehåller pipelines mapp du har bekräftat och välj mappen Pipelines.

  2. Öppna exempel distributionspipelinen deploy-prod-pipelineartifact-SampleSolution.yml och kopiera YAML för att använda i din nya pipeline.

  3. Notera namnet på lagringsplats som ska användas i din pipeline.

  4. Gå till den lagringsdatabas där du vill källkontrollera lösningen.

  5. Välj Ny på menyn och välj sedan Arkiv.

  6. Ge den nya pipeline YAML-filen ett namn till exempel, deploy-prod-MyNewSolution.yml, där MyNewSolution är namnet på lösningen.

  7. Välj Skapa.

  8. Klistra in den YAML du kopierade i steg 2 i den nya pipelinefilen.

  9. Ändra följande värden i den nya pipelinen YAML:

    • Ändra Utlösare>Grenar>Inkludera till de förgreningar för vilka ändringar skulle utlösa en distribution till produktion.

    • Ändra Resurs>Lagringsplats>Namn till lagringsplatsnamnet som innehåller dina pipelinemallar.

      I detta exempel kallas lagringsplatsen coe-alm-accelerator-templates och finns i samma projekt som vår lagringsplats MyNewSolution. Om din lagringsplats för mallar finns i ett annat Azure DevOps-projekt kan du använda formatet ProjectName/RepoName. Du kan även ange en gren där mallarna finns med parametern ref om det behövs.

    • Uppdatera resurser>Pipelines>källa för att ange byggpipeline som innehåller artefakterna som ska distribueras av denna pipeline. I det här fallet ska vi distribuera lösningen från testpipelinen som skapats tidigare, som har skapat och distribuerat lösningen i testmiljön.

    • Ändra ett värde som refererar SampleSolutionName till lösningens unika namn ( detta exempel MyNewSolution)..

  10. Upprepa samma steg 11-20 som utförts för deploy-validation-ALMAcceleratorSampleSolution och deploy-test-ALMAcceleratorSampleSolution för att skapa en pipeline från den nya produktionspipeline som YAML kallas deploy-prod-ALMAcceleratorSampleSolution.

Ställa in distributionspipelinevariabler

För varje distributionspipeline som du konfigurerat tidigare måste du ställa in värdena för variablerna EnvironmentName och ServiceConnection baserat på den miljö som pipelinen distribuerar till. Du kan även ange att variabeln EnableFlows ska stänga av Power Automate flöden som en del av en distribution.

Skapa miljö- och serviceanslutning (obligatoriskt)

För varje distributionspipeline krävs miljövariabeln EnvironmentName och variabeln för tjänstanslutning ServiceConnection.

  • EnvironmentName Anger den Azure DevOps miljö som distribueras för att aktivera spårning av distributionshistorik och ange behörigheter och godkännanden för distribution till specifika miljöer. Ange det här värdet till Verifiera, Testa eller Produktion, efter behov.

  • ServiceConnection Anger hur distributionskanalen ansluter till Power Platform. Tillåtna värden är namnen på de tjänstanslutningar du skapade tidigare.

  1. Välj Redigera på alla distributionspipelines.

  2. Välj Variabler i definitionen för distributionspipeline för att öppna redigerare för variabler.

  3. Välj (+) för att lägga till en variabel. Ange namnet på variabeln och lämpligt värde.

Upprepa dessa steg för att skapa variablerna EnvironmentName och ServiceConnection.

Skapa EnableFlows-variabel (valfritt)

Du kan ange värdet för en pipelinevariabel med namnet EnableFlows till Falskt om du vill hoppa över stegen som automatiskt aktiverar Power Automate-flöden som en del av en distribution. Standardvärdet för variabeln EnableFlows är sant.

Ange förgreningspolicyer för validering av pull-begäran

Skapa en förgreningspolicy för att köra pipelinen du skapade tidigare när en pull-begäran skapades.

  1. I Azure DevOps, gå till Lagringsplatser och välj mappen Grenar.

  2. Sök grenen som du vill skapa pull-begärans policy för. Välj (...) till höger om grenen och välj sedan förgreningspolicyer.

  3. På sidan Grenpolicyer gå till Versionsvalidering.

  4. Välj + för att lägga till en ny förgreningspolicy.

  5. Välj den pipeline du skapade i Bygg pipeline.

  6. Ange ett sökvägsfilter om tillämpligt för att säkerställa att endast ändringar i den angivna sökvägen utlöser pipelinen för pull-begäran.

  7. Ställ in utlösaren på Automatisk.

  8. Ange Policykrav till Obligatoriskt.

  9. Ange förfallodagen för versionen till Omedelbart.

  10. Ange ett visningsnamn för förgreningspolicyn, till exempel PR-byggvalidering.

  11. Välj Spara.

Bild på hur du väljer inställningar för en valideringsbyggprincip.

Ange resursåtkomstbehörigheter för pipelines

Pipelines behöver åtkomst till nödvändiga resurser, till exempel databaser, variabelgrupper och tjänstanslutningar för att köras. Om du vill tillåta åtkomst har du tre alternativ.

Bevilja åtkomst under första körningen

Du kan tillåta åtkomst till en obligatorisk resurs under pipelinens första körning.

  1. Utlös pipelinen och öppna pipeline-körning i Azure DevOps.
  2. Välj Visa i banderollen "behörigheter som krävs".
  3. Välj Tillåt för varje obligatorisk resurs.

Ge explicit behörighet

Du kan ge en pipeline uttrycklig behörighet att komma åt nödvändiga lagringsplatser.

  1. I Azure DevOps, öppna Projektinställningar.
  2. Välj lagringsplatser och välj lagringsplats.
  3. Välj fliken Säkerhet.
  4. Bläddra ned till pipelinebehörigheter och välj +.
  5. Markera pipeline du vill ge åtkomst till lagringsplatsen.

Du kan ge en pipeline uttrycklig behörighet att komma åt nödvändiga variabelgrupper.

  1. I Azure DevOps, välj Pipelines>Bibliotek och välj sedan en variabelgrupp.
  2. Välj Pipelinebehörigheter.
  3. Markera + och välj sedan den pipeline som du vill ge åtkomst till variabelgruppen.

Du kan ge en pipeline uttrycklig behörighet att komma åt nödvändiga tjänstanslutningar.

  1. I Azure DevOps, öppna Projektinställningar.
  2. Välj Tjänstanslutningar och välj tjänstanslutning.
  3. Välj Fler åtgärder (...) och välj sedan Säkerhet.
  4. Bläddra ned till pipelinebehörigheter och välj +.
  5. Välj den pipeline som du vill ge åtkomst till tjänsteanslutningen.

Ge åtkomst till alla pipelines

Du kan tillåta att alla pipelines, både de du har nu och de du skapar i framtiden, har åtkomst till nödvändiga databaser.

  1. I Azure DevOps, öppna Projektinställningar.
  2. Välj lagringsplatser och välj lagringsplats.
  3. Välj fliken Säkerhet.
  4. Bläddra nedåt till Pipeline-behörigheter.
  5. Välj Fler åtgärder (...), välj Öppna åtkomst och bekräfta sedan när du får frågan.

Du kan tillåta att alla pipelines har åtkomst till obligatoriska variabelgrupper.

  1. I Azure DevOps, välj Pipelines>Bibliotek och välj sedan en variabelgrupp.
  2. Välj Pipelinebehörigheter.
  3. Välj Fler åtgärder (...), välj Öppna åtkomst och bekräfta sedan när du får frågan.

Du kan tillåta att alla pipelines har åtkomst till obligatoriska tjänstanslutningar.

  1. I Azure DevOps, öppna Projektinställningar.
  2. Välj Tjänstanslutningar och välj tjänstanslutning.
  3. Välj Fler åtgärder (...) och välj sedan Säkerhet.
  4. Markera en tjänstanslutning, välj Fler åtgärder (…) och välj Säkerhet.
  5. Bläddra nedåt till Pipeline-behörigheter.
  6. Välj Fler åtgärder (...), välj Öppna åtkomst och bekräfta sedan när du får frågan.

Ställ in omfattningen av jobbehörighet

Omfattningen av jobbehörighet kan ställas in för hela Azure DevOps-organisationen eller för ett specifikt projekt. Inaktivera inställningen Begränsa omfattningen av jobbehörighet till aktuellt projekt för utgivningspipelines om du väljer ett annat Azure DevOps-projekt för att installera mallarna.

Att ställa in omfattningen av jobbehörighet på organisationsnivå för alla projekt

  1. I Azure DevOps väljer du Organisationsinställningar > Pipelines > Inställningar.
  2. Inaktivera inställningen Begränsa omfattningen av jobbehörighet till aktuellt projekt för utgivningspipelines.

Skapa distributionskonfigurationen (valfritt)

Du måste skapa flera konfigurationer som måste göras i en målmiljö när en lösning har distribuerats. Dessa konfigurationer är specifika för miljön och inkluderar anslutningsreferenser, miljövariabler, ställa in behörigheter för Microsoft Entra-grupper och Dataverse-team, samt dela canvas-program och uppdatera ägandet av lösningskomponenter som t.ex Power Automate-flöden. Tillsammans med dessa konfigurationer behöver en målmiljö ofta exempel- eller konfigurationsdata som är kopplade till Dataverse-tabeller i lösningen krävs i en målmiljö för att ge en fullständig ALM-upplevelse.

Om lösningen kräver dessa andra konfigurationer eller data följer du distributionskonfigurationsguiden för att konfigurera dina pipelines baserat på de miljöer som du distribuerar i.

Importera lösningen och konfigurera programmet

Importera arbetsyteappen ALM Accelerator till Power Platform-miljön och konfigurera den medföljande anpassade anslutningsprogram för Azure DevOps.

Installera ALM Accelerator i Dataverse

  1. Lösningen ALM Accelerator beror på skaparpaketet. Installera Creator Kit nu.

  2. Hämta den senaste hanterade lösningsfilen från GitHub. Bläddra ned till Tillgångar och välj CenterofExcellenceALMAccelerator_<latest version>_managed.zip.

  3. Logga in på Power Apps och välj den miljö som du vill använda som värd för ALM Accelerator app.

  4. Välj Lösningar på den sidopanelen.

  5. Välj Importera lösning>Bläddra och bläddra sedan till platsen för hanterad lösning där du hämtade och valde filen.

  6. Välj Nästa och Nästa igen.

  7. På sidan Anslutningar väljer eller skapar du en ny anslutning som ska anslutas till CDS DevOps-anslutningen till Dataverse.

    När du skapar en anslutning för HTTP med Microsoft Entra använder Microsoft du Graph för båda parametrarna.

  8. Välj Importera.

Konfigurera den anpassade DevOps-anslutningen

  1. Välj Data>Anpassade anslutningsprogram>CustomAzureDevOps.

  2. Välj Redigera. På sidan Säkerhet välj Registrera och ange sedan följande fält:

    Name Värde
    Typ av autentisering OAuth 2.0
    Identitets leverantör Azure Active Directory
    Klient-ID Det program-ID (klient-ID) du kopierade när du skapade appregistreringen
    Klient hemlighet Den Appens (klient) hemlighetsvärde du kopierade när du skapade appregistreringen
    Klient-ID Lämna som standardvärde vanliga
    URL för resurs Den DevOps-program-ID (klient) som du kopierade när du lägger till behörigheter till din appregistrering
    URL för omdirigering Generera automatiskt. Om du lägger märke till kryssrutan Uppdatera till unik omdirigerad URL under "omdirigerings-URL" markerar du kryssrutan.

  3. Välj Uppdatera anslutningsprogram.

Lägg till "omdirigerings-URL" som "omdirigerings-URI"

Den autogenererade "omdirigerings-URL"-adressen från avsnittet ovan måste läggas till som "omdirigerings-URI" till appregistreringen.

  1. Gå tillbaka till appregistreringen som du skapade.

  2. Välj Översikt på den sidopanelen.

  3. Välj Lägg till en omdirigerings-URI.

  4. Välj + Lägg till plattform och välj sedan Webb.

  5. Under textrutan omdirigerings-URI, klistra in den automatiskt genererade "omdirigerings-URL" som kopierats från avsnittet ovan.

  6. Välj Konfigurera.

Testa den anpassade anslutningsappen

  1. Öppna Test-menyn.

  2. Välj Ny anslutning och följ uppmaningarna om du vill skapa en anslutning.

  3. I Power Apps, välj din miljö i och välj sedan Dataverse>Anpassade anslutningsprogram>CustomAzureDevOps.

  4. Välj Redigera, gå till sidan Testa och leta upp åtgärden GetOrganizations.

  5. Välj Teståtgärd.

  6. Bekräfta att Svarsstatus som returneras är 200 och att Svarstext är en JSON-representation av din Azure DevOps-organisation.

    Skärmbild av testsäkerhetsinställningarna för ett anpassat Azure DevOps-anslutningsprogram.

Konfigurera skapare att använda ALM Accelerator-appen

Läs mer