{"meta":{"title":"Gerenciar repositórios remote","intro":"Aprenda a trabalhar com seus repositórios locais no seu computador e repositórios remotos hospedados no GitHub.","product":"Introdução","breadcrumbs":[{"href":"/pt/enterprise-server@3.20/get-started","title":"Introdução"},{"href":"/pt/enterprise-server@3.20/get-started/git-basics","title":"Noções básicas do Git"},{"href":"/pt/enterprise-server@3.20/get-started/git-basics/managing-remote-repositories","title":"Gerenciar repositórios remotos"}],"documentType":"article"},"body":"# Gerenciar repositórios remote\n\nAprenda a trabalhar com seus repositórios locais no seu computador e repositórios remotos hospedados no GitHub.\n\n## Adicionar um repositório remoto\n\nPara adicionar um novo controle remoto, use o comando `git remote add` no terminal, no diretório em que o repositório está armazenado.\n\nO comando `git remote add` usa dois argumentos:\n\n* Um nome remoto, por exemplo, `origin`\n* Uma URL remota, por exemplo, `https://HOSTNAME/OWNER/REPOSITORY.git`\n\nPor exemplo:\n\n```shell\n$ git remote add origin https://HOSTNAME/OWNER/REPOSITORY.git\n# Set a new remote\n\n$ git remote -v\n# Verify new remote\n> origin  https://HOSTNAME/OWNER/REPOSITORY.git (fetch)\n> origin  https://HOSTNAME/OWNER/REPOSITORY.git (push)\n```\n\nPara obter mais informações sobre a URL que deve ser usada, confira [Sobre repositórios remotos](/pt/enterprise-server@3.20/get-started/git-basics/about-remote-repositories).\n\n### Solução de problemas: A origem remota já existe\n\nEsse erro significa que você tentou adicionar um remoto com um nome que já existe no repositório local.\n\n```shell\n$ git remote add origin https://HOSTNAME/octocat/Spoon-Knife.git\n> fatal: remote origin already exists.\n```\n\nPara corrigir isso, você pode:\n\n* Usar um nome diferente para o novo controle remoto.\n* Renomeie o repositório remoto existente antes de adicionar o novo repositório remoto. Para obter mais informações, confira [Renomear um repositório remoto](#renaming-a-remote-repository) abaixo.\n* Exclua o repositório remoto existente antes de adicionar o novo repositório remoto. Para obter mais informações, confira [Remover um repositório remoto](#removing-a-remote-repository) abaixo.\n\n## Alterar a URL de um repositório remoto\n\nO comando `git remote set-url` altera uma URL do repositório remoto existente.\n\n> \\[!TIP]\n> Para obter informações sobre a diferença entre URLs HTTPS e SSH, confira [Sobre repositórios remotos](/pt/enterprise-server@3.20/get-started/git-basics/about-remote-repositories).\n\nO comando `git remote set-url` usa dois argumentos:\n\n* Um nome remoto existente. Por exemplo, `origin` ou `upstream` são duas opções comuns.\n* Uma nova URL para o remoto. Por exemplo:\n\n  * Se estiver atualizando para usar HTTPS, a URL poderá ser parecida com esta:\n\n  ```shell\n  https://HOSTNAME/OWNER/REPOSITORY.git\n  ```\n\n  * Se estiver atualizando para usar SSH, a URL poderá ser parecida com esta:\n\n  ```shell\n  git@HOSTNAME:OWNER/REPOSITORY.git\n  ```\n\n### Alternar URLs remotos de SSH para HTTPS\n\n1. Abra <span class=\"platform-mac\">Terminal</span><span class=\"platform-linux\">Terminal</span><span class=\"platform-windows\">Git Bash</span>.\n\n2. Altere o diretório de trabalho atual para seu projeto local.\n\n3. Liste seus remotes existentes para obter o nome do remote que deseja alterar.\n\n   ```shell\n   $ git remote -v\n   > origin  git@HOSTNAME:OWNER/REPOSITORY.git (fetch)\n   > origin  git@HOSTNAME:OWNER/REPOSITORY.git (push)\n   ```\n\n4. Altere a URL do remoto de SSH para HTTPS com o comando `git remote set-url`.\n\n   ```shell\n   git remote set-url origin https://HOSTNAME/OWNER/REPOSITORY.git\n   ```\n\n5. Verifique se o URL remote foi alterado.\n\n   ```shell\n   $ git remote -v\n   # Verify new remote URL\n   > origin  https://HOSTNAME/OWNER/REPOSITORY.git (fetch)\n   > origin  https://HOSTNAME/OWNER/REPOSITORY.git (push)\n   ```\n\nNa próxima vez que você usar `git fetch`, `git pull` ou `git push` para o repositório remoto, deverá fornecer seu nome de usuário e 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](https://github.com/GitCredentialManager/git-credential-manager/blob/main/README.md). 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](/pt/enterprise-server@3.20/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token).\n\nÉ possível [usar um auxiliar de credencial](/pt/enterprise-server@3.20/get-started/git-basics/caching-your-github-credentials-in-git) para que o Git se lembre do nome de usuário do GitHub e do personal access token toda vez que se comunicar com o GitHub.\n\n### Mudar as URLs remotas de HTTPS para SSH\n\n1. Abra <span class=\"platform-mac\">Terminal</span><span class=\"platform-linux\">Terminal</span><span class=\"platform-windows\">Git Bash</span>.\n\n2. Altere o diretório de trabalho atual para seu projeto local.\n\n3. Liste seus remotes existentes para obter o nome do remote que deseja alterar.\n\n   ```shell\n   $ git remote -v\n   > origin  https://HOSTNAME/OWNER/REPOSITORY.git (fetch)\n   > origin  https://HOSTNAME/OWNER/REPOSITORY.git (push)\n   ```\n\n4. Altere a URL do seu remoto de HTTPS para SSH com o comando `git remote set-url`.\n\n   ```shell\n   git remote set-url origin git@HOSTNAME:OWNER/REPOSITORY.git\n   ```\n\n5. Verifique se o URL remote foi alterado.\n\n   ```shell\n   $ git remote -v\n   # Verify new remote URL\n   > origin  git@HOSTNAME:OWNER/REPOSITORY.git (fetch)\n   > origin  git@HOSTNAME:OWNER/REPOSITORY.git (push)\n   ```\n\n### Solução de problemas: Não há tal '\\[name]' remoto '\n\nEste erro informa que o remote que você tentou alterar não existe:\n\n```shell\n$ git remote set-url sofake https://HOSTNAME/octocat/Spoon-Knife\n> fatal: No such remote 'sofake'\n```\n\nVerifique se você inseriu corretamente o nome do remoto.\n\n## Renomear um repositório remoto\n\nUse o comando `git remote rename` para renomear um remoto existente.\n\nO comando `git remote rename` usa dois argumentos:\n\n* Um nome remoto existente, por exemplo, `origin`\n* Um novo nome para o remoto, por exemplo, `destination`\n\n### Exemplo de como renomear um repositório remoto\n\nEsses exemplos pressupõem que você esteja [clonando usando HTTPS](/pt/enterprise-server@3.20/get-started/git-basics/about-remote-repositories#cloning-with-https-urls), o que é recomendado.\n\n```shell\n$ git remote -v\n# View existing remotes\n> origin  https://HOSTNAME/OWNER/REPOSITORY.git (fetch)\n> origin  https://HOSTNAME/OWNER/REPOSITORY.git (push)\n\n$ git remote rename origin destination\n# Change remote name from 'origin' to 'destination'\n\n$ git remote -v\n# Verify remote's new name\n> destination  https://HOSTNAME/OWNER/REPOSITORY.git (fetch)\n> destination  https://HOSTNAME/OWNER/REPOSITORY.git (push)\n```\n\n### Solução de problemas: Não foi possível renomear a seção de configuração 'remote.\\[old name]' para 'remote.\\[new name]'\n\nEste erro significa que o nome remoto antigo digitado não existe.\n\nVocê pode verificar quais remotos existem atualmente com o comando `git remote -v`:\n\n```shell\n$ git remote -v\n# View existing remotes\n> origin  https://HOSTNAME/OWNER/REPOSITORY.git (fetch)\n> origin  https://HOSTNAME/OWNER/REPOSITORY.git (push)\n```\n\n### Solução de problemas: Já existe um \\[new name] remoto\n\nEsse erro informa que o nome de remote que você deseja usar já existe. Para resolver isso, use um nome remoto diferente ou renomeie o remoto original.\n\n## Remover um repositório remoto\n\nUse o comando `git remote rm` para remover uma URL remota do repositório.\n\nO comando `git remote rm` usa um argumento:\n\n* Um nome remoto, por exemplo, `destination`\n\nA remoção do URL remoto do repositório apenas desvincula os repositórios locais e remotos. Isso não exclui o repositório remoto.\n\n### Exemplo de como remover um repositório remoto\n\nEsses exemplos pressupõem que você esteja [clonando usando HTTPS](/pt/enterprise-server@3.20/get-started/git-basics/about-remote-repositories#cloning-with-https-urls), o que é recomendado.\n\n```shell\n$ git remote -v\n# View current remotes\n> origin  https://HOSTNAME/OWNER/REPOSITORY.git (fetch)\n> origin  https://HOSTNAME/OWNER/REPOSITORY.git (push)\n> destination  https://HOSTNAME/FORKER/REPOSITORY.git (fetch)\n> destination  https://HOSTNAME/FORKER/REPOSITORY.git (push)\n\n$ git remote rm destination\n# Remove remote\n$ git remote -v\n# Verify it's gone\n> origin  https://HOSTNAME/OWNER/REPOSITORY.git (fetch)\n> origin  https://HOSTNAME/OWNER/REPOSITORY.git (push)\n```\n\n> \\[!NOTE]\n\n```\n          `git remote rm` não exclui o repositório remoto do servidor. Ele simplesmente remove o remoto e suas referências do repositório local.\n```\n\n### Solução de problemas: Não foi possível remover a seção 'remote.\\[name]'\n\nEsse erro informa que o remote que você tentou excluir não existe:\n\n```shell\n$ git remote rm sofake\n> error: Could not remove config section 'remote.sofake'\n```\n\nVerifique se você inseriu corretamente o nome do remoto.\n\n## Leitura adicional\n\n* [\"Como trabalhar com repositórios remotos\" do livro *Pro Git*](https://git-scm.com/book/en/v2/Git-Basics-Working-with-Remotes)"}