Implementar o controle de versão e a integração com o Git

Concluído

Para dar suporte à integração contínua, você mescla com frequência suas alterações de código em um repositório compartilhado. O repositório compartilhado faz parte de um sistema de controle de versão, como o GitHub ou o Azure DevOps. O controle de versão é uma maneira de gerenciar as alterações no código com o passar do tempo. Ele permite que você acompanhe as revisões de código, contribua de forma colaborativa para o desenvolvimento de código e reverta para as versões anteriores do código, se for necessário.

O GitHub e o Azure DevOps são os sistemas de controle de versão com suporte no Fabric. Esses sistemas de controle de versão permitem que você crie uma cópia de um repositório de código chamado branch. Você pode usar o branch para trabalhar no seu próprio código independentemente da versão principal do código da sua equipe. Quando você tiver alterações para enviar, poderá confirmá-las no repositório e mesclar suas alterações com um branch de código principal.

A integração com o controle de versão está no nível do espaço de trabalho no Fabric. Você pode criar versões dos itens que você desenvolveu em um workspace.

Conectar-se a um Repositório Git

Um workspace do Fabric é um ambiente compartilhado que acessa itens dinâmicos. Todas as alterações feitas diretamente no workspace substituem e afetam todos os outros usuários do workspace. Uma prática recomendada é que você desenvolva em um ambiente de trabalho isolado, fora de um ambiente de trabalho compartilhado e ativo. No seu workspace protegido, você pode se conectar ao seu branch e sincronizar o conteúdo do workspace ao vivo no seu workspace protegido e confirmar suas alterações de volta ao branch ou ao branch principal.

  1. Configurar um repositório git: A primeira etapa na implementação da integração do Git é configurar um repositório Git no GitHub ou no Azure DevOps. O repositório é o local central para armazenar e gerenciar itens.

  2. Conectar um workspace do Fabric a um repositório Git: Em seguida, no workspace que você quer conectar ao seu repositório, estabeleça uma conexão com o repositório a partir da opção Integração do Git nas configurações do workspace.

    Captura de tela da interface de conexão do workspace com o provedor Git.

    Ao conectar um workspace ao Git, você cria ou seleciona um branch de repositório Git existente para sincronizar. O Fabric sincroniza o conteúdo entre o workspace e o Git para que eles tenham o mesmo conteúdo.

    Captura de tela da seleção do branch na interface do provedor Git.

Confirmar e atualizar o ambiente de trabalho do Fabric e o repositório Git

Depois que você se conectar ao repositório, o workspace mostra uma coluna de status do Git indicando o estado de sincronização dos itens no workspace, em comparação com os itens no branch remoto.

O ícone de controle do código-fonte mostra o número de itens diferentes entre o workspace e o repositório.

Para sincronizar o workspace e o repositório:

  • Quando você fizer alterações no espaço de trabalho, sincronize-as com o branch do Git usando a opção Alterações na janela Controle do código-fonte.

  • Quando novas confirmações forem feitas no branch do Git, sincronize-as com seu workspace usando a seleção Atualizações na janela Controle do código-fonte.

    Captura de tela das alterações não confirmadas na área de trabalho.

Cenários de ramificação

As alterações que você faz em um workspace quando está trabalhando no desenvolvimento afetam todos os outros usuários do workspace, portanto, é uma prática recomendada trabalhar isoladamente fora dos workspaces compartilhados. Para manter seu trabalho de desenvolvimento isolado dos workspaces compartilhados, você pode desenvolver usando:

  • Um workspace separado e isolado
  • Ferramentas de cliente como o Power BI Desktop para relatórios e modelos semânticos ou VS Code para Notebooks.

Em ambos os cenários, seu trabalho de desenvolvimento de recursos deve ocorrer em um branch dedicado em vez de no branch do código principal. Isso facilita o trabalho de vários desenvolvedores em um recurso sem afetar o branch principal.

Criar um branch dedicado, emitir solicitações de pull e sincronizar um workspace com o Git

Crie um branch dedicado e emita pull requests para incorporar as mudanças do seu branch ao branch principal, seguindo estas etapas:

Para fins de desenvolvimento usando um espaço de trabalho separado e isolado:

  1. Conecte um workspace de desenvolvimento ao branch principal, seguindo as instruções na seção desta página intitulada “Conectar-se a um Repositório Git”.

  2. Se você for um desenvolvedor que trabalha na interface da Web do Fabric, crie um branch isolado para seu trabalho pelo workspace de desenvolvimento que está conectado ao branch principal, selecionando Controle do código-fonte e Branch para o novo workspace. Nomeie o ramo e associe-o a outro espaço de trabalho. O novo workspace é sincronizado com o novo branch que você cria e se torna um ambiente de trabalho isolado para seu trabalho.

    Captura de tela da criação de um novo espaço de trabalho e ramificação.

  3. Faz alterações no seu branch e confirma-as no seu branch isolado pela interface Controle do código-fonte no Fabric.

  4. Em seguida, no Git, crie uma Solicitação de Pull (PR) para efetuar o pull das alterações do seu branch isolado no branch principal.

  5. O branch principal no Git será atualizado depois que a PR for mesclada ao branch principal. Quando você abrir o workspace de desenvolvimento compartilhado, será solicitado que você sincronize o novo conteúdo do Git com o workspace de desenvolvimento compartilhado.

Ao usar ferramentas de cliente para desenvolvimento, o processo é semelhante ao do desenvolvimento na interface da Web do Fabric.

  1. Conecte um espaço de trabalho de desenvolvimento ao branch principal, seguindo as instruções na seção desta página intitulada "Conectar um espaço de trabalho do Fabric a um repositório Git".
  2. Clone o repositório no seu computador local.
  3. Envie por push as alterações para o repositório remoto quando você estiver pronto para testar no Fabric. Teste as alterações conectando seu branch isolado a um workspace separado.
  4. Emita um PR no Git para mesclar suas alterações no branch principal.
  5. Ao abrir o workspace compartilhado associado ao branch principal, será solicitado que você sincronize as alterações do repositório no workspace.