Impulsionar o desenvolvimento do Git por meio de um item de trabalho no Azure Boards

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Uma das maneiras pelas quais sua equipe pode impulsionar seu desenvolvimento e permanecer em sincronia é vincular os itens de trabalho aos objetos criados durante o desenvolvimento, como branches, commits, solicitações de pull e compilações. Você pode começar essa vinculação criando um branch de um ou mais itens de trabalho. Posteriormente, você pode criar solicitações de pull, abrir commits rapidamente e manter um registro das operações de desenvolvimento executadas para concluir um trabalho específico.

Neste artigo, você aprende a realizar as seguintes tarefas:

• Como criar um branch ou solicitação de pull a partir de um item de trabalho
• Concluir a solicitação de pull
• Executar uma mesclagem squash
• Criar um branch para vários itens de trabalho
• Vincular um item de trabalho a objetos de desenvolvimento e compilação existentes

Este artigo aborda a criação de branches, a adição de vínculos para commits e a adição de solicitações de pull a um repositório Git hospedado no Azure DevOps. Para vincular os commits e solicitações de pull do GitHub, confira Vincular commits e solicitações de pull do GitHub a itens de trabalho.

Dica

Você pode definir a vinculação automática e outras configurações que vinculam itens de trabalho a confirmações do Git, solicitações de pull, compilações e muito mais. Para saber mais, consulte os recursos a seguir:

• Visão geral entre serviços
• Configurar pipelines para dar suporte ao acompanhamento de trabalho
• Vincule itens de trabalho a builds e implantações.

Controle Desenvolvimento

O controle Desenvolvimento registra todos os processos de desenvolvimento do Git que dão suporte à conclusão do item de trabalho. Esse controle pode mostrar as informações necessárias da sua equipe para executar a próxima etapa de desenvolvimento e minimizar as etapas de navegação para realizar tarefas comuns de desenvolvimento. Ele também dá suporte à rastreabilidade, fornecendo visibilidade de todos os branches, commits, solicitações de pull e compilações relacionados ao item de trabalho.

Nela, você pode acessar rapidamente branches, solicitações de pull e confirmações vinculadas ao item de trabalho. Além disso, você pode iniciar uma solicitação de pull para um branch ao qual você criou ou vinculou no item de trabalho.

Tenha em mente que o controle Desenvolvimento só aparece no formulário de item de trabalho no portal da Web. A experiência de acompanhamento de itens de trabalho e os formulários que aparecem no Visual Studio ou em outros clientes com suporte não exibem vários dos recursos disponíveis no portal da Web.

Pré-requisitos

• Conectar-se a um projeto. Se você não tiver um projeto ainda, crie um.
• Você precisa ser adicionado a um projeto como membro do grupo de segurança Colaboradores ou Administradores de Projeto. Para ser adicionado, Adicione usuários a um projeto ou equipe.
• Para exibir ou modificar itens de trabalho, você precisar ter as permissões de Exibir itens de trabalho neste nó e Editar itens de trabalho neste nó definidas como Permitir. Por padrão, o grupo Colaboradores tem essas permissões definidas. Para obter mais informações, consulte Definir permissões e acesso para acompanhamento de trabalho.

Processo de fluxo de trabalho

Considere criar um branch quando não houver artefatos de código vinculados. Se houver um branch, mas não houver solicitações de pull, considere criar uma solicitação de pull. Aqui está uma sequência de fluxo de trabalho típica ao trabalhar com um repositório Git.

1. Inicie o trabalho no item de trabalho criando um branch. Você pode adicionar um novo branch do Git na seção Desenvolvimento...

   

   ... ou, no menu Ações do formulário.

   

   Nomeie o branch e selecione o repositório.

   

   Quando você cria branches, eles são automaticamente vinculados ao item de trabalho.

   Observação

   Você só pode criar um branch depois de adicionar arquivos ao branch principal, que recomendamos que você rotule como main ou com outro rótulo distinto. O sistema adiciona automaticamente um arquivo LEIAME ao repositório inicial criado em cada novo projeto.

2. O sistema é aberto para o repositório e o branch que você criou.

   Você pode editar um arquivo no portal da Web.

   Ou, se você tiver edições de arquivo extensas ou precisar adicionar arquivos, trabalhe no Visual Studio ou em outro IDE com suporte. Adicione uma nova ramificação local do branch que você criou. Para obter mais informações, consulte Atualizar código com busca e pull, Baixe as alterações com fetch. (Embora qualquer processo de edição e confirmação de código funcione, trabalhamos melhor com uma edição do Visual Studio.)

3. Adicione ou modifique os arquivos no branch que você criou.

   No Visual Studio ou em outro IDE compatível, confirme e envie por push as alterações do branch local para o repositório.

   

   Se for a primeira vez que você envia alterações por push de uma nova ramificação, publique o branch antes de enviar alterações por push. Para obter mais informações, confira Compartilhar código com push.

4. Crie uma solicitação de pull no formulário do item de trabalho.

   Você cria uma solicitação de pull para mesclar as alterações feitas em um branch principal e conseguir a revisão das suas alterações por outros membros da sua equipe.

   

5. Sua exibição alterna para a página Código, Solicitações de Pull. Conclua a criação da solicitação de pull, conforme mostrado.

   

   Observação

   Depois de criar uma solicitação de pull, você não poderá criar uma solicitação de pull para o mesmo branch até concluir a solicitação de pull anterior.

   

   Marque a caixa Alterações de squash ao mesclar e conclua a mesclagem.

   

6. Após a conclusão, você deverá ver uma tela semelhante à seguinte.

   

7. Abra o formulário de item de trabalho ou atualize o formulário, expanda a seção Desenvolvimento (escolha Maximizar Desenvolvimento ) e você verá os links que foram adicionados para dar suporte às operações concluídas.

   

Criar um branch para vários itens de trabalho

Você também pode adicionar uma nova ramificação do item de trabalho listado na lista de pendências ou no quadro sem precisar abrir o item de trabalho. Usando Seleção múltipla, você pode selecionar vários itens de trabalho e criar um branch em que todos eles estejam vinculados ao branch.

Por exemplo, aqui, selecionamos os cinco primeiros itens a serem vinculados a um novo branch.

E especificamos o nome do branch.

Vincular a objetos de desenvolvimento e compilação existentes

Todos os itens listados na seção Desenvolvimento também aparecem na guia Links. Todas as ações de desenvolvimento iniciadas na seção Desenvolvimento também são registradas na guia Histórico.

Para vincular um item de trabalho a um objeto existente, escolha o ícone Adicionar vínculos e escolha o tipo de vínculo.

Remover um link

Se você deseja remover um link, pode fazê-lo na seção Desenvolvimento, destacando-o primeiro e depois escolhendo Remover link .

Ou você pode selecioná-lo na guia Links e escolher Ações para o link e, em seguida, escolher a opção Remover link.

Artigos relacionados

• Visão geral entre serviços
• Configurar pipelines para dar suporte ao acompanhamento de trabalho
• Adicionar itens de trabalho
• Visão geral do Git
• Vincular solicitações de pull e commit do GitHub para itens de trabalho
• Vincular a itens de trabalho a partir de outros objetos

Itens de trabalho associados na compilação

Com confirmações do Git, todos os itens de trabalho vinculados a uma confirmação são listados nos itens de trabalho associados na página de resumo de build.

Tipos de vínculos exibidos na seção Desenvolvimento

Os vínculos mostrados nesta seção aparecem devido a estas ações:

• Criar um branch, commit ou solicitação de pull do item de trabalho
• Especificar a ID do item de trabalho durante um commit, uma solicitação de pull ou outra operação compatível do Git ou TFVC
• Vinculando especificamente o item de trabalho da seção Desenvolvimento ou da guia Links a uma ramificação de código-fonte, build ou outra operação Git ou TFVC com suporte.

Passar o mouse sobre qualquer entrada listada na seção Desenvolvimento ativa o hiperlink ao objeto associado.

Os tipos de vínculos que você pode adicionar na seção de desenvolvimento são Branch, Compilação, Conjunto de alterações, Commit, Encontrado na compilação, Integrado na compilação, Solicitação de Pull e Item com Controle de Versão.