Tutorial: automatizar a implantação da solução usando o GitHub Actions para Microsoft Power Platform

Artigo
03/27/2023

Neste tutorial, você saberá como:

Criar um novo repositório do GitHub
Criar dois fluxos de trabalho do GitHub usando GitHub Actions para Microsoft Power Platform

Os fluxos de trabalho podem exportar automaticamente seu aplicativo (como uma solução não gerenciada) de um ambiente de desenvolvimento, gerar um artefato de construção (solução gerenciada) e implantar o aplicativo em seu ambiente de produção. Este tutorial usa a solução ALMLab que você criou e os ambientes que você configurou em tutoriais anteriores.

Tutoriais relacionados: Introdução e Criar um aplicativo baseado em modelo.

Criar uma conta do GitHub

Acesse https://github.com e clique em Inscrever-se ou Iniciar uma avaliação gratuita (ou entre se você tiver uma conta existente).
Depois de criar sua conta, crie um repositório selecionando Criar repositório ou Novo.

Você pode ver a seguinte tela de aterrissagem alternativa:
Crie seu novo repositório e chame-o de 'poweractionslab'. Selecione Adicionar um arquivo README para iniciar o repositório e escolha Criar repositório.

Criação de um novo segredo para Autenticação da Entidade de Serviço

Navegue até seu repositório e clique em Configurações, depois expanda Segredos e clique em Ações.
Na página Segredos, nomeie o segredo 'PowerPlatformSPN'. Use o segredo do cliente do registro de aplicativo criado no Microsoft Entra e insira-o no campo Valor e, depois, selecione Adicionar segredo. O segredo do cliente será referenciado nos arquivos YML usados para definir os fluxos de trabalho do GitHub mais adiante neste laboratório.

O segredo do cliente agora está armazenado com segurança como um segredo do GitHub.

Crie um fluxo de trabalho para exportar e descompactar o arquivo de solução para uma nova ramificação

Clique em Ações e em configurar um fluxo de trabalho por conta própria ou clique em Configurar na caixa Fluxo de trabalho simples na seção sugerido para este repositório.
Isso iniciará um novo arquivo YAML com um fluxo de trabalho básico para ajudá-lo a começar com o GitHub actions.
Exclua o conteúdo pré-criado, cole o conteúdo do arquivo export-and-branch-solution-with-spn-auth.yml e renomeie o arquivo para 'export-and-branch-solution'.yml.
Atualize <ENVIRONMENTURL> com a URL do ambiente de desenvolvimento de onde você exportar (por exemplo: https://poweractionsdev.crm.dynamics.com).
Atualize <APPID> e <TENANT ID> com seus valores.
- Se você estiver usando credenciais, cole o arquivo export-and-branch-solution.yml, em vez do conteúdo do arquivo export-and-branch-solution-with-spn-auth.yml. Atualize <USERNAME> com o nome de usuário que você está usando para se conectar ao ambiente.
Dica

Se você não estiver familiarizado com o GitHub Actions e quiser saber mais, confira a documentação oficial em https://docs.github.com/en/actions.
Agora você está pronto para confirmar suas alterações. Selecione Iniciar confirmação, digite Criar yml de exportação no campo de título e, em seguida, adicione uma descrição (opcional). Em seguida, clique em Confirmar novo arquivo.

Parabéns, você acabou de criar seu primeiro fluxo de trabalho do GitHub usando as seguintes ações:

Quem sou eu: Garante que você consiga se conectar com sucesso ao ambiente do qual está exportando.
Exportar solução: exporta o arquivo de solução do seu ambiente de desenvolvimento.
Descompactar solução: O arquivo de solução exportado do servidor é um arquivo compactado (zip) com arquivos de configuração consolidados. Esses arquivos iniciais não são adequados para gerenciamento de código-fonte, pois eles não são estruturados para tornar viável para os sistemas de gerenciamento de código-fonte fazerem a diferenciação adequada nos arquivos e capturar as alterações que você deseja enviar para o controle de origem. Você precisa 'descompactar' os arquivos da solução para torná-los adequados para armazenamento e processamento de controle de origem.
Solução de ramificação: Cria uma nova ramificação para armazenar a solução exportada.

Testar o fluxo de trabalho de exportação e descompactação

Em seguida, teste se o fluxo de trabalho é executado. Navegue até Ações, Executar fluxo de trabalho e escolha Executar fluxo de trabalho. Se você tiver um nome de solução diferente de 'ALMLab', altere o valor aqui, mas deixe os outros valores inalterados.
Após 5 a 10 segundos, o fluxo de trabalho será iniciado e você poderá selecionar o fluxo de trabalho em execução para monitorar o progresso.
Após a conclusão do fluxo de trabalho, valide se um novo branch foi criado com a solução descompactada na pasta solutions/ALMLab. Navegue até a guia Código e expanda o menu suspenso ramificações .
Selecione a ramificação criada pela ação.
Valide se a pasta solutions/ALMLab foi criada na nova ramificação e, a seguir, crie uma solicitação de Pull para mesclar as alterações na ramificação principal. Clique em Contribuir e no menu suspenso clique em Abrir solicitação de pull.
Na tela Abrir uma solicitação de Pull, adicione um título e uma descrição, conforme desejado, depois clique em Criar solicitação de pull.
A tela será atualizada mostrando a solicitação de pull recém-criada. À medida que a solicitação de pull é criada, a confirmação será fornecida mostrando que nossa ramificação não tem conflito com a ramificação principal. Essa confirmação significa que as alterações podem ser mescladas na ramificação principal automaticamente. Clique em Mesclar solicitação de pull e depois clique em Confirmar mesclagem. Opcionalmente, clique em excluir ramificação para limpar a ramificação desativada agora.
Navegue de volta para a ramificação (principal) padrão e valide se a solução agora está disponível lá também.

Criar um fluxo de trabalho reutilizável para gerar um artefato de compilação e importar para produção

Nesta seção, criaremos um fluxo de trabalho adicional, que:

Cria um solução gerenciada e o publica como um artefato GitHub
Importa o artefato de compilação para o ambiente de produção

Navegue até Ações e selecione Novo fluxo de trabalho.
Escolha configurar um fluxo de trabalho você mesmo.
Renomeie o título do fluxo de trabalho como 'release-solution-to-prod-with-inputs' e copie o conteúdo do arquivo release-solution-to-prod-with-inputs.yml e cole-o na tela Editar novo arquivo.
Confirme as mudanças. Escolha Iniciar confirmação e adicione um título e uma descrição (opcional). Em seguida, selecione Confirmar novo arquivo.

Chame o fluxo de trabalho reutilizável no evento de versão

Nesta seção, chamaremos o fluxo de trabalho reutilizável no evento de versão.

Navegue até Ações e selecione Novo fluxo de trabalho.
Escolha configurar um fluxo de trabalho por conta própria.
Renomeie o título do fluxo de trabalho como 'release-action-call' e copie o conteúdo do arquivo release-action-call.yml e cole-o na tela Editar novo arquivo.
Atualize as seguintes variáveis no novo arquivo de fluxo de trabalho:
- Atualize <BUILD_ENVIRONMENT> com a URL para o ambiente de compilação que você está usando para gerar o solução gerenciada. Por exemplo: https://poweractionsbuild.crm.dynamics.com.
- Atualize <PROD_ENVIRONMENT> com a URL para o ambiente de produção no qual você está implementando. Por exemplo: https://poweractionsprod.crm.dynamics.com.
- Atualize <APP_ID> com o ID do Aplicativo (Cliente) que pode ser encontrado na Folha de registros de aplicativos do Portal do Microsoft Azure clicando no registro criado anteriormente neste tutorial.
- Atualize <TENANT_ID> com o ID do Aplicativo (Cliente) que pode ser encontrado na Folha de registros de aplicativos do Portal do Microsoft Azure clicando no registro criado anteriormente neste tutorial.
Confirme as mudanças. Escolha Iniciar confirmação e adicione um título (opcional) e uma descrição (opcional). Em seguida, selecione Confirmar novo arquivo.

Testar o fluxo de trabalho de liberação para produção

Agora você está pronto para testar o último fluxo de trabalho. Este fluxo de trabalho é acionado quando uma nova versão é implantada na produção.

Navegue até Versões.
Selecione Rascunhar uma nova versão.
Adicione uma marca de versão, um título e escolha Publicar versão.
Selecione Ações para exibir o fluxo de trabalho em execução.
Escolha o fluxo de trabalho em execução para exibir as ações à medida que são executadas.
Aguardar cada ação ser concluída.
Após a conclusão do fluxo de trabalho, entre em seu ambiente de produção e valide se a solução foi implementada como um solução gerenciada.

Implantar a atualização e revisar as alterações antes do lançamento de produção

Agora vamos testar o processo de ponta a ponta e, em seguida, ver como podemos exibir e validar as alterações em um aplicativo antes de implantá-lo na produção.

Navegue até a solução ALMLab em seu ambiente de desenvolvimento e escolha Editar ou clique no nome de exibição das soluções.
Selecione e visualize a tabela Solicitação de Folga.
Clique em + Adicionar coluna e crie a nova coluna, conforme mostrado na figura abaixo.

Valores de campo atualizados:**
- Nome de exibição: Aprovado
- Tipo de dados: Sim/Não
Clique em Concluído.
Clique em Salvar tabela
Navegue de volta para seus repositórios do GitHub da guia Ações, escolha Executar fluxo de trabalho, e selecione o botão Executar fluxo de trabalho.
Após 5 a 10 segundos, o fluxo de trabalho será iniciado e você poderá clicar no fluxo de trabalho em execução para monitorar seu progresso.
Depois que o fluxo de trabalho for concluído, navegue até o novo branch selecionando Código e depois Branches.
Selecione a ramificação que foi criada pela expansão contribuir e clique em Abrir solicitação de pull.
Adicione um título (opcional) e clique em Criar solicitação de pull.
Após as atualizações de conteúdo, clique na guia Arquivos alterados.
Observe que as mudanças na solução são realçadas em verde para indicar que esta seção do arquivo foi adicionada quando comparada ao mesmo arquivo na ramificação principal.
Navegue de volta à guia Conversa. Selecione Solicitações de pull e, em seguida, selecione a solicitação de pull criada anteriormente.
Na página Solicitação de pull, selecione Squash e mesclagem para mesclar o arquivo de solução atualizado em sua ramificação principal, exclua opcionalmente que agora está mesclado no principal.
Siga as etapas na seção Testar o fluxo de trabalho de liberação para produção para criar uma nova versão e validar se a solução atualizada foi implementada em seu ambiente de produção.