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

أدوات الموقع


docs:git_tutorial

اختلافات

عرض الاختلافات بين النسخة المختارة و النسخة الحالية من الصفحة.

رابط إلى هذه المقارنة

جانبي المراجعة السابقة المراجعة السابقة
المراجعة التالية
المراجعة السابقة
docs:git_tutorial [2014/06/17 10:42]
albakry [git من الداخل]
docs:git_tutorial [2015/04/23 00:19] (حالي)
سطر 1: سطر 1:
 +{{tag>​مقالات برمجة git لينكس}}
 +====== أساسيات نظام إدارة إصدارات المصدر git ======
  
 +<note note>
 +نظرا لإنتقال [[https://​github.com/​ojuba-org|بوتقة تطوير أعجوبة]] إلى موقع "​Github"​ فإن العديد من التّطورات طرأت على طريقة المساهمة، لذلك نرجوا الاطلاع على موقع  ​
 +[[http://​www.arabicgit.com/​contributing-open-source-projects-github/​|Git باللغة العربية]]
 + ​لمزيد من التّفاصيل أو راجع [[http://​www.arabicgit.com/​simple-guide/​|الدليل المبسّط]] لمباشرة العمل بـ"​Git"​ دون وجع رأس !
 +</​note>​.
 +===== مقدمة =====
 +يعتبر "​Git"​ (ينطق "​چيت"​ بالجيم القاهرية) من أشهر نظم إدارة الإصدارات وأوسعها انتشارا. بدأ العمل عليه "Linus Torvalds"​ مطوّر نواة لينكس نفسه؛ حيث أنه قبل ذلك كان يفضل أن يتعامل مع عدة نسخ وكومة من الرقاع على استخدام أي من أنظمة إدارة المصدر والتّحكم بإصداراته مثل "​[[http://​www.nongnu.org/​cvs/​|CVS]]"​ (الذي يرجع تاريخ تطويره لسنة 1986) حيث أنه لم يكن يخفي إمتعاضه من عيوب تطوير وإستخدام هذا الأخير. ​
 +
 +يعتبر Git نقلة نوعية في عالم نظم التّحكم في النّسخ ("​VCS"​)، بشكل عام، ﻷنه جاء بإدارة التّفرعات ("​branches"​) المتوازية وإعادة دمجها مع بعض، وهو الأمر الذي كان يُعدّ كابوسا في الأدوات القديمة مثل CVS. وللأمانة، فإن Git ليس أول نظام جاء بهذه الفكرة، بل سبقه إليها "​[[http://​www.bitkeeper.com/​|bitkeeper]]"​ لكنه لم يكن برنامجا مجانيا ولا حرّا، وبالتّالي فإن Git أوّل نظام حرّ ومفتوح المصدر يأتي بإدارة التّفرعات المتوازية ([[http://​mercurial.selenic.com/​|mercurial]] أيضا جاء في نفس الفترة تقريبا أي سنة 2005 وهو حرّ، وقد تم تطويرهما أصلا ليكونا بدائل bitkeeper).
 +===== مميزات Git وعيوبه =====
 +من مميزات Git أنه سريع وعمليّ ويستخدم مقاطع "​hash"​ قوية للتّأكد من سلامة الملفات ولترقيم الإصدارات.
 +كما أنه يوفر طرق سهلة لعمل **فروع متوازية** "​branches"​ و**إصدارات موسومة** "​tags"​ والأهم من ذلك هو تسهيل **الدّمج** "​merge"​ بين الفروع.
 +
 +من أهم ما يميز Git عن نظم مثل CVS هو أنه نظام موزَّع غير مركزي "​Distributed Version Control Systems"​.
 +
 +من عيوب Git القديمة أنه كان ملتصقا جدا بفلسفة نظام يونكس أو لينكس في جميع نواحيه. ولكن يوجد الآن إصدارات أساسية لنظم ويندوز وماك أو إس ( من موقع "​[[http://​git-scm.com/​download/​|git-scm]]"​)، ​ والعديد من  برامج عميلة ​ بواجهات رسومية "GUI Clients":​
 +  * [[https://​msysgit.github.io/​|msysgit]]
 +  * [[https://​code.google.com/​p/​tortoisegit/​|TortoiseGit]]
 +  * وأخرى مجانية أو مدفوعة الثمن توجد [[http://​git-scm.com/​downloads/​guis|بهذه القائمة]]
 +
 +للمزيد:​
 +  * [[http://​www.infoq.com/​articles/​dvcs-guide|مقارنة بين نظم إدارة المصدر الموزّعة]] (2008)
 +  * [[http://​whygitisbetterthanx.com/​|موقع لماذا Git أفضل من كذا]]
 +
 +===== الاستضافة والتعاون والتفريع =====
 +لأن نظام Git نظام موزع أي لا مركزيّ فإنه يمكن أن تتحوّل عملية استضافة الكود إلى شبكة اجتماعية. هذا ليس كلام نظريا، فمثلا **موقع "​[[http://​github.com|Github]]"​** (حيث يقع إستضافة [[https://​github.com/​ojuba-org|بوتقة تطوير أعجوبة]]) عبارة عن شبكة اجتماعية لكتابة الأكواد عبر Git بطريقة تمكّن كلّ شخص من تفريع أي كود مستضاف حتى لو كان خارج Github ويمكن مزامنة كل فرع في الآخر أو **جذب** "​pull"​ أي فرع و**دمجه** "​merge"​ مع الرّئيسي إن رغب صاحبه بذلك أو متابعة التّطوير في **الفرع** "​branch"​. المطوّر عبر Github يرى **طلبات الجذب والدمج** "pull request"​ كذلك هناك قائمة المستودعات الأكثر نشاطا "​trending repos" وهناك ويكي، وهناك نظام تتعبّع عثرات تحت تبويب "​Issues"​ ... وطبعا هذا كله مجانا للمشاريع مفتوحة المصدر وهناك عدة عروض وخطط مدفوعة الثمن لاستضافة مشاريع خاصة (غير منشورة للعلن).
 +
 +يمكن استضافة Git على خادمك الخاص وتحديد الصلاحيات عبر مفاتيح ssh الآمنة وذلك عبر حساب shell وحيد محدود الصلاحيات عبر [[http://​gitolite.com/​gitolite/​|Gitolite]] وهو يدير الوصول إلى مستودعات Git.
 +
 +وهناك أكثر من واجهة ويب مثل "​cgit"​ (واجهة بوتقة أعجوبة سابقا) و "​[[https://​git.wiki.kernel.org/​index.php/​Gitweb|gitweb]]"​.
 +===== إنشاء مشروع git محلي =====
 +إن كنت ترغب بالتدرب على git يمكنك إنشاء مشروع محلي والتدرب عليه.
 +
 +هناك نوعان من مستودعات git: **العادي** و **المجرد**. في الأول يكون هناك مجلد .git مخفي يحتوي أمور git الداخلية إلى جانب ملفات المشروع. أما في حالة المستودع المجرد فإنك لن ترى ملفات المشروع وسترى ملفات git الداخلية فقط ويستخدم هذا الأخير عند الاستضافة العامة.
 +
 +افتح مجلد جديد مثلا myproj ثم أنشئ مستودع git بداخله
 +<code bash>
 +mkdir myproj
 +cd myproj
 +git init
 +</​code>​
 +
 +هذا الأمر ينشئ ويحول المجلد إلى مستودع git عادي، لاحظ وجود مجلد .git الخفي.
 +
 +لعمل مستودع مجرد اكتب الأمر
 +
 +<code bash>
 +mkdir myproj.git
 +cd myproj.git
 +git init --bare
 +</​code>​
 +
 +ومن أعراف مجتمع git وضع اللاحقة .git بعد اسم المجلد إن كان مجردا bare.
 +
 +إن كنت تريد استخدام هذا المجلد كمستودع "​بعيد"​ لأغراض التجربة لا تقم بعمل أي تعديل على أي من الملفات هناك. سنفرض أنك عملت مستودع مجرد وأن المجلد موجود في /​opt/​myproj.git/ ​
 +
 +===== عناوين URLs في git =====
 +يمكن أن يكون العنوان مسارا مطلقا لمجلد محلي مثل /​opt/​myproj.git/​ أو ما يكافئه من البروتوكول المحلي هكذا ​
 +<​nowiki>​file:///​opt/​myproj.git</​nowiki>​
 +
 +إضافة لاستخدام العنوان من مجلد محلي يمكن استعمال العناوين البعيدة بأي من البروتوكولات التالية:​
 +  * عبر 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 وتركه للقيمة التلقائية.
 +
 +===== الأوامر الأساسية =====
 +أول ما يقوم به أي مطور هو استنساخ مستودع بعيد بواسطة الأمر التالي:​
 +
 +<code bash>
 +git clone URL
 +</​code>​
 +
 +يمكنك تجربة استنساخ المستودع المحلي الذي عملناه للتجربة
 +
 +<code bash>
 +git clone /​opt/​myproj.git/​
 +</​code>​
 +
 +وفي هذه الحالة ستحصل على مجلد جديد اسمه myproj وبه ملفات المشروع ومجلد .git المخفي. وفي حالتي سيكون هذا المجلد فارغا.
 +
 +تستطيع البدء في التحرير وإضافة الملفات وتعديلها داخل ذلك المجلد. لكن في الواقع العملي قبل أن تبدأ بالتحرير عليك التأكد من أن النسخة لديك هي آخر نسخة من الموقع (قد تأخذ نسخة ثم يأتي شخص ويرفع تعديلات بعد أن حصلت على نسختك). تستطيع سحب آخر نسخة ودمجها مع النسخة الموجودة لديك بالأمر
 +
 +<code bash>
 +git pull URL
 +</​code>​
 +
 +ثم تبدأ بتحرير الملفات وإنشائها.
 +
 +
 +لمعرفة أين تقف وما هي التغييرات التي أنت على وشك حفظها اكتب ​
 +git status والتي قد تعطي ما يشبه
 +
 +<​code>​
 +[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")
 +</​code>​
 +
 +وهو يعني أن الملف readme-ar.html قد تغيّر ولم يحفظ. أما الملف الذي ينتهي ب ~ فلا يتم تتبعه (غير مضاف للمستودع). حيث يجب أن تخبر git عن الملفات التي عليه تتبعها. تستطيع إضافة الملفات أو المجلدات الجديدة عبر git add ثم أسماء الملفات والمجلدات. ويمكنك إضافة كل ما تغيّر في المجلد الحالي كله (هذا لا يشمل ما استجد من ملفات) بالأمر:​
 +
 +<code bash>
 +git add .
 +</​code>​
 +
 +يمكنك القيام بأوامر يونكس التقليدية من خلال git مثل rm و mv  لحذف الملفات و نقلها أو تغيير اسمها مع إعلام git بتلك التغييرات (إن قمت بتغيير اسم ملف من خارج git فإنه سيعجز عن تتبع ذلك)
 +
 +
 +لحفظ النسخة اكتب
 +<code bash>
 +git commit -a -m "​MESSAGE"​
 +</​code>​
 +مع وضع رسالة مكان MESSAGE تشرح التعديلات التي قمت بها.
 +الخيار -a يعني إضافة ما تغيّر (وليس ما استحدث) عبر الأمر add ضمنيا.
 +
 +الأمر السابق يحفظ التغييرات التي قمت بها داخل مجلد .git المخفي ولا يرسلها للمنبع البعيد.
 +
 +لدفع التغييرات للمنبع البعيد اكتب
 +
 +<code bash>
 +git push
 +</​code>​
 +
 +===== أوامر شائعة =====
 +لعرض الفرق قبل حفظه اكتب git diff دون أي معاملات حيث ستعرض الفرق بين الحالية والنسخة المحفوظة.
 +
 +<code bash>
 +git diff | less
 +</​code>​
 +
 +إن كنت قمت بتعديلات ولم تحفظها في git وكنت تريد الرجوع عنها إلى آخر نسخة محفوظة افعل الخيار الثاني (بعد git add) الذي يخبرك عنه git status وهو طبعا
 +<code bash>
 +git checkout -- FILE1 FILE2
 +</​code>​
 +حيث FILE1 FILE2 هي أسماء الملفات
 +
 +إن لم تكن ترغب في تحديد أسماء الملفات وكل ما تريده هو استعادة آخر نسخة محفوظة اكتب
 +
 +<code bash>
 +git reset --hard
 +</​code>​
 +
 +===== كتيبات 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 جديد من الكود الحالي اكتب
 +
 +<code bash>
 +git push -u origin FORK1
 +</​code>​
 +
 +لتحديد الفرع الفاعل استعمل checkout متبوع باسم الفرع مثلا
 +
 +  git checkout FORK1
 +
 +هذه العملية تجعل الدليل الحالي يحتوي الإصدار أو الفرع المطلوب. وبعد ذلك تبدأ بتحرير الملفات.
 +
 +الفرع الرئيسي يسمى master والفرع الذي تعمل عليه حاليا يسمى HEAD وهو مجرد مؤشر. وفي الوضع الطبيعي يكون المؤشر HEAD مشيرا نحو master
 +
 +إن وجدت الفرع FORK1 غير مستقر وقررت حذفه اكتب
 +
 +  git branch -d FORK1
 +
 +لحذف الفرع على الخادم البعيد
 +<code bash>
 +git push origin :FORK1
 +</​code>​
 +===== بعض مصطلحات git =====
 +قد تختلف مصطلحات git يمكنك النظر في الرابط التالي لمصطلحات git
 +  * http://​www.kernel.org/​pub/​software/​scm/​git/​docs/​user-manual.html#​glossary
 +
 +===== git من الداخل =====
 +
 +كُتب Git أساسا بلغة C وPerl وBourne shell. ولكن توجد كتابات أخرى "​Implementation"​ بلغات برمجة أخرى:
 +  * [[http://​www.eclipse.org/​jgit/​|JGit]] باستعمال لغة Java وهو إضافة لمحرّر "​Eclipse"​.
 +  * [[https://​www.samba.org/​~jelmer/​dulwich/​|Dulwich]] باستعمال بايثون مع إضافات بلغة C لتحسين الأداء.
 +  * [[http://​libgit2.github.com/​|libgit2]] باستعمال C الخالصة دون إعتماد أي مكتبات خارجية مما يجعله متعدد المنصات 100%. 
 +
 +الإطلاع على الكود المصدري:​
 +  * https://​www.kernel.org/​pub/​software/​scm/​git/ ​
 +  * https://​github.com/​git/​git
 +
 +لتثبيت Git من المصدر:​
 +  * http://​www.linuxfromscratch.org/​blfs/​view/​cvs/​general/​git.html
 +===== مصادر أخرى =====
 +  * ما هو Git؟ http://​www.arabicgit.com/​what-is-git/ ​
 +  * توثيق ​ http://​git-scm.com/​doc
 +  * كتاب "Pro Git" من نفس الموقع http://​git-scm.com/​book
 +  * أسئلة شائعة https://​git.wiki.kernel.org/​index.php/​GitFaq
 +  * "​جذاذة الغشّ"​ http://​cheat.errtheblog.com/​s/​git
docs/git_tutorial.txt · آخر تعديل: 2015/04/23 00:19 (تحرير خارجي)