Apa perbedaan antara tag dan rilis?

176

Menggunakan API GitHub, saya tidak bisa mendapatkan daftar rilis, tapi saya bisa mendapatkan daftar tag.

Apa perbedaan di antara mereka?

git github github-api naor
sumber

Jawaban:

200

Apa perbedaan di antara mereka?

A tagadalah pointer ke komit tertentu. Pointer ini dapat diisi dengan super dengan beberapa informasi tambahan (identitas pembuat tag, deskripsi, tanda tangan GPG, ...).

A tagadalah konsep git sedangkan a Releaseadalah konsep tingkat tinggi GitHub.

Seperti yang dinyatakan dalam posting pengumuman resmi dari blog GitHub: "Rilis adalah objek kelas satu dengan changelog dan aset biner yang menyajikan sejarah proyek penuh di luar artefak Git."

A Releasedibuat dari yang sudah ada tagdan mengekspos catatan rilis dan tautan untuk mengunduh perangkat lunak atau kode sumber dari GitHub.

Menggunakan API GitHub, saya tidak bisa mendapatkan daftar rilis, tapi saya bisa mendapatkan daftar tag.

Versi GitHub API saat ini tidak memaparkan cara mengelola Release(buat, perbarui, ...). Saya cukup yakin bahwa ini seharusnya tidak terlalu lama sebelum terbuka.

Namun, saat ini dimungkinkan untuk mendaftar rilis dan tag dari repositori tertentu.

Misalnya, url di bawah ini akan mencantumkan 6 rilis (mulai hari ini) dari ReactiveUI

Sedangkan yang ini akan mencantumkan 54 tag (pada hari ini) dari repositori yang sama

Membuat rilis saat ini sedang dalam proses yang melibatkan tindakan manual (menambahkan catatan rilis, mengunggah paket, ...). Ini menjelaskan mengapa tags tidak dilihat secara transparan sebagai Releases.

Jika Anda ingin diberitahu tentang perubahan API, Anda dapat berlangganan blog GitHub API Changes .

Namun, jika Anda tidak bisa menunggu, halaman beranda GitHub API menyatakan "Jika Anda memiliki masalah atau permintaan, silakan hubungi dukungan. ". Ini dapat dilakukan melalui email ke [email protected] atau formulir kontak ini .

Memperbarui:

API GitHub sekarang memungkinkan untuk memanipulasi Releases. Lihat pengumumannya .

nulltoken
sumber
Terima kasih banyak atas jawaban terperinci Anda. Re: / rilis - Saya mendapatkan 0 rilis untuk rel , yang agak aneh, bukan?
naor
1
Saya tidak berpikir itu aneh. Itu hanya berarti bahwa tim Rails belum menggunakan GitHub UI untuk membuat Releasedari yang sudah ada tag. ReleaseIni adalah tambahan yang cukup baru. Mungkin tim Rails lebih suka tetap dengan proses mereka saat ini dan memposting ke blog mereka setiap kali versi baru dirilis (lihat pengumuman 3.2.14 ).
nulltoken
2
+1 untuk perbedaan yang jelas antara tag dan rilis dan masing-masing untuk: "A tagadalah konsep git sedangkan a Releaseadalah konsep tingkat tinggi GitHub ... A Releasedibuat dari yang sudah ada tagdan memperlihatkan catatan rilis dan tautan untuk mengunduh perangkat lunak atau kode sumber dari GitHub. "
Paul Masri-Stone
Mungkin juga bermanfaat untuk mengetahui bahwa sekarang ada alat baris perintah yang disebut hub yang supercharges kemampuan git. Di antara kekuatan super ini, ada kemampuan untuk mendorong rilis di terminal.
Paul Razvan Berg