Codificação colaborativa com o Git
Este artigo descreve como usar o Git como a estrutura de desenvolvimento de código colaborativa para projetos de ciência de dados. O artigo aborda como vincular código no Azure Repos aos itens de trabalho de desenvolvimento do Agile no Azure Boards, como fazer revisões de código e como criar e mesclar solicitações de pull para alterações.
Vincular um item de trabalho a uma branch do Azure Repos
O Azure DevOps fornece uma maneira conveniente de conectar uma história de usuário do Azure Boards ou um item de trabalho de tarefa com uma branch de repositório do Git do Azure Repos. Você pode vincular sua história de usuário ou tarefa diretamente ao código associado a ele.
Para conectar um item de trabalho a uma nova branch, selecione as reticências (...) de Ações ao lado do item de trabalho e no menu de contexto, role para e selecione Nova branch.
Na caixa de diálogo Criar uma branch, forneça o nome da nova branch e o repositório e ramificação base do Git do Azure Repos. O repositório base deve estar no mesmo projeto DevOps do Azure que o item de trabalho. A branch de base pode ser toda ramificação existente. Selecione Criar branch.
Você também pode criar uma nova branch usando o seguinte comando Git bash no Windows ou Linux:
git checkout -b <new branch name> <base branch name>
Se você não especificar um <nome de branch base>, o novo branch será baseado em main.
Para alternar para a ramificação de trabalho, execute o seguinte comando:
git checkout <working branch name>
Depois que você alternar para a ramificação de trabalho, você pode começar a desenvolver os artefatos de código ou documentação necessários para concluir o item de trabalho. Executar git checkout main alterna de volta para a ramificação main.
É uma melhor prática criar uma GIT branch para cada item de trabalho da História de Usuário. Em seguida, para cada item de trabalho da Tarefa, você pode criar uma branch com base na branch da História de Usuário. Organize as branchs em uma hierarquia que corresponde à relação entre Tarefa e História de Usuário quando você tem várias pessoas trabalhando em Histórias de Usuário diferentes para o mesmo projeto ou em Tarefas diferentes para a mesma História de Usuário. Você pode minimizar conflitos fazendo com que cada membro da equipe trabalhe em uma branch diferente, em código diferente ou em outros artefatos ao compartilhar uma branch.
O diagrama a seguir mostra a estratégia de branch recomendada para TDSP. Talvez não sejam necessárias tantas branchs quanto mostrado aqui, especialmente quando apenas uma ou duas pessoas trabalham no mesmo projeto ou apenas uma pessoa trabalha em todas as Tarefas de uma História de Usuário. Mas separar a branch de desenvolvimento da branch primária é sempre uma boa prática e pode ajudar a impedir a interrupção pelas atividades de desenvolvimento da branch de lançamento. Para uma descrição completa do modelo de Git branch, confira Um Modelo de GIT branch bem-sucedido.
Você também pode vincular um item de trabalho para uma branch existente. Na página Detalhes de um item de trabalho, selecione Adicionar link. Em seguida, selecione uma branch existente para vincular o item de trabalho e selecione OK.
Trabalhar na branch e confirmar as alterações
Depois de fazer uma alteração para seu item de trabalho, como adicionar um arquivo de script R à branch do computador local script, você pode confirmar a alteração da branch local para o branch de trabalho upstream usando os seguintes comandos do Git bash:
git status
git add .
git commit -m "added an R script file"
git push origin script
Criar uma solicitação de pull
Após uma ou mais confirmações e envios por push, quando estiver pronto para mesclar seu branch de trabalho atual em sua branch de base, você poderá criar e enviar uma solicitação de pull no Azure Repos.
Na página principal do seu projeto DevOps do Azure, aponte para Repos>solicitações de pull no painel de navegação esquerdo. Em seguida, selecione um dos botões de Nova solicitação de pull ou o link Criar uma solicitação de pull.
Na tela Nova solicitação de pull, se necessário, navegue até o repositório Git e branch para os quais você deseja mesclar suas alterações. Adicione ou altere outras informações que desejar. Em Revisores, adicione os nomes dos revisores e selecione criar.
Examinar e mesclar
Depois de criar uma solicitação de pull, os revisores recebem uma notificação por email para revisar a solicitação de pull. Os revisores testam se as alterações funcionam e verificam as alterações com o solicitante, se possível. Os revisores podem fazer comentários, solicitar alterações e aprovar ou rejeitar a solicitação de pull com base em sua avaliação.
Depois que os revisores aprovarem as alterações, você ou outra pessoa com permissões de mesclagem podem mesclar a branch de trabalho com sua branch de base. Selecione Concluire selecione Mesclagem completa na caixa de diálogo Concluir solicitação de pull. Você pode optar por excluir a branch de trabalho depois que ela for mesclada.
Confirme que a solicitação está marcada como CONCLUÍDO.
Ao voltar para Repos no painel de navegação esquerdo, você pode ver que foi alternado para a branch principal desde que a branch script foi excluída.
Você também pode usar os seguintes comandos do Git bash para mesclar sua branch de trabalho script com sua branch base e excluir a branch de trabalho após a mesclagem:
git checkout main
git merge script
git branch -d script
Colaboradores
Esse artigo é mantido pela Microsoft. Ele foi originalmente escrito pelos colaboradores a seguir.
Autor principal:
- Mark Tabladillo | Arquiteto de soluções de nuvem sênior
Para ver perfis não públicos do LinkedIn, entre no LinkedIn.
Próximas etapas
Executar tarefas de ciência de dados mostra como usar os utilitários para executar várias tarefas de ciência de dados comuns como a exploração interativa de dados, a análise de dados, os relatórios e a criação de modelo.