Microsoft Power Platform Build Tools per a Azure DevOps

Utilitza Microsoft Power Platform Build Tools per automatitzar tasques comunes de compilació i desplegament relacionades amb aplicacions construïdes sobre Microsoft Power Platform. Entre les tasques hi pot haver:

• Sincronització de metadades de la solució (també conegudes com a solucions) que contenen els diferents components de la plataforma, com ara:
  • Aplicacions de compromís amb el client: Dynamics 365 Sales, Atenció al Client, Servei de Camp, Màrqueting i Project Service Automation
  • Aplicacions de llenç
  • Aplicacions basades en models
  • fluxos d'interfície d'usuari
  • Agents virtuals
  • Models d'AI Builder
  • Connectors entre entorns de desenvolupament i control de codi font
• Generació d'artefactes de compilació
• Implementació a entorns descendents
• Entorns de provisió o desproveïment
• Realitzar comprovacions d'anàlisi estàtica contra solucions utilitzant el servei de verificació de Power Apps

Utilitza les tasques de Microsoft Power Platform Build Tools amb qualsevol altra tasca disponible d'Azure DevOps per compondre les teves pipelines de build i release. Els pipelines que solen activar els equips inclouen Inicia, Exporta de desenvolupament, Compila i Publica.

Nota

Les Microsoft Power Platform Build Tools només són compatibles amb un entorn Microsoft Dataverse amb una base de dades. Més informació: Crear un entorn amb una base de dades

Microsoft Power Platform Build Tools ja estan disponibles per a les regions GCC i GCC High.

Quines són les eines de construcció de Microsoft Power Platform?

Microsoft Power Platform Build Tools són un conjunt de tasques específiques de compilació d'Azure DevOps per a Power Platform que eliminen la necessitat de descarregar manualment eines i scripts personalitzats per gestionar el cicle de vida de les aplicacions construïdes sobre Microsoft Power Platform.

Podeu utilitzar les tasques individualment, com ara importar una solució a un entorn descendent o juntes en un pipeline per orquestrar un escenari, com ara generar un artefacte de compilació, desplegar per provar o recopilar canvis de creador. Pots classificar en gran mesura les tasques de construcció en quatre tipus:

• Ajuda
• Comprovació de qualitat
• Solució
• Gestió de l'entorn

Per a més informació sobre les tasques disponibles, vegeu Microsoft Power Platform Tasques d'eines de construcció.

Què és Power Platform Build Tools versió 2.0?

A banda del que proporcionen Power Platform Build Tools, la versió 2.0 de Power Platform Build Tools es basa en Power Platform CLI.

Power Platform La versió 1.0 de Build Tools es basa en PowerShell. Power Platform Build Tools 2.0 és la versió que Microsoft services i a la qual afegeix funcions més noves.

Per a versions anteriors de Power Platform Build Tools, Microsoft proporciona actualitzacions de seguretat crítiques segons sigui necessari. Passa a Power Platform Build Tools versió 2.0 tan aviat com sigui possible.

Important

No pots barrejar i combinar versions de tasques per a Power Platform Build Tools a la teva pipeline de compilació.

Obteniu les eines de compilació de Microsoft Power Platform

Microsoft Power Platform Build Tools es pot instal·lar a la teva organització Azure DevOps des de Azure Marketplace.

Després de la instal·lació, totes les tasques incloses a les Microsoft Power Platform Build Tools estaran disponibles per afegir a qualsevol pipeline nou o existent. Per trobar-les, cerqueu "Power Platform".

Connexió a entorns

Per interactuar amb l'entorn de Microsoft Power Platform, has d'establir una connexió perquè les tasques de l'eina de construcció puguin realitzar les accions necessàries. Hi ha disponibles dos tipus de connexions:

Tipus de connexió	Descripció
Entitat de servei mitjançant la federació d'identitats de càrrega de treball (recomanat)	Utilitza l'autenticació basada en l'entitat de servei mitjançant credencials federades. Recomanat per a inquilins que requereixen autenticació multifactor.
Principal de servei i secret de client	Utilitza l'autenticació basada en l'entitat de servei.
Nom d'usuari/contrasenya	Una connexió de servei genèrica amb nom d'usuari i contrasenya. No admet els usuaris que requereixen autenticació multifactor.

Configurar les connexions de servei mitjançant una entitat de servei

Per configurar una connexió mitjançant l'entitat de servei, primer heu de tenir un Power Platform perfil autenticat amb els permisos necessaris. Has d'afegir una aplicació Microsoft Entra ID i l'usuari associat a l'entorn Dataverse.

Crear una entitat de servei i un secret de client

Utilitza la comanda pac admin create-service-principal per crear i configurar el principal de servei que s'utilitzi amb les tasques de Microsoft Power Platform Build Tools.

Aquesta comanda registra primer un objecte d'aplicació i el Nom del Principal de Servei (SPN) corresponent a Microsoft Entra ID. Després afegeix l'aplicació com a usuari administrador al lloguer de Microsoft Power Platform.

Aquesta ordre té dos paràmetres:

nom	nom curt	Necessari	Descripció
environment	env	Sí	L'identificador o l'adreça URL de l'entorn al qual afegir un usuari de l'aplicació.
role	r	No	Nom o ID del rol de seguretat per aplicar a l'usuari de l'aplicació. El valor per defecte és: "Administrador del sistema". El Verificador de solucions requereix una funció amb prvAppendmsdyn_analysisjob privilegi per afegir a la taula msdyn_analysisjob. La funció d'administrador del sistema té aquest privilegi per defecte.

Fes servir l'ordre així:

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

Quan té èxit, l'ordre mostra quatre columnes:

• TenantId del Power Platform
• Identificador d'aplicació
• Secret del client (en text clar)
• Venciment

Per exemple:

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

Utilitzeu la informació que es mostra per configurar la connexió del servei del Power Platform.

Important

Mantingueu el secret del client protegit i segur. Un cop s'ha esborrat el prompt d'ordres, no pots recuperar el mateix secret del client de nou.

Configurar l'entorn amb l'identificador de l'aplicació

Has d'afegir l'ID de l'aplicació com a usuari d'aplicació a l'entorn de Microsoft Power Platform al qual t'estàs connectant. Hi ha dues maneres de fer-ho.

• Podeu revisar aquest article: Creació d'usuaris d'aplicacions.
• Podeu utilitzar Power Platform la CLI. Per exemple:

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

Assegureu-vos que l'usuari de l'aplicació afegit tingui assignada la funció d'administrador del sistema (disponible a "Administra funcions" a la configuració de seguretat de l'usuari de l'aplicació).

Preguntes més freqüents

Els meus antics canals de l'eina de construcció de Microsoft Power Platform continuaran funcionant?

Les canalitzacions antigues continuen funcionant, però les funcions més noves no estan disponibles en les tasques antigues. Si vols utilitzar les funcions més noves, canvia la versió de la teva tasca al pipeline.

Per què heu basat la nova tasca en Power Platform CLI en lloc de PowerShell?

Les tasques de la CLI de Power Platform són multiplataforma amb gran flexibilitat, incloent-hi l'execució en runners Linux. Aquestes tasques són les mateixes que estan disponibles amb Power Platform Actions per a GitHub. Ara tens una experiència consistent entre Azure DevOps i GitHub.

Les eines de compilació Microsoft Power Platform només funcionen per a Power Apps?

Les eines de build funcionen tant per a aplicacions de llenç com de model, agents virtuals de Microsoft Copilot Studio, fluxos d'interfície d'usuari i fluxos tradicionals, AI Builder, connectors personalitzats i fluxos de dades, tot això que ara pots afegir a una solució. Aquesta llista també inclou aplicacions de compromís amb el client (Dynamics 365 Sales, Customer Service, Field Service, Marketing i Project Service Automation). Les tasques de creació independents estan disponibles per a les aplicacions de finances i operacions.

Anteriorment vaig instal·lar la previsualització de les Eines de Compilació: puc actualitzar la previsualització de Power Apps Build Tools a Power Platform Build Tools?

No es pot actualitzar des de la versió prèvia perquè vam haver d'introduir alguns canvis importants en la versió generalment disponible (GA). Per passar de la versió preliminar, cal instal·lar les Microsoft Power Platform Build Tools i reconstruir les teves pipelines o reconfigurar les teves pipelines existents per utilitzar les noves tasques de Build Tools. També has de crear noves connexions de servei.

Puc incloure aplicacions de flux i llenç?

Sí, les aplicacions de fluxos i canvas són conscients de la solució, així que si afegeixes aquests components a la teva solució, poden participar en el cicle de vida de la teva aplicació. Tanmateix, alguns passos encara necessiten configuracions manuals. La necessitat de la configuració manual, cosa que es corregirà a finals d'aquest any quan introduïm variables d'entorn i connectors. Una llista de limitacions actuals està disponible a l'article de Limitacions conegudes .

Quant costen les Microsoft Power Platform Build Tools?

Les Build Tools estan disponibles sense cap cost. Tanmateix, necessites una subscripció vàlida a Azure DevOps per utilitzar les eines de compilació. Per a més informació, vegeu Preus per a Azure DevOps.

Puc veure l'extensió, però per què no tinc l'opció d'instal·lar-la?

Si no veus l'opció d'instal·lació, probablement et falten els privilegis d'instal·lació necessaris a la teva organització Azure DevOps. Per a més informació, vegeu Gestionar permisos d'extensió.

Com poden els desenvolupadors utilitzar els resultats de la tasca Verificador?

La sortida de la tasca Checker és un fitxer SARIF. Tant les extensions de VS Code com de Visual Studio estan disponibles per visualitzar i fer accions sobre fitxers SARIF.

Consulteu també

Power Platform Build Tools per a Azure DevOps notes de versió
Tasques de l'eina de creació
Microsoft Power Platform Laboratoris d'eines de construcció