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. Les tasques de compilació es classifiquen en gran mesura 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 es donarà servei i s'afegiran funcions més noves.

Per a les versions anteriors de les eines de Power Platform compilació, farem actualitzacions de seguretat crítiques segons sigui necessari. Us recomanem que els clients es desplacen a Power Platform Build Tools a la versió 2.0 tan aviat com sigui possible.

Important

No podeu barrejar ni fer coincidir les versions de la tasca de Power Platform Build Tools a la vostra 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'utilitzarà amb les tasques 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 identificador de la funció de seguretat que s'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.

Podeu utilitzar-lo així:

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

Quan s'ha realitzat, es mostren 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 esborrat l'indicador d'ordres, no podeu recuperar el mateix secret de client.

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?

Els pipelines més antics continuen funcionant, però les característiques més noves no s'afegiran a les tasques anteriors. Si voleu fer l'exercici de les noves característiques, us recomanem que canvieu la versió de la tasca al pipeline.

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

Les tasques Power Platform CLI són multiplataforma amb molta flexibilitat, incloent-hi l'execució des de sànscrits. Aquestes són les mateixes tasques 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 construcció funcionen tant per a aplicacions de canvas com de models, agents virtuals de Microsoft Copilot Studio, fluxos d'interfície d'usuari i fluxos tradicionals, AI Builder, connectors personalitzats i fluxos de dades, tots els quals ara es poden 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 havia instal·lat la previsualització de les Build Tools: puc actualitzar de la previsualització de Power Apps Build Tools a Power Platform Build Tools?

No podeu actualitzar des de la versió preliminar, ja que hem hagut d'introduir alguns canvis importants a la versió generalment disponible. Per passar de la versió preliminar, has d'instal·lar les Microsoft Power Platform Build Tools i o bé reconstruir les teves pipelines, o reconfigurar les teves pipelines existents per utilitzar les noves tasques de les Build Tools. També heu de crear noves connexions de servei.

Puc incloure aplicacions de flux i llenç?

Sí, les aplicacions de flux i de llenç formen part de les solucions, de manera que si aquests components s'afegeixen a la solució, poden participar al cicle de vida de l'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 les limitacions actuals está disponible aquí: Limitacions conegudes.

Quant costen les Microsoft Power Platform Build Tools?

Les Build Tools estan disponibles sense cap cost. Tanmateix, es requereix una subscripció vàlida a Azure DevOps per utilitzar les Eines de Compilació. Hi ha més informació disponible 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ó install, probablement no tens els privilegis d'instal·lació necessaris a la teva organització Azure DevOps. Més informació disponible Gestionar els permisos d'extensió.

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

La sortida de la tasca Checker és un fitxer Sarif i tant les extensions VS Code com Visual Studio estan disponibles per visualitzar i prendre 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ó