Configurar o ALM Accelerator manualmente
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
- Configuração básica
- Configuração do projeto de desenvolvimento
- Configuração da solução
- Importar a solução e configurar o aplicativo
- Configurar criadores para usar o aplicativo ALM Accelerator
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.
- Dataverse (legado)
- HTTP
- Power Apps para Makers
- HTTP com Microsoft Entra ID (com acesso ponto final a https://graph.microsoft.com)
- DevOps Personalizado do ALM Accelerator (este conector é criado como parte da importação da solução do acelerador)
- Office 365 Utilizadores
- HTTP
Instale o Creator Kit no ambiente onde você 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
Inicie sessão no portal do Azure.
Selecione Microsoft Entra ID>Registos de aplicações.
Selecione + Novo registo e, em seguida, dê ao registo um nome, como ALMAcceleratorServicePrincipal.
Deixe todas as outras opções nos respetivos valores predefinidos e selecione Registar.
Adicionar permissões ao registo da aplicação
No painel do lado esquerdo, selecione Permissões da API.
Selecione + Adicionar uma permissão.
Selecione Dynamics CRM e, em seguida, selecione Permissões delegadas e user_impersonation.
Selecione Adicionar permissões para adicionar a permissão de user_impersonation da API Dynamics CRM ao registo da aplicação.
Selecione + Adicionar uma permissão novamente.
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.
Selecione Adicionar permissões para adicionar a permissão de Analysis.All da API PowerApps-Advisor ao registo da aplicação.
Selecione + Adicionar uma permissão novamente.
Microsoft Na guia APIs ou na guia APIs que minha organização usa , selecione Azure DevOps e 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.
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.
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):
- Abra uma janela privada no browser e aceda a
https://dev.azure.com/<your devops organization>/_apis
. - Na página de início de sessão, copie o valor do parâmetro client_id no URL.
- Abra uma janela privada no browser e aceda a
Selecione Adicionar permissões para adicionar a permissão de user_impersonation da API Azure DevOps ao registo da aplicação.
Selecione Conceder consentimento do administrador <ao seu inquilino>.
Configurar o segredo do cliente e o URI de redirecionamento
No painel do lado esquerdo, selecione Certificados & segredos.
Selecione + Novo segredo do cliente.
Selecione uma data de expiração e, em seguida, selecione Adicionar.
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.
No painel do lado esquerdo, selecione Descrição geral.
Copie o ID da Aplicação (cliente) e o ID do Diretório (inquilino).
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ão do Marketplace.
Iniciar sessão no Azure DevOps.
Selecione Definições da organização.
Selecione Geral>Extensões.
Pesquise pelas seguintes extensões e instale-as:
Power Platform Ferramentas de compilação (obrigatório): Esta extensão contém as tarefas de Microsoft compilação para Power Platform. (https://marketplace.visualstudio.com/items?itemName=microsoft-IsvExpTools.PowerPlatform-BuildTools)
Substituir tokens (obrigatório): Os pipelines usam essa extensão para substituir tokens em arquivos de configuração e armazenar valores seguros em variáveis privadas configuradas para um pipeline. (https://marketplace.visualstudio.com/items?itemName=qetza.replacetokens | https://github.com/qetza/vsts-replacetokens-task)
Guia SARIF SAST Scans (opcional): Use esta extensão para visualizar os arquivos SARIF que o verificador de solução gera durante uma compilação. (Separador de Digitalizações SARIF SAST – Marketplace do Visual Studio)
Clonar os pipelines de YAML do GitHub para a sua instância do Azure DevOps
Aceda a https://aka.ms/coe-alm-accelerator-templates-latest-release e copie o URL da versão mais recente.
Iniciar sessão no Azure DevOps.
Crie um projeto ou selecione um projeto existente.
Selecione Repositórios e, em seguida, selecione Importar repositório na lista de repositórios.
Cole o URL que copiou no passo 1 como Clonar URL e, em seguida, selecione Importar.
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 |
No Azure DevOps, vá a Pipelines>Criar um Novo Pipeline.
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.
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.
Selecione Continuar e, em seguida, selecione Guardar.
Selecione o menu Mais (...) junto de Executar Pipeline e, em seguida, selecione Mudar o nome/Mover.
Altere o nome do pipeline para export-solution-to-git, import-unmanaged-to-dev-environment ou delete-unmanaged-solution-and-components, como apropriado.
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.
No Azure DevOps, selecione Pipelines>Biblioteca>Criar um novo Grupo de Variáveis.
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.
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. (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 (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.
No Azure DevOps, selecione Definições do projeto.
Selecione Repositórios>Segurança.
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.
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 Sob Utilizadores, pesquise pelo Serviço de Compilação de O Nome do Seu Projeto (O Nome da Sua Organização) e selecione-o.
Defina os mesmos valores que no passo 4.
Selecione Pipelines, selecione os três pontos (…) no canto superior direito e, em seguida, selecione Gerir Segurança.
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 Selecione Definições do projeto>Conjuntos de agentes, selecione Segurança e, em seguida, selecione Adicionar.
Pesquise pelo Serviço de Compilação de O Nome do Seu Projeto (O Nome da Sua Organização) e selecione-o.
Defina a Função como Leitor.
Selecione Adicionar.
(Opcional) Por padrão, as permissões de pipeline para cada repositório são restritas e você precisa configurá-las 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.
Inicie sessão no Azure DevOps e, em seguida, selecione o seu projeto.
Selecione Definições do projeto>Ligações de serviço e, em seguida, selecione Criar ligação de serviço.
Pesquise pelo tipo de ligação de serviço do Power Platform e selecione-o.
Selecione Seguinte.
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.
Para Nome da Ligação de Serviço, introduza o mesmo URL que introduziu no passo 4, incluindo a barra à direita (/).
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.
Selecione Conceder permissões de acesso a todos os pipelines.
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).
Na lista Ligações de Serviço, selecione a ligação de serviço a ser partilhada com os utilizadores.
Selecione Mais (…) no canto superior direito e, em seguida, selecione Segurança.
Na lista Grupo ou Utilizador, selecione o utilizador ou o grupo a que pretende fornecer permissões.
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
No Azure DevOps, selecione Definições do projeto>Ligações de serviço.
Selecione (...) no canto superior direito, selecione Segurança e, em seguida, selecione Adicionar.
Pesquise pelo Serviço de Compilação de O Nome do Seu Projeto (O Nome da Sua Organização) e selecione-o.
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.
Inicie sessão no centro de administração do Power Platform.
Selecione o seu ambiente de programação e, em seguida, selecione Definições.
Selecione Utilizadores + permissões>Utilizadores da aplicação.
Selecione + Novo utilizador da aplicação.
Selecione + Adicionar uma aplicação, selecione o registo de aplicação que criou anteriormente e, em seguida, selecione Adicionar.
Selecione a Unidade de Negócio.
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.
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:
- https://github.com/microsoft/coe-alm-accelerator-templates/blob/main/Pipelines/build-deploy-validation-SampleSolution.yml
- https://github.com/microsoft/coe-alm-accelerator-templates/blob/main/Pipelines/build-deploy-test-SampleSolution.yml
- https://github.com/microsoft/coe-alm-accelerator-templates/blob/main/Pipelines/build-deploy-prod-SampleSolution.yml
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). Saiba mais sobre como definir políticas de ramificação para validação de solicitação 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
Em Azure DevOps, vá ao repositório que contém a pasta de pipelines que cometeu e selecione a pasta Pipelines.
Abra um dos três pipelines de implementação de amostra e copie o YAML a utilizar no seu novo pipeline.
Anote o nome do repositório para utilização no seu pipeline.
Vá ao repositório que pretende utilizar para controlo de origens para a sua solução.
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.
Selecione Novo no menu superior e, em seguida, selecione Pasta.
Dê à nova pasta o mesmo nome que deu à solução.
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.
Selecione Criar.
Atualize e guarde o ficheiro
Cole o YAML que copiou no passo 2 na secção anterior para o novo ficheiro de pipeline.
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.
Selecione Consolidar para guardar as alterações.
No Azure DevOps, vá a Pipelines e, em seguida, selecione Criar um Novo Pipeline.
Selecione Git de Repositórios do Azure para o seu repositório de código.
Selecione o Repositório de DevOps que contém o YAML de pipeline de implementação.
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.
Selecione Guardar, selecione (...) junto de Executar Pipeline e, em seguida, selecione Mudar o nome/Mover.
Altere o nome do pipeline para deploy-validation-MyNewSolution, deploy-test-MyNewSolution ou deploy-prod-MyNewSolution, onde MyNewSolution é o nome da sua solução.
Selecione Guardar.
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. Saiba mais sobre como configurar gatilhos de pipeline.
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).
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 |
Em Azure DevOps, vá ao repositório que contém a pasta de pipelines que cometeu e selecione a pasta Pipelines.
Abra o pipeline de implementação de amostra deploy-prod-pipelineartifact-SampleSolution.yml e copie o YAML a utilizar no seu novo pipeline.
Anote o nome do repositório para utilização no seu pipeline.
Vá ao repositório que pretende utilizar para controlo de origens para a sua solução.
Selecione Novo no menu superior e, em seguida, selecione Ficheiro.
Dê um nome ao novo ficheiro YAML do pipeline; por exemplo, deploy-prod-MyNewSolution.yml, em que MyNewSolution é o nome da sua solução.
Selecione Criar.
Cole o YAML que copiou no passo 2 no novo ficheiro de pipeline.
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.
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 Azure DevOps que está a ser implantado para habilitar o acompanhamento do histórico de implantação e definir permissões e aprovações para implantação em ambientes específicos. Defina este valor como Validar, Testar ou Produção, como apropriado.ServiceConnection
Especifica como o pipeline de implementação se conecta Power Platform. Os valores permitidos são os nomes das ligações de serviço que criou anteriormente.
Selecione Editar em cada um dos pipelines de implementação.
Selecione Variáveis na definição do pipeline de implementação para abrir o editor de variáveis.
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.
No Azure DevOps, vá a Repositórios e, em seguida, selecione a pasta Ramos.
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.
Na página Políticas de Ramos, vá a Validação da Compilação.
Selecione + para adicionar uma nova política de ramo.
Na lista Pipeline de compilação, selecione o pipeline que criou anteriormente.
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.
Defina o Acionador como Automático.
Defina o Requisito da política como Obrigatório.
Defina Expiração de compilação como Imediatamente.
Defina um Nome a apresentar para a sua política de ramos; por exemplo, Validação de Compilação de RP.
Selecione Guardar.
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.
- Acione o pipeline e abra a execução do pipeline no Azure DevOps.
- Selecione Ver na faixa "permissão necessária".
- 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.
- No Azure DevOps, abra Definições do projeto.
- Selecione Repositórios e, em seguida, selecione um repositório.
- Selecione ao separador Segurança.
- Desloque-se para baixo até Permissões de pipeline e selecione +.
- 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.
- No Azure DevOps, selecione Pipelines>Biblioteca e, em seguida, selecione um grupo de variáveis.
- Selecione Permissões de pipeline.
- 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.
- No Azure DevOps, abra Definições do projeto.
- Selecione Ligações de Serviço e, em seguida, selecione uma ligação de serviço.
- Selecione Mais ações (...) e, em seguida, selecione Segurança.
- Desloque-se para baixo até Permissões de pipeline e selecione +.
- 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.
- No Azure DevOps, abra Definições do projeto.
- Selecione Repositórios e, em seguida, selecione um repositório.
- Selecione ao separador Segurança.
- Desloque-se para baixo até Permissões de pipeline.
- 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.
- No Azure DevOps, selecione Pipelines>Biblioteca e, em seguida, selecione um grupo de variáveis.
- Selecione Permissões de pipeline.
- 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.
- No Azure DevOps, abra Definições do projeto.
- Selecione Ligações de Serviço e, em seguida, selecione uma ligação de serviço.
- Selecione Mais ações (...) e, em seguida, selecione Segurança.
- Selecione uma ligação de serviço. selecione Mais ações (…) e, em seguida, selecione Segurança.
- Desloque-se para baixo até Permissões de pipeline.
- 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
- No Azure DevOps, escolha Definições da organização > Pipelines > Definições.
- 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
A solução ALM Accelerator depende do Kit para Criadores. Instale o Creator Kit agora.
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.
Inicie sessão no Power Apps e, em seguida, selecione o ambiente onde pretende hospedar a aplicação ALM Accelerator.
No painel do lado esquerdo, selecione Soluções.
Selecione Importar solução>Navegar e, em seguida, navegue para a localização da solução gerida que transferiu e selecione o ficheiro.
Selecione Seguinte e, depois, selecione Seguinte novamente.
Na página Ligações, selecione ou crie uma ligação para ligar a Ligação CDS DevOps ao Dataverse.
Ao criar uma conexão para HTTP com Microsoft Entra, use Microsoft Graph para ambos os parâmetros.
Selecione Importar.
Configurar o conector personalizado DevOps
Selecione Dados>Conectores Personalizados>CustomAzureDevOps.
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 Provedor de identidade Azure Active Directory ID do 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. 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.
No painel do lado esquerdo, selecione Descrição geral.
Selecione Adicionar um URI de Redirecionamento.
Selecione + Adicionar uma Plataforma e, em seguida, selecione Web.
Na caixa de texto URL de Redirecionamento, cole o "URL de redirecionamento" gerado automaticamente copiado da secção acima.
Selecione Configurar.
Testar o conector personalizado
Abra o menu Teste.
Selecione Nova Ligação e, em seguida, siga os pedidos para criar uma ligação.
No Power Apps, selecione o seu ambiente e, em seguida, selecione Dataverse>Conectores Personalizados>CustomAzureDevOps.
Selecione Editar, aceda à página Teste e, em seguida, localize a operação GetOrganizations.
Selecione Testar operação.
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.
Configurar criadores para utilizarem a aplicação ALM Accelerator
Configure permissões de utente para a conta de um fabricante em Dataverse e Azure DevOps.
Configure as configurações do utente de implantação para configurar a experiência do utente do aplicativo e conceder acesso a soluções e perfis de implantação.