Créer et gérer des balises
Une balise est un nom fixe pour un commit, généralement une version telle que v2.2.0. Cliquez avec le bouton droit sur un commit, choisissez Tag Here, puis une balise légère ou annotée. Les balises ne sont pas poussées avec vos commits : poussez chacune d'elles avec Push Tag.
Fonctionne dans GitTree Gratuit : toutes les fonctionnalités Git locales, une fois connecté.
Sur cette page
Avant de commencer
- Le commit que vous souhaitez baliser se trouve dans le graphique (trouver un commit).
Où le trouver
- Cliquez avec le bouton droit sur un commit : Tag Here, puis Create Tag Here… ou Create Annotated Tag Here….
- Cliquez avec le bouton droit sur une étiquette de balise pour Push Tag, Copy Tag Name, Delete Tag… et Delete Tag from Remote….
- La section Tags du panneau de gauche répertorie chaque balise.
| Action | macOS | Windows et Linux |
|---|---|---|
| Undo création ou suppression d'une balise | ⌘Z | Ctrl+Z |
Mesures
Choisissez le commit et le type de tag
Cliquez avec le bouton droit sur le commit, ouvrez Tag Here et choisissez Create Annotated Tag Here… pour une version (il enregistre qui l'a marqué, quand et un message), ou Create Tag Here… pour une balise légère qui n'est qu'un nom.
Une balise annotée, v2.2.0, avec son message.Interface GitTree avec un référentiel de démonstration. Nommez-le et décrivez-le
Tapez le Tag name, tel que
v2.2.0, et pour une balise annotée un Message, comme ce que la version apporte.Signez-le, si votre projet le demande
Sous Signing, Follow Git config utilise votre paramètre
tag.gpgSign; Sign this tag ou Don’t sign this tag décidez pour celui-ci. Seules les balises annotées peuvent être signées.Créez et poussez-le
Appuyez sur Create Tag. L'étiquette apparaît sur le commit ; faites un clic droit dessus et choisissez Push Tag pour le publier.
Résultat attendu
La balise pointe définitivement vers le commit, dans le graphique et dans Tags, et sur la télécommande une fois poussée, où des hôtes tels que GitHub peuvent le transformer en version.
Supprimer une balise
- Delete Tag… supprime la balise locale. Il est enregistré en premier sous
refs/ogt/trash, donc Undo le ramène ; la télécommande n'est pas modifiée. - Delete Tag from Remote… supprime la balise de la télécommande pour tous ceux qui la récupèrent. Votre balise locale reste.
Si quelque chose ne va pas
"La balise n'a pas pu être signée, elle n'a donc pas été créée."
Git n'a pas pu exécuter votre programme de signature ni trouver de clé. Vérifiez user.signingkey et que la signature GPG ou SSH fonctionne dans un terminal, ou créez la balise sans signer.
Un collègue ne voit pas mon tag
Les balises restent locales jusqu'à ce qu'elles soient poussées. Cliquez avec le bouton droit sur la balise et choisissez Push Tag.
Questions
Léger ou annoté ?
Utilisez des tags annotés pour les releases : ils portent un message, le tagger et une date, et peuvent être signés. Les balises légères conviennent aux signets privés.