Sobre o git push
O comando git push
usa dois argumentos:
- Um nome de repositório remoto, por exemplo,
origin
- Um nome de branch, por exemplo,
main
Por exemplo:
git push REMOTE-NAME BRANCH-NAME
Por exemplo, em geral, git push origin main
é executado para efetuar push das alterações locais para o repositório online.
Renomear branches
Para renomear um branch, use o mesmo comando git push
, mas adicione mais um argumento: o nome do novo branch. Por exemplo:
git push REMOTE-NAME LOCAL-BRANCH-NAME:REMOTE-BRANCH-NAME
Isso efetua push do LOCAL-BRANCH-NAME
para o REMOTE-NAME
, mas ele é renomeado como REMOTE-BRANCH-NAME
.
Lidar com erros "non-fast-forward"
Se a cópia local de um repositório estiver fora de sincronia ou "atrasado" em relação ao repositório upstream do qual você está efetuando push, você receberá a mensagem non-fast-forward updates were rejected
.
Isso significa que você precisa recuperar ou "buscar" as alterações upstream antes de conseguir efetuar push das alterações locais.
Para saber mais sobre esse erro, confira "Lidar com erros non-fast-forward".
Fazer push de tags
Por padrão, e sem parâmetros adicionais, git push
envia todos os branches correspondentes que têm os mesmos nomes dos branches remotos.
Para fazer push de uma única tag, você pode usar o mesmo comando usado para fazer push de um branch:
git push REMOTE-NAME TAG-NAME
Para fazer push de todas as suas tags, digite o comando:
git push REMOTE-NAME --tags
Excluir uma tag ou branch remote
À primeira vista, a sintaxe para excluir um branch é um pouco enigmática:
git push REMOTE-NAME :BRANCH-NAME
Observe que há um espaço antes dos dois pontos. O comando se parece com as mesmas etapas que você usará para renomear um branch. No entanto, aqui, você está informando o Git para não efetuar push de nada para BRANCH-NAME
no REMOTE-NAME
. Por isso, git push
exclui o branch do repositório remoto.
Remotes e bifurcações
Talvez você já saiba que pode "criar forks" de repositórios no GitHub.
Ao clonar um repositório de sua propriedade, você fornece uma URL remota que informa ao Git o local em que ele deve efetuar fetch e push das atualizações. Caso deseje colaborar com o repositório original, adicione uma nova URL remota, normalmente chamada upstream
, ao clone do Git local:
git remote add upstream THEIR_REMOTE_URL
Agora, você pode buscar as atualizações e os branches do fork deles:
git fetch upstream
# Grab the upstream remote's branches
> remote: Counting objects: 75, done.
> remote: Compressing objects: 100% (53/53), done.
> remote: Total 62 (delta 27), reused 44 (delta 9)
> Unpacking objects: 100% (62/62), done.
> From https://HOSTNAME/OCTOCAT/REPO
> * [new branch] main -> upstream/main
Quando terminar de fazer alterações locais, efetue push do branch local para o GitHub e inicie uma solicitação de pull.
Para saber mais sobre como trabalhar com forks, confira "Sincronizar uma bifurcação".