Microsoft Power Platform Build Tools til Azure DevOps

  • Artikel

Brug Microsoft Power Platform Build Tools til at automatisere almindelige build- og installationsopgaver, der er relateret til apps, som er bygget på Microsoft Power Platform. Disse opgaver omfatter:

  • Synkronisering af løsningsmetadata (også kaldet løsninger), der indeholder de forskellige platformskomponenter, f.eks.:
    • Kundeengagementsapps som f.eks. Dynamics 365 Sales, Customer Service, Field Service, Marketing og Project Service Automation
    • Lærredapps
    • Modelbaserede apps
    • Flows for brugergrænseflade
    • Virtuelle agenter
    • AI Builder-modeller
    • Forbindelser mellem udviklingsmiljøer og kildekontrolelement
  • Generering af build-artefakter
  • Udrulning af downstream-miljøer
  • Klargøring eller deaktivering af miljøer
  • Udføre statisk analysekontrol mod løsninger ved hjælp af Power Apps-kontroltjenesten

Bruge Microsoft Power Platform Build Tools-opgaver sammen med alle andre tilgængelige Azure DevOps-opgaver til at oprette build- og versions-pipelines. De pipelines, som teams oftest etablerer, omfatter Start, Eksportér fra udvikling, Build og Frigiv.

ALM drevet af Azure DevOps.

Bemærk

Microsoft Power Platform Build Tools understøttes kun for et Microsoft Dataverse-miljø med en database. Flere oplysninger: Oprette et miljø med en database

Microsoft Power Platform Buildværktøjer er nu tilgængelige til brug i området GCC og GCC Høj.

Hvad er Microsoft Power Platform Build Tools?

Microsoft Power Platform Build Tools er en samling Power Platform-specifikke Azure DevOps-buildopgaver, der fjerner behovet for manuelt at hente brugerdefinerede værktøjssæt og scripts for at administrere programlivscyklussen for apps, der er bygget på Microsoft Power Platform.

Opgaverne kan bruges individuelt, f.eks. til import af en løsning i et downstream-miljø, eller sammen i en pipeline til udformning af et scenario, f.eks. generering af en build-artefakt, installation til test eller høstning af udviklerændringer. Build-opgaverne kan primært inddeles i fire typer:

  • Hjælp
  • Kvalitetskontrol
  • Løsning
  • Administration af miljøer

Du kan finde flere oplysninger om de tilgængelige opgaver under Microsoft Power Platform Build Tools-opgaver.

Hvad er Power Platform Build Tools version 2.0?

Ud over det, Power Platform Build Tools leverer, er version 2.0 af Power Platform Build Tools baseret på Power Platform CLI.

Power Platform Build Tools version 1.0 er baseret på PowerShell. Power Platform Build Tools 2.0 er den version, der skal servicere og nyere funktioner tilføjes.

I forbindelse med tidligere versioner af Power Platform Build Tools skal du udføre vigtige sikkerhedsopdateringer efter behov. Vi anbefaler, at kunder flytter til Power Platform Build Tools version 2.0 hurtigst muligt.

Vigtigt

Du kan ikke blande opgaveversioner for Power Platform Build Tools i build-pipelinen.

Hent Microsoft Power Platform Build Tools

Microsoft Power Platform Build Tools kan installeres i Azure DevOps-organisation fra Azure Marketplace.

Når de er blevet installeret, vil alle de opgaver, der indgår i Microsoft Power Platform Build Tools, kunne tilføjes i en ny eller eksisterende pipeline. Du kan finde dem ved at søge efter "Power Platform".

Hent Microsoft Power Platform Build Tools

Forbindelse til miljøer

Hvis der skal kommunikeres med Microsoft Power Platform-miljøet, skal der oprettes forbindelse, der gør det muligt for de forskellige Build Tools-opgaver at udføre de nødvendige handlinger. Der findes to typer af forbindelser:

Connection type Beskrivelse
Tjenestens hovedtjeneste og klient er hemmelig (anbefales) Bruger tjenestens hovedtjenestebaseret godkendelse og understøtter godkendelse med flere faktorer
Brugernavn og adgangskode En generisk tjenesteforbindelse med brugernavn og adgangskode. Godkendelse ud fra flere faktorer understøttes ikke.

Konfigurere tjenesteforbindelser ved hjælp af en tjenestes hovednavn

Hvis du vil konfigurere en forbindelse ved hjælp af tjenestens hovedtjeneste, skal du først have en Power Platform-profil godkendt med de påkrævede tilladelser. Du skal føje et Microsoft Entra ID-program og en tilknyttet programbruger til Dataverse-miljøet.

Oprette tjenesteprincipal og klienthemmelighed

Brug kommandoen pac admin create-service-principal til at oprette og konfigurere servicechefen, så den kan bruges sammen med buildværktøjer-opgaverne Microsoft Power Platform .

Denne kommando registrerer først et programobjekt og det tilhørende navn på tjenesteprincipalen (SPN) i Microsoft Entra ID. Dette program tilføjes derefter som administratorbruger i Microsoft Power Platform-lejeren.

Denne kommando har to parametre:

Navn kort navn Påkrævet Beskrivelse
environment env Ja ID eller URL-adresse for det miljø, en bruger skal tildeles til.
role r Nr. Navn eller id for sikkerhedsrolle, der skal anvendes til programbruger. Standardværdien er: 'Systemadministrator'.

Løsningskontrol kræver en rolle med rettigheden prvAppendmsdyn_analysisjob for at kunne føje til tabellen msdyn_analysisjob. Rollen Systemadministrator har som standard denne rettighed.

Du kan bruge det som dette:

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

Når det lykkedes, vises der fire kolonner:

  • Power Platform TenantId
  • Application ID
  • Klienthemmelighed (i klartekst)
  • Udløb

Eksempel: 

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

Brug de oplysninger, der vises, til at konfigurere Power Platform-tjenesteforbindelsen.

Vigtigt

Sørg for, at klienthemmeligheden er beskyttet og sikker. Når kommandoprompten er fjernet, kan du ikke hente samme klienthemmelighed igen.

Konfigurere miljøet med program-id'et

Du skal tilføje program-id'et som en programbruger i det Microsoft Power Platform-miljø, du opretter forbindelse til. Det kan du gøre på to måder.

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

Kontrollér, at den tilføjede programbruger har fået tildelt systemadministratorrollen (tilgængelig fra "Administrer roller" i sikkerhedsindstillingerne for programbrugeren).

Ofte stillede spørgsmål

Vil mine gamle Microsoft Power Platform Build Tool-pipelines fortsat fungere?

De ældre pipelines fungerer fortsat, men nyere funktioner føjes ikke til de ældre opgaver. Hvis du vil udnytte de nyere funktioner, anbefales det, at du ændrer versionen af opgaven i pipelinen.

Hvorfor har du baseret den nye opgave på Power Platform CLI og ikke på PowerShell?

CLI-opgaverne i Power Platform er multiplatform med stor fleksibilitet, herunder kørsel på linux-maskiner. Det er de samme opgaver, der er tilgængelige med Power Platform-handlinger til GitHub. Du har nu en ensartet oplevelse mellem Azure DevOps og GitHub.

Fungerer Microsoft Power Platform Build Tools kun for Power Apps?

Build-værktøjerne fungerer for både lærredapps og modelbaserede apps, Power Virtual Agents, UI-flows og traditionelle flow, AI Builder, brugerdefinerede connectorer og dataflow, der alle kan føjes til en løsning. Listen indeholder også kundeengagementsapps (Dynamics 365 Sales, Customer Service, Field Service, Marketing og Project Service Automation). Der findes separate buildopgaver til Finans og driftsprogrammer.

Jeg har tidligere installeret forhåndsversionen af Build-værktøjer – kan jeg opgradere fra forhåndsversionen af Power Apps Build Tools til Power Platform Build Tools?

Du kan ikke opgradere fra eksempelversionen, da vi var nødt til at introducere de seneste ændringer i den offentligt tilgængelige version. Hvis du vil flytte fra eksempelversionen, skal du installere Microsoft Power Platform Build Tools og enten genopbygge dine pipeliner eller omkonfigurere de eksisterende pipelines, så de bruger de nye buildværktøjer. Du skal også oprette nye tjenesteforbindelser.

Kan jeg inkludere flow- og lærred-apps?

Ja, flow- og lærredapps er løsningsbaserede, så hvis disse komponenter føjes til din løsning, kan de være en del af appens livscyklus. Visse trin kræver dog stadig manuelle konfigurationer. Behovet for manuel konfiguration beskrives senere i år, når vi introducerer miljøvariabler og connectorer. Du kan få vist en liste over aktuelle begrænsninger i Kendte begrænsninger.

Hvor meget koster Microsoft Power Platform Build Tools?

Buildværktøjerne er tilgængelige uden omkostninger. Der kræves dog et gyldigt abonnement på Azure DevOps for at kunne bruge Build Tools. Du kan finde flere oplysninger Prisfastsættelse for Azure DevOps.

Jeg kan se udvidelsen, men hvorfor har jeg ikke mulighed for at installere den?

Hvis du ikke kan se installationsindstillingen, har du højst sandsynligt ikke de nødvendige rettigheder til at installere i din Azure DevOps-organisation. Flere oplysninger i Administrere udvidelsestilladelser.

Hvordan kan udviklere bruge resultaterne fra kontrolopgaven?

Resultatet af kontrolopgaven er en Sarif-fil, og både VS Code- og Visual Studio-udvidelser er tilgængelige til visning og handling på Sarif-filer.

Se også

Build-værktøjsopgaver
Microsoft Power Platform Build Tools-labs