Comment renommer une balise Git?

Aujourd'hui, je regardais les journaux d'un projet et j'ai réalisé qu'il y a quelque temps, j'ai touché le nom d'une étiquette. Existe-t-il un moyen de renommer la balise? Google n'a rien trouvé d'utile.

Je me rends compte que je pouvais vérifier la version étiquetée et créer une nouvelle étiquette, j'ai même essayé. Mais cela semble créer un objet tag qui n'est pas tout à fait correct. Pour un,

git tag -l

la répertorie dans le désordre par rapport à toutes les autres balises. Je ne sais pas si c'est important, mais cela me porte à croire que le nouvel objet tag n'est pas tout à fait ce que je veux. Je peux vivre avec ça, car je me soucie vraiment que le nom de la balise corresponde à la documentation, mais je préfère le faire "bien", en supposant qu'il existe une bonne façon de le faire.

Voici comment je renomme une étiquette oldà new:

git tag new old
git tag -d old
git push origin :refs/tags/old
git push --tags

Le signe deux-points dans la commande push supprime la balise du référentiel distant. Si vous ne le faites pas, Git créera l'ancienne balise sur votre machine lorsque vous tirerez.

Enfin, assurez-vous que les autres utilisateurs suppriment la balise supprimée. Veuillez leur dire (collègues) d'exécuter la commande suivante:

git pull --prune --tags

Notez que si vous modifiez une balise annotée , vous devez vous assurer que le nouveau nom de balise fait référence à la validation sous-jacente et non à l'ancien objet de balise annoté que vous êtes sur le point de supprimer. Par conséquent, utilisez git tag -a new old^{}plutôt git tag new old(c'est parce que les balises annotées sont des objets alors que les balises légères ne le sont pas, plus d'informations dans cette réponse ).

La question initiale était de savoir comment renommer une étiquette, qui est facile: tout d' abord créer un nouveau comme un alias de vieux: git tag NEW OLDsupprimez VIEUX: git tag -d OLD.

La citation concernant "la manière Git" et (in) la raison est hors de propos, car il s'agit de préserver un nom de balise, mais de le faire référence à un état de référentiel différent.

En plus des autres réponses:

Vous devez d'abord créer un alias de l' ancien nom de la balise, pointant vers le commit d'origine:

git tag new old^{}

Ensuite, vous devez supprimer l'ancien localement :

git tag -d old

Ensuite, supprimez la balise sur vos emplacements distants:

# Check your remote sources:
git remote -v
# The argument (3rd) is your remote location,
# the one you can see with `git remote`. In this example: `origin`
git push origin :refs/tags/old

Enfin, vous devez ajouter votre nouvelle balise à l'emplacement distant. Jusqu'à ce que vous ayez fait cela, les nouvelles balises ne seront pas ajoutées:

git push origin --tags

Répétez cela pour chaque emplacement distant.

Soyez conscient des implications d'un changement de Git Tag pour les consommateurs d'un package!

S'il est publié, vous ne pouvez pas le supprimer (sans risquer d'être goudronné et à plumes, c'est-à-dire). La «manière Git» est de faire:

La chose sensée. Admettez simplement que vous avez foiré et utilisez un nom différent. D'autres ont déjà vu un nom de balise, et si vous gardez le même nom, vous pourriez être dans la situation où deux personnes ont toutes les deux la "version X", mais elles ont en fait des "X" différents. Il suffit donc de l'appeler "X.1" et d'en finir.

Alternativement,

La chose folle. Vous voulez vraiment appeler la nouvelle version "X" aussi, même si d'autres ont déjà vu l'ancienne. Utilisez donc à nouveau git-tag -f, comme si vous n'aviez pas déjà publié l'ancien.

C'est tellement fou parce que:

Git ne change pas (et ne devrait pas) changer les balises derrière les utilisateurs. Donc, si quelqu'un a déjà obtenu l'ancienne balise, faire un git-pull sur votre arbre ne devrait pas simplement les faire écraser l'ancienne.

Si quelqu'un a obtenu une balise de sortie de votre part, vous ne pouvez pas simplement la modifier en mettant à jour la vôtre. C'est un gros problème de sécurité, dans la mesure où les gens DOIVENT être en mesure de faire confiance à leurs noms de balises. Si vous voulez vraiment faire la chose folle, il vous suffit de vous en rendre compte et de dire aux gens que vous avez foiré.

Toute la courtoisie des pages de manuel .

Cette page wiki a cet intéressant one-liner, qui nous rappelle que nous pouvons pousser plusieurs refs :

git push origin <refs/tags/old-tag>:<refs/tags/new-tag> :<refs/tags/old-tag> && git tag -d <old-tag>

et demander aux autres cloners de faire git pull --prune --tags

L'idée est donc de pousser:

• <new-tag>pour tous les commits référencés par <old-tag>: <refs/tags/old-tag>:<refs/tags/new-tag>,
• la suppression de<old-tag> ::<refs/tags/old-tag>

Voir comme exemple " Changer la convention de nommage des balises à l'intérieur d'un référentiel git? ".

En complément des autres réponses, j'ai ajouté un alias pour tout faire en une seule étape, avec une sensation de commande de déplacement * nix plus familière. L'argument 1 est l'ancien nom de la balise, l'argument 2 est le nouveau nom de la balise.

[alias]
    renameTag = "!sh -c 'set -e;git tag $2 $1; git tag -d $1;git push origin :refs/tags/$1;git push --tags' -"

Usage:

git renametag old new

Suivez l'approche en 3 étapes pour une ou plusieurs balises.

Étape 1: identifier l'ID de validation / objet de la validation vers laquelle pointe la balise actuelle

     command: git rev-parse <tag name>
     example: git rev-parse v0.1.0-Demo
     example output: db57b63b77a6bae3e725cbb9025d65fa1eabcde

Étape 2: supprimer la balise du référentiel

     command: git tag -d <tag name>
     example: git tag -d v0.1.0-Demo
     example output: Deleted tag 'v0.1.0-Demo' (was abcde)

Étape 3: créer une nouvelle balise pointant vers le même ID de validation que l'ancienne balise pointait vers

     command: git tag -a <tag name>  -m "appropriate message" <commit id>
     example: git tag -a v0.1.0-full  -m "renamed from v0.1.0-Demo" db57b63b77a6bae3e725cbb9025d65fa1eabcde
     example output: Nothing or basically <No error>

Une fois que le git local est prêt avec le changement de nom de balise, ces changements peuvent être repoussés à l'origine pour que d'autres les prennent.

Pour les aventuriers, cela peut être fait en une seule commande:

mv .git/refs/tags/OLD .git/refs/tags/NEW

Indépendamment des problèmes liés à la transmission des balises et au changement de nom des balises qui ont déjà été poussées, dans le cas où la balise à renommer est annotée , vous pouvez d'abord la copier grâce à la ligne de commande à ligne unique suivante:

git tag -a -m "`git cat-file -p old_tag | tail -n +6`" new_tag old_tag^{}

Ensuite, il vous suffit de supprimer l'ancienne balise:

git tag -d old_tag

J'ai trouvé cette ligne de commande grâce aux deux réponses suivantes:

• https://stackoverflow.com/a/26132640/7009806 (deuxième commentaire)
• https://stackoverflow.com/a/49286861/7009806

Edit:
Ayant rencontré des problèmes lors de la synchronisation automatique des paramètres de balises fetch.pruneTags=true(comme décrit dans https://stackoverflow.com/a/49215190/7009806 ), je suggère personnellement de copier d' abord la nouvelle balise sur le serveur, puis de supprimer l'ancienne. De cette façon, la nouvelle balise n'est pas supprimée de manière aléatoire lors de la suppression de l'ancienne balise et une synchronisation des balises voudrait supprimer la nouvelle balise qui n'est pas encore sur le serveur . Ainsi, par exemple, tous ensemble, nous obtenons:

git tag -a -m "`git cat-file -p old_tag | tail -n +6`" new_tag old_tag^{}
git push --tags
git tag -d old_tag
git push origin :refs/tags/old_tag

Vous pouvez également renommer des balises distantes sans les extraire, en dupliquant l'ancienne balise / branche à un nouveau nom et supprimez l'ancienne, en une seule git pushcommande.

Renommage tag à distance / branche à distance → conversion de tag: (Avis: :refs/tags/)

git push <remote_name> <old_branch_or_tag>:refs/tags/<new_tag> :<old_branch_or_tag>

Renommage branche à distance / tag distance → conversion de branche: (Avis: :refs/heads/)

git push <remote_name> <old_branch_or_tag>:refs/heads/<new_branch> :<old_branch_or_tag>

Sortie renommant une balise distante:

D:\git.repo>git push gitlab App%2012.1%20v12.1.0.23:refs/tags/App_12.1_v12.1.0.23 :App%2012.1%20v12.1.0.23

Total 0 (delta 0), reused 0 (delta 0)
To https://gitlab.server/project/repository.git
 - [deleted]               App%2012.1%20v12.1.0.23
 * [new tag]               App%2012.1%20v12.1.0.23 -> App_12.1_v12.1.0.23