Git: Push a tag to a new remote branch in 1 command

Git push accepts a source and destination refspec as part of the push operation, but I can not seem to push a local tag as a new remote branch in a single command. I am aware I could checkout the tag and then push it, but this should be possible as a single command.

What I've tried:

git push origin refs/tags/0.0.1:new_branch

What happens:

Counting objects: 1, done.
Writing objects: 100% (1/1), 156 bytes | 0 bytes/s, done.
Total 1 (delta 0), reused 1 (delta 0)
To '■■■■■■■■■■■■■■■■■■■■■■■■■■■■.com/test.git' * [new tag] 0.0.1 -> new_branch

I've also tried variations of remotes/origin/master instead of master, but this also creates a new tag instead of creating a remote branch based on the tag.

2 Answers

git push origin refs/tags/0.0.1^{commit}:refs/heads/new_branch

I've found the answer from another answer here.

You can always push the tag directly, it will be pushed detached of a branch.

git push origin 0.0.1

What will happen:

Counting objects: 1, done.
Delta compression using up to 8 threads.
Compressing objects: 100% 1/1), done.
Writing objects: 100% (1/1), 685 bytes | 0 bytes/s, done.
Total 1 (delta 1), reused 0 (delta 0)
To :group-something/test.git * [new tag] 0.0.1 -> 0.0.1

If you want to use your ref syntax, it would be as follows:

git push origin refs/tags/0.0.1:refs/tags/0.0.1

The result is exactly the same.

In both cases you need to be aware that you are pushing a detached head. This means that anyone pulling or fetching will not get this tagged head. You need fetch with the --tags param. Otherwise only the tags in branches will be pulled. So only when you do:

git fetch --tags

You get the "detached" heads referenced by your tags.

remote: Counting objects: 6, done.
remote: Compressing objects: 100% (6/6), done.
remote: Total 6 (delta 2), reused 0 (delta 0)
Unpacking objects: 100% (6/6), done.
From :group-something/test * [new tag] 0.0.1 -> 0.0.1