Introdução ao Git no Azure Repos

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

Visual Studio 2019 | Visual Studio 2022

Comece a desenvolver seu código usando Azure Repos e repositórios Git. Você pode usar comandos do Visual Studio ou do Git para clonar um repositório, definir branches locais, confirmar e enviar alterações por push e sincronizar com outros. Se você precisar criar ou importar um repositório, consulte Criar um novo Repositório do Git em seu projeto ou Importar um Repositório do Git.

Observação

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

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

Observação

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

Pré-requisitos

• Os repositórios devem estar habilitados nas configurações do projeto do Azure DevOps. Se o hub do Repositório e as páginas associadas não forem exibidos, consulte Ativar ou desativar um serviço do Azure DevOps para reabilitar o Repositório.

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

  • Se você não tiver um projeto, crie um ou crie uma conta gratuitamente.

  • Se você não for um membro do projeto, será adicionado.

• Para clonar ou contribuir com o código para 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 código. Para obter mais informações, consulte O que é um projeto público?

  Observação

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

Para obter mais informações sobre permissões e acesso, consulte Permissões padrão de branch e repositório Git e Sobre níveis de acesso.

Obter o código

Você pode clonar um Repositório do Git remoto para criar uma cópia local dele. A clonagem cria uma cópia do código-fonte para você trabalhar com as 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 clonar, consulte Criar um novo Repositório do Git. Depois de criar seu repositório local, você pode continuar a confirmar, compartilhar e sincronizar seu trabalho.

Visual Studio 2022

O Visual Studio 2022 fornece uma experiência de controle de versão do Git usando o menu Git, as Alterações do Git e através dos menus de contexto no Gerenciador de Soluções. O Visual Studio 2019, versão 16.8, também oferece a interface do usuário do Git do Team Explorer. Para obter mais informações, consulte a guia Visual Studio 2019 – Team Explorer.

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

   

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

   

3. Selecione Clonar. Depois de clonar um Repositório do Git, o Visual Studio detecta o repositório e o adiciona à sua lista de Repositórios Locais no menu Git.

   

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 visualstudio.comformato anterior que faz referência ao formato. Para obter mais informações, consulte Apresentando o Azure DevOps, Alterne as organizações existentes para usar a nova URL de nome de domínio.

Visual Studio 2019 - Menu Git

O Visual Studio 2019 fornece uma experiência de controle de versão do Git usando o menu Git, as Alterações do Git e através dos menus de contexto no Gerenciador de Soluções.

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

   

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

   

3. Selecione Clonar. Depois de clonar um Repositório do Git, o Visual Studio detecta o repositório e o adiciona à sua lista de Repositórios Locais no menu Git.

   

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 visualstudio.comformato anterior que faz referência ao formato. Para obter mais informações, consulte Apresentando o Azure DevOps, Alterne as organizações existentes para usar a nova URL de nome de domínio.

Visual Studio 2019 - Team Explorer

O Visual Studio 2019 versão 16.8 e versões posteriores fornece uma experiência de controle de versão do Git, mantendo a interface do usuário do Team Explorer Git. Você pode exercer os recursos do Git de qualquer interface de forma intercambiável.

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 Team Explorer do Visual Studio.

1. Em Team Explorer, selecione Conectar para abrir a página Conectar e, em seguida, escolha Gerenciar Conexões>Conectar ao Projeto.

   

2. Na janela Conectar a um Projeto , 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.

   

3. 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 visualstudio.comformato anterior que faz referência ao formato. Para obter mais informações, consulte Apresentando o Azure DevOps, Alterne as organizações existentes para usar a nova URL de nome de domínio.

Linha de comando Git

1. Baixe e instale o Git e o Git Credential Manager para sua plataforma.

2. Abra o portal da Web do Azure DevOps Services no navegador acessando https://<your account name>.visualstudio.com.

3. Abra o portal da Web Azure DevOps Services no navegador navegando até https://<your account name>.visualstudio.com e localize seu Repositório do Git. Copie a URL do clone do pop-up Clone.

   

   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 visualstudio.comformato anterior que faz referência ao formato. Para obter mais informações, consulte Apresentando o Azure DevOps, Alterne as organizações existentes para usar a nova URL de nome de domínio.

4. No prompt de comando, vá para a pasta em que você deseja que o código seja armazenado no computador local.

5. No prompt de comando, execute git clone seguido pela URL de clone, conforme mostrado no exemplo a seguir.

    > git clone https://dev.azure.com/fabrikam-fiber/_git/FabrikamFiber
   

   O Git baixa e cria sua própria cópia do código em uma nova pasta para você.

Confirmar seu trabalho

Os branches do Git isolam suas alterações de outros trabalhos no projeto. O fluxo de trabalho do Git recomendado usa um novo branch para cada recurso ou correção trabalhada por você. Você faz commits no Repositório do Git local para salvar as alterações nesse branch.

Visual Studio 2022

1. No menu Git na barra de menus, escolha Novo Branch para abrir a janela Criar um novo branch.

   

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

   

3. 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 do Visual Studio no repositório. O Git acompanha as alterações feitas dentro e fora do Visual Studio.

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

   

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

   

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 Preparar. Quando você tiver preparado todos os arquivos que deseja confirmar, selecione Commit Staged. Commit Staged substitui Confirmar Tudo quando você prepara manualmente suas alterações.

Visual Studio 2019 - Menu Git

1. No menu Git na barra de menus, escolha Novo Branch para abrir a janela Criar um novo branch.

   

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

   

3. 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 do Visual Studio no repositório. O Git acompanha as alterações feitas dentro e fora do Visual Studio.

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

   

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

   

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 Preparar. Quando você tiver preparado todos os arquivos que deseja confirmar, selecione Commit Staged. Commit Staged substitui Confirmar Tudo quando você prepara manualmente suas alterações.

Visual Studio 2019 - Team Explorer

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

   

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

   

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

   

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

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

   

6. Insira uma mensagem que descreva o commit e selecione Confirmar Tudo.

   

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 Preparar. Quando você tiver preparado todos os arquivos que deseja confirmar, selecione Commit Staged. Commit Staged substitui Confirmar Tudo quando você prepara manualmente suas alterações.

Linha de comando Git

1. Crie um branch em que você faça suas alterações no código. Se você estiver colaborando com alguém usando um branch que ele criou, poderá pular para a git checkout etapa a seguir.

    > git branch ReadMeFix
   

   Escolha um nome de branch descritivo para seu trabalho para lembrar você e outras pessoas sobre o tipo de trabalho no branch.

2. Confira seu branch para que você possa começar a trabalhar nele.

    > git checkout ReadMeFix
   

   Você também pode usar o checkout comando para começar a trabalhar em um branch no qual outros membros da equipe já estão trabalhando.

3. Faça alterações usando suas ferramentas favoritas no código.

4. Quando você estiver satisfeito com as alterações, mesmo que não esteja pronto para compartilhar o trabalho, salve-os no Git usando um commit. Suas alterações não serão compartilhadas até que você as envie por push, conforme descrito na seção a seguir.

    > git commit -a -m "Descriptive message"
   

   Esse comando salva suas alterações localmente em um novo commit no Git. Certifique-se de dar ao commit uma breve mensagem que descreva suas alterações após -m.

Compartilhar suas alterações

Depois de adicionar um ou mais commits a um branch e estiver pronto para compartilhar essas alterações com outras pessoas, envie seus commits por push para que outras pessoas possam vê-los.

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 2022

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

   

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

   

   Ou você pode efetuar push das alterações no menu Git na barra de menus.

   

2. Crie uma solicitação de pull para que outras pessoas possam examinar suas alterações. Se você tiver acabado de efetuar push das alterações na janela Alterações do Git, poderá selecionar o link Criar uma Solicitação de Pull para abrir um navegador da Web no qual você pode criar uma nova solicitação de pull no portal da Web do Azure Repos.

   

   Ou, se você tiver acabado de efetuar push das alterações na janela Repositório do Git , poderá selecionar o link Criar uma Solicitação de Pull na parte superior dessa janela.

   

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

   

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

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

Visual Studio 2019 - Menu Git

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

   

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

   

   Ou você pode efetuar push das alterações no menu Git na barra de menus.

   

2. Crie uma solicitação de pull para que outras pessoas possam examinar suas alterações. Se você tiver acabado de efetuar push das alterações na janela Alterações do Git, poderá selecionar o link Criar uma Solicitação de Pull para abrir um navegador da Web no qual você pode criar uma nova solicitação de pull no portal da Web do Azure Repos.

   

   Ou, se você tiver acabado de efetuar push das alterações na janela Repositório do Git , poderá selecionar o link Criar uma Solicitação de Pull na parte superior dessa janela.

   

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

   

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

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

Visual Studio 2019 - Team Explorer

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

   

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

   

2. No modo de exibição Sincronização, escolha Push para carregar sua confirmação no repositório remoto. Se este for seu primeiro push para o repositório, você verá a mensagem: The current branch does not track a remote branch..., que permite que você saiba que a 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.

   

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

   

4. 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 no qual você pode criar uma nova solicitação de pull no portal da Web do Azure Repos.

   

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

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

Linha de comando Git

1. Efetue push do branch para que outras pessoas possam ver as alterações salvas.

    > git push -u origin ReadMeFix
   

2. Abra o projeto no portal da Web e navegue até o repositório na guia Código. Selecione Criar uma solicitação de pull para criar uma solicitação de pull para o branch que você efetuou push.

   

3. Verifique seus branches. Neste exemplo, queremos mesclar commits do ReadMeFix branch no main branch. Insira um título e uma descrição opcional, especifique todos os revisores, associe opcionalmente quaisquer itens de trabalho e selecione Criar.

   

4. Depois que as alterações forem aprovadas, conclua a solicitação de pull. Uma solicitação de pull completa adiciona as alterações do branch ao branch principal do código.

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

Sincronizar com outras pessoas

Você pode manter seus branches locais sincronizados com seus equivalentes remotos efetuando pull de commits criados por outras pessoas. Embora o Git seja bom em mesclar alterações de entrada com suas alterações, às vezes, talvez seja necessário resolver um conflito de mesclagem. Enquanto você estiver trabalhando em seu branch de recurso, é uma boa ideia alternar periodicamente para o main branch e efetuar pull de novos commits para mantê-lo atualizado com o branch remotomain.

Visual Studio 2022

Na janela Alterações do Git , você pode manter seu branch local atualizado com seu equivalente remoto usando os botões Buscar, Pull, Push e Sincronizar.

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

• Buscar baixa commits remotos que não estão no branch local, mas não os mescla.
• Pull executa uma busca e mescla os commits baixados no branch local.
• Push carrega seus commits não efetuados por push para o repositório remoto, que os adiciona ao branch remoto correspondente.
• Sincronizar executa um Pull e, em seguida, um Push.

Você também pode selecionar Buscar, Pull, Push, e Sincronizar no menu Git.

Visual Studio 2019 - Menu Git

Na janela Alterações do Git , você pode manter seu branch local atualizado com seu equivalente remoto usando os botões Buscar, Pull, Push e Sincronizar.

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

• Buscar baixa commits remotos que não estão no branch local, mas não os mescla.
• Pull executa uma busca e mescla os commits baixados no branch local.
• Push carrega seus commits não efetuados por push para o repositório remoto, que os adiciona ao branch remoto correspondente.
• Sincronizar executa um Pull e, em seguida, um Push.

Você também pode selecionar Buscar, Pull, Push, e Sincronizar no menu Git.

Visual Studio 2019 - Team Explorer

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

   

2. Você pode baixar as alterações mais recentes no branch 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.

   

Linha de comando Git

1. Alterne para o branch onde você deseja baixar as alterações que outras pessoas fizeram.

    > git checkout ReadMeFix
   

   Neste exemplo, você efetua pull de alterações feitas por outras pessoas em sua equipe para o ReadMeFix branch para sua cópia local do branch.

2. Efetuar pull das alterações feitas por outras pessoas no branch local.

    > git pull
   

   O Git baixa as alterações e as mescla com suas próprias alterações no branch local.

Artigos relacionados

• Perguntas frequentes sobre Git
• Experiência do Git no Visual Studio
• Comparação lado a lado do Git e do Team Explorer