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

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

Embora este artigo delineia várias opções distintas, muitas organizações adotarão uma abordagem híbrida.

Pré-requisitos

Para criar um processo de CI/CD usando as opções neste artigo, você precisa:

  • Uma assinatura Microsoft Fabric

  • Um workspace do Fabric (você deve ser um administrador do workspace para configurar a implantação)

  • Para opções baseadas em Git (1, 2 e 4), um provedor Git com suporte (Azure DevOps ou GitHub) conectado por meio da integração do Git

Note

A opção 3 utiliza pipelines de implantação do Fabric. Para usar essa opção, você também precisa de acesso ao recurso de pipelines de implantação e permissão para criar e gerenciar um pipeline.

Processo de desenvolvimento

O processo de desenvolvimento é o mesmo em todos os cenários de implantação e é independente de como lançar novas atualizações em produção. Quando os desenvolvedores trabalham com o controle do código-fonte, eles precisam trabalhar em um ambiente isolado. No Fabric, esse ambiente pode ser um IDE em seu computador local (como o Power BI Desktop ou o VS Code) ou um espaço de trabalho diferente no Fabric. Você pode encontrar informações sobre as diferentes considerações para o processo de desenvolvimento em Development process in Microsoft Fabric.

Diagrama mostrando caixas centralizadas de feature e do workspace dev, sincronização bidirecional do Git com seus branches, ramificação com um plano de implantação opcional e um PR de feature para dev.

O Git Sync suporta tanto fazer commit de alterações de workspace no Git quanto a atualização de um workspace a partir do Git. A seta PR mostra a direção em que você mescla as mudanças de recursos para o ramo de desenvolvimento compartilhado, não uma operação de sincronização bidirecional.

Processo de liberação

O processo de versão é iniciado quando novas atualizações são concluídas e o PR (pull request) mesclado na ramificação compartilhada da equipe (como Principal, Desenvolvimento etc.). A partir deste ponto, existem diferentes opções para criar um processo de lançamento no Fabric.

A tabela a seguir resume as opções para ajudá-lo a escolher. Muitas equipes combinam mais de uma.

Opção Fonte da verdade O que cada estágio faz deploy Mecanismo de implantação Configuração por estágio Melhor para
1 - Ramificações Git por estágio Git O próprio ramo primário do estágio APIs de integração com Git, fabric-cicd ou APIs de Itens do Fabric Definições específicas de estágio, parametrização fabric-cicd ou conjuntos de valores da Biblioteca de Variáveis Equipes que promovem mudanças por meio de um branch separado para cada etapa
2 - Commit de liberação compartilhada Git (Dev para trabalhos contínuos, Main para lançamentos)¹ A mesma tag de liberação no Main, primeiro no Teste, depois na Produção 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 Equipes que implantam uma versão compartilhada de lançamento para Teste e Produção, em vez de manter um ramo por estágio
3 – Pipelines de implantação Fabric workspace (Git somente via dev) O conteúdo do espaço de trabalho da etapa anterior Fabric UI ou APIs de pipelines de implantação Regras de implantação e vinculação automática Equipes que preferem uma implantação nativa do Fabric e de baixo código entre espaços de trabalho
4 – CI/CD para ISVs Git (Dev para trabalhos contínuos, Main para lançamentos) A mesma tag de release no Main, primeiro no Teste compartilhado, depois no espaço de trabalho de produção 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 versão por cliente ISVs que gerenciam muitos espaços de trabalho para cada cliente

¹ Na opção 2, apenas o espaço de trabalho Dev está conectado ao Git. Os workspaces de Teste e Produção não estão conectados ao Git. Fazer push de uma tag de release no Main aciona um pipeline que faz deploy dessa versão em Test. Após validação e aprovação bem-sucedidas, o pipeline implanta a mesma tag e o commit SHA para Prod.

Essas opções não exigem uma estratégia específica de ramificação, como Gitflow ou desenvolvimento baseado em trunk. O que importa é que cada estágio implante um commit conhecido e versionado, e que o Prod receba o mesmo conteúdo que você testou.

As opções 1 e 2 diferem em como você organiza e promove lançamentos, não em uma 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 por meio de branches de estágio separadas. A Opção 2 usa uma tag de release no Main para acionar a implantação do mesmo commit para Teste e, após validação e aprovação, para Prod.

Um plano de implantação não é uma opção de fluxo de trabalho separada. Você 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 de Definições de Itens de Importação em Massa nas opções 1, 2 e 4. A fabric-cicd biblioteca não suporta planos de implantação, inclusive quando você 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 definindo a fonte de verdade, o que cada estágio implanta e a configuração do estágio.

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

Diagrama com linhas separadas de workspace e branch Git. PRs promovem mudanças de branch de feature para dev, test e prod, e cada estágio implanta seu próprio branch usando integração Git ou APIs de items.

Com essa 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. PRs promovem mudanças entre esses branches, e cada workspace recebe as definições do branch do seu estágio. Você pode implantar com integração com Git, fabric-cicd ou APIs de Fabric Items. Quando você usa fabric-cicd ou APIs Items, o workspace de destino não precisa de uma conexão Git. A característica definidora é o branch separado para cada estágio, não a ferramenta de implantação.

Após um PR para a ramificação de Desenvolvimento ser aprovado e mesclado:

  1. Atualize o espaço de trabalho Dev a partir do ramo Dev , por exemplo, com integração com Git. Execute testes unitários e quaisquer operações pós-implantação necessárias.
  2. Crie um PR para o ramo Test com as mudanças que você deseja promover. Você pode usar uma branch de release para fazer cherry-pick dessas alterações. Aplique os processos de revisão e aprovação da sua equipe.
  3. Implante um commit específico do branch de Teste para o workspace de Teste usando APIs de integração Git, fabric-cicd ou Fabric Items. Aplique configuração específica para cada estágio e execute testes automáticos ou manuais.
  4. Crie um PR para a branch Prod que promova as mudanças validadas. Revise as definições resultantes para garantir que elas correspondam à versão testada, exceto para configurações intencionais específicas de cada estágio. Se você adicionar outras mudanças, valide-as no Test antes da promoção.
  5. Após a aprovação, implante o branch Prod no espaço de trabalho Prod usando a ferramenta de implantação selecionada por você. Execute as verificações pós-implantação necessárias e as operações de ingestão de dados.

Algumas dependências de itens se vinculam automaticamente por IDs lógicos. Outros precisam de parametrização ou atualizações pós-implantação. Para detalhes, consulte Entenda a vinculação de dependências na implantação em vários espaços de trabalho.

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

  • Integração com Git: Conecte cada espaço de trabalho ao seu branch de estágio. Atualize pela interface do Fabric ou automatize atualizações com as APIs do Fabric Git.
  • fabric-cicd: Confira o branch da etapa e publique suas definições de itens com parâmetros específicos do ambiente. O workspace de destino não precisa de uma conexão Git.
  • APIs de Fabric Items: Implante definições a partir do branch da etapa chamando Create item e Update item definition, ou a API de Bulk Import Item Definitions. Quando você chama APIs diretamente, 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 de Definições de Itens de Importação em Massa.

Quando você deve considerar usar a opção nº 1?

  • Quando você deseja usar seu repositório Git como a única fonte de verdade e a origem de todas as implementações.
  • Quando você quer um ramo primário separado para cada etapa, com revisão e promoção baseadas em PR entre etapas.
  • Quando quiser gerenciar definições específicas de estágio no Git, ou aplicar configurações específicas do ambiente com a ferramenta de implantação selecionada pela sua escolha.

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

Diagrama mostrando uma tag de release na branch main disparando a implantação em Test, com testes bem-sucedidos e aprovação condicionando a implantação da mesma tag e commit SHA para Prod por meio de APIs de items.

Com essa opção, os desenvolvedores trabalham em um branch Dev conectado ao espaço de trabalho Dev . O ramo Main é o ramo de liberação: contém apenas as mudanças que você escolhe lançar. Os workspaces de Teste e Produção não estão conectados ao Git. Fazer push de uma tag de release no Main ativa um fluxo de trabalho do GitHub Actions ou um pipeline do Azure DevOps. Ele implanta a versão marcada para Test, executa validação e aguarda a aprovação em produção antes de implantar a mesma tag e commit SHA para Prod. O pipeline pode usar um ambiente de compilação para rodar testes unitários e ajustar definições de itens antes de enviá-los. Por exemplo, você pode alterar conexões de fontes de dados, referências a outros itens ou valores de parâmetros para o estágio alvo. Nem todas as dependências de itens exigem essas mudanças. Alguns são vinculados automaticamente usando IDs lógicos quando implantados em um novo espaço de trabalho. Para detalhes, consulte Entenda a vinculação de dependências na implantação em vários espaços de trabalho.

O fluxo de liberação funciona da seguinte forma:

  1. Desenvolvedores mesclam PRs aprovados no ramo Dev, e o espaço de trabalho Dev é atualizado a partir do Git.
  2. Para preparar um lançamento, crie um PR que faça cherry-pick das alterações que você quer lançar de Dev para Main. O PR deve incluir os mesmos processos de revisão e aprovação que qualquer outro PR da sua equipe ou organização.
  3. Crie uma tag release no commit escolhido no Main, por exemplo v1.5.0. Faça push da tag para acionar um fluxo de trabalho do GitHub Actions ou um pipeline do Azure DevOps configurado para tags de release.
  4. O pipeline resolve a tag para um SHA de commit, registra ambos, faz checkout desse commit, executa testes unitários e ajusta a configuração para Test. Ele faz upload dessas definições de itens para o espaço de trabalho Test usando fabric-cicd ou a Bulk Import Item Definitions API. Para detalhes, veja Quais componentes podem ser usados para implementar a opção #2?. Execute testes automatizados 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 espera em um gate de aprovação de produção configurado. Use uma aprovação de ambiente do GitHub ou uma verificação de aprovação do ambiente Azure DevOps.
  6. Após a aprovação, implante a mesma tag de release e o SHA de commit registrado para o Prod. Somente a configuração por estágio, como conjuntos de valores da Biblioteca de Variáveis ou arquivos de parâmetros, difere do Test. Execute verificações específicas para produção e acione qualquer ingestão de dados que a mudança exija para minimizar a indisponibilidade dos consumidores.

Importante

Implante para Prod exatamente o commit que você testou no Test. Reutilize o SHA de commit gravado, mesmo que o Main avance. Não mova ou reutilize uma tag de liberação para apontar para outro commit.

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

Para rastreabilidade, configure os jobs de implantação para ter como destino os ambientes correspondentes no GitHub ou no Azure DevOps. Inclua a tag release e o commit SHA resolvido em cada registro de implantação para identificar qual versão foi implantada no Test e na Prod. Uma tag Git sozinha não registra onde uma versão foi implantada.

Quais componentes podem ser usados para implementar a opção nº 2?

  • Fabric-cicd - uma biblioteca python projetada para uso com workspaces do Microsoft Fabric. Esta biblioteca oferece suporte a automações de CI/CD com abordagem code-first para integrar perfeitamente os espaços de trabalho em uma estrutura de implantação. Para obter um exemplo completo de ponta a ponta, siga nosso tutorial fabric-cicd e Azure DevOps. O Fabric-CICD suporta dois modos de publicação:
  • Bulk-Import-Item-Definitions-API – A API dá suporte à criação de novos itens e à atualização dos existentes em vigor, ao mesmo tempo em que depende do tratamento de dependência interno do Fabric para garantir que os itens sejam implantados na ordem correta. Isso permite implantações consistentes e repetíveis em ambientes de teste e produção sem intervenção manual. Para obter um tutorial de exemplo, siga nossa CI/CD do Fabric com a API de Definições de Itens de Importação em Massa.

Quando você deve considerar usar a opção nº 2?

  • Quando você precisa de parametrização específica do ambiente das definições de itens antes da implantação. A funcionalidade de parametrização fabric-cicd usa um parameter.yml arquivo para substituir valores para cada ambiente alvo, incluindo IDs de conexão e IDs de lakehouse, sem manter definições separadas de itens para cada estágio. Ele 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 alvo. Essa capacidade também está disponível na opção 1 quando você usa fabric-cicd. A integração com o Git sozinha não fornece essa substituição no tempo de implantação.
  • Ao querer usar o Git como sua única fonte de verdade e a origem de todas as implantações.
  • Quando quiser escolher quais mudanças vão em cada lançamento, e implemente uma versão marcada e testada para Prod.

Opção 3 – Implantar usando pipelinas de implantação do Fabric

Diagrama com linhas separadas de workspace e Git. Workspaces de feature e dev sincronizam com branches Git, enquanto pipelines de implantação promovem conteúdo de workspace do Dev para Teste e depois para Prod sem branches de Teste ou Prod.

Com essa opção, o Git está conectado somente até o estágio de desenvolvimento. No estágio de desenvolvimento, as implantações ocorrem diretamente entre os espaços de trabalho de Desenvolvimento/Teste/Produção, usando pipelines de implantação do Fabric. Você pode implantar entre as etapas diretamente pela interface do Fabric, ou usar as APIs dos pipelines de implantação para orquestrar a implantaçã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 lançamento semelhante como em 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, você pode anexar um plano de implantação a uma implantação entre etapas. As regras de implantação e a vinculação automática continuam a gerenciar a configuração específica de cada estágio.

Quando você aprova e mescla um PR ao branch conectado ao espaço de trabalho Dev :

  1. Atualize o espaço de trabalho Dev do Git usando a interface do Fabric ou as APIs do Fabric Git. Execute quaisquer operações e testes necessários após a atualização.
  2. Implante as mudanças de Dev para Test usando pipelines de implantação Fabric, seja a partir da interface Fabric ou pelas APIs dos pipelines de implantação. Execute testes automatizados ou manuais em Test antes de promover as mudanças na Prod.
  3. Depois que os testes passarem e o gerenciador de lançamento aprovar, implante o conteúdo validado de Test para Prod. Não atualize o conteúdo selecionado em Test entre validação e implantação em Prod sem testar novamente.

Você pode realizar essas etapas pela interface do Fabric ou automatizá-las com APIs no Azure Pipelines ou GitHub Actions. Você não precisa de pipelines externos de build e release para o fluxo de trabalho baseado na interface do usuário.

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

  • Quando sua equipe prefere a experiência de implantação integrada do Fabric e seus recursos atendem às suas necessidades de implantação. Você pode implantar entre espaços de trabalho a partir da interface do Fabric sem manter pipelines de versão externos, e usar APIs para automação quando necessário. Essa abordagem também pode se adequar a equipes com experiência limitada com ferramentas DevOps, como Azure Pipelines ou GitHub Actions.
  • Ao estar 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 lançamento.
  • 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 lançamento.
  • 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 deployment pipelines do Fabric têm uma estrutura linear e exigem permissões adicionais para criar e gerenciar o pipeline.

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

Diagrama mostrando uma tag de release acionando a implantação compartilhada de Test, seguido de validação e aprovação antes de implantar a mesma tag e SHA em múltiplos workspaces de produção do cliente com parâmetros específicos do cliente.

Essa opção é diferente das outras. É mais relevante para ISV (Fornecedores Independentes de Software) que criam aplicativos SaaS para seus clientes sobre o 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 a estrutura da análise fornecida a cada cliente é semelhante e pronta para uso, é recomendável ter um processo centralizado de desenvolvimento e teste que se divide para cada cliente apenas no estágio de Produção.

Esta opção é baseada na opção #2:

  1. Os desenvolvedores trabalham no branch Dev e no espaço de trabalho Dev, e fazem cherry-pick das alterações que querem liberar de Dev para Main, conforme descrito na opção #2.
  2. Crie e faça push de uma tag release no commit escolhido no Main, por exemplo v1.5.0. A tag desencadeia um fluxo de trabalho GitHub Actions ou um pipeline Azure DevOps.
  3. O pipeline resolve a tag para um SHA de commit, registra ambos, executa testes unitários e ajusta as definições marcadas para Test compartilhado. Implanta-os usando fabric-cicd ou a Bulk Import Item Definitions API, conforme descrito na opção #2. Execute testes automatizados ou manuais após a implantação. Se a validação falhar, pare a promoção, corrija o problema no Dev, traga a correção para o 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, implante a mesma tag e o mesmo SHA de commit registrado no espaço de trabalho Prod de cada cliente. Aplique parâmetros e conexões específicas do cliente antes da implantação ou por meio de APIs pós-implantação. Implantações independentes de clientes podem rodar em paralelo. Registre 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 nº 4?

  • Você é um ISV criando aplicativos para a plataforma Fabric.
  • Você está usando espaços de trabalho diferentes para cada cliente gerenciar a multilocação do seu aplicativo
  • Para obter mais separação ou para testes específicos para clientes diferentes, talvez você queira ter multilocação nas etapas anteriores de desenvolvimento ou teste. Nesse caso, considere que, com várias locações, o número de espaços de trabalho necessários aumenta 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. Enquanto descrevemos 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. Use este artigo para orientá-lo sobre as diferentes opções e como construí-las, mas não é necessário escolher apenas uma delas.

Alguns cenários ou itens específicos podem ter limitações em vigor podem impedir a adoção de qualquer um desses cenários.

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