Compartilhar via


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 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 em qualquer ambiente de desenvolvimento vinculado a ele.

  • Ambiente alvo. O ambiente de destino ao qual o pipeline é implantado. Por exemplo, teste de integração, teste de assistência ao 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.

  1. 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.
  2. Instale o aplicativo Power Platform Pipelines no seu ambiente de host selecionando o ambiente de host, Recursos>Aplicativos do Dynamics 365.
  3. Selecione Instalar aplicativo e role dentro do painel direito até encontrar Power Platform Pipelines.
  4. 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

  1. 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

  2. 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).

  3. Execute o aplicativo de configuração pipeline de implantação.

  4. 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: Select 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: certifique-se de Select o ID correto. 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
  5. Selecione Salvar.

  6. Atualize o formulário e verifique se o Status de Validação é igual a Sucesso.

  7. Repita as etapas de 4 a 6 até que todos os ambientes que participam do pipeline tenham registros de ambiente criados.

  8. 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 Contoso Padrão pipeline de implantação ou Contoso Hotfix Pipeline.
    • Descrição: Opcionalmente, insira uma descrição significativa para o pipeline. Ícone Novo pipeline
  9. 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. Ícone Adicionar ambiente de desenvolvimento

  10. Na grade Estágios de Implantação, selecione Novo Estágio de Implantação para exibir o painel de criação rápida. Ícone Etapas do pipeline

  11. Insira os detalhes para cada estágio e selecione Salvar e Fechar:

    • Nome: O nome do estágio.
    • Descrição (opcional): Descrição opcional para o 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: este é o ambiente de destino onde este estágio é implantado.
    • Pré-implantação etapa Obrigatório (opcional): As solicitações de implantação ficam pendentes até serem aprovadas por meio de lógica comercial personalizada. Requer configuração adicional. Mais informações: Estender pipelines no Power Platform
  12. 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.

Etapa de pré-implantação de pipelines obrigatória

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.

Ao instalar o aplicativo pipelines, duas funções de segurança são adicionadas: Power Platform

  • pipeline de implantação Usuário: Tem privilégios para executar pipelines que foram compartilhados com ele.
  • pipeline de implantação Administrador: Tem controle total sobre toda a configuração do pipeline, sem precisar ser membro do administrador do sistema direito de acesso.

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. Usuários com o usuário pipeline de implantação direito de acesso não podem visualizar o ambiente do host no seletor de ambiente em Power Apps ou Power Automate, ou precisam estar cientes disso.

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 visualizar e executar um pipeline de dentro do 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 de configuração pipeline de implantação

Como um pipeline de implantação Administrador, você pode atribuir funções de Pipelines prontas para uso facilmente no aplicativo pipeline de implantação Configuração :

  1. Execute o aplicativo pipeline de implantação Configuration .
  2. Select Equipes de segurança em Configurações no painel de navegação esquerdo.

There são três equipes:

  • Pipeline de implantação Administradores. Esses usuários têm acesso total a todos os pipelines e podem executar o aplicativo de configuração pipeline de implantação.
  • Pipeline de implantação Criadores. 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 pipeline de implantação Usuários para obter acesso a artefatos compartilhados e execuções de estágios compartilhados.
  • Usuários do pipeline de implantação. Esses usuários podem Gatilho um pipeline compartilhado com eles. Pipeline de implantação Os usuários também têm acesso de leitura a todas as execuções de estágios de implantação dentro da 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 gravação em um determinado pipeline, ele poderá associar outros ambientes de desenvolvimento a esse pipeline na experiência do Pipelines.

Escolha o pipeline criado no menu suspenso. Quando você Select Next no primeiro 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 é ú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 comando navega até o aplicativo de configuração do host de pipelines associado ao ambiente atual:

  1. 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.
  2. 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 de configuração pipeline de implantação pode ser acessado por qualquer pessoa com a função de administrador pipeline de implantação, se estiver usando um host personalizado, e qualquer administrador de locatário do aplicativo associado ao host da plataforma.

Desassociando manualmente ambientes de um host e associando-os a outro host

  1. De Power Apps (make.powerapps.com), comece em um ambiente que deseja desassociar e selecione Soluções.
  2. Escolha qualquer solução à qual você tenha acesso e selecione-a.
  3. 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á.
  4. Agora que você está no aplicativo pipeline de implantação Configuration , vá para Ambientes no painel de navegação esquerdo.
  5. 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.
  6. Selecione Excluir na barra de comandos e confirme a exclusão.
  7. Para associar os ambientes excluídos ao novo host, repita as etapas 1 a 4, mas no contexto do host desejado para associar os ambientes.
  8. Na tabela Ambientes de implantação adicionados mostrada por padrão, Select Novo na barra de comando.
  9. 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.

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.

Próximas etapas