Microsoft Power Platform Build Tools voor Azure DevOps
Gebruik Microsoft Power Platform Build Tools om veelvoorkomende build- en implementatietaken met betrekking tot apps te automatiseren in Microsoft Power Platform. Deze taken omvatten:
- Metagegevens van oplossingen synchroniseren (ook wel oplossingen genoemd) die de verschillende platformonderdelen bevatten, zoals:
- Apps voor klantbetrokkenheid: Dynamics 365 Sales, Customer Service, Field Service, Marketing en Project Service Automation
- Canvas-apps
- Modelgestuurde apps
- UI flows
- Virtuele agenten
- AI Builder-modellen
- Connectors tussen ontwikkelomgevingen en broncodebeheer
- Genereren van build-artefacten
- Implementatie in downstream-omgevingen
- Omgevingen inrichten of buiten gebruik stellen
- Statische analysecontroles uitvoeren op oplossingen met behulp van de Power Apps-controleservice
Gebruik Microsoft Power Platform Build Tools-taken met alle andere beschikbare Azure DevOps-taken om uw build- en releasepipelines samen te stellen. Pipelines die teams veelal gebruiken, zijn Initiate, Export From Dev, Build en Release.
Notitie
Microsoft Power Platform Build Tools worden alleen ondersteund voor een Microsoft Dataverse-omgeving met een database. Meer informatie: Een omgeving met een database maken
Microsoft Power Platform Build Tools zijn nu beschikbaar voor gebruik in de regio´s GCC en GCC High.
Wat zijn Microsoft Power Platform Build Tools?
Microsoft Power Platform Build Tools zijn een verzameling van Power Platform-specifieke Azure DevOps-buildtaken die de noodzaak wegnemen om handmatig aangepaste tooling en scripts te downloaden om de levenscyclus te beheren van apps die zijn gebouwd op Microsoft Power Platform.
U kunt de afzonderlijk gebruiken, zoals het importeren van een oplossing in een downstream-omgeving, of samen in een pipeline om een scenario te orkestreren zoals een buildartefact genereren, implementeren om te testen of makerwijzigingen verzamelen. De build-taken kunnen grotendeels worden onderverdeeld in vier typen:
- Help
- Kwaliteitscontrole
- Oplossing
- Omgevingsbeheer
Zie Taken van Microsoft Power Platform Build Tools voor meer informatie over de beschikbare taken.
Wat is Power Platform Build Tools versie 2.0?
Naast wat Power Platform Build Tools te bieden heeft, is versie 2.0 van Power Platform Build Tools nu gebaseerd op Power Platform CLI.
Power Platform Build Tools versie 1.0 is gebaseerd op PowerShell. Power Platform Build Tools 2.0 is de versie die zal worden onderhouden en waaraan nieuwere functies zullen worden toegevoegd.
Voor eerdere versies van Power Platform Build Tools voeren we indien nodig kritieke beveiligingsupdates uit. We raden klanten ten zeerste aan om zo snel mogelijk over te stappen naar Power Platform Build Tools versie 2.0.
Belangrijk
U kunt taakversies niet mixen en matchen voor Power Platform Build Tools in uw build-pipeline.
Microsoft Power Platform Build Tools verkrijgen
Microsoft Power Platform Build Tools kunnen vanuit Azure Marketplace in uw Azure DevOps-organisatie worden geïnstalleerd.
Na installatie zijn alle taken die zijn opgenomen in de Microsoft Power Platform Build Tools beschikbaar om te worden toegevoegd aan een nieuwe of bestaande pipeline. U vindt ze door te zoeken naar 'Power Platform'.
Verbinding met omgevingen
Als u wilt communiceren met de Microsoft Power Platform-omgeving, moet u een verbinding tot stand brengen zodat de taken van de build-tool de vereiste acties kunnen uitvoeren. Er zijn twee typen verbindingen beschikbaar:
| Connection type | Omschrijving |
|---|---|
| Service Principal via Workload Identity Federation (aanbevolen) | Maakt gebruik van authenticatie op basis van serviceprincipals via gefedereerde referenties. Aanbevolen voor huurders die multi-factor-authenticatie nodig hebben. |
| Serviceprincipal en clientgeheim | Maakt gebruik van authenticatie op basis van een service-principal. |
| Gebruikersnaam/wachtwoord | Een algemene serviceverbinding met gebruikersnaam en wachtwoord. Ondersteunt geen gebruikers die multi-factor-authenticatie nodig hebben. |
Serviceverbindingen configureren met behulp van een service-principal
Als u een verbinding wilt configureren met behulp van een service-principal, moet u eerst een Power Platform-profiel hebben dat is geverifieerd met de vereiste machtigingen. U moet een Microsoft Entra ID-toepassing en bijbehorende toepassingsgebruiker toevoegen aan de Dataverse-omgeving.
Service-principal en clientgeheim maken
Gebruik de opdracht pac admin create-service-principal om de service-principal te maken en te configureren die moet worden gebruikt met de Microsoft Power Platform Build Tools-taken.
Deze opdracht registreert eerst een object Toepassing en de bijbehorende Service Principal Name (SPN) in Microsoft Entra ID. Vervolgens wordt de toepassing toegevoegd als beheerdergebruiker aan de Microsoft Power Platform-tenant.
Deze opdracht heeft twee parameters:
| name | korte naam | Vereist | Omschrijving |
|---|---|---|---|
environment |
env |
Ja | De id of URL van de omgeving waaraan een toepassingsgebruiker moet worden toegewezen. |
role |
r |
No | Naam of id van beveiligingsrol die op toepassingsgebruiker moet worden toegepast. De standaardwaarde is 'Systeembeheerder'. Solution Checker vereist een rol met prvAppendmsdyn_analysisjob-rechten om aan de tabel msdyn_analysisjob toe te voegen. De rol Systeembeheerder beschikt standaard over deze bevoegdheid. |
U kunt deze als volgt gebruiken:
C:\> pac admin create-service-principal --environment <environment id>
Als dit gelukt is, worden er vier kolommen weergegeven:
- Power Platform-tenant-id
- Application ID
- Clientgeheim (in leesbare tekst)
- Verloop
Bijvoorbeeld:
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
Gebruik de weergegeven informatie om de Power Platform-serviceverbinding te configureren.
Belangrijk
Bewaar het clientgeheim veilig. Zodra de opdrachtprompt is gewist, kunt u hetzelfde clientgeheim niet opnieuw ophalen.
Omgeving configureren met de toepassings-id
U moet de toepassings-id toevoegen als toepassingsgebruiker in de Microsoft Power Platform-omgeving waarmee u verbinding maakt. Er zijn twee manieren waarop u dit kunt doen.
- U kunt dit artikel bekijken: Toepassingsgebruiker maken.
- U kunt gebruikmaken van Power Platform CLI. Bijvoorbeeld:
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
Zorg ervoor dat aan de toegevoegde toepassingsgebruiker de systeemrol Beheerder is toegewezen (beschikbaar via "Rollen beheren" in de beveiligingsinstellingen voor de toepassingsgebruiker).
Veelgestelde vragen (FAQ's)
Blijven mijn oude Build Tool-pipelines werken? Microsoft Power Platform
De oudere pipelines blijven werken, maar nieuwere functies worden niet toegevoegd aan de oudere taken. Als u de nieuwere functies wilt gebruiken, raden we u ten zeerste aan om de versie van uw taak in de pijplijn te wijzigen.
Waarom heb je de nieuwe taak gebaseerd op CLI in plaats van op PowerShell? Power Platform
De Power Platform CLI-taken zijn multi-platform met grote flexibiliteit, inclusief uitvoering op Linux-runners. Dit zijn dezelfde taken die beschikbaar zijn bij Power Platform-acties voor GitHub. U hebt nu een consistente ervaring tussen Azure DevOps en GitHub.
Werken de Microsoft Power Platform Build Tools alleen voor Power Apps?
De buildtools werken voor zowel canvas- als modelgestuurde apps, virtuele CoPilot Studio-agenten, UI-stromen en traditionele stromen, aangepaste connectoren en gegevensstromen. Deze kunnen nu allemaal aan een oplossing worden toegevoegd. Microsoft AI Builder Deze lijst bevat ook apps voor klantbetrokkenheid (Dynamics 365 Sales, Customer Service, Field Service, Marketing en Project Service Automation). Er zijn afzonderlijke build-taken beschikbaar voor Finance and Operations-toepassingen.
Ik had eerder de preview van de Build Tools geïnstalleerd. Kan ik upgraden van de preview van Power Apps Build Tools naar Power Platform Build Tools?
U kunt niet upgraden vanaf de preview-versie omdat we een aantal belangrijke wijzigingen moesten aanbrengen in de algemeen beschikbare release. Om over te stappen van de preview-versie, moet u Microsoft Power Platform Build Tools installeren en uw pijplijnen opnieuw opbouwen of uw bestaande pijplijnen opnieuw configureren om de nieuwe Build Tools-taken te gebruiken. U moet ook nieuwe serviceverbindingen maken.
Kan ik flow- en canvas-apps toevoegen?
Ja, stromen en canvas-apps zijn oplossingsbewust, dus als deze onderdelen aan uw oplossing worden toegevoegd, kunnen ze deelnemen aan de levenscyclus van uw app. Sommige stappen vereisen echter nog steeds handmatige configuraties. De vereiste van handmatige configuratie wordt later dit jaar aangepakt wanneer we omgevingsvariabelen en connectoren introduceren. Een lijst met huidige beperkingen zijn hier beschikbaar: Bekende beperkingen.
Hoeveel kosten de Microsoft Power Platform Build Tools?
De Build Tools zijn gratis beschikbaar. Wel een geldig abonnement voor Azure DevOps is vereist om de Build Tools te gebruiken. Meer informatie is hier beschikbaar: Prijzen voor Azure DevOps.
Ik zie de extensie, maar waarom krijg ik geen optie om deze te installeren?
Als u de optie installeren niet ziet, beschikt u hoogstwaarschijnlijk niet over de benodigde installatiebevoegdheden in uw Azure DevOps-organisatie. Meer informatie beschikbaar: Extensiemachtigingen beheren.
Hoe kunnen ontwikkelaars de resultaten van de Checker taak gebruiken?
De uitvoer van de Checker taak is een Sarif-bestand en zowel VS Code als Visual Studio extensies zijn beschikbaar voor het bekijken en uitvoeren van acties op Sarif-bestanden.
Zie ook
Power Platform Build Tools voor Azure DevOps release-opmerkingen
Taken voor het bouwen van gereedschappen
Microsoft Power Platform Bouwhulpmiddelen labs