Clonar um repositório Git existente

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

Você pode criar uma cópia local de um repositório Git remoto clonando-a em uma pasta local em seu computador. A clonagem de um repositório remoto baixa todas as confirmações em todos os branches do repositório, a menos que você use a opção --single-branch clone. A clonagem vincula cada branch em seu novo repositório local com o branch correspondente no repositório remoto. Dessa forma, quando você envia por push para compartilhar as alterações de branch local com sua equipe, o branch remoto correspondente é atualizado. Da mesma forma, quando você efetua pull para atualizar sua ramificação local com alterações feitas por sua equipe, as atualizações do branch remoto correspondente são recuperadas. O repositório remoto pode ser um repositório git Azure Repos, um repositório GitHub ou outro repositório Git hospedado.

Este artigo fornece procedimentos para as seguintes tarefas:

  • Obter a URL de clone para um repositório git Azure Repos
  • Obter a URL de clone para um repositório GitHub
  • Clonar um repositório Git Azure Repos
  • Clonar um repositório GitHub
  • Clonar qualquer repositório Git
  • Abrir uma solução de Visual Studio de um repositório clonado

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

Pré-requisitos para acesso 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 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.

Obter a URL de clone de um repositório Git Azure Repos

Normalmente, você precisa saber a URL de clone do repositório remoto que deseja clonar. A URL de clone identifica exclusivamente o repositório remoto.

Observação

Quando você está conectado a um projeto Azure DevOps, Visual Studio dá suporte à pesquisa e à clonagem de repositórios de projeto sem a necessidade de saber a URL do clone.

  1. No navegador da Web, abra o projeto de equipe para sua organização Azure DevOps e escolha Repos>Files para abrir a exibição Arquivos.

    Screenshot of the Azure DevOps project page.

  2. Na exibição Arquivos , escolha Clonar para iniciar o pop-up clonar repositório .

    Screenshot of the Clone button on the Azure DevOps repo page.

  3. Copie a URL de clone do pop-up do Repositório clone .

    Screenshot of the 'Clone Repository' popup on the Azure DevOps project site.

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.

Obter a URL de clone de um repositório GitHub

Normalmente, você precisa saber a URL de clone do repositório remoto que deseja clonar. A URL de clone identifica exclusivamente o repositório remoto.

Observação

Quando você está conectado ao GitHub, Visual Studio dá suporte à pesquisa e à clonagem GitHub repositórios sem a necessidade de saber a URL do clone.

  1. Abra um navegador e navegue até sua conta GitHub, selecione a guia Repositórios e escolha o repositório a ser clonado.

    Screenshot of the repository page on the GitHub site.

  2. Na página GitHub repositório, escolha Código para iniciar o pop-up Clone. Copie a URL de clone do pop-up Clone .

    Screenshot of the Clone popup on the page on the GitHub site.

Clonar um repositório Git Azure Repos

Ao entrar como membro de um projeto de Azure DevOps, você pode clonar repositórios privados acessíveis para você e repositórios públicos. Visual Studio dá suporte a operações de pesquisa, clonagem e sincronização em repositórios acessíveis por meio da autenticação.

Observação

Você pode clonar um repositório Git Azure Repos público sem entrar como membro de seu projeto de Azure DevOps pai. Para clonar um repositório Git público sem entrar, consulte Clonar qualquer repositório Git e Conexão para um projeto em Azure DevOps.

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. Para usar o Team Explorer, desmarque a experiência do usuário ToolsOptionsPreview>>FeaturesNew>Git na barra de menus. Você pode usar recursos do Git de qualquer interface intercambiável. Abaixo, fornecemos uma comparação lado a lado para clonar um repositório git Azure Repos.

Visual Studio Git

  1. No menu Git na barra de menus, escolha Clonar Repositório para abrir a janela Clonar um repositório .

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

  1. Na janela Clonar um repositório, selecione Azure DevOps em Procurar um repositório para abrir o Conexão em uma janela de Project.

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

  1. No Conexão para uma janela Project, entre no Azure DevOps e escolha o repositório remoto que você deseja clonar. Você pode usar a caixa de pesquisa para filtrar a lista de repositórios remotos. Se você não vir o repositório remoto, selecione Adicionar Azure DevOps Server para adicionar o servidor que hospeda o repositório. Verifique o caminho da pasta local onde você deseja que o clone local seja criado e selecione Clonar.

Screenshot of the 'Connect to a Project' window 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, entre no Azure DevOps e escolha o repositório remoto que você deseja clonar. Você pode usar a caixa de pesquisa para filtrar a lista de repositórios remotos. Se você não vir o repositório remoto, selecione Adicionar Azure DevOps Server para adicionar o servidor que hospeda o repositório. Verifique o caminho da pasta local onde você deseja que o clone local seja criado e selecione Clonar.

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

Depois de clonar um repositório Git remoto, Visual Studio detectará o clone local e o adicionará à lista de Repositórios Locais no menu Git.

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

Clonar um repositório GitHub

Ao entrar em GitHub ou usando a autenticação SSH, você pode clonar repositórios privados acessíveis para você e repositórios públicos. Visual Studio dá suporte a operações de pesquisa, clonagem e sincronização em repositórios acessíveis por meio da autenticação.

Observação

Você pode clonar um repositório de GitHub público sem entrar no GitHub ou autenticar de outra forma. Para clonar um repositório Git público sem entrar, consulte Clonar qualquer repositório Git.

Visual Studio versão 16.8 de 2019 e versões posteriores fornecem uma experiência de controle de versão do Git que dá suporte a operações de pesquisa, clone e sincronização em GitHub repositórios acessíveis por meio da autenticação. Para clonar um repositório GitHub usando o Team Explorer, consulte Clonar qualquer repositório Git. As etapas a seguir se aplicam à experiência de controle de versão do Git.

  1. No menu Git na barra de menus, escolha Clonar Repositório para abrir a janela Clonar um repositório .

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

  2. Na janela Clonar um repositório, selecione GitHub em Procurar um repositório para abrir a janela Abrir de GitHub.

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

  3. Na janela Abrir de GitHub, entre no GitHub e escolha o repositório remoto que você deseja clonar. Você pode usar a caixa de pesquisa para filtrar a lista de repositórios remotos. Verifique o caminho da pasta local onde você deseja que o clone local seja criado e escolha Clonar.

    Screenshot of the 'Open from GitHub' window in Visual Studio 2019.

Depois de clonar um repositório Git remoto, Visual Studio detectará o clone local e o adicionará à lista de Repositórios Locais no menu Git.

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

Clonar qualquer repositório Git

Você pode clonar qualquer repositório Git acessível a você usando a URL de clone do repositório.

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. Para usar o Team Explorer, desmarque a experiência do usuário ToolsOptionsPreview>>FeaturesNew>Git na barra de menus. Você pode usar recursos do Git de qualquer interface intercambiável. Abaixo, fornecemos uma comparação lado a lado para clonar qualquer repositório Git.

Visual Studio Git

  1. No menu Git na barra de menus, escolha Clonar Repositório para abrir a janela Clonar um repositório .

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

  1. Na janela Clonar um repositório , insira a URL de clone do repositório Git remoto que você deseja clonar, verifique o caminho da pasta local onde você deseja criar o clone local e escolha Clonar.

Screenshot of the 'Clone a repository' window 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 Clonar em Repositórios Git Locais.

Screenshot of the Clone link in the Connect view of Team Explorer in Visual Studio 2019.

  1. Insira a URL de clone do repositório Git remoto que você deseja clonar, verifique o caminho da pasta local onde você deseja criar o clone local e escolha Clonar. Para clonar o repositório Git remoto e todos os repositórios Git aninhados dentro dele, deixe Os Submódulos clonados recursivamente verificados .

Screenshot of the Clone options in the 'Local Git Repositories' section of the 'Team Explorer' Connect view in Visual Studio 2019.

Depois de clonar um repositório Git remoto, Visual Studio detectará o clone local e o adicionará à lista de Repositórios Locais no menu Git.

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

Abrir uma solução de Visual Studio de um repositório clonado

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. Para usar o Team Explorer, desmarque a experiência do usuário ToolsOptionsPreview>>FeaturesNew>Git na barra de menus. Você pode usar recursos do Git de qualquer interface intercambiável. Abaixo, fornecemos uma comparação lado a lado para abrir uma solução Visual Studio de um repositório clonado.

Visual Studio Git

  1. Escolha o arquivo > Abrir > Project/Solução na barra de menus e selecione o arquivo de solução a ser aberto.

Screenshot of the Open Solution option in the File menu in Visual Studio 2019.

  1. A solução Visual Studio selecionada agora está aberta em Gerenciador de Soluções.

Screenshot of an open solution in 'Solution Explorer' in Visual Studio 2019.

Team Explorer para Visual Studio

  1. Clique com o botão direito do mouse em um repositório na exibição Conexão do Team Explorer e escolha Abrir.

Screenshot of cloned repos in the 'Local Git Repositories' section of Team Explorer in Visual Studio 2019.

  1. Na exibição Página Inicial do Team Explorer, clique duas vezes no arquivo de solução em Soluções.

Screenshot of the solution file in the Solutions section of Team Explorer in Visual Studio 2019.

  1. A solução Visual Studio selecionada agora está aberta em Gerenciador de Soluções.

Screenshot of an open solution within 'Solution Explorer' in Visual Studio 2019.

Próximas etapas