| الوثيقة بهيئات أخرى |  |  |
|---|
يعتبر git من أشهر نظم إدارة الإصدارات وأوسعها انتشارا. بدأ العمل عليه Linus Torvalds مبرمج نظام لينكس نفسه حيث أنه قبل ذلك كان يفضل أن يتعامل مع عدة نسخ وكومة من الرقاع على استخدام أي من أنظمة إدارة المصدر والتحكم بإصداراته مثل CVS بل إنه لا يتردد بتسفيه أحلام مطوري CVS فضلا عن مستخدميه. ثم قام بتطوير GIT ليعالج نقاط الضعف التي كانت موجودة في الأنظمة الأخرى.
من مميزات git أنه سريع وعملي ويستخدم مقاطع hash قوية للتأكد من سلامة الملفات ولترقيم الإصدارات.
كما أنه يوفر طرق سهلة لعمل فروع branches وإصدارات موسومة tags والأهم من ذلك هو تسهيل الدمج بين الفروع.
من أهم ما يميز git عن نظم مثل CVS هو أنه نظام موزَّع غير مركزي.
من عيوب git أنه ملتصق جدا بفلسفة نظام يونكس أو لينكس في جميع نواحيه. يوجد نسخة لنظام ويندوز اسمها msysgit وهناك طريقة لربطها مع PuTTY (من أجل بروتوكول SSH). لا أعلم إن كانت تنفيذاته على جافا أو .net عملية أم لا. هذا لا يعني أن استخدام git على ويندوز مستحيل أو صعب بل إنه هناك واجهات له مثل TortoiseGit التي هي واجهة رسومية سهلة ل msysgit. لاستعمال git على ويندوز قم بتثبيت الملفات التالية:
لأن نظام git نظام موزع أي لا مركزي فإنه يمكن أن تتحول عملية استضافة الكود شبكة اجتماعية. هذا ليس كلام نظري مثلا موقع github عبارة عن شبكة اجتماعية لكتابة الأكواد عبر git مثلا يمكن لأي شخص أن يفرع أي كود مستضاف على git حتى لو كان خارج github ويمكن مزامنة كل فرع في الآخر أو جذب pull أي فرع ودمجه merge مع الرئيسي إن رغب صاحبه بذلك أو متابعة التطوير في الفرع. المطور عبر github يرى طلبات الجذب والدمج pull request كذلك هناك قائمة المستودعات الأكثر نشاطا trending repos وهناك ويكي وهناك نظام تتعبع عثرات تحت تبويب issues … وطبعا هذا كله مجانا للمشاريع مفتوحة المصدر وهناك عدة عروض وخطط مدفوعة الثمن لاستضافة مشاريع خاصة (غير منشورة للعلن).
يمكن استضافة git على خادمك الخاص وتحديد الصلاحيات عبر مفاتيح ssh الآمنة وذلك عبر حساب shell وحيد محدود الصلاحيات عبر gitolite (الذي خلف gitosis المتوقف التطوير) وهو يدير الوصول إلى مستودعات git.
وهناك أكثر من واجهة ويب مثل cgit و gitweb.
إن كنت ترغب بالتدرب على git يمكنك إنشاء مشروع محلي والتدرب عليه.
هناك نوعان من مستودعات git: العادي و المجرد. في الأول يكون هناك مجلد .git مخفي يحتوي أمور git الداخلية إلى جانب ملفات المشروع. أما في حالة المستودع المجرد فإنك لن ترى ملفات المشروع وسترى ملفات git الداخلية فقط ويستخدم هذا الأخير عند الاستضافة العامة.
افتح مجلد جديد مثلا myproj ثم أنشئ مستودع git بداخله
mkdir myproj
cd myproj
git init
هذا الأمر ينشئ ويحول المجلد إلى مستودع git عادي، لاحظ وجود مجلد .git الخفي.
لعمل مستودع مجرد اكتب الأمر
mkdir myproj.git
cd myproj.git
git init --bare
ومن أعراف مجتمع git وضع اللاحقة .git بعد اسم المجلد إن كان مجردا bare.
إن كنت تريد استخدام هذا المجلد كمستودع “بعيد” لأغراض التجربة لا تقم بعمل أي تعديل على أي من الملفات هناك. سنفرض أنك عملت مستودع مجرد وأن المجلد موجود في /opt/myproj.git/
يمكن أن يكون العنوان مسارا مطلقا لمجلد محلي مثل /opt/myproj.git/ أو ما يكافئه من البروتوكول المحلي هكذا
file:///opt/myproj.git
إضافة لاستخدام العنوان من مجلد محلي يمكن استعمال العناوين البعيدة بأي من البروتوكولات التالية:
وكلها لا تقبل اسم مستخدم إلا ssh أي أن العنوان هو:
PROTOCOL://HOST[:PORT]/PATH/REPO.git/
أما في حالة ssh فإنه يمكن تحديد اسم المستخدم قبل العائل HOST وتفصل بينهما علامة @ هكذا
ssh://USER@HOST[:PORT]/PATH/REPO.git/
ويمكن أن يكون المسار نسبة لبيت المستخدم USER هكذا
ssh://USER@HOST[:PORT]/~/PATH/REPO.git/
ولأن ssh هو الأكثر شيوعا يمكنك أن لا تكتبه لأنه يفترض ضمنا فيكون العنوانان الأخيران هكذا
USER@HOST:/PATH/REPO.git/
USER@HOST:PATH/REPO.git/
وفي جميع البروتوكولات يمكن إهمال رقم المنفذ PORT وتركه للقيمة التلقائية.
أول ما يقوم به أي مطور هو استنساخ مستودع بعيد بواسطة الأمر التالي:
git clone URL
يمكنك تجربة استنساخ المستودع المحلي الذي عملناه للتجربة
git clone /opt/myproj.git/
وفي هذه الحالة ستحصل على مجلد جديد اسمه myproj وبه ملفات المشروع ومجلد .git المخفي. وفي حالتي سيكون هذا المجلد فارغا.
تستطيع البدء في التحرير وإضافة الملفات وتعديلها داخل ذلك المجلد. لكن في الواقع العملي قبل أن تبدأ بالتحرير عليك التأكد من أن النسخة لديك هي آخر نسخة من الموقع (قد تأخذ نسخة ثم يأتي شخص ويرفع تعديلات بعد أن حصلت على نسختك). تستطيع سحب آخر نسخة ودمجها مع النسخة الموجودة لديك بالأمر
git pull URL
ثم تبدأ بتحرير الملفات وإنشائها.
لمعرفة أين تقف وما هي التغييرات التي أنت على وشك حفظها اكتب
git status والتي قد تعطي ما يشبه
[alsadi@ojuba myproj]$ git status
# On branch master
# Changed but not updated:
# (use "git add <file>..." to update what will be committed)
# (use "git checkout -- <file>..." to discard changes in working directory)
#
# modified: readme-ar.html
#
# Untracked files:
# (use "git add <file>..." to include in what will be committed)
#
# readme-ar.html~
no changes added to commit (use "git add" and/or "git commit -a")
وهو يعني أن الملف readme-ar.html قد تغيّر ولم يحفظ. أما الملف الذي ينتهي ب ~ فلا يتم تتبعه (غير مضاف للمستودع). حيث يجب أن تخبر git عن الملفات التي عليه تتبعها. تستطيع إضافة الملفات أو المجلدات الجديدة عبر git add ثم أسماء الملفات والمجلدات. ويمكنك إضافة كل ما تغيّر في المجلد الحالي كله (هذا لا يشمل ما استجد من ملفات) بالأمر:
git add .
يمكنك القيام بأوامر يونكس التقليدية من خلال git مثل rm و mv لحذف الملفات و نقلها أو تغيير اسمها مع إعلام git بتلك التغييرات (إن قمت بتغيير اسم ملف من خارج git فإنه سيعجز عن تتبع ذلك)
لحفظ النسخة اكتب
git commit -a -m "MESSAGE"
مع وضع رسالة مكان MESSAGE تشرح التعديلات التي قمت بها.
الخيار -a يعني إضافة ما تغيّر (وليس ما استحدث) عبر الأمر add ضمنيا.
الأمر السابق يحفظ التغييرات التي قمت بها داخل مجلد .git المخفي ولا يرسلها للمنبع البعيد.
لدفع التغييرات للمنبع البعيد اكتب
git push
لعرض الفرق قبل حفظه اكتب git diff دون أي معاملات حيث ستعرض الفرق بين الحالية والنسخة المحفوظة.
git diff | less
إن كنت قمت بتعديلات ولم تحفظها في git وكنت تريد الرجوع عنها إلى آخر نسخة محفوظة افعل الخيار الثاني (بعد git add) الذي يخبرك عنه git status وهو طبعا
git checkout -- FILE1 FILE2
حيث FILE1 FILE2 هي أسماء الملفات
إن لم تكن ترغب في تحديد أسماء الملفات وكل ما تريده هو استعادة آخر نسخة محفوظة اكتب
git reset --hard
اكتب man git للحصول على كتيب git الرئيسي.
ولقراءة كتيب أمر معين مثل git clone
اكتب man git-clone
كذلك يمكن استعمال الأمر git help والذي يجوز أن يلحق به اسم الأمر مثلا git help clone
للبدء بتعلم git اكتب man gittutorial
وللجزء الثاني man gittutorial-2
لاستعراض آخر التعديلات اكتب
git log
ولعرض ملخص السجل اكتب
git shortlog
يمكن تخصيص المخرجات بعدة طرق مثلا لعرض معلومات إحصائية بطريقة ملونة اكتب
git log --color --stat --summary
نلاحظ أن كل عملية حفظ تأخذ معرف طويل مكون من عدد كبير من المنازل الست عشرية لعرض الفرق (على شكر رقعة) اكتب git show ثم المعرف
git show b978e8b77b1b57e0ad2d4832a3afbe2943f6b82f
ويمكنك تحديد المعرف بطرق أسهل من المعرف الطويل كأن تأخذ أي جزء فريد من أول المعرف انظر
git help rev-parse
كما يمكن المقارنة بين أي نسختين وذلك بأن تكتب
git diff COMMIT1 COMMIT2
مع تعويض معرفات الحفظ. ويمكنك تلوين المخرجات هكذا
git diff --color b978e8 5a5854
وهناك أكثر طريقة لعرض السجل أجملها وأكثرها اختصارا
git log --abbrev-commit --pretty=oneline
والتي تطبع معرف مختصر وسطر وحيد من عنوان التعديل.
يمكنك تخصيص طريقة عرض السجل لتوليد changelog مثلا عبر الأمر التالي الذي يطبع تاريخ التعديل وعنوانه (أول سطر من الرسالة)
git log --pretty=format:'%ai %s'
يمكن مثلا إضافة اسم صاحب التعديل عبر %an لقائمة كاملة بتلك الخيارات انظر كتيب git-whatchanged
حتى تتمكن من دفع التغييرات بعملية push يجب أن تحدد عنوان الدفع URL للطرف البعيد في كل مرة. لكن إن قمت بجلب المستودع البعيد عبر clone (وهو الغالب) فإن عنوان الطرف البعيد يحدد تلقائيا.
قد يكون هناك أكثر من طرف بعيد، كل منها يعطى اسما. معرف الطرف البعيد التلقائي هو origin وهو المعرف الذي قمت بعملية الاستيراد منه.
لطباعة الأطراف البعيدة المتوفرة اكتب
git remote show
لطباعة معلومات طرف بعيد اكتب اسمه بعد show مثلا إن كنت تريد معلومات عن origin اكتب
git remote show origin
لإضافة موقع بعيد اكتب
git remote add REMOTE URL
في أي مرحلة من مراحل التطوير يمكنك أن تضع عدد من الوسوم عليها مثلا رقم الإصدار هذه تسمى tags. لعرض الوسوم المستخدمة حاليا اكتب
git tag -l
لعرض الوسم الحالي git tag دون معاملات.
لوضع وسم على مرحلة ما بعد حفظها commit نكتب الأمر التالي
git tag TAGNAME
حيث TAGNAME هو اسم الوسم مثلا الذي يمكن أن يكون رقم الإصدارة هكذا
git tag 1.5.20
وبعد حفظ التغييرات وإنشاء وسم معين عليها يمكن دفعها إلى المصدر البعيد بالأمر
git push origin master 1.5.20
يمكن رفع كل الوسوم المحلية للأصل بالخيار –tags بعد الأمر push.
في أي لحظة من التطوير يمكنك تشعيب التطوير إلى فرع جديد.
مثلا إن كنت تريد تطوير ميزة لكنك تظن أن هذه الفكرة قد تكون خطأ أو أنها قد تكون غير مستقرة في هذه الحالة تقوم بتشعيب المشروع.
لعرض فروع البرنامج المحلية استعمل git branch دون معاملات. وأضف -r لعرض البعيدة منها.
لإنشاء فرع باسم FORK1
git branch FORK1
إنشاء الفروع لا يعني أن بها محتويات ولا يعني أنها فاعلة.
إذا كنت تريد أن تدفع فرع branch جديد من الكود الحالي اكتب
git push -u origin FORK1
لتحديد الفرع الفاعل استعمل checkout متبوع باسم الفرع مثلا
git checkout FORK1
هذه العملية تجعل الدليل الحالي يحتوي الإصدار أو الفرع المطلوب. وبعد ذلك تبدأ بتحرير الملفات.
الفرع الرئيسي يسمى master والفرع الذي تعمل عليه حاليا يسمى HEAD وهو مجرد مؤشر. وفي الوضع الطبيعي يكون المؤشر HEAD مشيرا نحو master
إن وجدت الفرع FORK1 غير مستقر وقررت حذفه اكتب
git branch -d FORK1
لحذف الفرع على الخادم البعيد
git push origin :FORK1
قد تختلف مصطلحات git يمكنك النظر في الرابط التالي لمصطلحات git
نقاش
جزاكم الله خيراً على هذا الشرح الوافي، فعلاً نفتقد لتناول هذه المواضيع باللغة العربية.
ممتاز .. وربنا يبارك فيك
جزاكم الله خيراً
شكرا جزيلا على هذه المعلومات القيمة.
إلى الآن لا توجد صفحة باللغة العربية في الويكيبيديا فالرجاء من كاتب المقال إضافته و لك الأجر…
شكراً يا أخوة ، وجزاكم الله خيراً أفدتمونا :)
Got it! Thanks a lot again for hpleing me out!
Was ttoally stuck until I read this, now back up and running.
Artielcs like this make life so much simpler.
Unbelievable how well-wriettn and informative this was.