Compartilhar via


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

Vincular seus itens de trabalho a objetos de desenvolvimento, como branches, confirmações, solicitações de pull e compilações, é uma maneira poderosa de impulsionar o desenvolvimento e manter sua equipe sincronizada. Ao criar ramificações diretamente de itens de trabalho, você estabelece uma conexão clara entre tarefas e alterações de código. À medida que o desenvolvimento avança, você pode associar solicitações de pull e confirmações a esses itens de trabalho, garantindo um registro abrangente das operações executadas para concluir um trabalho específico.

Este artigo aborda como criar novos branches, adicionar links para confirmações e gerenciar solicitações de pull em um repositório Git hospedado no Azure DevOps. Para obter instruções sobre como vincular confirmações e solicitações de pull do GitHub a itens de trabalho, consulte Vincular confirmações 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 de desenvolvimento rastreia todas as atividades de desenvolvimento do Git que contribuem para a conclusão de um item de trabalho. Ele fornece à sua equipe as informações necessárias para dar os próximos passos de desenvolvimento, minimizando a necessidade de várias ações de navegação para realizar tarefas comuns. Além disso, ele aprimora a rastreabilidade exibindo todas as ramificações, confirmações, solicitações de pull e builds relacionados associados ao item de trabalho, garantindo visibilidade abrangente do processo de desenvolvimento.

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.

No controle de desenvolvimento , 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 uma ramificação criada ou vinculada diretamente do item de trabalho.

Observação

O controle de desenvolvimento só está disponível no formulário de item de trabalho do portal da Web. A experiência de acompanhamento de item de trabalho e os formulários no Visual Studio ou em outros clientes com suporte não exibem vários recursos disponíveis no portal da Web.

Pré-requisitos

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.

    A captura de tela mostra o formulário de item de trabalho da história do usuário, o menu Ação, adicionar nova ramificação.

    Nomeie o branch e selecione o repositório.

    A captura de tela mostra a caixa de diálogo Criar uma ramificação.

    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.

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

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

    A captura de tela mostra as alterações de confirmação e 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.

    Crie uma solicitação de pull para mesclar as alterações feitas em um branch principal e fazer com que suas alterações sejam revisadas por outros membros da sua equipe.

    A captura de tela mostra Controle de desenvolvimento, Criar link 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.

    A captura de tela mostra a página Solicitação de Pull, Criar solicitação de pull.

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

    A captura de tela mostra a caixa de diálogo Solicitação de pull completa, verifique squash-merge.

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

    A captura de tela mostra a 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.

A captura de tela mostra a caixa de diálogo Criar nova ramificação.

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.

A captura de tela mostra a guia Links, links 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.

A captura de tela mostra o ícone Adicionar links e escolha o tipo de link.

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

A captura de tela mostra a seção Desenvolvimento, exclua um 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.

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 links mostrados nesta seção aparecem devido às seguintes 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.

A captura de tela mostra os tipos de link Artefato para artefato.

::: moniker-end

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.