Sobre repositórios remote

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 se autenticar. 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".

Se você prefere usar o SSH mas não consegue se conectar pela porta 22, use o SSH pela porta HTTPS. Para saber mais, 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 saber mais, 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 saber mais, 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.

Clonar com GitHub CLI

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