Konfigurera ALM-acceleratorn manuellt (inaktuell)

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
• Grundläggande konfiguration
• Konfigurera utvecklingsprojekt
• Konfigurera lösning
• Importera lösningen och konfigurera appen
• Konfigurera tillverkare till att använda ALM Accelerator-appen

Förutsättningar

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

• ALM-acceleratorn måste installeras i en Power Platform-miljö som har 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.

  Anteckning

  ALM Accelerator är inte kompatibel med Dataverse for Teams. Både ALM Accelerator-appen och de tillhörande pipelines förutsätter att du använder den fullständiga versionen av Dataverse används 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:

  • Etablera en miljöstrategi för Microsoft Power Platform
  • Miljöstrategi för ALM

• ALM Accelerator använder Azure DevOps för källkontroll och distributioner. Om du inte har en Azure DevOps organisation registrerar du dig kostnadsfritt för upp till fem användare på webbplatsen Azure DevOps.

• För att slutföra stegen i det här avsnittet 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 appanvändare och bevilja dem administratörsbehörigheter

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

  • Dataverse (äldre)
  • HTTP
  • Power Apps för skapare
  • HTTP med Microsoft Entra ID (med slutpunktsåtkomst till https://graph.microsoft.com)
  • ALM Accelerator anpassad DevOps (det här anslutningsprogrammet skapas som en del av accelerator lösningsimporten)
  • Office 365 användare
  • HTTP

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

Grundläggande konfiguration

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 appregistrering i din Microsoft Entra miljö

Skapa en appregistrering för ALM Accelerator för att bevilja appen och associerade pipelines 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.

Följande steg visar hur du skapar en enskild appregistrering med behörigheter 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-portalen.

2. Välj Microsoft Entra ID>App registrations.

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 en behörighet.

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

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

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

6. Välj fliken API:er som min organisation använder. Sök efter 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 behörigheten PowerApps-Advisor API Analysis.All i appregistreringen.

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

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

   Den här behörigheten krävs för att ansluta till Azure DevOps via den anpassade anslutningsappen i ALM Accelerator-appen.

10. Om du har lagt till Azure DevOps behörigheten från fliken APIs som min organisation använder kopierar du Application(klient)-ID för användning senare i den här proceduren.

    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.

    

    Om du inte hittar Azure DevOps behörighet på fliken APIs som min organisation använder följer du dessa steg för att hämta DevOps Application (klient)-ID:

    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.

    

11. Välj Lägg till behörigheter för att lägga till Azure DevOps API-user_impersonation behörighet 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 & 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. Det gör du genom att köra följande PowerShell-cmdlet som en interaktiv användare som har Power Apps administrativa behörigheter. Du behöver bara köra kommandot en gång när du har skapat din appregistrering.

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, inklusive vissa tillägg från tredje part 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 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:

   • Power Platform Build Tools (krävs): Det här tillägget innehåller Microsoft-bygguppgifter för Power Platform. (https://marketplace.visualstudio.com/items?itemName=microsoft-IsvExpTools.PowerPlatform-BuildTools)

   • Ersätt token (obligatoriskt): Pipelines använder detta tillägg för att ersätta token i konfigurationsfiler för att kunna lagra säkra värden i privata variabler konfigurerade för en pipeline. (https://marketplace.visualstudio.com/items?itemName=qetza.replacetokens | https://github.com/qetza/vsts-replacetokens-task)

   • Fliken SARIF SAST-inläsningar (valfritt): Använd det här tillägget för att visualisera SARIF-filerna som lösningskontrollen genererar under ett bygge. (SARIF SAST Söker igenom fliken – Visual Studio Marketplace)

     

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 Repos 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 Repos och Branches och kontrollera att grenen main ä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.

   Anteckning

   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-lagringsplats. 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.

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

1. I Azure DevOps går du till Pipelines>Skapa en ny pipeline.

2. Välj Azure Repos Git för din kodlagringsplats och peka sedan på den Azure DevOps lagringsplats som du skapade och hämtade med pipelinemallarna i de tidigare stegen.

3. På sidan Konfigurera din pipeline väljer du Existing Azure Pipelines YAML-fil och pekar 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.

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äljer du Pipelines>Library>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	Endpoint för Microsoft Entra-auktorisering	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
   TestAutomationMakerPortalUrl	URL:en från Power Apps maker-portalen, 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äljer du Pipeline-behörigheter på den översta menyn, väljer (…) och väljer sedan Öppen åtkomst.

Ange behörigheter för projektbyggtjänst

1. I Azure DevOps väljer du inställningar för Projekt.

2. Välj Lagringsplats>Säkerhet.

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

   Anteckning

   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>Agentpooler, välj Säkerhet och välj sedan Lägg till.

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

11. Ange att rollen ska Läsare.

12. Välj Lägg till.

13. (Valfritt) Som standard är pipelinebehörigheterna för varje databas begränsade och måste konfigureras individuellt. Det går att förenkla och tillåta åtkomst till alla pipelines. Under Projektinställningar>Lagringsplatser väljer du 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 felfri hantering av programmets livscykel (ALM), inklusive konfigurationen av Dataverse-miljön som stödjer ALM-processen.

Skapa tjänstanslutningar för Azure DevOps för åtkomst till Power Platform

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

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

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

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

4. Klicka på 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 Tenant-ID, Application (klient)-ID 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äljer du Projektinställningar>Tjänstanslutningar.

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 appanvä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 administrationscenter.

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:

• https://github.com/microsoft/coe-alm-accelerator-templates/blob/main/Pipelines/build-deploy-validation-SampleSolution.yml
• https://github.com/microsoft/coe-alm-accelerator-templates/blob/main/Pipelines/build-deploy-test-SampleSolution.yml
• https://github.com/microsoft/coe-alm-accelerator-templates/blob/main/Pipelines/build-deploy-prod-SampleSolution.yml

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.

Skapa lösningsversionen och distributionskanalerna

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.

Exempeldistributionspipelines utlöses av ändringar i en gren (dvs. test och produktion) eller som en del av en grenprincip i Azure DevOps (dvs. validering). Läs mer om hur du ställer in förgreningspolicyer för validering av pull-begäran. Du kan också köra pipelines manuellt utan en utlösare.

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

Skapa en pipelinefil

1. I Azure DevOps går du till lagringsplatsen som innehåller mappen pipelines som du har checkat in och väljer mappen Pipelines.

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

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 Resurser>Lagringsplatser>Namn till namnet på lagringsplatsen 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 malllagringsplatsen finns i ett annat Azure DevOps projekt använder du 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år du till Pipelines och väljer sedan Skapa en ny pipeline.

5. Välj Azure Repos Git för din kodlagringsplats.

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

7. På sidan Konfigurera din pipeline väljer du Existing Azure Pipelines YAML-fil, pekar på YAML-filen på lagringsplatsen som du skapade tidigare och väljer sedan Continue.

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 kanalutlösare.

12. Upprepa stegen ovan för att skapa en distributionskanal 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 distributionskanal för lösning (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 distributionskanal 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.

Följ stegen i det här avsnittet för att skapa en distributionskanal för lösningen från exempelkanalen YAML. I följande tabell beskrivs pipelinekonfiguration.

1. I Azure DevOps går du till lagringsplatsen som innehåller mappen pipelines som du har checkat in och väljer mappen Pipelines.

2. Öppna exemplet på distributionskanal deploy-prod-pipelineartifact-SampleSolution.yml och kopiera YAML för att använda i din nya kanal.

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 Resurser>Lagringsplatser>Namn till namnet på lagringsplatsen 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 malllagringsplatsen finns i ett annat Azure DevOps projekt använder du 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 till att ange din 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 variabler för distributionskanal

För varje distributionskanal 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 också ange variabeln EnableFlows för att inaktivera Power Automate flöden som en del av en distribution.

Skapa miljö- och serviceanslutning (obligatoriskt)

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

• EnvironmentName anger miljön Azure DevOps som distribueras för att möjliggöra 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 distributionskanaler.

2. Välj Variabler i definitionen för distributionskanalen 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 False för att hoppa över de steg 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år du till Repos och väljer sedan mappen Branches.

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.

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 pipelinekörningen 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. Öppna Projektinställningar i Azure DevOps.
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äljer du Pipelines>Library och väljer 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. Öppna Projektinställningar i Azure DevOps.
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. Öppna Projektinställningar i Azure DevOps.
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äljer du Pipelines>Library och väljer 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. Öppna Projektinställningar i Azure DevOps.
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

Jobbauktoriseringsomfång kan anges för hela Azure DevOps organisationen eller för ett visst projekt. Inaktivera inställningen Begränsa jobb-auktoriseringsomfånget till nuvarande 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 Organiseringsinstä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 omfattar anslutningsreferenser, miljövariabler och behörigheter för Microsoft Entra-grupper och Dataverse-team, samt delning av canvas-appar och uppdatering av ägarskapet för lösningskomponenter som Power Automate-flöden. Utöver dessa konfigurationer behöver en målmiljö ofta exempel- eller konfigurationsdata som är associerade med Dataverse-tabeller i lösningen 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 appen

Importera ALM Accelerator-arbetsyteappen till din Power Platform-miljö och konfigurera sedan den inkluderade anpassade anslutningsappen för Azure DevOps.

Installera ALM Accelerator i Dataverse

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

2. Ladda ned 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 sedan den miljö som du vill vara värd för ALM Accelerator-appen.

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 ansluta CDS DevOps-anslutningen till Dataverse.

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

8. Välj Importera.

Konfigurera det anpassade DevOps-anslutningsprogrammet

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:

   Namn	Värde
   Autentiseringstyp	OAuth 2.0
   Identitetsprovider	Azure Active Directory
   Kund-ID	Det program-ID (klient-ID) du kopierade när du skapade appregistreringen
   Klienthemlighet	Den Appens (klient) hemlighetsvärde du kopierade när du skapade appregistreringen
   Hyresgäst-ID	Lämna som standardvärde vanliga
   Resurs-URL	Den DevOps-program-ID (klient) som du kopierade när du lägger till behörigheter till din appregistrering
   Omdirigerings-URL	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. Återgå till den appregistrering 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 det anpassade anslutningsprogrammet

1. Öppna Test-menyn.

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

3. I Power Apps väljer du din miljö och väljer sedan Dataverse>Custom Connectors>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 Response Status returneras är 200 och att Response Body är en JSON-representation av din Azure DevOps organisation.

   

Konfigurera tillverkare till att använda ALM Accelerator-appen

• Konfigurera användarbehörigheter för en tillverkares konto i Dataverse och Azure DevOps.

• Konfigurera användarinställningar för distribution för att ställa in användarupplevelsen och ge tillgång till lösningar och distributionsprofiler.

Läs mer

• ALM Accelerator för Power Platform
• Konfigurera profiler för distribution
• Konfiguration och datadistribution i pipelines
• Konfiguration och datadistribution i pipelines
• Konfigurera pipelinesynkronisering