Skip to main content

Sobre repositórios remotos

A abordagem colaborativa do GitHub para o desenvolvimento depende da publicação de commits do seu repositório local em GitHub para que outras pessoas possam visualizá-los, buscá-los e atualizá-los.

Sobre repositórios remotos

Uma URL remota é outra forma de o Git dizer "o lugar onde seu código é armazenado". Essa URL pode ser o repositório no GitHub, o fork de outro usuário, ou até mesmo em um servidor totalmente diferente.

Você pode enviar apenas para dois tipos de endereço URL:

  • Uma URL HTTPS como https://HOSTNAME/user/repo.git
  • Uma URL SSH como git@HOSTNAME:user/repo.git

O Git associa uma URL remota a um nome, e o repositório remoto padrão geralmente é chamado origin.

Criar repositórios remotos

Use o comando git remote add para corresponder uma URL remota com um nome. Por exemplo, você digitaria o seguinte na linha de comando:

git remote add origin <REMOTE_URL>

Isso associa o nome origin à REMOTE_URL.

Use o comando git remote set-url para alterar a URL de um repositório remoto.

Escolher uma URL para o seu repositório remoto

Há várias maneiras de clonar repositórios disponíveis em GitHub.

Quando você visualiza um repositório conectado à sua conta, as URLs que podem ser usadas para clonar o projeto no computador ficam disponíveis abaixo dos detalhes do repositório.

Para obter informações sobre como definir ou alterar a URL remota, confira Gerenciar repositórios remote.

Clonando com as URLs de HTTPS

As URLs de clone https:// estão disponíveis em todos os repositórios, independentemente da visibilidade. As URLs de clone https:// funcionam mesmo que você esteja protegido por um firewall ou um proxy.

Quando você git clone, git fetch, git pullou git push para um repositório remoto privado usando URLs HTTPS na linha de comando, o Git solicitará seu GitHub nome de usuário e senha. Quando o Git solicitar sua senha, insira seu personal access token. Como alternativa, você pode usar um auxiliar de credenciais como o Gerenciador de Credenciais do Git. A autenticação baseada em senha para o Git foi removida em favor de métodos de autenticação mais seguros. Para saber mais, confira Gerenciar seus tokens de acesso pessoal.

Dica

Clonar com URLs de SSH

As URLs de SSH fornecem acesso a um repositório do Git via SSH, um protocolo seguro. Para usar essas URLs, você deve gerar um keypair SSH em seu computador e adicionar a chave pública à sua conta GitHub. Para saber mais, confira Conectando-se ao GitHub com o SSH.

Quando você usar git clone, git fetch, git pullou git push em um repositório remoto usando URLs SSH, precisará inserir uma senha e fornecer sua frase secreta de chave SSH. Para saber mais, confira Trabalhar com frase secreta da chave SSH.

Dica

Use uma URL com SSH para clonar um repositório no computador ou como uma forma segura de implantar o código em servidores de produção. Você também pode usar o encaminhamento de agente SSH com o seu script de implantação para evitar o gerenciamento de chaves no servidor. Para saber mais, confira Usar o encaminhamento de agente SSH.

Clonagem com GitHub CLI

Você também pode instalar GitHub CLI para usar fluxos de trabalho do GitHub no terminal. Para saber mais, confira Sobre GitHub CLI.