Introdução com o Git no Azure Repos

Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server | 2019 TFS 2018

Visual Studio 2022 | | Visual Studio 2019 Visual Studio 2017 | Visual Studio 2015 | Visual Studio 2013

Introdução com o desenvolvimento de seu código usando repositórios Azure Repos e Git. Você pode usar comandos Visual Studio ou Git para clonar um repositório, definir branches locais, confirmar e enviar alterações por push e sincronizar com outras pessoas. Se você precisar criar ou importar um repositório, consulte Criar um novo repositório Git em seu projeto ou importar um repositório Git.

Observação

Este artigo descreve como usar Visual Studio para gerenciar Azure Repos repositórios Git. Usando procedimentos semelhantes, você pode usar Visual Studio para gerenciar GitHub repositórios. Para clonar um repositório GitHub, obtenha a URL conforme descrito na Clonagem de um repositório.

Para obter uma visão geral do fluxo de trabalho do Git, consulte Azure Repos tutorial do Git.

Observação

Visual Studio versão 16.8 de 2019 e versões posteriores fornecem um novo menu Git para gerenciar o fluxo de trabalho git com menos alternância de contexto do que o Team Explorer. Os procedimentos fornecidos neste artigo na guia Visual Studio 2019 fornecem informações sobre como usar a experiência do Git, bem como o Team Explorer. Para saber mais, confira a comparação lado a lado do Git e do Team Explorer.

Pré-requisitos

  • Repos deve ser habilitado nas configurações do projeto Azure DevOps. Se o hub de Repos e as páginas associadas não forem exibidos, consulte Ativar ou desativar um serviço de Azure DevOps para reencável Repos.

  • Para exibir o código em projetos privados, você deve ser membro de um projeto de Azure DevOps com nível de acesso básico ou superior. Para projetos públicos, todos podem exibir o código.

  • Para clonar ou contribuir com o código de um projeto privado, você deve ser membro do grupo de segurança Colaboradores ou ter as permissões correspondentes definidas. Para projetos públicos, qualquer pessoa pode clonar e contribuir com o código. Para saber mais, confira o que é um projeto público?

    Observação

    Para projetos públicos, os usuários que receberam acesso ao Stakeholder têm acesso total a Azure Repos.

  • Repos deve ser habilitado nas configurações do projeto Azure DevOps. Se o hub de Repos e as páginas associadas não forem exibidos, consulte Ativar ou desativar um serviço de Azure DevOps para reencável Repos.

  • Para exibir o código, você deve ser membro do projeto Azure DevOps com acesso básico ou superior. Se você não for membro do projeto, será adicionado.

  • Para clonar ou contribuir com o código, você deve ser membro do grupo de segurança Colaboradores ou ter as permissões correspondentes no projeto que deseja alterar.

  • Para exibir o código, você deve ser membro de um projeto de Azure DevOps com acesso básico ou superior. Se você não for membro do projeto, será adicionado.

  • Para clonar ou contribuir com o código, você deve ser membro do grupo de segurança Colaboradores ou ter as permissões correspondentes.

Para saber mais sobre permissões e acesso, consulte o repositório Git padrão e as permissões de branch e sobre os níveis de acesso.

Obter o código

Você pode clonar um repositório Git remoto para criar uma cópia local dele. A clonagem cria uma cópia do código-fonte para você trabalhar com informações de controle de versão e para que o Git possa gerenciar o código-fonte.

Se você preferir criar um repositório local sem clonagem, consulte Criar um novo repositório Git. Depois de criar seu repositório local, você pode continuar a confirmar, compartilhar e sincronizar seu trabalho.

Visual Studio versão 16.8 de 2019 e versões posteriores fornece uma experiência de controle de versão do Git, mantendo a interface do usuário git do Team Explorer. Você pode exercitar os recursos do Git de qualquer interface intercambiável. Abaixo, fornecemos uma comparação lado a lado para clonar um repositório.

Observação

Uma vantagem de se conectar a um projeto por meio do Team Explorer é que você obtém acesso ao hub de Itens de Trabalho. Para obter uma visão geral dos recursos do Team Explorer, consulte Navegar no Visual Studio Team Explorer.

Visual Studio Git

  1. No menu Git na barra de menus, escolha Clonar Repositório...

Screenshot of the 'Clone Repository' option in the Git menu in Visual Studio 2019.

  1. Na janela Clonar um repositório , insira o local do repositório remoto e o caminho da pasta para o repositório clonado. Se você não souber o local do repositório remoto, selecione Azure DevOps nas opções Procurar um repositório.

Screenshot of the 'Clone Repository' window in Visual Studio 2019.

  1. Selecione Clonar. Depois de clonar um repositório Git, Visual Studio detectará o repositório e o adicionará à sua lista de Repositórios Locais no menu Git.

Screenshot of the 'Local Repositories' option in the Git menu in Visual Studio 2019.

Team Explorer para Visual Studio

  1. No Team Explorer, selecione Conexão para abrir a página Conexão e escolha Gerenciar Conexões>Conexão para Project.

Screenshot of the 'Connect to a Project' link in Team Explorer in Visual Studio 2019.

  1. No Conexão para uma janela Project, escolha o repositório que você deseja clonar e selecione Clonar. Se você não vir seu repositório, selecione Adicionar Azure DevOps Server para adicionar um servidor que hospeda um repositório. Você pode filtrar a lista para localizar seu repositório.

Screenshot of the 'Connect to a Project' window in Visual Studio 2019.

  1. Verifique o local do repositório clonado no computador e selecione Clonar.

Observação

Com Azure DevOps Services, o formato da URL do projeto é dev.azure.com/{your organization}/{your project}. No entanto, ainda há suporte para o formato anterior que faz referência ao visualstudio.com formato. Para obter mais informações, consulte Introdução a Azure DevOps, alterne as organizações existentes para usar a nova URL de nome de domínio.

Confirmar seu trabalho

Os branches do Git isolam suas alterações de outros trabalhos no projeto. O fluxo de trabalho do Git recomendado é usar um novo branch para cada recurso ou corrigir o trabalho. Você faz confirmações em seu repositório Git local para salvar suas alterações nesse branch.

Visual Studio Git

  1. No menu Git na barra de menus, escolha Novo Branch... para abrir a janela Criar uma nova ramificação .

Screenshot of the 'New Branch' option in the Git menu in Visual Studio 2019.

  1. Na janela Criar uma nova ramificação , insira um nome de branch descritivo para que outras pessoas saibam qual trabalho o branch contém. Por padrão, Visual Studio cria seu novo branch do branch atual. A caixa de seleção do branch checkout alterna automaticamente você para o branch recém-criado. Selecione Criar.

Screenshot of the 'Create a new branch' window in Visual Studio 2019.

  1. Adicione um arquivo README.md ao repositório clonado. Em Gerenciador de Soluções, você pode procurar o conteúdo do repositório usando o Modo de Exibição de Pasta ou abrir soluções de Visual Studio no repositório. O Git rastreia as alterações feitas dentro e fora de Visual Studio.

  2. Quando estiver satisfeito com suas alterações, salve-as no Git usando uma confirmação. Na janela Alterações do Git , insira uma mensagem que descreva as alterações e selecione Confirmar Tudo. Commit All confirma alterações não ofuscadas e ignora a área de preparo. Você pode optar por preparar todos os arquivos antes de se comprometer selecionando o botão todos + (mais) na parte superior da seção Alterações na janela Alterações do Git .

Screenshot of the 'Commit All' button in the 'Git Changes' window in Visual Studio 2019.

Selecione o link de informações de confirmação para obter mais detalhes sobre a confirmação.

Screenshot showing the commit information link in Visual Studio 2019.

Team Explorer para Visual Studio

  1. No Team Explorer, selecione o botão Página Inicial e escolha Branches.

Screenshot showing the Branches option in Team Explorer in Visual Studio 2019.

  1. Clique com o botão direito do mouse no branch padrão, geralmente nomeado main, e escolha Novo Branch Local de...

Screenshot of the 'New Local Branch From' menu option in the context menu of the main branch in Visual Studio 2019.

  1. Insira um nome de branch descritivo para que outras pessoas saibam o trabalho que o branch contém. Selecione Criar Branch.

Screenshot of the branch name text and 'Create Branch' button in Visual Studio 2019.

  1. Adicione um arquivo README.md ao repositório clonado. No modo de exibição Home do Team Explorer, você pode procurar o conteúdo do repositório usando Mostrar Exibição de Pasta ou abrir Visual Studio soluções no repositório. O Git rastreia as alterações feitas dentro e fora de Visual Studio.

  2. Quando estiver satisfeito com suas alterações, salve-as no Git usando uma confirmação. Abra o modo de exibição Alterações do Team Explorer selecionando o botão Página Inicial e escolhendo Alterações.

Screenshot of the Changes option in Team Explorer in Visual Studio 2019.

  1. Insira uma mensagem que descreva a confirmação e selecione Confirmar Tudo.

Screenshot of commit message text and 'Commit All' button in Visual Studio 2019.

Observação

Se você tiver vários arquivos e não quiser confirmar todos eles, clique com o botão direito do mouse em cada arquivo e escolha Estágio. Quando você tiver preparado todos os arquivos que deseja confirmar, selecione Commit Staged. Commit Staged substitui Commit All ao preparar manualmente suas alterações.

Visual Studio Git

Screenshot of the Stage option in the 'Git Changes' window in Visual Studio 2019.

Team Explorer para Visual Studio

Screenshot of the Stage option in the changed-file context menu in Team Explorer in Visual Studio 2019.

Compartilhar suas alterações

Depois de adicionar uma ou mais confirmações a um branch e você estiver pronto para compartilhar essas alterações com outras pessoas, envie suas confirmações por push para que outras pessoas possam vê-las.

Depois de enviar seus commits por push, você pode criar uma solicitação de pull. Uma solicitação de pull permite que outras pessoas saibam que você gostaria de examinar suas alterações. Após a aprovação, uma solicitação de pull normalmente adiciona suas alterações ao branch padrão do repositório remoto.

Visual Studio Git

  1. Na janela Alterações do Git , selecione o botão de push de seta para cima para pressionar sua confirmação.

Screenshot of the up-arrow push button in the 'Git Changes' window of Visual Studio 2019.

Ou você pode efetuar push das alterações da janela do Repositório Git . Para abrir a janela repositório Git , selecione o link de saída/entrada na janela Alterações do Git .

Screenshot of the 'outgoing / incoming' link in the 'Git Changes' window, and the Push link in the 'Git Repository' window of Visual Studio 2019.

Ou você pode enviar suas alterações por push do menu Git na barra de menus.

Screenshot of the Push option from the Git menu in Visual Studio 2019.

  1. Crie uma solicitação de pull para que outras pessoas possam examinar suas alterações. Se você acabou de enviar suas alterações por push da janela Alterações do Git, poderá selecionar o link Criar uma Solicitação de Pull para abrir um navegador da Web em que você pode criar uma nova solicitação de pull no portal da Web Azure Repos.

Screenshot of the 'Create a Pull Request' link in the 'Git Changes' window in Visual Studio 2019.

Ou, se você acabou de enviar suas alterações por push da janela do Repositório Git , poderá selecionar o link Criar uma Solicitação de Pull na parte superior dessa janela.

Screenshot of the 'Create a Pull Request' link in the 'Git Repository' window in Visual Studio 2019.

Ou, você pode clicar com o botão direito do mouse em qualquer branch na janela do Repositório Git e selecionar Criar Solicitação de Pull.

Screenshot of the 'Create a Pull Request' menu option from the branch context menu in the 'Git Repository' window in Visual Studio 2019.

Team Explorer para Visual Studio

  1. No Team Explorer, selecione Página Inicial e escolha Sincronizar para abrir a Sincronização.

Screenshot of the Sync option in Team Explorer in Visual Studio 2019.

Você também pode ir para o modo de exibição sincronização de Alterações escolhendo Sincronizar imediatamente após fazer uma confirmação.

Screenshot of the Sync link that appears after making a commit in Visual Studio 2019.

  1. No modo de exibição Sincronização , escolha Push para carregar sua confirmação no repositório remoto. Se este for o primeiro push para o repositório, você verá a mensagem: The current branch does not track a remote branch..., o que permite que você saiba que sua confirmação foi enviada por push para um novo branch no repositório remoto e que as confirmações futuras enviadas por push do branch atual serão carregadas para esse branch remoto.

Screenshot of the Push link in the Synchronization view of Team Explorer in Visual Studio 2019.

  1. Crie uma solicitação de pull para que outras pessoas possam examinar suas alterações. Abra solicitações de pull no Team Explorer selecionando Página Inicial e escolhendo Solicitações de Pull.

Screenshot of the 'Pull Requests' option in Team Explorer in Visual Studio 2019.

  1. Em Solicitações de Pull, você pode exibir solicitações de pull abertas por você, atribuídas a você e pode criar novas solicitações de pull. Selecione Nova Solicitação de Pull para abrir um navegador da Web em que você pode criar uma nova solicitação de pull no portal da Web Azure Repos.

Screenshot of the 'New Pull Request' link in the Pull Requests view of Team Explorer in Visual Studio 2019.

Quando a solicitação de pull for aberta no portal da Web Azure Repos, verifique suas ramificações de origem e de destino. Neste exemplo, queremos mesclar commits do add-readme-file branch para o main branch. Insira um título e uma descrição opcional, especifique todos os revisores, associe opcionalmente quaisquer itens de trabalho e selecione Criar.

Screenshot of the 'New Pull Request' form in the Azure Repos web portal.

Para obter mais informações sobre solicitações de pull, consulte o tutorial de solicitação pull .

Sincronizar com outras pessoas

Você pode manter seus branches locais em sincronia com seus equivalentes remotos puxando confirmações criadas por outras pessoas. Embora o Git seja bom em mesclar alterações de entrada com suas alterações, às vezes você pode ter que resolver um conflito de mesclagem. Enquanto você estiver trabalhando no branch de recursos, é uma boa ideia alternar periodicamente para o branch main e efetuar pull de novas confirmações para mantê-lo atualizado com o branch remoto main .

Visual Studio Git

Na janela Alterações do Git , você pode manter sua ramificação local atual com seu equivalente remoto usando os botões Buscar, Puxar, Pressionar e Sincronizar .

Screenshot of the Fetch, Pull, Push and Sync buttons in the 'Git Changes' window of Visual Studio 2019.

Da esquerda para a direita na captura de tela anterior, os controles de botão são:

  • Fetch baixa confirmações remotas que não estão no branch local, mas não as mescla.
  • O Pull executa uma busca e mescla as confirmações baixadas no branch local.
  • O push carrega suas confirmações não pressionadas no repositório remoto, o que as adiciona ao branch remoto correspondente.
  • A sincronização executa um Pull e, em seguida, um Push.

Você também pode selecionar Buscar, Puxar, Empurrar e Sincronizar no menu Git.

Screenshot of the Fetch, Pull, Push and Sync options in the Git menu in Visual Studio 2019.

Team Explorer para Visual Studio

  1. No Team Explorer, selecione Página Inicial e escolha Sincronizar para abrir a Sincronização.

Screenshot of the Sync option in 'Team Explorer' in Visual Studio 2019.

  1. Você pode baixar as alterações mais recentes em sua ramificação usando o link Pull . Há dois links pull , um próximo à parte superior e outro na seção Confirmações de Entrada . Você pode usar qualquer um porque ambos fazem a mesma coisa.

Screenshot of the Pull link in the Synchronization view of Team Explorer in Visual Studio 2019.