Criar um pipeline usando um host de pipelines personalizado
Os administradores do Power Platform podem criar um ou mais pipelines, associar qualquer número de ambientes e compartilhar o acesso com as pessoas que administram ou executam pipelines.
Pré-requisitos para host de pipelines personalizados
- Quatro ambientes são recomendados, mas você pode usar apenas três ambientes do Power Platform para criar um pipeline.
- Todos os ambientes usados em pipelines devem ter um banco de dados do Microsoft Dataverse.
- Você deve ter uma função de administrador do Power Platform ou administrador de sistema do Dataverse para instalar o aplicativo de pipelines.
- Todos os ambientes de destino usados em um pipeline devem ser ativados como Ambientes Gerenciados.
Crie ou escolha ambientes para pipelines
Antes de começar, você precisa identificar quais ambientes participam dos pipelines. Certifique-se de ativar todos os ambientes de destino como Ambientes Gerenciados. Ambientes Gerenciados não são necessários para o host de pipelines ou ambientes do desenvolvedor.
Ambiente de host. Este ambiente de finalidade especial atua como o plano de gerenciamento e armazenamento para todas as configurações, a segurança e o histórico de execuções dos pipelines.
- Recomendamos que você mantenha essa configuração como um ambiente de produção dedicado, separado dos ambientes de desenvolvimento e de destino.
- Se desejar, você pode configurar vários hosts diferentes em um locatário, por exemplo, para gerenciar pipelines separadamente para diferentes organizações comerciais ou localizações geográficas. Um host para todo o locatário também é aceitável, desde que todos os ambientes estejam na mesma localização geográfica.
Importante
A exclusão do ambiente de host exclui todos os pipelines e dados de execução. Tenha cuidado e entenda o impacto da perda de dados e configuração, bem como o acesso do criador aos pipelines hospedados no ambiente.
Ambiente de desenvolvimento. É nesse ambiente que você desenvolve soluções. Um pipeline pode ser executado de dentro de qualquer ambiente de desenvolvimento vinculado a ele.
Ambiente de destino. O ambiente de destino ao qual o pipeline é implantado. Por exemplo, teste de integração, teste de aceitação do usuário (UAT), produção e assim por diante.
Dica
Use nomes de ambiente que indiquem seu propósito. Por exemplo, Host da Contoso, Desenvolvimento da Contoso, QA da Contoso e assim por diante.
Instalar o aplicativo de pipelines no seu ambiente de host
Essa etapa só é obrigatória para a configuração de host inicial. Você pode pular para a próxima seção se já tiver acesso a um ambiente de host no qual criará pipelines.
- Entre no centro de administração do Power Platform, acesse Ambientes>Novo e crie um ambiente com o um banco de dados do Dataverse. Escolha a mesma região em que seus ambientes de desenvolvimento, QA e produção são criados.
- Instale o aplicativo Power Platform Pipelines no seu ambiente de host selecionando o ambiente de host, Recursos>Aplicativos do Dynamics 365.
- Selecione Instalar aplicativo e role dentro do painel direito até encontrar Power Platform Pipelines.
- Selecione Avançar, se concordar, aceite os termos e selecione Instalar.
Importante
Você só precisa instalar o aplicativo de pipelines de implantação no ambiente de host. Você não precisa instalá-lo em outros ambientes, como desenvolvimento, QA ou produção, que serão associados aos seus pipelines.
Depois de instalado, o aplicativo de configuração dos pipelines de implantação aparecerá na lista de aplicativos instalados.
Configurar um pipeline de implantação
Copie as IDs de ambiente de todos os Ambientes Gerenciados de desenvolvimento e de destino vinculados a pipelines. Você precisará desses IDs posteriormente. Mais informações: Localizar a ID do ambiente e da organização
Após a conclusão da instalação do pacote do Pipeline de Implantação, acesse o Power Apps e selecione o ambiente de host dedicado (onde você instalou o aplicativo).
Execute o aplicativo Configuração do Pipeline de Implantação.
Selecione Ambientes no painel esquerdo e, em seguida, selecione Novo para criar os registros de ambiente no Dataverse:
- Nome: insira o nome do registro de ambiente. É uma boa ideia incluir o mesmo nome do ambiente real, como Desenvolvimento Contoso.
- Tipo de Ambiente: selecione Ambiente de Desenvolvimento ou Ambiente de Destino. Selecione Ambiente de Desenvolvimento para todos os ambientes de origem onde soluções não gerenciadas serão desenvolvidas. Selecione o Ambiente de Destino para ambientes de QA e produção onde os artefatos de solução gerenciada são implantados.
- Id do ambiente: selecione a ID correta. Você pode encontrar a ID do ambiente atual em make.powerapps.com. Selecione o ícone Configurações na barra de comandos e, em seguida, selecione Recursos do desenvolvedor. Mais informações: Localizar a ID do ambiente e da organização
Selecione Salvar.
Atualize o formulário e verifique se o Status de Validação é igual a Sucesso.
Repita as etapas de 4 a 6 até que todos os ambientes que participam do pipeline tenham registros de ambiente criados.
Selecione Pipelines no painel de navegação esquerdo e, em seguida, selecione Novo para criar um novo pipeline de implantação:
- Nome: insira um nome para o pipeline, como Pipeline de Implantação Padrão da Contoso ou Pipeline de Hotfix da Contoso.
-
Descrição: como opção, insira uma descrição significativa do pipeline.
Na grade Ambientes de Desenvolvimento Vinculados, selecione Adicionar Ambiente de Desenvolvimento Existente e associe um ou mais ambientes de desenvolvimento. Um pipeline deve ter pelo menos um ambiente de desenvolvimento e um estágio antes de poder ser executado.
Na grade Estágios de Implantação, selecione Novo Estágio de Implantação para exibir o painel de criação rápida.
Insira os detalhes para cada estágio e selecione Salvar e Fechar:
- Nome: o nome do estágio.
- Descrição (opcional): descrição opcional do estágio.
- Estágio de Implantação Anterior (opcional): especifica um estágio de implantação que deve ser implantado antes da implantação no estágio atual. Por exemplo, ao criar um estágio de produção, você pode adicionar o estágio de teste como o Estágio de Implantação Anterior. Para o primeiro estágio, ou pipelines que contenham apenas um estágio, este estágio deve ser deixado em branco.
- Ambiente de Implantação de Destino: é o ambiente de destino no qual esse estágio é implantado.
- Etapa de Pré-Implantação Obrigatória (opcional): as solicitações de implantação ficam pendentes até serem aprovadas pela lógica de negócios personalizada. Requer configuração adicional. Mais informações: Estender pipelines no Power Platform
Repita as duas etapas anteriores para cada estágio que deseja adicionar ao pipeline. Você deve ter pelo menos um estágio. Você pode adicionar até sete estágios.
Conceder acesso para editar ou executar pipelines
A segurança dos pipelines é gerenciada no ambiente de host por meio da atribuição de direitos de acesso. Além disso, atualmente, os usuários devem ter acesso a todos os ambientes associados a um pipeline para criar ou executar o pipeline.
Quando você instala o aplicativo de pipelines do Power Platform, duas funções de segurança são adicionadas:
- Usuário de Pipeline de Implantação: tem privilégios para executar pipelines que foram compartilhados com ele.
- Administrador de Pipeline de Implantação: tem controle total sobre toda a configuração do pipeline, sem precisar de associação de direito de acesso de administrador de sistema.
Compartilhar pipelines com criadores
O direito de acesso Usuário do Pipeline de Implantação concede acesso para executar um ou mais pipelines. Ele não concede acesso para criar, editar ou excluir pipelines. Os usuários com o direito de acesso Usuário do Pipeline de Implantação não podem exibir o ambiente do host dentro do seletor de ambiente no Power Apps ou Power Automate, ou de outra forma, precisam estar cientes dele.
Para compartilhar pipelines:
- Atribua aos criadores o direito de acesso Usuário do Pipeline de Implantação no ambiente de host. Esse direito de acesso é instalado com o aplicativo Power Platform Pipelines. Mais informações: Atribuir um direito de acesso a um usuário
- No aplicativo de configuração do pipeline de implantação, compartilhe o registro do pipeline com criadores (ou grupos do Microsoft Entra). O privilégio de Leitura é suficiente para exibir e executar um pipeline no ambiente de desenvolvimento. Mais informações: Compartilhar linhas com um usuário ou uma equipe
- Os criadores também devem ter privilégios para exportar soluções dos ambientes de desenvolvimento de origem, bem como privilégios para importar soluções para os ambientes de teste e produção de destino nos quais o pipeline é implantado. Por padrão, as funções de personalizador do sistema e criador de ambiente têm esses privilégios.
Compartilhar com administradores de pipelines
O direito de acesso Administrador do Pipeline de Implantação concede privilégios totais a todos os pipelines (e tabelas, que armazenam informações sobre os pipelines) no ambiente de host. A função também concede acesso para executar todos os pipelines associados ao host atual. O direito de acesso Administrador do Pipeline de Implantação não concede privilégios para executar outras atividades no ambiente de host.
Importante
Os administradores de pipelines também devem ter acesso a todos os ambientes de desenvolvimento, teste e produção associados aos pipelines que eles criam ou executam.
Atribua o direito de acesso Administrador do Pipeline de Implantação a usuários ou grupos do Microsoft Entra no ambiente de host. Esse direito de acesso é instalado com o aplicativo Power Platform Pipelines. Mais informações: Atribuir um direito de acesso a um usuário
Atribuindo funções de pipeline por meio de Equipes de Segurança no aplicativo Configuração do pipeline de implantação
Como Administrador de Pipeline de Implantação, você pode atribuir facilmente funções de Pipelines prontas para uso no aplicativo Configuração de Pipeline de Implantação:
- Execute o aplicativo Configuração de Pipeline de Implantação.
- Selecione Equipes de Segurança em Configurações no painel de navegação esquerdo.
Há três equipes:
- Administradores de Pipeline de Implantação. Esses usuários têm acesso total a todos os pipelines e podem usar o aplicativo Configuração do Pipeline de Implantação.
- Criadores de Pipeline de Implantação. Esses usuários podem criar e consumir pipelines pessoais que são gerenciados no host personalizado. Se um criador precisar usar um pipeline compartilhado, recomendamos que o usuário receba a função Usuários do Pipeline de Implantação para obter acesso a artefatos compartilhados e execuções de estágio compartilhado.
- Usuários de Pipeline de Implantação. Esses usuários podem disparar um pipeline que é compartilhado com eles. Os Usuários do Pipeline de implantação também têm acesso de leitura a todas as execuções de estágio de implantação na mesma unidade de negócios.
Usando um pipeline com outros ambientes de desenvolvimento que ainda não estão associados
Se um usuário tiver acesso de escrita em um determinado pipeline, ele poderá associar outros ambientes de desenvolvimento a esse pipeline na experiência de Pipelines.
Escolha o pipeline criado no menu suspenso. Quando você seleciona Avançar na primeira etapa do processo de configuração de implantação, o ambiente atual é vinculado ao pipeline (e ao host, se ainda não estiver) como um ambiente de desenvolvimento.
Isso será útil se você tiver o mesmo processo de pipeline para um ambiente de desenvolvimento adicional. Por exemplo, seus ambientes de UAT e produção são os mesmos para outro ambiente de origem. Você pode reutilizar o pipeline que já criou ou ao qual recebeu acesso de gravação.
Gerenciar e monitorar centralmente as implantações
O aplicativo de configuração de pipeline e o ambiente de host fornecem muitos outros benefícios, como:
- Exibir centralmente todas as atividades de implantação. Exibições filtradas também são acessíveis na experiência do criador para um determinado pipeline e solução.
- Auditar onde uma determinada versão da solução é implantada, bem como quem iniciou a solicitação.
- Exibir logs de erro, resultados de validação e configurações de implantação. Variáveis de ambiente e conexões são fornecidas durante a implantação.
- Reter backups de todos os artefatos de soluções por versão.
- Agendar trabalhos de exclusão em massa para remover dados indesejados e conservar a capacidade do banco de dados. Mais informações: Remover uma grande quantidade de dados específicos de destino com exclusão em massa
- Usar um painel para visualizar as métricas de implantação. Você também pode criar seus próprios relatórios usando dados armazenados no host.
Acesso ao aplicativo Configuração de Pipeline de Implantação do Power Apps
Na página Pipelines em qualquer solução, o comando Gerenciar pipelines na barra de comandos navega até o aplicativo de configuração do host de pipelines associado ao ambiente atual:
- Se o ambiente atual estiver associado a um host de pipelines personalizado, o botão será vinculado ao aplicativo Configuração do Pipeline de Implantação no ambiente de host dedicado.
- Se o ambiente atual estiver associado ao host da Plataforma, o botão será vinculado a um aplicativo de Configuração do Pipeline de Implantação dentro do Power Apps.
O aplicativo Configuração do Pipeline de Implantação pode ser acessado por qualquer pessoa com a função Administrador do Pipeline de Implantação, se estiver usando um host personalizado, e por qualquer administrador de locatário do aplicativo associado ao host da plataforma.
Desassociando manualmente ambientes de um host e associando-os a outro host
- De Power Apps (make.powerapps.com), comece em um ambiente que deseja desassociar e selecione Soluções.
- Escolha qualquer solução à qual você tenha acesso e selecione-a.
- Navegue até a página Pipelines no painel de navegação esquerdo e selecione Gerenciar pipelines na barra de comandos. Se você estiver começando com um host personalizado, também poderá ir diretamente para o ambiente de host dedicado e executar o aplicativo Configuração do Pipeline de Implantação de lá.
- Agora que você está no aplicativo Configuração do Pipeline de Implantação, vá para Ambientes no painel de navegação esquerdo.
- Na tabela Ambientes de Implantação Adicionados mostrada por padrão, selecione os registros de ambiente para os ambientes que você deseja desassociar deste host.
- Selecione Excluir na barra de comandos e confirme a exclusão.
- Para associar os ambientes excluídos ao novo host, repita as etapas 1 a 4, mas no contexto do host desejado ao qual associar os ambientes.
- Na tabela Ambientes de Implantação Adicionados mostrada por padrão, selecione Novo na barra de comandos.
- Crie o registro do ambiente atribuindo um nome, tipo, ID do ambiente e descrição opcional.
Agora você pode vincular os ambientes a pipelines no novo host.
Usar o Force Link para associar um ambiente a um novo host
Depois de criar um registro de ambiente no aplicativo Configuração de Pipeline de Implantação, você pode encontrar uma mensagem de erro indicando "este ambiente já está associado a outro host de pipelines". Para assumir a associação, resultando na desvinculação do ambiente no host anterior e em um link bem-sucedido para o novo host, selecione Force Link na barra de comandos.
Importante
- Os criadores perdem o acesso a qualquer pipeline no host anterior que estava acessível nesse ambiente quando você executa essa ação em um ambiente de desenvolvimento (origem).
- Essa ação pode ser desfeita executando um Force Link no host anterior.
- O registro do ambiente no host anterior terá um status de validação obsoleta até que seja atualizado, portanto, será mostrado como Bem-sucedido, a menos que seja atualizado.