Skip to content

Latest commit

 

History

History
73 lines (52 loc) · 6.83 KB

hive-git-subtree.md

File metadata and controls

73 lines (52 loc) · 6.83 KB

همانطور که قبلا هم در هایو نوشته بودم git امکان به اسم submodule دارد که امکن ترکیب ماژول‌های نرم‌افزار را به ما می‌دهد. در همان حدود ما در تیم توسعه‌مان از submodule برای توسعه نسل بعدی نرم‌افزارمان استفاده کردیم. بعد از گذشت حدود ۱۰ ماه از استفاده از این ویژگی git در این نوشته، مشکلات استفاده از submodule بصورت خلاصه بیان شده و راه‌حل جایگزینی ارائه می‌گردد. مهم‌ترین مشکل استفاده از submodule ها پیچیدگی روند کار با آن است. تیم برای انجام کارهای معمول خود نیاز به دانش بیشتری دارد. در ابتدا افرادی که درگیر این پروژه جدید بودند به دو نفر از اعضای تیم محدود می‌شد که بخشی از کارشان توسعه این پروژه به عنوان تحقیق و توسعه بود. اما با بالغ شدن پروژه و توسعه آن توسط تمام اعضای تیم مشکلات این روند کاری پیچیده خود را نشان دادند. حال روندی که برای جایگزین کردن پیشنهاد میشود استفاده از subtree هاست.

دستور subtree یک مخزن git را به عنوان یک زیرشاخه به مخزن اصلی اضافه میکند، همچنین کار بعدی آن این است که می‌توان زیر شاخه‌ای را از مخزن بزرگ جدا کرده تا تبدیل به یک مخزن مجزا شود. معمولا در مواردی که چند مخزن (یکی اصلی و مابقی به عنوان ماژول) وجود دارد از این روش استفاده می‌کنند. بدین صورت که یک مخزن اصلی(بزرگ) دارند که همه مخازن ماژول‌ها به عنوان subtree اضافه شده‌اند. روند کار یک برنامه نویس با مخزن اصلی بصورت عادی است و با همان روندهای آشنای git، توسعه را شروع و ادامه می‌دهد. حال در زمان‌هایی می‌توان تغییرات زیر شاخه‌ها را به مخازن مجزایشان توسط افرادی که تجربه‌بیشتری دارند و یا حتی با استفاده از چند script ساده ارسال نمود.

با این توضیحات دیدن یک نمونه عملی هم خالی از لطف نیست. در این مثلا قرار است یک مخزن اصلی وجود داشته باشد که شامل مخزن تمامی پست‌های وبلاگ بنده باشد.

اضافه کردن یک subtree

اضافه کردن یک subtree کار راحتی است. کافی است که به خط فرمان رفته و از دستور git subtree add استفاده کنید مثال این دستور به شکل زیر است:

$ git subtree add --prefix blog https://github.com/yazdan/blogPosts master
git fetch https://github.com/yazdan/blogPosts master
warning: no common commits
remote: Counting objects: 232, done.
remote: Total 232 (delta 0), reused 0 (delta 0), pack-reused 232
Receiving objects: 100% (232/232), 145.35 KiB | 36.00 KiB/s, done.
Resolving deltas: 100% (98/98), done.
From https://github.com/yazdan/blogPosts
 * branch            master     -> FETCH_HEAD
Added dir 'blog'

بعد از اجرای درست این دستور شاخه‌ای به نام blog به مخزن اصلی اضافه شده و تمامی سابقه مخزن ماژول نیز به عنوان سابقه مخزن اصلی اضافه می‌شود. در این مرحله نیاز نیست کار دیگری انجام دهید. تمامی ماژول‌ها را به همین منوال اضافه می‌شود.

کار با مخزنی که subtree دارد

کار با مخازنی که subtree دارد عینا شبیه مخازن عادی است و هیچ تفاوتی با مخازن عادی ندارد

بازگرداندن تغییرات به ماژول‌ها

برای بازگرداندن تغییرات به ماژول‌ها می‌توانید از دستور زیر استفاده کنید

$ git remote add blogposts-github https://github.com/yazdan/blogPosts
$ git subtree push --prefix blog blogposts-github master
git fetch https://github.com/yazdan/blogPosts master
git push using:  blogposts-github master
Everything up-to-date

##نکات قابل توجه هنگام استفاده از subtreeها همانطور که در مورد تمام ابزارهای تکنولوژیک صدق می‌کنید هریک از این ابزارها علاوه بر حل کردن مشکلاتی، ممکن است پیچیدگی‌هایی را ایجاد کنند. قطعا استفاده از subtree ساده‌تر و آسان‌تر از استفاده از submodule هاست. ولی به خودی خود مشکلاتی نیز دارد

  • کل سابقه مخزن ماژول به مخزن مادر اضافه می‌شود. که در صورت وجود سابقه‌های زیاد این عمل باعث سنگین شدن مخزن اصلی می‌شود.
  • روند merge کردن و رفع conflict ها پیچیده‌تر حالت عادی است.

در مجموع استفاده از subtree به استفاده از submodule بخاطر سادگی بیشتر ارجحیت دارد.

منابع و خواندن بیشتر

منابع این متن در زیر آمده است: