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:

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.

Captura de tela do formulário de item de trabalho, controle Desenvolvimento.

Captura de tela do formulário de item de trabalho, controle Desenvolvimento, Azure DevOps Server 2019.

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.
  • 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...

    Captura de tela do controle Desenvolvimento, Criar vínculo de branch.

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

    Formulário do item de trabalho da história do usuário, menu Ação, adicionar novo branch.

    Nomeie o branch e selecione o repositório.

    Criar uma caixa de diálogo de branch

    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.

    Confirmar e enviar alterações por push

    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.

    Captura de tela do controle Desenvolvimento, Criar vínculo de solicitação de pull.

  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.

    Exibir código, página Solicitação de Pull.

    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.

    página Solicitação de Pull, Criar solicitação de pull.

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

    Caixa de diálogo Concluir solicitação de pull, marque de mesclagem de squash

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

    Solicitação de pull, notificação concluída

  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.

    Captura de tela do formulário Item de trabalho, seção Desenvolvimento, links adicionados.

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.

Captura de tela ao selecionar vários itens na lista de pendências, Criar vínculo do branch.

E especificamos o nome do branch.

Caixa de diálogo Criar branch

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.

Guia Vínculos, vínculos de desenvolvimento

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

Selecione o ícone Adicionar vínculos e escolha o tipo de vínculo.

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

Seção Desenvolvimento, excluir um vínculo

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

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.

Itens de trabalho vinculados listados em Itens de trabalho associados na página de resumo de compilação.

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.

Tipos de vínculos de artefato a artefato

Para obter mais informações sobre o controle de links ou para personalizar o controle de links de desenvolvimento, consulte LinksControlOptions elements, controle de links de desenvolvimento.