Escolha a melhor opção de fluxo de trabalho CI/CD do Fabric para si

Este artigo apresenta aos programadores do Fabric diferentes opções para construir processos CI/CD no Fabric, baseados em cenários comuns de clientes. Este artigo se concentra mais na implantação contínua (CD) do processo de CI/CD. Para uma discussão sobre a parte de integração contínua (CI), veja processo de desenvolvimento no Microsoft Fabric.

Embora este artigo descreva várias opções distintas, muitas organizações adotam uma abordagem híbrida.

Pré-requisitos

Para construir um processo CI/CD usando as opções deste artigo, precisa de:

Note

A opção 3 utiliza os pipelines de implementação do Fabric. Para usar essa opção, também precisa de acesso à funcionalidade pipelines de implementação e permissão para criar e gerir um pipeline.

Processo de desenvolvimento

O processo de desenvolvimento é o mesmo em todos os cenários de implantação e independe de como lançar novas atualizações em produção. Quando os desenvolvedores trabalham com controle do código-fonte, eles precisam trabalhar em um ambiente isolado. Na Malha, esse ambiente pode ser um IDE em sua máquina local (como o Power BI Desktop ou o VS Code) ou um espaço de trabalho diferente na Malha. Pode encontrar informações sobre as diferentes considerações para o processo de desenvolvimento em Processo de desenvolvimento no Microsoft Fabric.

Diagrama mostrando caixas centradas de funcionalidades e espaço de trabalho de desenvolvimento, sincronização Git bidirecional com os seus branches, ramificação com um plano de implementação opcional e um PR de funcionalidades para dev.

O Git Sync suporta tanto o commit das alterações do espaço de trabalho para o Git como a atualização de um espaço de trabalho a partir do Git. A seta PR mostra a direção em que integras as alterações de funcionalidades no ramo de desenvolvimento partilhado, e não uma operação de sincronização bidirecional.

Processo de liberação

O processo de lançamento começa assim que as novas atualizações são concluídas e o pull request (PR) é mesclado na ramificação compartilhada da equipa (como Main, Dev, etc.). A partir desse ponto, há diferentes opções para criar um processo de liberação no Fabric.

A tabela seguinte resume as opções para o ajudar a escolher. Muitas equipas combinam mais do que uma.

Option Fonte da verdade O que cada estágio faz deploy Mecanismo de implantação Configuração por fase Melhor para
1 - Ramificações Git por fase Git O ramo primário próprio da fase integração com Git, fabric-cicd ou APIs de Itens do Fabric Definições específicas por estágio, parametrização fabric-cicd ou conjuntos de valores da Biblioteca de Variáveis Equipas que promovem mudanças através de uma ramificação separada para cada fase
2 - Commit de lançamento partilhado Git (Dev para trabalho em curso, Main para lançamentos)¹ A mesma etiqueta de lançamento no Main, primeiro no Test, depois na Prod após validação e aprovação fabric-cicd ou API de Definições de Itens de Importação em Massa parametrização fabric-cicd, scripts personalizados e conjuntos de valores da Biblioteca de Variáveis Equipas que implementam uma versão de lançamento partilhada para Test e Prod em vez de manter uma ramificação por etapa
3 - Pipelines de implementação Área de trabalho do Fabric (Git apenas através de dev) O conteúdo do espaço de trabalho da fase anterior Fabric UI ou APIs de pipelines de implementação Regras de implementação e associação automática Equipas que preferem uma implementação nativa do Fabric e de baixo código entre espaços de trabalho
4 - CI/CD para ISVs Git (Dev para trabalho em andamento, Main para lançamentos) A mesma etiqueta de lançamento no Main, primeiro no Test partilhado, depois no espaço de trabalho Prod de cada cliente após validação e aprovação fabric-cicd ou API de Definições de Itens de Importação em Massa (por espaço de trabalho do cliente) Parâmetros de lançamento por cliente ISVs que gerem muitos espaços de trabalho por cliente

¹ Na opção 2, apenas o espaço de trabalho Dev está ligado ao Git. Os espaços de trabalho Test e Prod não estão ligados ao Git. Empurrar uma tag release no Main desencadeia um pipeline que faz deploy dessa versão para Test. Após validação e aprovação bem-sucedidas, o pipeline implanta a mesma etiqueta e commit SHA no Prod.

Estas opções não requerem uma estratégia específica de ramificação, como o Gitflow ou desenvolvimento baseado em trunk. O que importa é que cada fase faça a implantação de um commit conhecido e versionado, e que o Prod receba o mesmo conteúdo que testaste.

As opções 1 e 2 diferem na forma como organizas e promoves lançamentos, não numa escolha exclusiva de ferramentas. Ambas as opções podem usar APIs fabric-cicd ou Fabric Items e parametrização específica do ambiente. A opção 1 promove mudanças através de branches de staging separadas. A Opção 2 utiliza uma tag de release no Main para desencadear a implementação do mesmo commit em Test e, após validação e aprovação, em Prod.

Um plano de implementação não é uma opção de fluxo de trabalho separada. Pode usar um plano com operações Git suportadas na opção 1, com pipelines de implantação na opção 3, ou chamando diretamente a API Bulk Import Item Definitions nas opções 1, 2 e 4. A fabric-cicd biblioteca não suporta planos de implementação, incluindo quando se usa o modo de importação em massa. O plano controla a ordem de implantação, dependências e ações, enquanto o fluxo de trabalho selecionado continua a definir a fonte de verdade, o que cada etapa implanta e a configuração da etapa.

Opção 1 - Implementações baseadas em definição a partir de branches Git por estágio

Diagrama com linhas separadas de workspace e branch Git. PRs promovem alterações de branch de funcionalidades para dev, test e prod, e cada estágio implementa o seu próprio branch usando integração Git ou APIs de items.

Com esta opção, todas as implantações têm origem no Git. Cada estágio tem um ramo primário dedicado: Dev, Test e Prod , neste exemplo. Os PRs promovem alterações entre esses ramos, e cada espaço de trabalho recebe as definições do ramo do seu ambiente. Pode implementar com integração com Git, fabric-cicd ou APIs Fabric Items. Quando usas fabric-cicd ou APIs Items, o workspace de destino não precisa de uma ligação Git. A característica definidora é a ramificação separada para cada estágio, não a ferramenta de implementação.

Uma vez que um PR para a ramificação de Dev é aprovado e integrado:

  1. Atualize o espaço de trabalho Dev a partir do ramo Dev , por exemplo, com integração com Git. Executar testes unitários e quaisquer operações necessárias após a implantação.
  2. Cria um PR para o ramo Test com as alterações que queres promover. Podes usar um ramo de lançamento para fazer cherry-pick dessas alterações. Aplique os processos de revisão e aprovação da sua equipa.
  3. Efetue a implementação de um commit específico da ramificação Teste para o espaço de trabalho de Teste usando integração Git, fabric-cicd ou APIs Fabric Items. Aplique configurações específicas para cada etapa e execute testes automatizados ou manuais.
  4. Crie um PR para a branch Prod que promova as alterações validadas. Revise as definições resultantes para garantir que correspondem à versão testada, exceto para configurações intencionais específicas de cada estágio. Se adicionares outras alterações, valida-as no Test antes da promoção.
  5. Após a aprovação, implemente a branch Prod no workspace Prod utilizando a ferramenta de implementação selecionada. Executar as verificações pós-implementação e operações de ingestão de dados necessárias.

Algumas dependências de itens vinculam-se automaticamente através de IDs lógicos. Outros precisam de parametrização ou atualizações pós-implementação. Para mais detalhes, consulte Compreender a associação de dependências na implementação entre áreas de trabalho.

Que componentes podem ser usados para implementar a opção #1?

  • Integração com Git: Liga cada espaço de trabalho ao seu ramo de staging. Atualize-o através da interface do Fabric ou automatize as atualizações com as APIs do Fabric Git.
  • Fabric-CICD: Verifique o ramo da stage e publique as definições dos itens com parâmetros específicos do ambiente. O espaço de trabalho alvo não precisa de uma ligação Git.
  • APIs de Fabric Items: Implemente definições a partir da ramificação do estágio chamando Create item and Update item definition, ou a API de Bulk Import Item Definitions. Quando chama APIs diretamente, a sua automação prepara as definições e a configuração específica de cada estágio.

Para exemplos de implementação, veja o tutorial fabric-cicd e Azure DevOps ou Fabric CI/CD com a API Bulk Import Item Definitions.

Quando você deve considerar o uso da opção #1?

  • Quando você quiser usar seu repositório Git como a única fonte de verdade e a origem de todas as implantações.
  • Quando quiseres um ramo primário separado para cada etapa, com revisão e promoção baseados em PR entre etapas.
  • Quando quiseres gerir definições específicas de cada fase no Git, ou aplicar uma configuração específica do ambiente com a ferramenta de implementação que escolheste.

Opção 2 - Implementações baseadas em definição a partir de um commit de release partilhado

Diagrama que mostra uma tag de release na main a desencadear a implementação para Test, com testes bem-sucedidos e aprovação que condiciona a implementação da mesma tag e commit SHA para Prod através de APIs de Items.

Com esta opção, os programadores trabalham numa ramificação Dev que está ligada ao espaço de trabalho Dev . O ramo Main é o ramo de publicação: contém apenas as alterações que escolhes publicar. Os espaços de trabalho Test e Prod não estão ligados ao Git. Colocar uma tag release no Main desencadeia um fluxo de trabalho GitHub Actions ou um pipeline Azure DevOps. Implementa a versão com tag para Test, executa validação e espera pela aprovação de produção antes de implementar a mesma tag e commit SHA para Prod. O pipeline pode usar um ambiente de compilação para executar testes unitários e ajustar definições de itens antes de os enviar. Por exemplo, pode alterar ligações à fonte de dados, referências a outros itens ou valores de parâmetros para a fase alvo. Nem todas as dependências de itens exigem estas alterações. Alguns vinculam-se automaticamente através de IDs lógicos quando implementados num novo espaço de trabalho. Para mais detalhes, consulte Compreender a associação de dependências na implementação entre áreas de trabalho.

O fluxo de lançamento funciona da seguinte forma:

  1. Os programadores fundem PRs aprovados no ramo Dev , e o espaço de trabalho Dev é atualizado a partir do Git.
  2. Para preparar um lançamento, cria um PR que faça cherry-pick das alterações que queres lançar de Dev para o Main. O PR deve incluir os mesmos processos de revisão e aprovação que qualquer outro PR da sua equipa ou organização.
  3. Crie uma tag release no commit escolhido no Main, por v1.5.0exemplo. Faça push da tag para ativar um fluxo de trabalho GitHub Actions ou um pipeline Azure DevOps configurado para tags de release.
  4. O pipeline resolve a tag para um commit SHA, regista ambos, faz checkout desse commit, executa testes unitários e ajusta a configuração para Test. Carrega essas definições de itens para o espaço de trabalho Test usando fabric-cicd ou a API de Definições de Itens de Importação em Massa. Para mais detalhes, veja Que componentes podem ser usados para implementar a opção #2?. Efetue testes automáticos ou manuais após a implantação. Se a validação falhar, pare a promoção para Prod.
  5. Após o sucesso da validação, o pipeline aguarda numa etapa de aprovação de produção configurada. Use uma verificação de aprovação do ambiente GitHub ou uma verificação de aprovação do ambiente Azure DevOps.
  6. Após aprovação, implemente a mesma tag de release e o mesmo commit SHA registado para o Prod. Apenas a configuração por estágio, como conjuntos de valores da Biblioteca de Variáveis ou ficheiros de parâmetros, difere do Test. Execute verificações específicas de produção e acione qualquer ingestão de dados que a alteração exija para minimizar a indisponibilidade dos consumidores.

Important

Implementa para Prod exatamente o commit que testaste no Test. Reutilize o SHA de commit registado, mesmo que o Main avance. Não movas nem reutilizes uma etiqueta de lançamento para apontar para outro commit.

Se a validação falhar, faz a correção primeiro no Dev e depois faz cherry-pick para Main. Crie uma nova tag de release e repita o pipeline, incluindo validação de Testes. Esta abordagem também garante que futuras versões de Dev incluam a correção.

Para rastreabilidade, configure os trabalhos de implementação para terem como destino os ambientes correspondentes do GitHub ou do Azure DevOps. Inclua a tag release e o commit SHA resolvido em cada registo de deployment para que possa identificar qual versão chegou ao Test e à Prod. Uma tag Git sozinha não regista onde uma versão foi implementada.

Que componentes podem ser usados para implementar a opção #2?

Quando você deve considerar o uso da opção #2?

  • Quando é necessária parametrização específica do ambiente das definições de item antes da implantação. A funcionalidade de parametrização fabric-cicd utiliza um parameter.yml ficheiro para substituir valores para cada ambiente de destino, incluindo IDs de ligação e IDs de lakehouse, sem manter definições separadas de itens para cada estágio. Suporta operações de encontrar e substituir, substituição de valores selecionados por caminhos JSON e resolução dinâmica dos IDs de itens do workspace de destino. Esta funcionalidade também está disponível na opção 1 quando se usa o fabric-cicd. A integração do git sozinha não fornece esta substituição no tempo de implementação.
  • Quando você quiser usar o Git como sua única fonte de verdade e a origem de todas as implantações.
  • Quando quiseres escolher que alterações vão em cada lançamento, e implementares uma versão marcada e testada para o Prod.

Opção 3 - Implantar usando pipelines de implantação do Fabric

Diagrama com linhas de workspace e Git separadas. Os workspaces de feature e dev sincronizam-se com os branches Git, enquanto os pipelines de implementação promovem o conteúdo do workspace do Dev para o Teste para o Prod sem ramificações de Test ou Prod.

Com essa opção, o Git fica conectado apenas até o estágio de desenvolvimento . A partir do estágio de desenvolvimento, as implantações acontecem diretamente entre os espaços de trabalho de Dev/Test/Prod, usando pipelines de implantação de Fabric. Pode implementar entre fases diretamente a partir da interface Fabric, ou usar as APIs dos pipelines de implementação para orquestrar a implementação como parte do seu pipeline de lançamento do Azure, ou um fluxo de trabalho no GitHub. Essas APIs permitem que a equipe crie um processo de compilação e liberação semelhante ao de outras opções, usando testes automatizados (que podem ser feitos no próprio espaço de trabalho ou antes do estágio de desenvolvimento), aprovações, etc.

Quando a implantação exige uma ordem específica, itens relacionados ou ações, pode anexar um plano de implantação a uma implantação entre etapas. As regras de implementação e a autobinding continuam a gerir a configuração específica de cada estágio.

Quando aprovar e fundir um PR com o ramo ligado ao espaço de trabalho Dev:

  1. Atualiza o espaço de trabalho Dev a partir do Git usando a interface do Fabric ou as APIs do Fabric Git. Execute todas as operações e testes necessários após a atualização.
  2. Implemente as alterações de Dev para Test usando pipelines de implementação Fabric, seja a partir da interface Fabric ou através das APIs dos pipelines de implementação. Execute testes automatizados ou manuais em Test antes de promover as alterações à Prod.
  3. Depois de os testes passarem e o gestor de lançamentos aprovar, implemente o conteúdo validado de Test para Prod. Não atualize o conteúdo selecionado em Test entre validação e implementação para Prod sem testar novamente.

Pode realizar estes passos a partir da interface Fabric ou automatizá-los com APIs no Azure Pipelines ou GitHub Actions. Não precisas de pipelines externos de build e release para o fluxo de trabalho baseado na interface.

Quando você deve considerar usar a opção #3?

  • Quando a sua equipa prefere a experiência de implementação integrada do Fabric e as suas capacidades satisfazem as suas necessidades de implementação. Podes efetuar implementações entre espaços de trabalho a partir da interface do Fabric sem manter pipelines de lançamento externos, e usar APIs para automação quando necessário. Esta abordagem também pode servir equipas com experiência limitada com ferramentas DevOps, como o Azure Pipelines ou o GitHub Actions.
  • Quando você estiver usando o controle do código-fonte apenas para fins de desenvolvimento e preferir implantar alterações diretamente entre os estágios do pipeline de versão.
  • Quando as regras de implantação, a vinculação automática e outras APIs disponíveis são suficientes para gerenciar as configurações entre os estágios do pipeline de versão.
  • Quando você quiser usar outras funcionalidades dos pipelines de implantação do Fabric, como exibir alterações no Fabric, histórico de implantação, etc.
  • Considere também que as implantações nos pipelines de implantação do Fabric têm uma estrutura linear e exigem outras permissões para criar e gerenciar o pipeline.

Opção 4 - CI/CD para ISVs no Fabric (gerindo vários clientes/soluções)

Diagrama a mostrar uma etiqueta de lançamento a desencadear a implementação partilhada do Teste, seguido de validação e aprovação antes de implementar a mesma etiqueta e SHA em múltiplos espaços de trabalho de produção do cliente com parâmetros específicos do cliente.

Esta opção é diferente das outras. É mais relevante para fornecedores independentes de software (ISV) que criam aplicações SaaS para os seus clientes com base no Fabric. Os ISVs geralmente têm um espaço de trabalho separado para cada cliente e podem ter até várias centenas ou milhares de espaços de trabalho. Quando as estruturas de análise fornecidas a cada cliente são semelhantes e out-of-the-box, recomendamos ter um processo centralizado de desenvolvimento e teste que é distribuído a cada cliente apenas no estágio de Produção Prod.

Esta opção baseia-se na opção #2:

  1. Os programadores trabalham na ramificação Dev e no espaço de trabalho Dev, e fazem cherry-pick das alterações que querem lançar de Dev para Main, conforme descrito na opção #2.
  2. Crie e envie uma tag release no commit escolhido em Main, por exemplo v1.5.0. A etiqueta desencadeia um fluxo de trabalho GitHub Actions ou um pipeline Azure DevOps.
  3. O pipeline faz a resolução da tag para um commit SHA, regista ambos, executa testes unitários e ajusta as definições marcadas para o Test partilhado. Implanta-os usando fabric-cicd ou a API de Definições de Itens de Importação em Massa, conforme descrito na opção #2. Execute testes automáticos ou manuais após a implementação. Se a validação falhar, pare a promoção, corrija o problema no Dev, traga a correção para Main e crie uma nova tag para outra execução.
  4. Após a validação ser bem-sucedida e a aprovação de produção configurada ser concedida, implemente a mesma tag e o mesmo SHA de commit registado para o espaço de trabalho Prod de cada cliente. Aplique parâmetros e conexões específicos do cliente antes da implementação ou através de APIs pós-implementação. As implementações independentes dos clientes podem ser executadas em paralelo. Regista a tag, o commit SHA e o alvo do cliente no histórico de implantação do ambiente para que a versão implantada de cada cliente seja rastreável.

Quando você deve considerar o uso da opção #4?

  • Você é um ISV criando aplicativos sobre o Fabric.
  • Você está usando espaços de trabalho diferentes para cada cliente para gerenciar a multilocação do seu aplicativo
  • Para mais separação, ou para testes específicos para clientes diferentes, você pode querer ter multilocação em estágios anteriores de desenvolvimento ou teste. Nesse caso, considere que, com a multilocação, o número de espaços de trabalho necessários cresce significativamente.

Resumo

Este artigo resume as principais opções de CI/CD para uma equipe que deseja criar um processo automatizado de CI/CD no Fabric. Embora delineemos quatro opções, as restrições da vida real e a arquitetura da solução podem se prestar a opções híbridas ou completamente diferentes. Você pode usar este artigo para guiá-lo através de diferentes opções e como criá-las, mas você não é forçado a escolher apenas uma das opções.

Alguns cenários ou itens específicos podem ter limitações em vigor que podem impedi-lo de adotar qualquer um desses cenários.

O mesmo vale para o equipamento. Embora mencionemos diferentes ferramentas aqui, você pode escolher outras ferramentas que podem fornecer o mesmo nível de funcionalidade. Considere que o Fabric tem melhor integração com algumas ferramentas, portanto, escolher outras resulta em mais limitações que precisam de soluções alternativas diferentes.