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 Canvas
- Aplicativos baseados em modelo
- 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: Iniciar, Exportar do Dev, Compilar e Release.
Observação
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
Microsoft Power Platform Ferramentas de Construção agora estão disponíveis para uso nas regiões GCC e GCC High.
Quais são as Ferramentas de Build do Microsoft Power Platform?
Ferramentas de Build do Microsoft Power Platform são uma coleção de tarefas de build específicas do Azure DevOps do Power Platform que eliminam a necessidade de fazer o download manual de ferramentas e scripts personalizados para gerenciar o ciclo de vida dos 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. As tarefas de build podem ser amplamente categorizadas 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. Power Platform Build Tools 2.0 é a versão que receberá manutenção e novos recursos serão adicionados.
Para versões anteriores do Power Platform Build Tools, faremos atualizações críticas de segurança conforme necessário. É altamente recomendável que os clientes mudem para o Power Platform Build Tools versão 2.0 o quanto antes.
Importante
Você não pode misturar e combinar versões de tarefas para ferramentas de build do Power Platform em seu pipeline de compilação.
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 |
|---|---|
| Principal de serviço via Federação de identidade de carga de trabalho (recomendado) | Usa autenticação baseada em princípio de serviço por meio de credenciais federadas. Recomendado para inquilinos que exigem autenticação multifator. |
| Principal de serviço e segredo do cliente | Usa autenticação baseada em princípio de serviço. |
| Nome de usuário/senha | 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 um service principal, 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 principal de serviço e segredo do aplicativo
Use o comando pac admin create-service-principal para criar e configurar a entidade de serviço a ser usada com as tarefas das Ferramentas de Build do Microsoft Power Platform.
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ória | Descrição |
|---|---|---|---|
environment |
env |
Sim | A ID ou URL do ambiente ao qual adicionar um usuário do aplicativo. |
role |
r |
Não | Nome ou ID do papel de segurança a ser aplicado ao usuário da aplicação. O valor padrão é: 'Administrador do Sistema'.
O Solution Checker requer uma função com privilégio prvAppendmsdyn_analysisjob para anexar à tabela msdyn_analysisjob. A função de Administrador do Sistema tem esse privilégio por padrão. |
Você pode usar assim:
C:\> pac admin create-service-principal --environment <environment id>
Quando o processo é bem-sucedido, quatro colunas são exibidas.
- 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.
Importante
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
Os meus pipelines antigos da Ferramenta de Build do Microsoft Power Platform continuarão funcionando?
Os pipelines mais antigos continuam funcionando, mas os recursos mais novos não serão adicionados às tarefas dos pipelines mais antigos. Se você quiser experimentar os recursos mais recentes, recomendamos fortemente que altere a versão de sua tarefa no pipeline.
Por que você baseou a nova tarefa no Power Platform CLI em vez de PowerShell?
As tarefas CLI do Power Platform são multiplataforma com grande flexibilidade, incluindo execução em executores Linux. Essas 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 para aplicativos orientados a canvas e modelo, agentes virtuais do Microsoft Copilot Studio, fluxos de UI 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 já tinha instalado a prévia das Ferramentas de Build - posso atualizar da prévia das Ferramentas de Build do Power Apps para as Ferramentas de Build do Power Platform?
Você não pode atualizar a partir da versão de visualização, pois tivemos que introduzir algumas alterações significativas na versão Geralmente Disponível. Para sair da versão de visualização, você precisa instalar as Ferramentas de Build do Microsoft Power Platform e, em seguida, recompilar ou reconfigurar seus pipelines existentes para usar as novas tarefas dessas ferramentas. Você também deve criar novas conexões de serviço.
Posso incluir aplicativos de fluxo e tela?
Sim, os fluxos e os aplicativos de tela reconhecem a solução, portanto, se esses componentes forem adicionados à sua solução, eles podem 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 das limitações atuais está disponível aqui 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, uma assinatura válida para Azure DevOps é necessária para utilizar as Ferramentas de Build. Mais informações estão disponíveis em Preços 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 instalar, provavelmente não terá os privilégios de instalação necessários em sua organização Azure DevOps. Mais informações disponíveis: Gerenciar permissões de extensão.
Como os desenvolvedores podem usar os resultados da tarefa Checker?
A saída da tarefa Verificador é um arquivo Sarif e ambas as extensões VS Code e Visual Studio estão disponíveis para exibição e ação em arquivos Sarif.
Confira também
Power Platform Build Tools for Azure DevOps notas de lançamento
Tarefas de ferramentas de construção
Labs de ferramentas de criação da Microsoft Power Platform