Partilhar via


Clone um repositório Git existente

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

Visual Studio 2019 | Visual Studio 2022

Você pode criar uma cópia local de um repositório Git remoto clonando-o em uma pasta local no seu computador. A clonagem de um repositório remoto baixa todas as confirmações em todas as ramificações do repositório, a menos que você use a --single-branch opção de clone. A clonagem vincula cada ramificação em seu novo repositório local com a ramificação correspondente no repositório remoto. Dessa forma, quando você pressiona para compartilhar suas alterações de ramificação local com sua equipe, a ramificação remota correspondente é atualizada. Da mesma forma, quando você puxa para atualizar sua ramificação local com alterações feitas por sua equipe, as atualizações da ramificação remota correspondente são recuperadas. O repositório remoto pode ser um repositório Git do 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 do Azure Repos
  • Obter a URL de clone para um repositório GitHub
  • Clonar um repositório Git do Azure Repos
  • Clone um repositório do GitHub
  • Clone qualquer repositório Git
  • Abrir uma solução do Visual Studio a partir de um repositório clonado

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

Pré-requisitos para acesso ao Azure Repos

  • Os repositórios devem ser habilitados em suas configurações de projeto do Azure DevOps. Se o hub Repos e as páginas associadas não forem exibidos, consulte Ativar ou desativar um serviço de DevOps do Azure para reativar Repos.

  • Para exibir 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 visualizar 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 código. Para obter mais informações, consulte O que é um projeto público?

    Nota

    Para projetos públicos, os usuários com acesso de Partes Interessadas têm acesso total aos Repositórios do Azure.

  • Os repositórios devem ser habilitados em suas configurações de projeto do Azure DevOps. Se o hub Repos e as páginas associadas não forem exibidos, consulte Ativar ou desativar um serviço de DevOps do Azure para reativar Repos.

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

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

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

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

Nota

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

  1. No navegador da Web, abra o projeto de equipe para sua organização do Azure DevOps e escolha Arquivos de Repositório> para abrir o modo de exibição Arquivos.

    Captura de tela da página do projeto Azure DevOps.

  2. Na visualização Arquivos, escolha Clonar para iniciar o pop-up Repositório de clones.

    Captura de tela do botão Clonar na página de repositório do Azure DevOps.

  3. Copie a URL do clone do pop-up Clone Repository .

    Captura de ecrã do pop-up 'Repositório de clones' no site do projeto Azure DevOps.

Nota

Com os Serviços de DevOps do Azure, o formato da URL do projeto é dev.azure.com/{your organization}/{your project}. No entanto, o formato anterior que faz referência ao visualstudio.com formato ainda é suportado. Para obter mais informações, consulte Apresentando o Azure DevOps, Alternar 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 do clone identifica exclusivamente o repositório remoto.

Nota

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

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

    Captura de tela da página do repositório no site do GitHub.

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

    Captura de tela do pop-up Clone na página no site do GitHub.

Importante

O botão "Gerar credenciais Git" será removido em janeiro de 2025, para reduzir a criação de tokens de acesso pessoal desnecessários e subutilizados. Consulte a documentação de Autenticação do Git para todos os métodos de autenticação disponíveis para operações de clonagem do Git.

Clonar um repositório Git do Azure Repos

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

Nota

Você pode clonar um repositório Git do Azure Repos público sem entrar como membro de seu projeto pai do Azure DevOps. Para clonar um repositório Git público sem entrar, consulte Clonar qualquer repositório Git e conectar-se a um projeto no Azure DevOps.

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

  1. No menu Git na barra de menus, escolha Clone Repository para abrir a janela Clone a repository.

    Captura de tela da opção 'Clone Repository' no menu Git no Visual Studio.

  2. Na janela Clonar um repositório, selecione Azure DevOps em Procurar um repositório para abrir a janela Conectar a um projeto.

    Captura de tela da janela 'Clone Repository' no Visual Studio.

  3. Na janela Conectar a um projeto, entre no Azure DevOps e escolha o repositório remoto que 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 Servidor de DevOps do Azure 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.

    Captura de tela da janela 'Conectar a um projeto' no Visual Studio.

Depois de clonar um repositório Git remoto, o Visual Studio deteta o clone local e o adiciona à lista de repositórios locais no menu Git .

Captura de tela da opção 'Repositórios locais' no menu Git no Visual Studio.

Clone um repositório do GitHub

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

Nota

Você pode clonar um repositório público do GitHub sem entrar no GitHub ou autenticar de outra forma. Para clonar um repositório Git público sem fazer login, consulte Clone any Git repo.

  1. No menu Git na barra de menus, escolha Clone Repository para abrir a janela Clone a repository.

    Captura de tela da opção 'Clone Repository' no menu Git no Visual Studio.

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

    Captura de tela da opção GitHub na janela 'Clone Repository' no Visual Studio.

  3. Na janela Abrir do GitHub , entre no GitHub e escolha o repositório remoto que 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.

    Captura de tela da janela 'Abrir do GitHub' no Visual Studio.

Depois de clonar um repositório Git remoto, o Visual Studio deteta o clone local e o adiciona à lista de repositórios locais no menu Git .

Captura de tela da opção 'Repositórios locais' no menu Git do Visual Studio.

Clone qualquer repositório Git

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

  1. No menu Git na barra de menus, escolha Clone Repository para abrir a janela Clone a repository.

    Captura de tela da opção 'Clone Repository' no menu Git no Visual Studio.

  2. 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 deseja criar o clone local e escolha Clonar.

    Captura de tela da janela 'Clone a repository' no Visual Studio.

Depois de clonar um repositório Git remoto, o Visual Studio deteta o clone local e o adiciona à lista de repositórios locais no menu Git .

Captura de tela da opção 'Repositórios locais' no menu Git no Visual Studio.

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

  1. Escolha o > de abertura > de arquivo na barra de menus e selecione o arquivo de solução a ser aberto.

    Captura de tela da opção Abrir solução no menu Arquivo no Visual Studio.

  2. A solução do Visual Studio que você selecionou agora está aberta no Gerenciador de Soluções.

    Captura de ecrã de uma solução aberta no 'Solution Explorer' no Visual Studio.

Próximos passos