Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Use as Ferramentas de Build da Microsoft Power Platform para automatizar tarefas comuns de construção e implementação relacionadas com aplicações construídas na Microsoft Power Platform. Estas tarefas incluem:
- A sincronização de metadados de soluções (também conhecidos como metadados de soluções) que contém os diversos componentes da plataforma, tais como:
- Aplicações de envolvimento do cliente: Dynamics 365 Sales, Atendimento ao Cliente, Serviço de Campo, Marketing e Project Service Automation
- Aplicações Canvas
- Aplicativos orientados por modelo
- fluxos de IU
- Agentes virtuais
- Modelos do AI Builder
- Conectores entre ambientes de programação e o controlo de origem
- Gerar artefactos de compilação
- Implementar em ambientes a jusante
- Aprovisionar ou desaprovisionar ambientes
- Realizar verificações de análise estática contra soluções utilizando o serviço verificador do Power Apps
Use tarefas do Microsoft Power Platform Build Tools juntamente com quaisquer outras tarefas disponíveis do Azure DevOps para compor os seus pipelines de build e release. Os pipelines que as equipas normalmente colocam em vigor incluem Iniciar, Exportar do Desenvolvimento, Compilar e Publicar.
Observação
As Microsoft Power Platform Build Tools são suportadas apenas para um ambiente Microsoft Dataverse com base de dados. Mais informações: Criar um ambiente com uma base de dados
As Microsoft Power Platform Build Tools estão agora disponíveis para utilização nas regiões GCC e GCC High.
O que são as ferramentas de construção da Microsoft Power Platform?
As Microsoft Power Platform Build Tools são um conjunto de tarefas específicas de build Azure DevOps para Power Platform que eliminam a necessidade de descarregar manualmente ferramentas e scripts personalizados para gerir o ciclo de vida das aplicações construídas no Microsoft Power Platform.
Pode utilizar as tarefas individualmente, como importar uma solução para um ambiente a jusante, ou utilizadas em conjunto num pipeline para orquestrar um cenário, como gerar um artefacto de compilação, implementar para testar ou colher alterações do criador. Pode, em grande parte, categorizar as tarefas de construção em quatro tipos:
- Assistente
- Verificação de qualidade
- Solução
- Gestão do ambiente
Para mais informações sobre as tarefas disponíveis, consulte Microsoft Power Platform Build Tools.
O que é o Power Platform Build Tools versão 2.0?
Para além do que é proporcionado pelo Power Platform Build Tools, a versão 2.0 do Power Platform Build Tools baseia-se na CLI do Power Platform.
A versão 1.0 do Power Platform Build Tools baseia-se no PowerShell. O Power Platform Build Tools 2.0 é a versão à qual a Microsoft presta manutenção e adiciona novas funcionalidades.
Para versões anteriores do Power Platform Build Tools, a Microsoft fornece atualizações de segurança críticas conforme necessário. Migre para o Power Platform Build Tools versão 2.0 o mais rapidamente possível.
Important
Não podes misturar e combinar versões de tarefas para o Power Platform Build Tools no teu pipeline de build.
Obtenha as Ferramentas de Build da Microsoft Power Platform
Microsoft Power Platform Build Tools pode ser instalado na sua organização de Azure DevOps a partir de Azure Marketplace.
Após a instalação, todas as tarefas incluídas no Microsoft Power Platform Build Tools estarão disponíveis para serem adicionadas a qualquer pipeline novo ou existente. Pode encontrá-los pesquisando por "Power Platform".
Ligação a Ambientes
Para interagir com o ambiente da Microsoft Power Platform, deve estabelecer uma ligação para que as tarefas da ferramenta de construção possam realizar as ações necessárias. Estão disponíveis dois tipos de ligação:
| Tipo de ligação | Description |
|---|---|
| Principal de Serviço via Federação de Identidade de Carga de Trabalho (recomendado) | Utiliza a autenticação baseada no principal de serviço através de credenciais federadas. Recomendado para locatários que exigem autenticação multifator. |
| Principal de serviço e segredo do cliente | Usa autenticação baseada em entidade de serviço. |
| Nome de utilizador/palavra-passe | Uma ligação de serviço genérica com nome de utilizador e palavra-passe. Não suporta utilizadores que requerem autenticação multifator. |
Configurar as ligações do serviço com um principal de serviço
Para configurar uma ligação utilizando o principal de serviço, tem primeiro de ter um perfil do Power Platform autenticado com as permissões necessárias. Deve adicionar uma aplicação Microsoft Entra ID e o utilizador associado à aplicação ao ambiente Dataverse.
Criar principal de serviço e segredo do cliente
Use o comando pac admin create-service-principal para criar e configurar o principal de serviço para ser usado com as tarefas do Microsoft Power Platform Build Tools.
Este comando regista primeiro um objeto Application e o respetivo Nome Principal de Serviço (SPN) no Microsoft Entra ID. Depois, adiciona a aplicação como utilizador administrador ao inquilino da Microsoft Power Platform.
Este comando tem dois parâmetros:
| nome | nome abreviado | Obrigatório | Description |
|---|---|---|---|
environment |
env |
Yes | O ID ou URL do ambiente onde adicionar um utilizador da aplicação. |
role |
r |
No | Nome ou ID da função de segurança para aplicar ao utilizador da aplicação. O valor predefinido é: "Administrador de Sistema".
O Verificador de Soluções requer uma função com o privilégio prvAppendmsdyn_analysisjob para anexar à tabela msdyn_analysisjob. Por predefinição, a função de Administrador de Sistema tem este privilégio. |
Use o comando assim:
C:\> pac admin create-service-principal --environment <environment id>
Quando bem-sucedido, o comando mostra quatro colunas:
- Power Platform Identificador de Arrendatário
- ID da aplicação
- Segredo do Cliente (em texto não encriptado)
- Validade
Por exemplo:
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
Utilize as informações apresentadas para configurar a ligação ao serviço do Power Platform.
Important
Mantenha o segredo do cliente seguro e protegido. Uma vez que o prompt de comandos está apagado, não pode recuperar o mesmo segredo do cliente novamente.
Configurar o ambiente com o ID da Aplicação
Deve adicionar o ID da Aplicação como Utilizador de Aplicação no ambiente da Microsoft Power Platform ao qual está a conectar-se. Existem duas formas de o fazer.
- Pode rever este artigo: Criação de utilizador da aplicação.
- Pode utilizar o Power Platform CLI. Por exemplo:
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
Certifique-se de que o Utilizador da Aplicação adicionado tem a função de administrador de sistema atribuída (disponível em "Gerir Funções" nas definições de segurança para o utilizador da aplicação).
Perguntas mais frequentes (FAQ)
Os meus antigos pipelines do Microsoft Power Platform Build Tool vão continuar a funcionar?
Os pipelines mais antigos continuam a funcionar, mas as funcionalidades mais recentes não estão disponíveis nas tarefas mais antigas. Se quiseres usar as funcionalidades mais recentes, muda a versão da tua tarefa no pipeline.
Por que você baseou a nova tarefa na Power Platform CLI em vez de PowerShell?
As tarefas de CLI do Power Platform são multiplataforma com grande flexibilidade, incluindo o funcionamento em runners Linux. Estas tarefas são as mesmas que estão disponíveis com o Power Platform Actions para GitHub. Agora tens uma experiência consistente entre o Azure DevOps e o GitHub.
As Ferramentas de Compilação da Microsoft Power Platform funcionam apenas para Power Apps?
As ferramentas de compilação funcionam para aplicações de tela e aplicações orientadas por modelos, agentes virtuais do Microsoft Copilot Studio, UI Flows e fluxos tradicionais, AI Builder, conectores personalizados e fluxos de dados, todos os quais podem agora ser adicionados a uma solução. Esta lista inclui também aplicações de envolvimento do cliente (Dynamics 365 Sales, Atendimento ao Cliente, Serviço de Campo, Marketing e Project Service Automation). Estão disponíveis tarefas de compilação separadas para as aplicações Finanças e Operações.
Instalei anteriormente a versão preliminar do Build Tools - posso fazer a atualização da versão preliminar do Power Apps Build Tools para o Power Platform Build Tools?
Não podes atualizar a partir da versão de pré-visualização porque tivemos de introduzir algumas alterações significativas na versão disponível de forma geral (GA). Para sair da versão de pré-visualização, precisa de instalar as Microsoft Power Platform Build Tools e reconstruir os seus pipelines ou reconfigurar os seus pipelines existentes para usar as novas tarefas do Build Tools. Também deve criar novas ligações de serviço.
Posso incluir aplicações do Flow e do Canvas?
Sim, as apps de flows e canvas são conscientes da solução, por isso, se adicionar estes componentes à sua solução, eles podem participar no ciclo de vida da sua aplicação. No entanto, alguns passos continuam a requerer configurações manuais. A necessidade de configuração manual será abordada ainda este ano, quando introduzirmos variáveis de ambiente e conectores. Uma lista de limitações atuais está disponível no artigo Limitações Conhecidas .
Quanto custam as Microsoft Power Platform Build Tools?
As ferramentas de compilação estão disponíveis sem custos. No entanto, precisa de uma subscrição válida do Azure DevOps para usar as Ferramentas de Compilação. Para mais informações, consulte Pricing for Azure DevOps.
Posso ver a extensão, mas por que não tenho uma opção para instalá-la?
Se não vê a opção de instalação, provavelmente não tem os privilégios necessários de instalação na sua organização Azure DevOps. Para mais informações, consulte Gerenciar permissões de extensão.
Como os desenvolvedores podem usar os resultados da tarefa Checker?
A saída da tarefa Checker é um ficheiro SARIF. Tanto as extensões VS Code como Visual Studio estão disponíveis para visualização e ação em ficheiros SARIF.
Ver também
Notas de lançamento do Power Platform Build Tools para Azure DevOps
Criar tarefas de ferramentas
Laboratórios de Ferramentas de Desenvolvimento do Microsoft Power Platform