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
- Aplicações condicionadas por modelos
- 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 Dev, Compilar e Lançamento.
Nota
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
Microsoft Power Platform Ferramentas de Construção estão agora disponíveis 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 do 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 subsequente, ou utilizadas em conjunto num pipeline para orquestrar um cenário, como gerar um artefacto de compilação, implantar para teste ou recolher alterações do maker. As tarefas de compilação podem ser amplamente categorizadas 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 que será servida e são adicionadas caraterísticas mais recentes.
Para as versões anteriores do Power Platform Build Tools, faremos as atualizações de segurança críticas, conforme necessário. Recomendamos vivamente que os clientes se mudem para o Power Platform Build Tools versão 2.0 assim que possível.
Importante
Não é possível combinar versões de tarefas para o Power Platform Build Tools no seu pipeline de compilação.
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 | Descrição |
|---|---|
| Entidade de Serviço via Federação de Identidade de Carga de Trabalho (recomendado) | Usa a autenticação baseada na entidade de serviço por meio 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 de serviço utilizando uma identidade 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 a 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 | Descrição |
|---|---|---|---|
environment |
env |
Sim | O ID ou URL do ambiente onde adicionar um utilizador da aplicação. |
role |
r |
Não | Nome ou ID da função de segurança a ser aplicada ao utilizador da aplicação. O valor predefinido é: "Administrador de Sistema".
O Verificador de Soluções requer um papel 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. |
Pode utilizá-lo desta forma:
C:\> pac admin create-service-principal --environment <environment id>
Se for bem-sucedido, são apresentadas quatro colunas:
- Power Platform Identificador de Arrendatário
- ID da aplicação
- Segredo do Cliente (em texto não encriptado)
- 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
Utilize as informações apresentadas para configurar a ligação ao serviço do Power Platform.
Importante
Mantenha o segredo do cliente seguro e protegido. Quando a linha de comandos estiver limpa, não poderá voltar a obter o mesmo segredo do cliente.
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 funcionalidades mais recentes não serão adicionadas às tarefas antigas. Se pretende utilizar as funcionalidades mais recentes, recomendamos vivamente que altere a versão da sua tarefa no pipeline.
Por que você baseou a nova tarefa na Power Platform CLI em vez de PowerShell?
As tarefas da CLI do Power Platform são compatíveis com várias plataformas, com grande flexibilidade, incluindo executar tarefas em executores do Linux. Estas são as mesmas tarefas que estão disponíveis com o Power Platform Actions para o 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 build funcionam tanto para aplicações canvas como orientadas a modelos, agentes virtuais do Microsoft Copilot Studio, UI Flows e fluxos tradicionais, AI Builder, conectores personalizados e fluxos de dados, todos agora adicionáveis 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.
Já tinha instalado a pré-visualização das Build Tools - posso atualizar da pré-visualização do Power Apps Build Tools para o Power Platform Build Tools?
Não pode atualizar a versão a partir da versão de pré-visualização, uma vez que introduzimos algumas alterações interruptivas na versão Geralmente Disponível. Para sair da versão de pré-visualização, tens de instalar as Microsoft Power Platform Build Tools e reconstruir os teus pipelines, ou reconfigurar os teus pipelines existentes para usar as novas tarefas do Build Tools. Também tem de criar novas ligações de Serviço.
Posso incluir aplicações do Flow e do Canvas?
Sim, fluxos e aplicativos de tela estão integrados à solução, assim, se esses componentes forem adicionados à sua solução, podem participar do 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. Está disponível uma lista de limitações atuais aqui: Limitações conhecidas.
Quanto custam as Microsoft Power Platform Build Tools?
As ferramentas de compilação estão disponíveis sem custos. No entanto, é necessária uma subscrição válida do Azure DevOps para utilizar as Ferramentas de Compilação. Mais informações estão disponíveis Preços para Azure DevOps.
Posso ver a extensão, mas por que não tenho uma opção para instalá-la?
Se não vir a opção install, então provavelmente não tem os privilégios necessários para instalação na organização Azure DevOps da sua. Mais Informações disponíveis Gerir permissões de extensão.
Como os desenvolvedores podem usar os resultados da tarefa Checker?
A saída da tarefa Checker é um ficheiro Sarif e tanto as extensões VS Code como Visual Studio estão disponíveis para visualização e ação em ficheiros Sarif.
Consulte também
Power Platform Build Tools para Azure DevOps notas de lançamento
Criar tarefas de ferramentas
Laboratórios de Ferramentas de Desenvolvimento do Microsoft Power Platform