Bagaimana Anda mengganti nama tag Git?

Hari ini saya sedang melihat-lihat log untuk sebuah proyek dan menyadari bahwa saya gemuk memainkan nama tag beberapa waktu yang lalu. Apakah ada cara untuk mengganti nama tag? Google belum menemukan sesuatu yang berguna.

Saya menyadari bahwa saya dapat memeriksa versi yang ditandai dan membuat tag baru, saya bahkan mencobanya. Tapi itu sepertinya membuat objek tag yang kurang tepat. Untuk satu,

git tag -l

mencantumkannya dalam urutan relatif terhadap semua tag lainnya. Saya tidak tahu apakah itu signifikan, tetapi itu membuat saya percaya bahwa objek tag baru tidak cukup seperti yang saya inginkan. Saya dapat hidup dengan itu, karena saya benar-benar hanya peduli bahwa nama tag cocok dengan dokumentasi, tetapi saya lebih suka melakukannya "benar", dengan asumsi ada cara yang tepat untuk melakukan ini.

Inilah cara saya mengganti nama tag oldmenjadi new:

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

Tanda titik dua dalam perintah push menghilangkan tag dari repositori jarak jauh. Jika Anda tidak melakukan ini, Git akan membuat tag lama pada mesin Anda saat Anda menarik.

Akhirnya, pastikan bahwa pengguna lain menghapus tag yang dihapus. Harap beri tahu mereka (rekan kerja) untuk menjalankan perintah berikut:

git pull --prune --tags

Perhatikan bahwa jika Anda mengubah tag beranotasi , Anda perlu memastikan bahwa nama tag baru merujuk komit yang mendasarinya dan bukan objek tag beranotasi lama yang akan Anda hapus. Oleh karena itu, gunakan git tag -a new old^{}alih-alih git tag new old(ini karena tag beranotasi adalah objek sementara tag ringan tidak, info lebih lanjut dalam jawaban ini ).

Pertanyaan awal adalah bagaimana mengubah nama tag, yang mudah: pertama kali membuat BARU sebagai alias OLD: git tag NEW OLDkemudian menghapus OLD: git tag -d OLD.

Kutipan mengenai "cara Git" dan kewarasan tidak masuk akal, karena berbicara tentang mempertahankan nama tag, tetapi membuatnya merujuk ke status repositori yang berbeda.

Selain jawaban lain:

Pertama, Anda perlu membuat alias dari nama tag lama , menunjuk ke komit asli:

git tag new old^{}

Maka Anda perlu menghapus yang lama secara lokal :

git tag -d old

Kemudian hapus tag pada Anda lokasi yang jauh:

# 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

Akhirnya Anda perlu menambahkan tag baru Anda ke lokasi yang jauh. Sampai Anda melakukan ini, tag baru tidak akan ditambahkan:

git push origin --tags

Iterasi ini untuk setiap lokasi terpencil.

Sadarilah, implikasi yang dimiliki perubahan Git Tag kepada konsumen suatu paket!

Jika dipublikasikan, Anda tidak dapat menghapusnya (tanpa risiko menjadi tar dan berbulu, artinya). 'Cara Git' adalah melakukan:

Yang waras. Akui saja Anda mengacau, dan gunakan nama yang berbeda. Yang lain telah melihat satu nama tag, dan jika Anda menggunakan nama yang sama, Anda mungkin berada dalam situasi di mana dua orang sama-sama memiliki "versi X", tetapi mereka sebenarnya memiliki "X" yang berbeda. Jadi sebut saja "X.1" dan selesai dengan itu.

Kalau tidak,

Hal yang gila. Anda benar-benar ingin memanggil versi baru "X" juga, meskipun yang lain sudah melihat yang lama. Jadi gunakan saja git-tag -f lagi, seolah-olah Anda belum menerbitkan yang lama.

Ini sangat gila karena:

Git tidak (dan seharusnya tidak) mengubah tag di belakang pengguna. Jadi, jika seseorang sudah mendapatkan tag lama, melakukan git-pull pada pohon Anda tidak hanya membuat mereka menimpa yang lama.

Jika seseorang mendapatkan tag rilis dari Anda, Anda tidak bisa hanya mengubah tag untuk mereka dengan memperbarui tag Anda sendiri. Ini adalah masalah keamanan besar, di mana orang HARUS dapat mempercayai nama tag mereka. Jika Anda benar-benar ingin melakukan hal yang gila, Anda hanya perlu mengakuinya, dan memberi tahu orang-orang bahwa Anda kacau.

Semua milik halaman manual .

Halaman wiki ini memiliki one-liner yang menarik ini, yang mengingatkan kita bahwa kita dapat mendorong beberapa referensi :

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

dan meminta klon lain untuk melakukannya git pull --prune --tags

Jadi idenya adalah untuk mendorong:

• <new-tag>untuk setiap komit direferensikan oleh <old-tag>: <refs/tags/old-tag>:<refs/tags/new-tag>,
• penghapusan<old-tag> ::<refs/tags/old-tag>

Lihat sebagai contoh " Mengubah konvensi penamaan tag di dalam repositori git? ".

Sebagai tambahan pada jawaban lain, saya menambahkan alias untuk melakukan semuanya dalam satu langkah, dengan nuansa perintah * nix move yang lebih akrab. Argumen 1 adalah nama tag lama, argumen 2 adalah nama tag baru.

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

Pemakaian:

git renametag old new

Ikuti pendekatan 3 langkah untuk satu atau beberapa tag.

Langkah 1: Identifikasi komit / objek ID dari komit tag saat ini menunjuk ke

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

Langkah 2: Hapus tag dari repositori

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

Langkah 3: Buat tag baru yang menunjuk ke id komit yang sama seperti yang ditunjukkan oleh tag lama

     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>

Setelah git lokal siap dengan perubahan nama tag, perubahan ini dapat didorong kembali ke asal untuk diambil orang lain.

Untuk para petualang itu dapat dilakukan dalam satu perintah:

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

Terlepas dari masalah yang terkait dengan mendorong tag dan mengganti nama tag yang telah didorong, jika tag untuk mengganti nama adalah yang beranotasi , Anda dapat menyalinnya terlebih dahulu berkat baris perintah baris tunggal berikut:

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

Kemudian, Anda hanya perlu menghapus tag lama:

git tag -d old_tag

Saya menemukan baris perintah ini berkat dua jawaban berikut:

• https://stackoverflow.com/a/26132640/7009806 (komentar kedua)
• https://stackoverflow.com/a/49286861/7009806

Edit:
Setelah mengalami masalah menggunakan sinkronisasi otomatis tag pengaturan fetch.pruneTags=true(seperti yang dijelaskan dalam https://stackoverflow.com/a/49215190/7009806 ), saya pribadi menyarankan untuk pertama menyalin tag baru pada server dan kemudian menghapus yang lama. Dengan begitu, tag baru tidak dihapus secara acak ketika menghapus tag lama dan sinkronisasi tag ingin menghapus tag baru yang belum ada di server . Jadi, misalnya, secara bersama-sama kita dapatkan:

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

Anda juga dapat mengganti nama tag jarak jauh tanpa memeriksanya, dengan menduplikasi tag / cabang lama ke nama baru dan menghapus yang lama, dalam satu git pushperintah.

Terpencil tag rename / Remote cabang → konversi tag: (Notice: :refs/tags/)

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

Terpencil cabang rename / Remote tag → konversi cabang: (Notice: :refs/heads/)

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

Output mengganti nama tag jarak jauh:

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