Nel mio repository, ho creato dei tag usando i seguenti comandi.
git tag v1.0.0 -m 'finally a stable release'
git tag v2.0.0 -m 'oops, there was still a major bug!'
Come fai a elencare tutti i tag nel repository?
git tag
dovrebbe essere sufficiente. Vedi pagina man di git tag
Hai anche:
git tag -l <pattern>
Elenca i tag con i nomi che corrispondono allo schema dato (o tutti se non viene dato alcuno schema).
Digitando "git tag" senza argomenti, elenca anche tutti i tag.
Più recentemente ("Come ordinare i tag git?", per Git 2.0+)
git tag --sort=<type>
Ordina in un ordine specifico.
Il tipo supportato è:
- "
refname
" (ordine lessicografico),- "
version:refname
" o "v:refname
" (i nomi dei tag sono trattati come versioni).
Prependere "-" per invertire l'ordine.
Questo elenca entrambi:
Nota: l'articolo git ready article on tagging disapprova i tag leggeri.
Senza argomenti, git tag crea un tag "leggero" che è fondamentalmente un ramo che non si muove mai.
I tag leggeri sono comunque utili, forse per marcare una versione nota buona (o cattiva), o un gruppo di commit che potresti aver bisogno di usare in futuro.
Tuttavia, probabilmente non vuoi spingere questo tipo di tag.
Normalmente, vuoi almeno passare l'opzione -a per creare un tag non firmato, o firmare il tag con la tua chiave GPG tramite le opzioni -s o -u
Detto questo, Charles Bailey fa notare che un 'git tag -m "..."
' implica effettivamente un tag corretto (annotato senza firma) (opzione '-a
'), e non uno leggero. Quindi sei a posto con il tuo comando iniziale.
Questo differisce da:
git show-ref --tags -d
che elenca i tag con i loro commit (vedi "Git Tag list, display commit sha1 hashes").
Si noti la -d
per dereferenziare l'oggetto tag annotato (che ha il proprio commit SHA1) e visualizzare il commit effettivo del tag.
Allo stesso modo, git show --name-only <aTag>
elencherebbe il tag e il commit associato.
Per elencare i tag che preferisco:
git tag -n
Il flag -n
visualizza la prima riga del messaggio di annotazione insieme al tag, o la prima riga del messaggio di commit se il tag non è annotato.
Puoi anche fare git tag -n5
per mostrare le prime 5 righe dell'annotazione.