Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Use as Ferramentas de Build do Microsoft Power Platform para automatizar tarefas comuns de build e implantação relacionadas a aplicativos criados no Microsoft Power Platform. Essas tarefas incluem:
- Sincronizando os metadados da solução (também conhecidos como soluções) que contêm os vários componentes da plataforma, como:
- Aplicativos de envolvimento do cliente: Dynamics 365 Sales, Atendimento ao Cliente, Serviço de Campo, Marketing e Project Service Automation
- Aplicativos de tela
- Aplicativos baseados em modelos
- fluxos de interface do usuário
- Agentes virtuais
- modelos de AI Builder
- Conectores entre ambientes de desenvolvimento e controle de origem
- Geração de artefatos de compilação
- Implantação em ambientes downstream
- Provisionar ou desprovisionar ambientes
- Executando verificações de análise estática em soluções usando o serviço de verificador de Power Apps
Use as tarefas das Ferramentas de Build do Microsoft Power Platform com outras tarefas disponíveis do Azure DevOps para compor seus pipelines de build e desdobramento. Os pipelines que as equipes costumam colocar em prática incluem Iniciar, Exportar de Dev, Compilar e Liberar.
Note
Ferramentas de build do Microsoft Power Platform têm suporte apenas para um ambiente do Microsoft Dataverse com um banco de dados. Mais informações: Criar um ambiente com um banco de dados
O Microsoft Power Platform Build Tools já está disponível para uso nas regiões GCC e GCC High.
Quais são as Ferramentas de Build do Microsoft Power Platform?
As Ferramentas de Build do Microsoft Power Platform são uma coleção de tarefas de build do Azure DevOps específicas do Power Platform que eliminam a necessidade de fazer download manual de ferramentas e scripts personalizados para gerenciar o ciclo de vida de aplicativos criados no Microsoft Power Platform.
Você pode usar as tarefas individualmente, como importar uma solução para um ambiente downstream, ou juntas em um pipeline para orquestrar um cenário como gerar um artefato de compilação, implantar em teste ou fazer a coleta de alterações do criador. Você pode categorizar em grande parte as tarefas de build em quatro tipos:
- Auxiliar
- Verificação de qualidade
- Solução
- Gerenciamento de ambiente
Para obter mais informações sobre as tarefas disponíveis, consulte tarefas do Microsoft Power Platform Build Tools.
O que é o Power Platform Build Tools versão 2.0?
Além do que o Power Platform Build Tools fornece, a versão 2.0 do Power Platform Build Tools é baseada na CLI da Power Platform.
A versão 1.0 do Power Platform Build Tools é baseada no PowerShell. O Power Platform Build Tools 2.0 é a versão à qual a Microsoft dá suporte e adiciona novos recursos.
Para versões anteriores do Power Platform Build Tools, Microsoft fornece atualizações de segurança críticas, conforme necessário. Vá para o Power Platform Build Tools versão 2.0 o mais rápido possível.
Important
Não é possível misturar e combinar diferentes versões das tarefas do Power Platform Build Tools no seu pipeline de build.
Obter ferramentas de build do Microsoft Power Platform
As ferramentas de build do Microsoft Power Platform podem ser instaladas em sua organização no Azure DevOps do Azure Marketplace.
Após a instalação, todas as tarefas incluídas nas Ferramentas de Build do Microsoft Power Platform estarão disponíveis para serem adicionadas a qualquer pipeline novo ou existente. Para encontrá-las, procure por "Power Platform".
Conexão a ambientes
Para interagir com o ambiente Microsoft Power Platform, você deve estabelecer uma conexão para que as tarefas da ferramenta de build possam executar as ações necessárias. Há dois tipos conexões disponíveis:
| Tipo de conexão | Descrição |
|---|---|
| Entidade de Serviço via Federação de Identidade de Carga de Trabalho (recomendado) | Usa autenticação baseada na entidade de serviço por meio de credenciais federadas. Recomendado para inquilinos que exigem autenticação multifator. |
| Entidade de serviço e segredo do cliente | Usa autenticação baseada em entidade de serviço. |
| Nome de utilizador/palavra-passe | Uma conexão de serviço genérico com nome de usuário e senha. Não oferece suporte a usuários que exigem autenticação multifator. |
Configurar conexões de serviço usando um principal de serviço
Para configurar uma conexão usando uma entidade de serviço, você deve primeiro ter um perfil do Power Platform autenticado com as devidas permissões. Você deve adicionar um aplicativo Microsoft Entra ID e um usuário de aplicativo associado ao ambiente do Dataverse.
Criar entidade 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 uso com as tarefas do Microsoft Power Platform Build Tools.
Esse comando primeiro registra um objeto Application e um SPN (Nome da Entidade de Serviço) correspondentes em Microsoft Entra ID. Em seguida, adiciona o aplicativo como usuário administrador ao ambiente do Microsoft Power Platform.
Esse comando tem dois parâmetros:
| nome | nome curto | Obrigatório | Descrição |
|---|---|---|---|
environment |
env |
Sim | A ID ou URL do ambiente ao qual adicionar um usuário do aplicativo. |
role |
r |
No | Nome ou ID da função de segurança a ser aplicada ao usuário do aplicativo. O valor padrão é: 'Administrador do Sistema'.
O Verificador de Solução requer uma função com o privilégio prvAppendmsdyn_analysisjob para acrescentar à tabela msdyn_analysisjob. A função de Administrador do Sistema tem esse privilégio por padrão. |
Use o comando da seguinte maneira:
C:\> pac admin create-service-principal --environment <environment id>
Quando bem-sucedido, o comando exibe quatro colunas:
- Power Platform Id do Inquilino
- ID do Aplicativo
- Segredo do cliente (em texto não criptografado)
- Expiração
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
Use as informações exibidas para configurar a conexão de serviço do Power Platform.
Important
Mantenha o segredo do cliente seguro e protegido. Depois que o prompt de comando for limpo, você não poderá recuperar o mesmo segredo do cliente novamente.
Configure o ambiente com a ID do Aplicativo
Você deve adicionar a ID do aplicativo como usuário de aplicativo no ambiente de Microsoft Power Platform ao qual você está se conectando. Há duas maneiras de você fazer isto.
- Você pode revisar este artigo: Criação de usuário do aplicativo.
- Você pode usar 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
Verifique se o Usuário do Aplicativo adicionado tem a função de administrador do sistema atribuída (disponível em "Gerenciar Funções" nas configurações de segurança do usuário do aplicativo).
Perguntas frequentes (FAQs)
Os meus pipelines antigos da Ferramenta de Compilação do Microsoft Power Platform continuarão funcionando?
Os pipelines mais antigos continuam funcionando, mas os recursos mais recentes não estão disponíveis nas tarefas mais antigas. Se você quiser usar os recursos mais recentes, altere a versão da tarefa no pipeline.
Por que você baseou a nova tarefa no Power Platform CLI em vez de PowerShell?
As tarefas da CLI do Power Platform são multiplataforma e oferecem grande flexibilidade, inclusive podendo ser executadas em runners Linux. Essas tarefas são as mesmas tarefas disponíveis com o Power Platform Actions para GitHub. Agora você tem uma experiência consistente entre Azure DevOps e GitHub.
As Ferramentas de Build da Microsoft Power Platform funcionam apenas para Power Apps?
As ferramentas de build funcionam tanto para aplicativos de tela quanto para aplicativos baseados em modelo, agentes virtuais do Microsoft Copilot Studio, fluxos de interface do usuário (UI Flows) e fluxos tradicionais, AI Builder, conectores personalizados e fluxos de dados, todos os quais agora podem ser adicionados a uma solução. Essa lista também inclui aplicativos de participação do cliente (Dynamics 365 Sales, Atendimento ao Cliente, Serviço de Campo, Marketing e Project Service Automation). Tarefas de compilação separadas estão disponíveis para aplicativos de finanças e operações.
Eu havia instalado anteriormente a versão preliminar do Build Tools — posso fazer upgrade da versão preliminar do Power Apps Build Tools para o Power Platform Build Tools?
Você não pode atualizar da versão prévia porque tivemos que introduzir algumas alterações incompatíveis na versão de disponibilidade geral (GA). Para migrar da versão prévia, você precisa instalar o Microsoft Power Platform Build Tools e recriar seus pipelines ou reconfigurar os pipelines existentes para usar as novas tarefas do Build Tools. Você também deve criar novas conexões de serviço.
Posso incluir fluxo e aplicativos de tela?
Sim, fluxos e aplicativos de tela estão cientes da solução, portanto, se você adicionar esses componentes à sua solução, eles poderão participar do ciclo de vida do seu aplicativo. No entanto, algumas etapas ainda requerem configurações manuais. Algumas etapas ainda exigem configuração manual, que serão abordadas ainda este ano, quando introduzirmos as variáveis de ambiente e os conectores. Uma lista de limitações atuais está disponível no artigo Limitações conhecidas .
Quanto custam as Ferramentas de Build do Microsoft Power Platform?
As ferramentas de compilação estão disponíveis gratuitamente. No entanto, você precisa de uma assinatura válida do Azure DevOps para usar as Ferramentas de Build. Para obter mais informações, consulte Pricing para Azure DevOps.
Consigo ver a extensão, mas por que não tenho a opção de instalá-la?
Se você não vir a opção de instalação, provavelmente não terá os privilégios de instalação necessários em sua organização Azure DevOps. Para obter 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 arquivo SARIF. As extensões vs code e Visual Studio estão disponíveis para exibição e ação em arquivos SARIF.
Consulte Também
Notas sobre a versão do Power Platform Build Tools for Azure DevOps
Tarefas de ferramentas de construção
Laboratórios do Microsoft Power Platform Build Tools