سازنده تگ گیت حرفه‌ای

اطلاعات پایه
شاخه‌ای که تگ روی آن ساخته شود
مثال: v1.2.3 یا v1.2.3-rc.1
تنظیمات تگ
پیام و مقصد
نسخه و انتشار
پیش‌نمایش دستور

            

راهنمای جامع و سازمانی Git Tag — سطح Enterprise

تگ در گیت یک اشاره‌گر نام‌دار و پایدار به یک commit است. در سازمان‌ها، تگ پایهٔ اصلی فرآیندهای انتشار، CI/CD، ثبت سوابق، امنیت و ارائهٔ نسخه‌های قابل پیگیری است.

۱) انواع تگ

  • تگ سبک (Lightweight)
    • فقط یک ref ساده است
    • بدون پیام و متادیتا
    • مناسب برای نشانه‌گذاری داخلی
  • تگ Annotated
    • حاوی تاریخ، پیام، اطلاعات سازنده
    • امکان امضای GPG
    • نسخه‌های سازمانی باید Annotated باشند

۲) جریان‌های سازمانی انتشار

  • انتشار بر اساس شاخهٔ release/x.y
  • تگ‌گذاری مستقیم روی main در مدل CD
  • Hotfix: ایجاد شاخه → اعمال اصلاح → تگ

۳) تغییرناپذیری و حاکمیت تگ

تگ‌ها پس از انتشار نباید دوباره‌نویسی شوند.

  • در صورت تغییر، نسخهٔ جدید بسازید
  • Force push فقط با تأیید رسمی
  • تگ‌های تولیدی باید audit شوند

۴) تگ‌های امضاشده

  • استفاده از -s یا -u
  • مورد نیاز در شرکت‌های با حساسیت بالا
  • کلید باید در HSM/KMS نگه‌داری شود

۵) تعامل با CI/CD

  • تگ باعث اجرای Pipeline انتشار می‌شود
  • Artifact باید از خود commit تگ‌شده ساخته شود
  • شناسهٔ بیلد، شمارهٔ تیکت و checksum الزامی است

۶) نسخه‌گذاری Semver

MAJOR.MINOR.PATCH
v1.2.3
v1.2.3-rc.1
v1.2.3+build.20240201
    

۷) دستورات کاربردی

git tag v1.0.0
git tag -a v1.0.0 -m "انتشار"
git tag -s v1.0.0 -m "انتشار امضاشده"
git tag -a v1.0.0 9fceb02 -m "Backport"
git push origin v1.0.0
    

هشدارها

  • هرگز تگ منتشرشده را بازنویسی نکنید
  • پیام تگ نباید شامل اطلاعات حساس باشد
  • تگ باید به Release Notes لینک شود