Partilhar via

Configurar o ALM Accelerator manualmente

  • Artigo

Pode configurar os componentes do ALM Accelerator for Power Platform utilizando a aplicação de administração que o acompanha ou manualmente. Este artigo orienta-o através da configuração da aplicação manualmente e está estruturado em sete secções:

Pré-requisitos

Antes de instalar o ALM Accelerator for Power Platform, certifique-se de que cumpre os seguintes pré-requisitos.

  • O ALM Accelerator tem de ser instalado num ambiente do Power Platform que tenha uma base de dados do Microsoft Dataverse. Todos os ambientes que utilizam o ALM Accelerator para implementar soluções também requerem uma base de dados do Dataverse.

    Nota

    O ALM Accelerator não é compatível com o Dataverse for Teams. Tanto a aplicação ALM Accelerator como os pipelines associados, assumem que está a utilizar a versão completa do Dataverse em todos os ambientes.

    Recomendamos que instale o ALM Accelerator no mesmo ambiente que outras soluções do Kit de Iniciação CoE. Obter mais informações sobre como determinar a melhor estratégia para a sua organização:

  • O ALM Accelerator utiliza o Azure DevOps para o controlo de origens e implementações. Se não tiver uma organização do Azure DevOps, inscreva-se gratuitamente para até cinco utilizadores no site do Azure DevOps.

  • Para completar os passos nesta secção, precisa dos seguintes utilizadores e permissões no Azure, Azure DevOps e Power Platform:

    • Um utilizador do Azure licenciado com permissões para criar e ver grupos do Microsoft Entra, criar registos de aplicações e conceder consentimento do administrador para registos de aplicações no Microsoft Entra ID
    • Um utilizador do Azure DevOps licenciado com permissões para criar e gerir pipelines, ligações de serviço, repositórios e extensões
    • Um utilizador do Power Platform licenciado com permissões para criar utilizadores de aplicações e conceder-lhes permissões administrativas

  • Têm de estar disponíveis os seguintes conectores para serem utilizados em conjunto no ambiente em que o ALM Accelerator é importado.

  • Instale o Kit para Criadores no ambiente onde instala o ALM Accelerator.

Configuração da fundação

Os passos que se seguem são gerais para a funcionalidade do ALM Accelerator e não são específicos de qualquer projeto ou solução.

Criar um registo de aplicação no seu ambientes do Microsoft Entra

Crie um registo de aplicação para o ALM Accelerator para conceder permissões à aplicação e aos pipelines associados as permissões necessárias para realizar operações no Azure DevOps e Power Apps ou Dataverse. Só precisa de fazer isto uma vez.

Os passos que se seguem mostram como criar um registo de uma única aplicação com permissões para ambos o Dataverse e o Azure DevOps. No entanto, pode querer criar registos de aplicações separados para dividir responsabilidades. Deverá considerar a forma como os registos de aplicações separados afetam a manutenção e a segurança antes de decidir uma estratégia de registo de aplicações.

Criar o registo de aplicações

  1. Inicie sessão no portal do Azure.

  2. Selecione Microsoft Entra ID>Registos de aplicações.

  3. Selecione + Novo registo e, em seguida, dê ao registo um nome, como ALMAcceleratorServicePrincipal.

  4. Deixe todas as outras opções nos respetivos valores predefinidos e selecione Registar.

Adicionar permissões ao registo da aplicação

  1. No painel do lado esquerdo, selecione Permissões da API.

  2. Selecione + Adicionar uma permissão.

  3. Selecione Dynamics CRM e, em seguida, selecione Permissões delegadas e user_impersonation.

  4. Selecione Adicionar permissões para adicionar a permissão de user_impersonation da API Dynamics CRM ao registo da aplicação.

  5. Selecione + Adicionar uma permissão novamente.

  6. Selecione o separador APIs que a minha organização utiliza. Pesquise por e selecione PowerApps-Advisor e, em seguida, selecione Permissões delegadas e Analysis.All (o consentimento de administrador não é obrigatório).

    Esta permissão é obrigatória para executar a análise estática através do verificador de aplicações.

  7. Selecione Adicionar permissões para adicionar a permissão de Analysis.All da API PowerApps-Advisor ao registo da aplicação.

  8. Selecione + Adicionar uma permissão novamente.

  9. No separador APIs da Microsoft ou no separador APIs que a minha organização utiliza, selecione Azure DevOps e, em seguida, selecione Permissões delegadas e user_impersonation.

    Esta permissão é necessária para a ligação ao Azure DevOps através do conector personalizado na aplicação ALM Accelerator.

  10. Se adicionou a permissão do Azure DevOps a partir do separador APIs que a minha organização utiliza, copie o ID da aplicação (cliente) para utilização posterior neste procedimento.

    Irá utilizar isto como o ID da Aplicação DevOps (cliente), que é diferente do ID da Aplicação (cliente) que copiará posteriormente neste procedimento.

    Captura de ecrã da janela Pedir permissões da API, com o separador APIs que a minha organização utiliza e ID da Aplicação (cliente) realçados.

    Se não conseguir encontrar a permissão do Azure DevOps no separador APIs que a minha organização utiliza, siga estes passos para obter o ID da Aplicação DevOps (cliente):

    1. Abra uma janela privada no browser e aceda a https://dev.azure.com/<your devops organization>/_apis.
    2. Na página de início de sessão, copie o valor do parâmetro client_id no URL.

    Captura de ecrã de uma página de início de sessão da organização do Azure DevOps, com o parâmetro client_id no URL realçado.

  11. Selecione Adicionar permissões para adicionar a permissão de user_impersonation da API Azure DevOps ao registo da aplicação.

  12. Selecione Conceder consentimento do administrador <ao seu inquilino>.

Configurar o segredo do cliente e o URI de redirecionamento

  1. No painel do lado esquerdo, selecione Certificados & segredos.

  2. Selecione + Novo segredo do cliente.

  3. Selecione uma data de expiração e, em seguida, selecione Adicionar.

  4. Copie o Valor do segredo do cliente para utilização posterior. Esta é a única altura em que pode copiar o valor. Certifique-se de que o faz antes de sair da página.

  5. No painel do lado esquerdo, selecione Descrição geral.

  6. Copie o ID da Aplicação (cliente) e o ID do Diretório (inquilino).

  7. Selecione Configurar.

Conceder permissão de Gestão de Power App ao seu registo da aplicação

Conceda permissões de Gestão de Power App ao seu registo da aplicação para que os pipelines possam realizar as ações necessárias nos respetivos ambientes. Para tal, execute o seguinte cmdlet do PowerShell como um utilizador interativo que tenha privilégios administrativos do Power Apps. Só necessita de executar este comando uma vez, depois de criar o seu registo da aplicação.

Importante

O cmdlet do PowerShell seguinte concede permissões elevadas ao registo da aplicação, como Administrador do Power Platform. As políticas de segurança da sua organização poderão não permitir estes tipos de permissões. Certifique-se de que têm permissão antes de continuar. Se não tiverem permissão, determinadas capacidades não funcionam em pipelines do ALM Accelerator.

Install-Module -Name Microsoft.PowerApps.Administration.PowerShell
Install-Module -Name Microsoft.PowerApps.PowerShell -AllowClobber
New-PowerAppManagementApp -ApplicationId <the Application (client) ID you copied when you created the app registration>

Instalar extensões do Azure DevOps

O ALM Accelerator utiliza várias extensões do Azure DevOps, incluindo algumas extensões de terceiros que estão disponíveis no marketplace do Azure DevOps. O site de cada extensão de terceiros e uma ligação para o respetivo código de origem são fornecidos nas instruções que se seguem. Saiba como avaliar um editor de extensões do Marketplace.

  1. Iniciar sessão no Azure DevOps.

  2. Selecione Definições da organização.

  3. Selecione Geral>Extensões.

  4. Pesquise pelas seguintes extensões e instale-as:

Clonar os pipelines de YAML do GitHub para a sua instância do Azure DevOps

  1. Aceda a https://aka.ms/coe-alm-accelerator-templates-latest-release e copie o URL da versão mais recente.

  2. Iniciar sessão no Azure DevOps.

  3. Crie um projeto ou selecione um projeto existente.

  4. Selecione Repositórios e, em seguida, selecione Importar repositório na lista de repositórios.

  5. Cole o URL que copiou no passo 1 como Clonar URL e, em seguida, selecione Importar.

  6. Confirme se o ramo predefinido para o repositório é principal. Selecione Repositórios e Ramos e certifique-se de que o ramo principal tem a etiqueta de predefinido.

    Se não tiver, selecione os três pontos verticais (⋮) correspondentes ao ramo principal e, do menu Mais opções, selecione Predefinir ramo.

    Nota

    Este repositório é onde os modelos de pipeline de solução e os pipelines de exportação/importação são executados. Mais tarde, quando criar os pipelines para as suas soluções, poderá ter de consultar este projeto e repositório específicos se optar por utilizar um repositório diferente para controlar a origem das suas soluções.

Criar pipelines para importação, eliminação e exportação de soluções

Crie pipelines de importação, eliminação e exportação com base no YAML no repositório do Azure DevOps. Estes pipelines são executados quando utiliza a aplicação para consolidar uma solução para Git, importar uma solução ou eliminar uma solução.

Nota

Se esperar que todas as suas exportações efetuem as mesmas ações independentemente da solução para a qual o pipeline está a executar, pode criar um único pipeline de exportação, como descrito nesta secção. No entanto, poderá ser necessário exportar ações diferentes com base na solução. Nesse caso, pode anexar o nome da solução ao pipeline export-solution-to-git, tal como export-solution-to-git-SampleSolution, para que a aplicação execute os seus pipelines de solução específicos quando efetua as ações na aplicação.

A tabela seguinte mostra a correspondência entre o ficheiro YAML no repositório e o pipeline que o acompanha.

YAML file Nome do pipeline
export-solution-to-git.yml export-solution-to-git
import-unmanaged-to-dev-environment.yml import-unmanaged-to-dev-environment
delete-unmanaged-solution-and-components.yml delete-unmanaged-solution-and-components

  1. No Azure DevOps, vá a Pipelines>Criar um Novo Pipeline.

  2. Selecione Git de Repositórios do Azure para o seu repositório de códigos e, em seguida, aponte para o repositório do Azure DevOps que criou e propagou com os modelos de pipeline nos passos anteriores.

  3. Na página Configurar o seu pipeline, selecione Ficheiro YAML de Pipelines do Azure Existente e aponte para /Pipelines/export-solution-to-git.yml, /Pipelines/import-unmanaged-to-dev-environment.yml ou /Pipelines/delete-unmanaged-solution-and-components.yml.

  4. Selecione Continuar e, em seguida, selecione Guardar.

  5. Selecione o menu Mais (...) junto de Executar Pipeline e, em seguida, selecione Mudar o nome/Mover.

  6. Altere o nome do pipeline para export-solution-to-git, import-unmanaged-to-dev-environment ou delete-unmanaged-solution-and-components, como apropriado.

  7. Selecione Guardar.

Criar variáveis de pipeline de exportação (opcional)

Poderá definir variáveis de pipeline no pipeline export-solution-to-git para controlar que informações persistem no controlo de origens. Para aplicar estas definições globalmente, pode definir as variáveis no seu pipeline export-solution-to-git. Para aplicar estas definições a soluções específicas aquando da exportação, crie um pipeline de exportação da sua solução, conforme descrito na nota da secção anterior e defina as variáveis nesse pipeline.

Para se certificar de que os valores atuais das variáveis de ambiente nunca são consolidados com o controlo de origens durante o processo de exportação, crie a variável DoNotExportCurrentEnvironmentVariableValues no seu pipeline export-solution-to-git e defina o respetivo valor como True.

Importante

Esta variável de pipeline é recomendada para que possa utilizar a funcionalidade de configuração de implementação no ALM Accelerator.

Para se certificar de que os valores das variáveis de ambiente predefinidas específicas são definidas durante a exportação de uma solução, crie a variável VerifyDefaultEnvironmentVariableValues no seu pipeline export-solution-to-git e defina o respetivo valor como True. Defina os valores das variáveis de ambiente predefinidas no customDeploymentSettings.json, como descrito no guia de configuração de implementação.

  1. No Azure DevOps, selecione Pipelines>Biblioteca>Criar um novo Grupo de Variáveis.

  2. Atribua o novo grupo de variáveis alm-accelerator-variable-group, exatamente como fornecido aqui.

    Os pipelines consultam este grupo de variáveis específico, pelo que tem de ser chamado exatamente como mostrado. Se decidir usar uma convenção de nomenclatura diferente para o seu grupo de variáveis, precisa de modificar partes dos pipelines para consultarem o nome que utiliza.

  3. Adicione as variáveis que se seguem ao grupo de variáveis:

    Name Descrição valor
    AADHost O ponto final de autorização do Microsoft Entra Para clouds públicas, utilize login.microsoftonline.com. Para clouds de administração pública, utilize o URL de autorização apropriado.
    ProcessCanvasApps Se as aplicações de tela forem desembaladas durante a exportação ou embaladas durante compilações Se False, as aplicações de tela não são desembaladas durante a exportação ou embaladas durante compilações. Neste momento, a funcionalidade de desempacotar e empacotar está em pré-visualização e não é recomendado para utilização em ambientes de produção. No entanto, não pode ver o código de origem de telas no controlo de origem, a menos que esta variável seja definida como True.

  4. (Opcional) Se utilizar o Canvas studio test automation nos seus pipelines, adicione as variáveis seguintes ao grupo de variáveis:

    Name valor
    TestAutomationLoginMethod CloudIdentity
    TestAutomationMakerPortalUrl Normalmente, o URL do portal de criadores do Power Apps é *https://make.powerapps.com*
    TestAutomationUsername A conta de utilizador utilizada para executar os testes automatizados
    TestAutomationPassword A palavra-passe da conta de utilizador utilizada para executar os testes automatizados

  5. (Opcional) Por predefinição, as variáveis globais estão restritas e precisa de configurar o acesso a cada pipeline. Pode simplificar isto e permitir o acesso a qualquer pipeline. Sob o Grupo de variáveis (Pipelines>Biblioteca>alm-accelerator-variable-group), selecione Permissões do pipeline no menu superior, selecione (…) e, em seguida, selecione Acesso livre.

Definir permissões para o serviço de compilação do projeto

Importante

O Azure DevOps contém várias contas de "Serviço de Compilação" e pode ser confuso seguir os passos nesta secção. Preste muita atenção aos nomes e formatos especificados nos passos 3 e 5. Pode ter de pesquisar pela conta específica, se não aparecer na lista inicial.

  1. No Azure DevOps, selecione Definições do projeto.

  2. Selecione Repositórios>Segurança.

  3. Sob Utilizadores, pesquise por Serviço de Compilação de Coleção de Projetos (O Nome da Sua Organização) e selecione-o.

    Nota

    Poderá não ver O Nome da Sua Organização depois do utilizador do Serviço de Compilação de Coleção de Projetos. Pode ser apenas um identificador exclusivo. Neste caso, utilize a função de pesquisa para localizar o utilizador e, em seguida, selecione-o.

  4. Defina as seguintes permissões para o utilizador do serviço de compilação:

    Permissão valor
    Contribuir Permitir
    Contribuir para pedidos Pull Permitir
    Criar ramo Permitir
    Editar políticas Permitir

  5. Sob Utilizadores, pesquise pelo Serviço de Compilação de O Nome do Seu Projeto (O Nome da Sua Organização) e selecione-o.

  6. Defina os mesmos valores que no passo 4.

  7. Selecione Pipelines, selecione os três pontos (…) no canto superior direito e, em seguida, selecione Gerir Segurança.

  8. Defina as seguintes permissões para o utilizador do Serviço de Compilação do Nome do Seu Projeto (O Nome da Sua Organização):

    Permissão valor
    Editar pipeline de compilação Permitir
    Editar qualidade de compilação Permitir
    Gerir fila de compilação Permitir
    Substituir validação de dar entrada por compilação Permitir
    Atualizar informações de compilação Permitir
    Ver pipeline de compilações Permitir
    Ver compilações Permitir

  9. Selecione Definições do projeto>Conjuntos de agentes, selecione Segurança e, em seguida, selecione Adicionar.

  10. Pesquise pelo Serviço de Compilação de O Nome do Seu Projeto (O Nome da Sua Organização) e selecione-o.

  11. Defina a Função como Leitor.

  12. Selecione Adicionar.

  13. (Optional) Por predefinição, as permissões do pipeline para cada repositório são restritas e precisa de as configurar individualmente. Pode simplificar isto e permitir o acesso a qualquer pipeline. Sob Definições do Projeto>Repositórios, selecione cada repositório por vez. Selecione Segurança no menu superior. Localize o bloco Permissões do pipeline, selecione (…) e, em seguida, selecione Acesso livre.

Configuração do projeto de desenvolvimento

A secção seguinte guia-o através dos passos necessários para configurar cada um dos projetos de desenvolvimento que suporta. Neste contexto, um projeto de desenvolvimento é composto pela infraestrutura e configuração que suportam a gestão do ciclo de vida das aplicações (ALM), incluindo a configuração do seu ambiente do Dataverse que suporta o próprio processo ALM.

Criar ligações de serviço para que o Azure DevOps aceda ao Power Platform

Cada ambiente do Dataverse, desenvolvimento, validação, teste e produção, tem de ter uma ligação de serviço do Power Platform no Azure DevOps. Efetue os seguintes passos para cada um dos ambientes.

Nota

Os utilizadores da aplicação ALM Accelerator só vêem ambientes em que têm uma função de utilizador ou de administrador na ligação de serviço no Azure DevOps. Se trabalharem em ambientes de desenvolvimento pessoais, os criadores têm de ter uma função de utilizador ou de administrador na ligação de serviço para respetivo ambiente de programação. As ligações de serviço de ambiente de validação, teste e de produção, como o serviço de compilação, só necessitam de permissões concedidas aos pipelines.

  1. Inicie sessão no Azure DevOps e, em seguida, selecione o seu projeto.

  2. Selecione Definições do projeto>Ligações de serviço e, em seguida, selecione Criar ligação de serviço.

  3. Pesquise pelo tipo de ligação de serviço do Power Platform e selecione-o.

  4. Selecione Seguinte.

  5. Para URL do Servidor, introduza o URL do seu ambiente; por exemplo, https://myorg.crm.dynamics.com/.

    Importante

    Tem de incluir a barra à direita (/) no URL, ou seja, depois de .com, neste exemplo.

  6. Para Nome da Ligação de Serviço, introduza o mesmo URL que introduziu no passo 4, incluindo a barra à direita (/).

  7. Introduza o ID do Inquilino, o ID da Aplicação (cliente) e o Segredo do Cliente que copiou do Microsoft Entra quando criou o registo da aplicação.

  8. Selecione Conceder permissões de acesso a todos os pipelines.

  9. Selecione Guardar.

As ligações de serviço têm de fornecer permissões de utilizador a todos os utilizadores em todos os ambientes que os utilizadores necessitam de poder aceder a partir da aplicação (por exemplo, ambientes de criador).

  1. Na lista Ligações de Serviço, selecione a ligação de serviço a ser partilhada com os utilizadores.

  2. Selecione Mais (…) no canto superior direito e, em seguida, selecione Segurança.

  3. Na lista Grupo ou Utilizador, selecione o utilizador ou o grupo a que pretende fornecer permissões.

  4. Selecione Utilizador, selecione uma Função e, em seguida, selecione Adicionar.

Repita os passos nesta secção para cada um dos seus ambientes de programação, validação, teste e produção.

Definir as permissões para o serviço de compilação do projeto utilizar as ligações de serviço

  1. No Azure DevOps, selecione Definições do projeto>Ligações de serviço.

  2. Selecione (...) no canto superior direito, selecione Segurança e, em seguida, selecione Adicionar.

  3. Pesquise pelo Serviço de Compilação de O Nome do Seu Projeto (O Nome da Sua Organização) e selecione-o.

  4. Selecione a Função como Administrador e, em seguida, selecione Adicionar.

Criar um utilizador de aplicação nos seus ambientes do Dataverse

Crie um utilizador de aplicações nos seus ambientes para permitir que os pipelines se liguem ao Dataverse. Faça isto em cada ambiente em que pretende utilizar o ALM Accelerator onde implementar.

  1. Inicie sessão no centro de administração do Power Platform.

  2. Selecione o seu ambiente de programação e, em seguida, selecione Definições.

  3. Selecione Utilizadores + permissões>Utilizadores da aplicação.

  4. Selecione + Novo utilizador da aplicação.

  5. Selecione + Adicionar uma aplicação, selecione o registo de aplicação que criou anteriormente e, em seguida, selecione Adicionar.

  6. Selecione a Unidade de Negócio.

  7. Selecione o ícone de lápis à direita de Direitos de acesso e, em seguida, selecione direitos de acesso para o utilizador da aplicação.

    Recomendamos que conceda ao utilizador da aplicação privilégios de direito de acesso de administrador de sistema, para que o utilizador possa desempenhar as funções necessárias em cada ambiente.

  8. Selecione Criar.

Repita estes passos nos seus ambientes de validação, teste e produção.

Configuração da solução

Quando criar uma solução do Dataverse, tem de criar pipelines especificamente para essa solução. Os seguintes pipelines de amostra estão incluídos no diretório de Pipelines no repositório coe-alm-templates:

Os pipelines de amostra proporcionam flexibilidade para que as organizações armazenem os seus modelos de pipeline num projeto ou repositório separado YAML de pipeline específico da solução. Siga os passos nesta secção para configurar o pipeline da sua solução. Repita estes passos para cada solução para a qual está a utilizar o ALM Accelerator para controlar a origem.

Importante

O YAML para o seu pipeline de soluções é sempre armazenado no mesmo repositório que utiliza para controlar a origem da sua solução. No entanto, os modelos de pipeline, ou seja, a pasta Pipeline\Modelos, podem existir no mesmo repositório que o seu YAML de pipeline da solução ou num repositório ou projeto separado.

Criar pipelines de compilação e implementação de soluções

Os pipelines de soluções são utilizados para compilar e implementar as suas soluções controladas por origens para ambientes no seu inquilino. Os pipelines de amostra assumem que está a utilizar apenas três ambientes: validação, teste e produção. No entanto, pode criar quantos pipelines de solução precisar com base na estratégia de ambientes da sua organização.

Os pipelines de implementação de amostra são acionados por alterações num ramo (ou seja, teste e produção) ou como parte de uma política de ramo em Azure DevOps (ou seja, validação). Mais informações sobre a definição de políticas de ramos para validação de pedidos pull. Também pode executar pipelines manualmente, sem um acionador.

Siga os passos nesta secção para criar pipelines de implementação a partir do YAML de pipeline de amostra. A tabela seguinte descreve a configuração do pipeline.

Importante

O nome do pipeline tem de ser exatamente como mostrado na tabela seguinte, com o nome da sua solução em vez de MyNewSolution.

Nome do ficheiro YAML de Pipeline Nome do pipeline Política de ramo ativada Obrigatório
build-deploy-validation-MyNewSolution.yml deploy-validation-MyNewSolution Sim Sim
build-deploy-test-MyNewSolution.yml deploy-test-MyNewSolution Não Sim
build-deploy-prod-MyNewSolution.yml deploy-prod-MyNewSolution Não Não (Ir para a secção seguinte)

Nota

Os passos seguintes criam pipelines de compilação e implementação para os ambientes de validação, teste e produção. No entanto, pode querer compilar e implementar para validação e teste e, em seguida, implementar os artefactos da compilação de teste para produção. Se for esse o caso, siga os passos nesta secção apenas para os ambientes de validação e de teste. Em seguida, salte para Criar o pipeline de implementação de soluções para configurar o seu pipeline de versão.

Criar o ficheiro do pipeline

  1. Em Azure DevOps, vá ao repositório que contém a pasta de pipelines que cometeu e selecione a pasta Pipelines.

  2. Abra um dos três pipelines de implementação de amostra e copie o YAML a utilizar no seu novo pipeline.

  3. Anote o nome do repositório para utilização no seu pipeline.

  4. Vá ao repositório que pretende utilizar para controlo de origens para a sua solução.

  5. Crie um ramo com base no seu ramo predefinido e dê-lhe um nome para a solução; por exemplo, MyNewSolution.

    Este ramo tornar-se-á no próximo ramo de versão (v-next) para a sua solução. Todos os trabalhos de desenvolvimento têm de ser ramificados a partir deste ramo para o ramo de trabalho pessoal de um programador e, em seguida, unidos no ramo v-next, para emitir para validação e testes. Posteriormente, quando uma versão estiver pronta, o ramo v-next pode ser unido no ramo principal ou predefinido.

  6. Selecione Novo no menu superior e, em seguida, selecione Pasta.

  7. Dê à nova pasta o mesmo nome que deu à solução.

  8. Dê um nome ao novo ficheiro YAML de pipeline, como build-deploy-validation-SampleSolution.yml, build-deploy-test-SampleSolution.yml ou build-deploy-prod-SampleSolution.yml.

  9. Selecione Criar.

Atualize e guarde o ficheiro

  1. Cole o YAML que copiou no passo 2 na secção anterior para o novo ficheiro de pipeline.

  2. Altere os seguintes valores no novo YAML de pipeline:

    • Altere Recursos>Repositórios>Nome para o nome do repositório que contém os seus modelos de pipeline.

      Neste exemplo, o repositório é chamado de coe-alm-accelerator-templates e existe no mesmo projeto que o repositório MyNewSolution. Se o seu repositório de modelos estiver num projeto diferente do Azure DevOps, utilize o formato NomedoProjeto/NomedoRepositório. Também pode especificar um ramo para onde os seus modelos residem utilizando o parâmetro ref, se necessário.

    • Altere qualquer valor que se refira a SampleSolutionName para o nome exclusivo da sua solução; por exemplo, MyNewSolution.

  3. Selecione Consolidar para guardar as alterações.

  4. No Azure DevOps, vá a Pipelines e, em seguida, selecione Criar um Novo Pipeline.

  5. Selecione Git de Repositórios do Azure para o seu repositório de código.

  6. Selecione o Repositório de DevOps que contém o YAML de pipeline de implementação.

  7. Na página Configurar o seu pipeline, selecione Ficheiro YAML de Pipelines do Azure Existentes, aponte para o ficheiro YAML no repositório que criou anteriormente e, em seguida, selecione Continuar.

  8. Selecione Guardar, selecione (...) junto de Executar Pipeline e, em seguida, selecione Mudar o nome/Mover.

  9. Altere o nome do pipeline para deploy-validation-MyNewSolution, deploy-test-MyNewSolution ou deploy-prod-MyNewSolution, onde MyNewSolution é o nome da sua solução.

  10. Selecione Guardar.

  11. Se o novo pipeline não tiver sido criado no ramo predefinido do repositório: selecione Editar no pipeline. Selecione (...) no canto superior direito e, em seguida, selecione Acionadores. Selecione o separador YAML e selecione Obter Origens. Altere o Ramo predefinido para compilações manuais e agendadas para apontar para o seu ramo de solução. Mais informações sobre como configurar acionadores de pipeline.

  12. Repita os passos anteriores para criar um pipeline de implementação para cada um dos seus ambientes, referenciando o YAML de pipeline de implementação de amostra do repositório coe-alm-accelerator-templates (deploy-validation-SampleSolution.yml, deploy-test-SampleSolution.yml e deploy-prod-SampleSolution.yml).

  13. Selecione Guardar e Colocar em Fila e, em seguida, selecione Guardar.

Criar o pipeline de implementação de soluções (opcional)

Como referido anteriormente, os passos na secção anterior permitem-lhe criar pipelines que compilam e implementam para ambientes de validação, teste e produção. No entanto, pode criar um pipeline de implementação de soluções separado se pretender compilar e implementar apenas para validação e teste e, em seguida, implementar os artefactos da compilação de teste para produção.

Siga os passos nesta secção para criar um pipeline de implementação de soluções a partir do YAML de pipeline de amostra. A tabela seguinte descreve a configuração do pipeline.

Importante

O nome do pipeline tem de ser exatamente como mostrado na tabela seguinte, com o nome da sua solução em vez de MyNewSolution.

Nome do ficheiro YAML de Pipeline Nome do pipeline Política de ramo ativada
deploy-prod-MyNewSolution.yml deploy-prod-MyNewSolution Não

  1. Em Azure DevOps, vá ao repositório que contém a pasta de pipelines que cometeu e selecione a pasta Pipelines.

  2. Abra o pipeline de implementação de amostra deploy-prod-pipelineartifact-SampleSolution.yml e copie o YAML a utilizar no seu novo pipeline.

  3. Anote o nome do repositório para utilização no seu pipeline.

  4. Vá ao repositório que pretende utilizar para controlo de origens para a sua solução.

  5. Selecione Novo no menu superior e, em seguida, selecione Ficheiro.

  6. Dê um nome ao novo ficheiro YAML do pipeline; por exemplo, deploy-prod-MyNewSolution.yml, em que MyNewSolution é o nome da sua solução.

  7. Selecione Criar.

  8. Cole o YAML que copiou no passo 2 no novo ficheiro de pipeline.

  9. Altere os seguintes valores no novo YAML de pipeline:

    • Altere Acionador>Ramos>Incluir nos ramos em que as alterações deveriam acionar uma implementação para produção.

    • Altere Recursos>Repositórios>Nome para o nome do repositório que contém os seus modelos de pipeline.

      Neste exemplo, o repositório é chamado de coe-alm-accelerator-templates e existe no mesmo projeto que o repositório MyNewSolution. Se o seu repositório de modelos estiver num projeto diferente do Azure DevOps, utilize o formato NomedoProjeto/NomedoRepositório. Também pode especificar um ramo para onde os seus modelos residem utilizando o parâmetro ref, se necessário.

    • Atualize Recursos>Pipelines>Origem para especificar o pipeline de compilação que contém os artefactos que este pipeline deve implementar. Neste caso, irá implementar os artefactos do pipeline de teste que criou anteriormente, que criou e implementou a sua solução para o ambiente de teste.

    • Altere qualquer valor que se refira a SampleSolutionName para o nome exclusivo da sua solução; por exemplo, MyNewSolution.

  10. Repita os passos 11 a 20 na secção anterior para deploy-validation-ALMAcceleratorSampleSolution e deploy-test-ALMAcceleratorSampleSolution para criar um pipeline a partir do novo YAML de pipeline de produção denominado deploy-prod-ALMAcceleratorSampleSolution.

Definir variáveis de pipeline de implementação

Para cada pipeline de implementação que configurou anteriormente, tem de definir os valores das variáveis EnvironmentName e ServiceConnection com base no ambiente em que o pipeline é implementado. Também pode definir a variável EnableFlows para desativar fluxos do Power Automate como parte de uma implementação.

Criar variáveis de ambiente e de ligação de serviço (obrigatório)

Todos os pipelines de implementação requerem a variável de ambiente EnvironmentName e a variável de ligação de serviço ServiceConnection.

  • EnvironmentName especifica o ambiente do Azure DevOps que está a ser implementado, para permitir a monitorização do histórico de implementações e definir permissões e aprovações para a implementação em ambientes específicos. Defina este valor como Validar, Testar ou Produção, como apropriado.

  • ServiceConnection especifica a forma como o pipeline de implementação se liga ao Power Platform. Os valores permitidos são os nomes das ligações de serviço que criou anteriormente.

  1. Selecione Editar em cada um dos pipelines de implementação.

  2. Selecione Variáveis na definição do pipeline de implementação para abrir o editor de variáveis.

  3. Para adicionar a variável, selecione (+). Introduza o nome da variável e o valor apropriado.

Repita estes passos para criar as variáveis EnvironmentName e ServiceConnection.

Criar a variável EnableFlows (opcional)

Pode definir o valor de uma variável de pipeline chamada EnableFlows como False para ignorar os passos que permitem fluxos do Power Automate como parte de uma implementação. O valor predefinido da variável EnableFlows é True.

Definir políticas de ramos para validação de pedidos pull

Crie uma política de ramo para executar o pipeline que criou anteriormente quando é criado um pedido pull.

  1. No Azure DevOps, vá a Repositórios e, em seguida, selecione a pasta Ramos.

  2. Localize o ramo para o qual pretende criar a política de pedido pull. Selecione (...) à direita do ramo e, em seguida, selecione Políticas de Ramos.

  3. Na página Políticas de Ramos, vá a Validação da Compilação.

  4. Selecione + para adicionar uma nova política de ramo.

  5. Na lista Pipeline de compilação, selecione o pipeline que criou anteriormente.

  6. Especifique um Filtro de caminho, se aplicável, para se certificar de que apenas as alterações ao caminho especificado acionam o pipeline para o pedido pull.

  7. Defina o Acionador como Automático.

  8. Defina o Requisito da política como Obrigatório.

  9. Defina Expiração de compilação como Imediatamente.

  10. Defina um Nome a apresentar para a sua política de ramos; por exemplo, Validação de Compilação de RP.

  11. Selecione Guardar.

Captura de ecrã da seleção de definições para uma política de compilação de validação.

Definir permissões de acesso a recursos para pipelines

Os pipelines necessitam de acesso a recursos necessários, como repositórios, grupos de variáveis e ligações de serviço, para serem executados. Para permitir o acesso, tem três opções.

Conceder acesso durante a primeira execução

Pode permitir o acesso a um recurso necessário durante a primeira execução do pipeline.

  1. Acione o pipeline e abra a execução do pipeline no Azure DevOps.
  2. Selecione Ver na faixa "permissão necessária".
  3. Selecione Permitir para cada recurso necessário.

Conceder permissão explícita

Pode conceder permissão explícita para que um pipeline aceda a repositórios obrigatórios.

  1. No Azure DevOps, abra Definições do projeto.
  2. Selecione Repositórios e, em seguida, selecione um repositório.
  3. Selecione ao separador Segurança.
  4. Desloque-se para baixo até Permissões de pipeline e selecione +.
  5. Selecione o pipeline ao qual pretende conceder acesso ao repositório.

Pode conceder permissão explícita para que um pipeline aceda a grupos de variáveis obrigatórios.

  1. No Azure DevOps, selecione Pipelines>Biblioteca e, em seguida, selecione um grupo de variáveis.
  2. Selecione Permissões de pipeline.
  3. Selecione + e, em seguida, selecione o pipeline ao qual pretende dar acesso ao grupo de variáveis.

Pode conceder permissão explícita para que um pipeline aceda a ligações de serviço obrigatórias.

  1. No Azure DevOps, abra Definições do projeto.
  2. Selecione Ligações de Serviço e, em seguida, selecione uma ligação de serviço.
  3. Selecione Mais ações (...) e, em seguida, selecione Segurança.
  4. Desloque-se para baixo até Permissões de pipeline e selecione +.
  5. Selecione o pipeline a que pretende dar acesso à ligação de serviço.

Conceder acesso a todos os pipelines

Pode permitir que todos os pipelines, tanto os que tem agora como os que criar no futuro, acedam a repositórios obrigatórios.

  1. No Azure DevOps, abra Definições do projeto.
  2. Selecione Repositórios e, em seguida, selecione um repositório.
  3. Selecione ao separador Segurança.
  4. Desloque-se para baixo até Permissões de pipeline.
  5. Selecione Mais ações (...), selecione Acesso livre e, em seguida, confirme quando lhe for pedido.

Pode permitir que todos os pipelines acedam a grupos de variáveis obrigatórios.

  1. No Azure DevOps, selecione Pipelines>Biblioteca e, em seguida, selecione um grupo de variáveis.
  2. Selecione Permissões de pipeline.
  3. Selecione Mais ações (...), selecione Acesso livre e, em seguida, confirme quando lhe for pedido.

Pode permitir que todos os pipelines acedam a ligações de serviço obrigatórias.

  1. No Azure DevOps, abra Definições do projeto.
  2. Selecione Ligações de Serviço e, em seguida, selecione uma ligação de serviço.
  3. Selecione Mais ações (...) e, em seguida, selecione Segurança.
  4. Selecione uma ligação de serviço. selecione Mais ações (…) e, em seguida, selecione Segurança.
  5. Desloque-se para baixo até Permissões de pipeline.
  6. Selecione Mais ações (...), selecione Acesso livre e, em seguida, confirme quando lhe for pedido.

Definir o âmbito de autorização da Tarefa

O âmbito de autorização da Tarefa pode ser definido para toda a organização do Azure DevOps ou para um projeto específico. Desative a definição Limitar o âmbito de autorização da tarefa para o projeto atual para pipelines de lançamento, se escolher um projeto do Azure DevOps diferente para instalar os modelos.

Para definir o âmbito de autorização da tarefa ao nível da organização para todos os projetos

  1. No Azure DevOps, escolha Definições da organização > Pipelines > Definições.
  2. Desative a definição Limitar o âmbito de autorização da tarefa para o projeto atual para pipelines de lançamento.

Criar uma configuração de implementação (opcional)

Necessita de criar várias configurações num ambiente de destino depois de uma solução ser implementada. Estas configurações são específicas do ambiente e incluem referências de ligação, variáveis de ambiente e permissões de definição para grupos do Microsoft Entra e equipas do Dataverse, para além da partilha de aplicações de tela e atualização da propriedade de componentes de solução, como fluxos do Power Automate. Juntamente com estas configurações, frequentemente, um ambiente de destino necessita de dados de amostra ou de configuração que estejam associados a tabelas do Dataverse na solução para proporcionar uma experiência ponto a ponto ALM completa.

Se a sua solução necessitar destas outras configurações ou dados, siga o guia de configuração de implementação para configurar os seus pipelines com base nos ambientes para os quais está a implementar.

Importar a solução e configurar a aplicação

Importe a aplicação de tela ALM Accelerator para o seu ambiente do Power Platform e, em seguida, configure o conector personalizado incluído para o Azure DevOps.

Instalar o ALM Accelerator no Dataverse

  1. A solução ALM Accelerator depende do Kit para Criadores. Instalar o Kit para Criadores agora.

  2. Transfira o ficheiro da solução gerida mais recentes a partir do GitHub. Desloque-se para baixo até Recursos e selecione CenterofExcellenceALMAccelerator_<versão mais recente>_managed.zip.

  3. Inicie sessão no Power Apps e, em seguida, selecione o ambiente onde pretende hospedar a aplicação ALM Accelerator.

  4. No painel do lado esquerdo, selecione Soluções.

  5. Selecione Importar solução>Navegar e, em seguida, navegue para a localização da solução gerida que transferiu e selecione o ficheiro.

  6. Selecione Seguinte e, depois, selecione Seguinte novamente.

  7. Na página Ligações, selecione ou crie uma ligação para ligar a Ligação CDS DevOps ao Dataverse.

    Quando cria uma ligação para HTTP com Microsoft Entra, utilize o Microsoft Graph para ambos os parâmetros.

  8. Selecione Importar.

Configurar o conector personalizado DevOps

  1. Selecione Dados>Conectores Personalizados>CustomAzureDevOps.

  2. Selecione Editar. Na página Segurança, selecione Editar e, em seguida, defina os campos que se seguem:

    Name valor
    Tipo de Autenticação OAuth 2.0
    Fornecedor de identidade Azure Active Directory
    ID de Cliente O ID da Aplicação (cliente) que copiou quando criou o registo da aplicação
    Segredo do cliente O Valor do segredo da aplicação (cliente) que copiou quando criou o registo da aplicação
    ID do Inquilino Deixe o valor predefinido, comum
    URL do Recurso O ID da Aplicação DevOps (cliente) que copiou quando adicionou permissões ao seu registo de aplicação
    URL de Redirecionamento Gera automaticamente. Se reparar na caixa de verificação "Atualizar para URL de redirecionamento exclusivo" abaixo do "URL de Redirecionamento", marque a caixa de verificação.

  3. Selecione Atualizar conector.

Adicionar o "URL de Redirecionamento" como "URL de Redirecionamento"

O "URL de Redirecionamento" gerado automaticamente a partir da secção acima tem de ser adicionado como o "URL de Redirecionamento" ao registo da aplicação.

  1. Regressar ao registo de aplicação que criou.

  2. No painel do lado esquerdo, selecione Descrição geral.

  3. Selecione Adicionar um URI de Redirecionamento.

  4. Selecione + Adicionar uma Plataforma e, em seguida, selecione Web.

  5. Na caixa de texto URL de Redirecionamento, cole o "URL de redirecionamento" gerado automaticamente copiado da secção acima.

  6. Selecione Configurar.

Testar o conector personalizado

  1. Abra o menu Teste.

  2. Selecione Nova Ligação e, em seguida, siga os pedidos para criar uma ligação.

  3. No Power Apps, selecione o seu ambiente e, em seguida, selecione Dataverse>Conectores Personalizados>CustomAzureDevOps.

  4. Selecione Editar, aceda à página Teste e, em seguida, localize a operação GetOrganizations.

  5. Selecione Testar operação.

  6. Confirme que o Estado da Resposta devolvido é 200 e que o Corpo da Resposta é uma representação JSON da sua organização do Azure DevOps.

    Captura de ecrã de testar definições de segurança para um conector do Azure DevOps personalizado.

Configurar criadores para utilizarem a aplicação ALM Accelerator

Mais informações