Compartilhar via

Gerenciar ramificações nos espaços de trabalho do Microsoft Fabric

  • Artigo

O objetivo deste artigo é apresentar aos desenvolvedores do Fabric diferentes opções para criar processos de CI/CD no Fabric, com base em cenários comuns de clientes. Este artigo se concentra mais na parte de integração contínua (CI) do processo de CI/CD. Para obter uma discussão sobre a parte de entrega contínua (CD), consulte gerenciar pipelines de implantação.

Este artigo descreve algumas opções de integração distintas, mas muitas organizações usam uma combinação delas.

Pré-requisitos

Para integrar o Git ao seu espaço de trabalho do Microsoft Fabric, você precisará configurar os pré-requisitos a seguir no Fabric e no Git.

Pré-requisitos do Fabric

Para acessar o recurso de integração do Git, você precisa de um dos itens a seguir:

Além disso, as seguintes opções de locatário devem ser habilitadas no portal do administrador:

Essas opções podem ser habilitadas pelo administrador de locatários, pelo administrador de capacidade ou pelo administrador do espaço de trabalho, dependendo das configurações da organização.

Pré-requisitos do Git

Atualmente, a integração do Git é compatível com o Azure DevOps e o GitHub. Para usar a integração do Git com seu espaço de trabalho do Fabric, você precisa do seguinte no Azure DevOps ou no GitHub:

  • Uma conta ativa do Azure registrada para o mesmo usuário que está utilizando o espaço de trabalho do Fabric. Criar uma conta gratuita.
  • Acesso a um repositório existente.

Processo de desenvolvimento

O espaço de trabalho do Fabric é um ambiente compartilhado que acessa itens ativos. Quaisquer alterações feitas diretamente no espaço de trabalho substituem e afetam todos os outros usuários do espaço de trabalho. Entretanto, a melhor prática do Git é que os desenvolvedores trabalhem isoladamente fora dos espaços de trabalho compartilhados. Existem duas maneiras de um desenvolvedor trabalhar em seu próprio espaço de trabalho protegido.

Para trabalhar com ramificações usando a integração do Git, primeiro conecte o espaço de trabalho da equipe de desenvolvimento compartilhado a uma única ramificação compartilhada. Por exemplo, se a sua equipe utiliza um espaço de trabalho compartilhado, conecte-o à ramificação principal no repositório da sua equipe e sincronize entre o espaço de trabalho e o repositório. Se o fluxo de trabalho da sua equipe tiver várias ramificações compartilhadas, como Desenvolvimento/Teste/Produção, cada ramificação poderá ser conectada a um espaço de trabalho diferente.

Assim, cada desenvolvedor pode escolher o ambiente isolado no qual trabalhará.

Cenário 1 – Desenvolver usando ferramentas de cliente

Se os itens em desenvolvimento estiverem disponíveis em outras ferramentas, você poderá trabalhar neles diretamente na ferramenta cliente. Nem todos os itens estão disponíveis em todas as ferramentas. Os itens que estão disponíveis apenas no Fabric precisam ser desenvolvidos no Fabric.

O fluxo de trabalho para desenvolvedores que utilizam uma ferramenta cliente, como o Power BI Desktop, deve ser mais ou menos assim:

  1. Clone o repositório em um computador local. (Você só precisa realizar essa etapa uma vez.)

  2. Abra o projeto no Power BI Desktop utilizando a cópia local do PBIProj.

  3. Faça alterações e salve os arquivos atualizados localmente. Confirmar no repositório local.

  4. Quando estiver pronto, faça push da ramificação e confirmações no repositório remoto.

  5. Teste as alterações em relação a outros itens ou mais dados, conectando o novo branch a um espaço de trabalho separado e fazendo upload do modelo semântico e dos relatórios utilizando o botão atualizar tudo no painel de controle do código-fonte. Faça quaisquer testes ou alterações de configuração que existam antes de mesclar com a ramificação principal.

    Se nenhum teste for exigido no espaço de trabalho, o desenvolvedor poderá mesclar as alterações diretamente na ramificação principal, sem a necessidade de outro espaço de trabalho.

  6. Depois que as alterações são mescladas, o espaço de trabalho da equipe compartilhada é solicitado a aceitar a nova confirmação. As alterações são atualizadas no espaço de trabalho compartilhado e todos podem conferir as alterações nesses modelos semânticos e relatórios.

Diagrama mostrando o fluxo de trabalho de envio de alterações de um repositório Git remoto para o espaço de trabalho do Fabric.

Para obter diretrizes específicas sobre como utilizar o novo formato de arquivo do Power BI Desktop no Git, confira Formato de código-fonte.

Cenário 2 – Desenvolver usando outro workspace

Para um desenvolvedor que trabalha na Web, o fluxo seria o seguinte:

  1. Na guia Branches do menu Controle do código-fonte, selecione Ramificação para novo espaço de trabalho.

    Captura de tela da opção de ramificação do controle do código-fonte.

  2. Especifique os nomes da ramificação e do espaço de trabalho. O branch criado com base no branch conectado ao espaço de trabalho atual.

    Captura de tela da ramificação especificando o nome do novo branch e espaço de trabalho.

  3. Selecione Ramificações.

    O Fabric cria o espaço de trabalho e o branch. O sistema automaticamente leva você ao novo espaço de trabalho.

    O espaço de trabalho sincroniza com o branch de recurso e se torna um ambiente isolado para trabalhar, conforme ilustrado. Agora você pode trabalhar nesse novo ambiente isolado. A sincronização pode levar alguns minutos. Consulte as dicas de solução de problemas para obter mais informações em ramificações.

    Diagrama mostrando o fluxo de trabalho das confirmações.

  4. Salve suas alterações e confirme elas na ramificação do recurso.

  5. Quando estiver pronto, crie um PR para a ramificação principal. Os processos de revisão e mesclagem são feitos por meio do Azure Repos com base na configuração que sua equipe definiu para esse repositório.

Quando a revisão e a mesclagem forem concluídas, uma nova confirmação será criada na ramificação principal. Essa confirmação solicita que o usuário atualize o conteúdo no espaço de trabalho da equipe de desenvolvimento com as alterações mescladas.

Confira limitações de ramificação para obter mais informações.

Processo de liberação

O processo de lançamento começa quando novas atualizações completam um processo de Solicitação de Pull e mesclam no branch compartilhado da equipe (como Principal, Desenvolvedor etc.). A partir deste ponto, descreveremos as diferentes opções para criar um processo de lançamento no Fabric. Você pode encontrar as diferentes considerações para o processo de lançamento em gerenciamento de pipelines de implantação.

Alternar branches

Se o workspace estiver conectado a um branch do Git e você quiser alternar para outro branch, poderá fazer isso rapidamente no painel Controle do código-fonte sem precisar desconectar e reconectar.
Quando você alterna as ramificações, o espaço de trabalho é sincronizado com a nova ramificação e todos os itens no espaço de trabalho são substituídos. Se existirem versões diferentes do mesmo item em cada ramificação, o item será substituído. Se um item estiver na ramificação antiga, mas não na nova, ele será excluído. Para alternar entre as ramificações, siga estas etapas:

  1. Na guia Branches do menu Controle do código-fonte, selecione Alternar Branch.

    Captura de tela do check-out do controle do código-fonte de uma nova opção de branch.

  2. Especifique o branch ao qual você deseja se conectar ou criar uma nova ramificação. Essa ramificação deve conter o mesmo diretório que a ramificação atual.

  3. Selecione Alternar Branch.

Você não poderá alternar branches se tiver alterações não confirmadas no workspace. Selecione Cancelar para retornar e salvar suas alterações antes de alternar as ramificações.

Para conectar o workspace atual a um novo branch, mantendo o status do workspace existente, selecione Fazer check-out no novo branch. Saiba mais sobre como fazer check-out de um novo branch em Resolver conflitos no Git.

Conteúdo relacionado