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 en clientgeheim (aanbevolen) | Maakt gebruik van op service-principal gebaseerde verificatie en ondersteunt meervoudige verificatie |
| Gebruikersnaam/wachtwoord | Een algemene serviceverbinding met gebruikersnaam en wachtwoord. Biedt geen ondersteuning voor meervoudige verificatie. |
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'. Oplossingscontrole vereist een rol met prvAppendmsdyn_analysisjob privilege om de tabel the msdyn_analysisjob toe te kunnen 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 Microsoft Power Platform Build Tool-pipelines werken?
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 hebben jullie de nieuwe taak gebaseerd op Power Platform CLI in plaats van PowerShell?
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 Build Tools werken voor zowel canvas- als modelgestuurde apps, Power Virtual Agents, UI-stromen en traditionele stromen, AI Builder, aangepaste connectoren en gegevensstromen, die nu allemaal aan een oplossing kunnen worden toegevoegd. 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 heb nu de preview van de Build Tools geïnstalleerd. Kan ik de preview van Power Apps Build Tools upgraden 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 stroom en canvas-apps opnemen?
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 kan de extensie zien, maar waarom heb ik geen optie om 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 controlefunctietaak gebruiken?
De uitvoer van de controlefunctietaak is een Sarif-bestand en er zijn zowel VS Code- als Visual Studio-extensies beschikbaar voor het bekijken en uitvoeren van acties voor Sarif-bestanden.
Zie ook
Taken van build-tools
Microsoft Power Platform Build Tools-labs