Skip to main content

Sobre repositórios remote

A abordagem colaborativa do GitHub para o desenvolvimento depende da publicação de commits do seu repositório local para GitHub para que outras pessoas visualizem, façam buscas e atualizações.

Sobre repositórios remote

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

Você pode fazer push apenas de dois tipos de endereço URL:

  • Uma URL HTTPS como https://github.com/user/repo.git
  • Uma URL SSH como git@github.com: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

Existem várias maneiras de clonar repositórios disponíveis no 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ê usar git clone, git fetch, git pull ou git push em um repositório remoto usando URLs HTTPS na linha de comando, o Git solicitará seu nome de usuário e sua senha do GitHub. 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 obter mais informações, confira "Gerenciar seus tokens de acesso pessoal".

Se você estiver acessando uma organização que usa o SSO do SAML e usando um personal access token (classic), será necessário autorizar o personal access token para acessá-la antes de autenticar-se. Para obter mais informações, confira "Sobre a autenticação com logon único de SAML" e "Autorizar o uso de um token de acesso pessoal para uso com logon único SAML".

Dicas:

Se você prefere usar o SSH mas não consegue se conectar pela porta 22, use o SSH pela porta HTTPS. Para obter mais informações, confira "Usar SSH na porta HTTPS".

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, gere um par de chaves SSH no computador e adicione a chave pública à sua conta do GitHub. Para obter mais informações, confira "Conectar-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 obter mais informações, confira "Trabalhar com frase secreta da chave SSH".

Se você estiver acessando uma organização que usa o SSO (logon único) do SAML, precisará autorizar sua chave SSH a acessar a organização antes de realizar a autenticação. Para obter mais informações, confira "Sobre a autenticação com logon único de SAML" e "Autorizar o uso de uma chave SSH para uso com logon único SAML" na documentação do GitHub Enterprise Cloud.

Dica: use uma URL com SSH para clonar um repositório no computador ou como uma forma segura de implantar seu 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 obter mais informações, confira "Usar o encaminhamento de agente SSH".

Clonar com GitHub CLI

Você também pode instalar o GitHub CLI para usar os fluxos de trabalho do GitHub no seu terminal. Para obter mais informações, confira "Sobre o a CLI do GitHub".