أعجوبة

البرمجيات الحُرة والمفتوحة المصدر

أدوات المستخدم

أدوات الموقع


docs:git_tutorial

أساسيات نظام إدارة إصدارات المصدر git

نظرا لإنتقال بوتقة تطوير أعجوبة إلى موقع “Github” فإن العديد من التّطورات طرأت على طريقة المساهمة، لذلك نرجوا الاطلاع على موقع Git باللغة العربية لمزيد من التّفاصيل أو راجع الدليل المبسّط لمباشرة العمل بـ“Git” دون وجع رأس !

.

مقدمة

يعتبر “Git” (ينطق “چيت” بالجيم القاهرية) من أشهر نظم إدارة الإصدارات وأوسعها انتشارا. بدأ العمل عليه “Linus Torvalds” مطوّر نواة لينكس نفسه؛ حيث أنه قبل ذلك كان يفضل أن يتعامل مع عدة نسخ وكومة من الرقاع على استخدام أي من أنظمة إدارة المصدر والتّحكم بإصداراته مثل “CVS” (الذي يرجع تاريخ تطويره لسنة 1986) حيث أنه لم يكن يخفي إمتعاضه من عيوب تطوير وإستخدام هذا الأخير.

يعتبر Git نقلة نوعية في عالم نظم التّحكم في النّسخ (“VCS”)، بشكل عام، ﻷنه جاء بإدارة التّفرعات (“branches”) المتوازية وإعادة دمجها مع بعض، وهو الأمر الذي كان يُعدّ كابوسا في الأدوات القديمة مثل CVS. وللأمانة، فإن Git ليس أول نظام جاء بهذه الفكرة، بل سبقه إليها “bitkeeper” لكنه لم يكن برنامجا مجانيا ولا حرّا، وبالتّالي فإن Git أوّل نظام حرّ ومفتوح المصدر يأتي بإدارة التّفرعات المتوازية (mercurial أيضا جاء في نفس الفترة تقريبا أي سنة 2005 وهو حرّ، وقد تم تطويرهما أصلا ليكونا بدائل bitkeeper).

مميزات Git وعيوبه

من مميزات Git أنه سريع وعمليّ ويستخدم مقاطع “hash” قوية للتّأكد من سلامة الملفات ولترقيم الإصدارات. كما أنه يوفر طرق سهلة لعمل فروع متوازية “branches” وإصدارات موسومة “tags” والأهم من ذلك هو تسهيل الدّمج “merge” بين الفروع.

من أهم ما يميز Git عن نظم مثل CVS هو أنه نظام موزَّع غير مركزي “Distributed Version Control Systems”.

من عيوب Git القديمة أنه كان ملتصقا جدا بفلسفة نظام يونكس أو لينكس في جميع نواحيه. ولكن يوجد الآن إصدارات أساسية لنظم ويندوز وماك أو إس ( من موقع “git-scm”)، والعديد من برامج عميلة بواجهات رسومية “GUI Clients”:

للمزيد:

الاستضافة والتعاون والتفريع

لأن نظام Git نظام موزع أي لا مركزيّ فإنه يمكن أن تتحوّل عملية استضافة الكود إلى شبكة اجتماعية. هذا ليس كلام نظريا، فمثلا موقع “Github (حيث يقع إستضافة بوتقة تطوير أعجوبة) عبارة عن شبكة اجتماعية لكتابة الأكواد عبر Git بطريقة تمكّن كلّ شخص من تفريع أي كود مستضاف حتى لو كان خارج Github ويمكن مزامنة كل فرع في الآخر أو جذب “pull” أي فرع ودمجه “merge” مع الرّئيسي إن رغب صاحبه بذلك أو متابعة التّطوير في الفرع “branch”. المطوّر عبر Github يرى طلبات الجذب والدمج “pull request” كذلك هناك قائمة المستودعات الأكثر نشاطا “trending repos” وهناك ويكي، وهناك نظام تتعبّع عثرات تحت تبويب “Issues” … وطبعا هذا كله مجانا للمشاريع مفتوحة المصدر وهناك عدة عروض وخطط مدفوعة الثمن لاستضافة مشاريع خاصة (غير منشورة للعلن).

يمكن استضافة Git على خادمك الخاص وتحديد الصلاحيات عبر مفاتيح ssh الآمنة وذلك عبر حساب shell وحيد محدود الصلاحيات عبر Gitolite وهو يدير الوصول إلى مستودعات Git.

وهناك أكثر من واجهة ويب مثل “cgit” (واجهة بوتقة أعجوبة سابقا) و ”gitweb”.

إنشاء مشروع git محلي

إن كنت ترغب بالتدرب على 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/

عناوين URLs في git

يمكن أن يكون العنوان مسارا مطلقا لمجلد محلي مثل /opt/myproj.git/ أو ما يكافئه من البروتوكول المحلي هكذا file:///opt/myproj.git

إضافة لاستخدام العنوان من مجلد محلي يمكن استعمال العناوين البعيدة بأي من البروتوكولات التالية:

  • عبر rsync
  • عبر http أو https
  • عبر بوتوكول git الذي يأتي من git-daemon
  • عبر ssh

وكلها لا تقبل اسم مستخدم إلا 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

كتيبات git

اكتب 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 يمكنك النظر في الرابط التالي لمصطلحات git

git من الداخل

كُتب Git أساسا بلغة C وPerl وBourne shell. ولكن توجد كتابات أخرى “Implementation” بلغات برمجة أخرى:

  • JGit باستعمال لغة Java وهو إضافة لمحرّر “Eclipse”.
  • Dulwich باستعمال بايثون مع إضافات بلغة C لتحسين الأداء.
  • libgit2 باستعمال C الخالصة دون إعتماد أي مكتبات خارجية مما يجعله متعدد المنصات 100%.

الإطلاع على الكود المصدري:

لتثبيت Git من المصدر:

مصادر أخرى

docs/git_tutorial.txt · آخر تعديل: 2015/04/23 03:19 بواسطة 127.0.0.1

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki