Microsoft Power Platform Byggverktyg för Azure DevOps

Använd Microsoft Power Platform Build Tools för att automatisera vanliga bygg- och distributionsuppgifter relaterade till appar som bygger på Microsoft Power Platform. Dessa uppgifter omfattar:

  • Synkronisera lösningsmetadata (kallas även lösningar) som innehåller de olika plattformskomponenterna, till exempel:
    • Appar för kundengagemang: Dynamics 365 Sales, kundtjänst, fälttjänst, marknadsföring och Project Service Automation
    • Canvas-appar
    • Modellbaserade appar
    • Flöden för användargränssnitt
    • Virtuella handläggare
    • AI Builder modeller
    • Anslutningsprogram mellan utvecklingsmiljöer och källkontroll
  • Genererar artefakter för bygget
  • Distribuera till nedströmsmiljöer
  • Tilldelnings- och avkonfigureringsmiljöer
  • Utföra statiska analyskontroller mot lösningar med hjälp av Power Apps checker-tjänsten

Använd Microsoft Power Platform Build Tools-uppgifter med andra tillgängliga Azure DevOps uppgifter för att skapa dina bygg- och versionspipelines. Pipelines som team ofta använder sig av inkluderar Initiering, Export från utveckling, Bygga och Publicering.

ALM drivs av Azure DevOps.

Anmärkning

Microsoft Power Platform Build Tools stöds endast för en Microsoft Dataverse miljö med en databas. Mer information: Skapa en miljö med en databas

Microsoft Power Platform Build Tools är nu tillgängliga för användning i regionerna GCC och GCC High.

Vad är Microsoft Power Platform Build Tools?

Microsoft Power Platform Build Tools är en samling Power Platform-specifika Azure DevOps bygguppgifter som eliminerar behovet av att manuellt ladda ned anpassade verktyg och skript för att hantera programlivscykeln för appar som bygger på Microsoft Power Platform.

Du kan använda uppgifterna individuellt, t. ex. för att importera en lösning till en efterföljande miljö, eller också användas tillsammans i en pipeline för att dirigera ett scenario som skapa en versionsartefakt, distribuera till test eller skörda utvecklarförändringar. Du kan till stor del kategorisera bygguppgifterna i fyra typer:

  • Hjälpare
  • Kvalitetskontroll
  • Lösning
  • Miljöhantering

Mer information om tillgängliga uppgifter finns i Microsoft Power Platform Build Tools-uppgifter.

Vad är Power Platform Build Tools version 2.0?

Förutom vad Power Platform Build Tools ger, version 2.0 av Power Platform Build Tools är Power Platform CLI-baserad.

Power Platform Build Tools version 1.0 bygger på PowerShell. Power Platform Build Tools 2.0 är den version som Microsoft underhåller och lägger till nya funktioner i.

För tidigare versioner av Power Platform Build Tools tillhandahåller Microsoft kritiska säkerhetsuppdateringar efter behov. Gå till Power Platform Build Tools version 2.0 så snart som möjligt.

Important

Du kan inte blanda uppgiftsversioner för Power Platform Build Tools i din build-pipeline.

Hämta Microsoft Power Platform Build Tools

Microsoft Power Platform Build Tools kan installeras i din Azure DevOps organisation från Azure Marketplace.

Efter installationen kommer alla uppgifter som ingår i Microsoft Power Platform Build Tools att vara tillgängliga för att lägga till i alla nya eller befintliga pipelines. Du hittar dessa genom att söka efter "Power Platform".

Ladda ner Microsoft Power Platform Build Tools

Anslut till miljöer

Om du vill interagera med den Microsoft Power Platform miljön måste du upprätta en anslutning så att byggverktygsuppgifterna kan utföra de åtgärder som krävs. Det finns två typer av anslutningar:

Anslutningstyp Beskrivning
Tjänstens huvudnamn via federation för arbetsbelastningsidentitet (rekommenderas) Använder autentisering baserad på tjänstens huvudnamn via federerade autentiseringsuppgifter. Rekommenderas för klienter som kräver multifaktorautentisering.
Tjänstens huvudnamn och klienthemlighet Använder autentisering baserad på tjänstens huvudnamn.
Användarnamn/lösenord En allmän tjänstanslutning med användarnamn och lösenord. Stöder inte användare som kräver multifaktorautentisering.

Konfigurera tjänstanslutningar med hjälp av ett tjänsthuvud

Om du vill konfigurera en anslutning med tjänstens huvudnamn måste du först ha en Power Platform-profil som autentiserats med den behörighet som krävs. Du måste lägga till ett Microsoft Entra ID program och en associerad programanvändare i Dataverse-miljön.

Skapa tjänstens huvudnamn och klienthemlighet

Använd kommandot pac admin create-service-principal för att skapa och konfigurera tjänstens huvudnamn som ska användas med Microsoft Power Platform Build Tools-uppgifter.

Det här kommandot registrerar först ett programobjekt och motsvarande SPN (Service Principal Name) i Microsoft Entra ID. Sedan läggs programmet till som administratörsanvändare i Microsoft Power Platform tenanten.

Detta kommando har två parametrar:

Namn kortnamn Obligatoriskt Beskrivning
environment env Yes ID eller URL för miljön som en användare läggs till i.
role r No Namn eller ID för säkerhetsroll som ska tillämpas på programanvändaren. Standardvärdet är: "systemadministratör".

Lösningskontrollen kräver en roll med "prvAppendmsdyn_analysisjob"-behörighet för att lägga till i tabellen msdyn_analysisjob. Systemadministratörsrollen har detta privilegium som standard.

Använd kommandot så här:

C:\> pac admin create-service-principal  --environment <environment id>

När det lyckas visar kommandot fyra kolumner:

  • Power Platform Hyresgäst-ID
  • Sökande-ID
  • Klienthemlighet (klartext)
  • Utgång

Som exempel:

PS C:\>pac admin create-service-principal --environment d3fcc479-0122-e7af-9965-bde57f69ee1d
Connected as admin@M365x57236726.onmicrosoft.com
Successfully assigned user adde6d52-9582-4932-a43a-beca5d182301 to environment d3fcc479-0122-e7af-9965-bde57f69eeld with security role System Administrator
Tenant ID                            Application ID                       Client Secret                           Expiration
2b0463ed-efd7-419d-927d-a9dca49d899c adde6d52-9582-4932-a43a-beca5d182301 beY8Q~JBZ~CBDgIKKBjbZ3g6BofKzoZkYj23Hbf 7/31/2024 4:27:03 PM

Använd informationen som visas för att konfigurera Power Platform tjänstanslutningen.

Important

Håll klientens hemlighet säker och skyddad. När kommandotolksfönstret har rensats kan du inte hämta klienthemligheten igen.

Konfigurera miljön med program-ID:t

Du måste lägga till program-ID:t som programanvändare i den Microsoft Power Platform miljö som du ansluter till. Det finns två sätt du kan göra detta på.

PS C:\>pac admin assign-user --user "adde6d52-9582-4932-a43a-beca5d182301" --role "System administrator" --environment d3fcc479-0122-e7af-9965-bde57f69ee1d --application-user
Connected to... SnDemoDev
Connected as admin@M365x57236726.onmicrosoft.com
Successfully assigned user adde6d52-9582-4932-a43a-beca5d182301 to environment d3fcc479-0122-e7af-9965-bde57f69ee1d with security role System Administrator

Se till att den tillagda programanvändaren har den tilldelade systemadministratörrollen (finns i Hantera roller i säkerhetsinställningarna för programanvändaren).

Vanliga frågor (FAQ)

Kommer mina gamla Microsoft Power Platform Build Tool-pipelines att fortsätta fungera?

De äldre pipelinerna fortsätter att fungera, men nyare funktioner är inte tillgängliga i de äldre aktiviteterna. Om du vill använda de nyare funktionerna ändrar du versionen av din uppgift i pipelinen.

Varför baserade ni den nya uppgift på Power Platform CLI istället för PowerShell?

Power Platform CLI-uppgifterna är plattformsoberoende och mycket flexibla, inklusive att de kan köras på Linux-agenter. Dessa uppgifter är samma uppgifter som är tillgängliga med Power Platform Actions för GitHub. Nu har du en konsekvent upplevelse mellan Azure DevOps och GitHub.

Fungerar Microsoft Power Platform Build Tools endast för Power Apps?

Byggverktygen fungerar för både arbetsyteappar och modelldrivna appar, virtuella agenter i Microsoft Copilot Studio, UI-flöden och traditionella flöden, AI Builder, anpassade anslutningar och dataflöden, som alla nu kan läggas till i en lösning. Den här listan innehåller även appar för kundengagemang (Dynamics 365 Sales, kundtjänst, fälttjänst, marknadsföring och Project Service Automation). Separata build-uppgifter är tillgängliga för program för ekonomi och drift.

Jag har tidigare installerat förhandsversionen av Build Tools – kan jag uppgradera från förhandsversionen av Power Apps Build Tools till Power Platform Build Tools?

Du kan inte uppgradera från förhandsversionen eftersom vi var tvungna att införa några icke-bakåtkompatibla ändringar i den allmänt tillgängliga versionen . Om du vill flytta från förhandsversionen måste du installera Microsoft Power Platform Build Tools och antingen återskapa dina pipelines eller konfigurera om dina befintliga pipelines för att använda de nya build tools-uppgifterna. Du måste också skapa nya tjänstanslutningar.

Kan jag inkludera flödes- och arbetsyteappar?

Ja, flöden och appar för arbetsytor är lösningsmedvetna, så om du lägger till dessa komponenter i din lösning kan de delta i appens livscykel. Vissa steg kräver emellertid fortfarande manuella konfigurationer. Behovet av manuell konfiguration kommer att åtgärdas senare i år när vi introducerar miljövariabler och kopplingar. En lista över aktuella begränsningar finns i artikeln Kända begränsningar .

Hur mycket kostar Microsoft Power Platform Build Tools?

Build Tools är tillgängliga utan kostnad. Du behöver dock en giltig prenumeration på Azure DevOps för att använda byggverktygen. Mer information finns i Prissättning för Azure DevOps.

Jag kan se tillägget, men varför har jag inte möjlighet att installera det?

Om du inte ser installationsalternativet saknar du förmodligen nödvändiga installationsbehörigheter i din Azure DevOps organisation. Mer information finns i Hantera tilläggsbehörigheter.

Hur kan utvecklare använda resultatet av uppgiften Checker?

Utdata från Checker-aktiviteten är en SARIF-fil. Både VS Code- och Visual Studio-tillägg är tillgängliga för att visa och vidta åtgärder på SARIF-filer.

Se även

Viktig information om Power Platform Build Tools för Azure DevOps
Byggverktygsuppgifter
Microsoft Power Platform Build Tools-labb