O comando git remote rename
tem dois argumentos:
- O nome de um remote existente, como
origin
- Um novo nome para o remote, como
destination
Exemplo
Estes exemplos supõem que você está clonando usando HTTPS, que é o método recomendado.
$ git remote -v
# Consulta os remotes existentes
> origin https://hostname/OWNER/REPOSITORY.git (fetch)
> origin https://hostname/OWNER/REPOSITORY.git (push)
$ git remote rename origin destination
# Altera o nome do remote de 'origin' para 'destination'
$ git remote -v
# Confirma o novo nome do remote
> destination https://hostname/OWNER/REPOSITORY.git (fetch)
> destination https://hostname/OWNER/REPOSITORY.git (push)
Solução de problemas
Você pode se deparar com os seguintes erros ao tentar renomear um remote.
Could not rename config section 'remote.[old name]' to 'remote.[new name]' (Não foi possível renomear a seção de configuração "remote.[old name]" como "remote.[new name]")
Esse erro informa que o nome do remote antigo que você inseriu não existe.
Você pode consultar os remotes existentes no momento com o comando git remote -v
:
$ git remote -v
# Consulta os remotes existentes
> origin https://hostname/OWNER/REPOSITORY.git (fetch)
> origin https://hostname/OWNER/REPOSITORY.git (push)
Remote [new name] already exists (Já existe um remote com o nome [novo nome]).
Esse erro informa que o nome de remote que você deseja usar já existe. Para resolver isso, use um nome de remote diferente ou renomeie o remote original.