Translation(s): English - Français - Italiano - عربية -

يعتبر git من أشهر نظم إدارة الإصدارات وأوسعها انتشارا. بدأ العمل عليه Linus Torvalds مبرمج نظام لينكس نفسه حيث أنه قبل ذلك كان يفضل أن يتعامل مع عدة نسخ وكومة من الرقاع على استخدام أي من أنظمة إدارة المصدر والتحكم بإصداراته مثل CVS بل إنه لا يتردد بتسفيه أحلام مطوري CVS فضلا عن مستخدميه. ثم قام بتطوير GIT ليعالج نقاط الضعف التي كانت موجودة في الأنظمة الأخرى.

من مميزات git أنه سريع وعملي ويستخدم مقاطع hash قوية للتأكد من سلامة الملفات ولترقيم الإصدارات. كما أنه يوفر طرق سهلة لعمل فروع branches وإصدارات موسومة tags والأهم من ذلك هو تسهيل الدمج بين الفروع. ومن من أهم ما يميز git عن نظم اخرى مثل CVS هو أنه نظام موزع (غير مركزي).

إنشاء مشروع 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

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

وكلها لا تقبل اسم مستخدم إلا ssh أي أن العنوان هو:

PROTOCOL://HOST[:PORT]/PATH/REPO.git/

أما في حالة ssh فإنه يمكن تحديد اسم المستخدم قبل العائل HOST وتفصل بينهما علامة @ هكذا

ssh://USER@HOST[:PORT]/PATH/REPO.

ويمكن أن يكون المسار نسبة لبيت المستخدم 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 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.

إدارة الفروع

في أي لحظة من التطوير يمكنك تشعيب التطوير إلى فرع جديد. مثلا إن كنت تريد تطوير ميزة لكنك تظن أن هذه الفكرة قد تكون خطأ أو أنها قد تكون غير مستقرة في هذه الحالة تقوم بتشعيب المشروع.

لإنشاء فرع باسم FORK1

git branch FORK1

إنشاء الفروع لا يعني أن بها محتويات ولا يعني أنها فاعلة.

لتحديد الفرع الفاعل استعمل checkout متبوع باسم الفرع مثلا

git checkout FORK1

هذه العملية تجعل الدليل الحالي يحتوي الإصدار أو الفرع المطلوب. وبعد ذلك تبدأ بتحرير الملفات.

الفرع الرئيسي يسمى master والفرع الذي تعمل عليه حاليا يسمى HEAD وهو مجرد مؤشر. وفي الوضع الطبيعي يكون المؤشر HEAD مشيرا نحو master

إن وجدت الفرع FORK1 غير مستقر وقررت حذفه اكتب

git branch -d FORK1

Git tools under Debian

تطوير دبيان

شاهد ايضا