كيف ترفع مشروعك على GitHub باستخدام مفتاح SSH (خطوة بخطوة للمبتدئين)

إذا كان لديك مشروع على جهازك (بنظام لينكس) وتريد رفعه على موقع GitHub لمشاركته أو حفظه، فهذا الدرس لك! سنتعلم كيف نربط جهازك بحسابك بشكل آمن باستخدام "المفتاح الذكي" (SSH) بحيث لا تضطر لإدخال كلمة المرور في كل مرة ترفع فيها تحديثاً.

الخطوة 1: تثبيت أداة Git (إذا لم تكن مثبتة)

أولاً، نحتاج للتأكد من وجود أداة Git في جهازك لكي نتمكن من استخدامها.

افتح "الطرفية" (Terminal) واكتب الأمر التالي لتثبيتها (هذا الأمر مخصص لتوزيعات ديبيان وأوبونتو وما بني عليها):

sudo apt update
sudo apt install git

الخطوة 2: عرّف عن نفسك للـ Git

الآن يجب أن نخبر أداة Git باسمك وبريدك الإلكتروني، حتى يُسجل اسمك على أي تعديل ترفعه.

في الطرفية، اكتب الأمرين التاليين (استبدل البيانات ببياناتك):

git config --global user.name "اسمك هنا"
git config --global user.email "بريدك_الإلكتروني@example.com"

الخطوة 3: إعداد مفتاح الدخول (SSH Key)

بدلاً من كتابة كلمة المرور كل مرة، سنستخدم "بصمة رقمية" لجهازك.

أولاً، لنتأكد إذا كان لديك مفتاح جاهز مسبقاً في جهازك. اكتب هذا الأمر في الطرفية:

ls -al ~/.ssh

• إذا ظهرت لك قائمة بها ملف ينتهي بـ .pub (مثل id_ed25519.pub أو id_rsa.pub)، فهذا يعني أن لديك مفتاحاً بالفعل ويمكنك تخطي خطوة الإنشاء!
• أما إذا ظهر لك رسالة خطأ أو لم تجد الملف، فهذا يعني أنك تحتاج لإنشاء مفتاح جديد بالخطوة التالية.

لإنشاء مفتاح جديد، اكتب هذا الأمر (ولا تنسَ وضع بريدك):

ssh-keygen -t ed25519 -C "بريدك_الإلكتروني@example.com"

ملاحظة: سيطلب منك النظام تحديد مكان حفظ المفتاح ووضع كلمة مرور إضافية له. للتسهيل: اضغط على زر Enter ثلاث مرات متتالية لترك الإعدادات الافتراضية وبدون كلمة مرور.

الآن، لنقم بعرض المفتاح حتى ننسخه (سواء أنشأته للتو أو كان لديك مسبقاً):

cat ~/.ssh/id_ed25519.pub

(ملاحظة: إذا كان مفتاحك القديم باسم مختلف، استبدل id_ed25519.pub باسم ملفك الذي ينتهي بـ .pub)

سيظهر لك نص طويل. قم بنسخ هذا النص كاملاً.

الخطوة 4: وضع المفتاح في حسابك على GitHub

1. افتح موقع GitHub وسجل دخولك.
2. اذهب إلى الإعدادات (Settings) من صورتك الشخصية أعلى اليمين.
3. من القائمة الجانبية، اختر SSH and GPG keys.
4. اضغط على الزر الأخضر New SSH key.
5. اكتب أي اسم للمفتاح (مثلاً: حاسوبي الشخصي).
6. الصق النص الطويل الذي نسخته في مربع Key واضغط Add SSH key.

الخطوة 5: إنشاء مستودع (مكان للمشروع) على GitHub

1. في أعلى يمين الصفحة، اضغط على علامة الزائد (+) ثم اختر من القائمة المنسدلة "New repository" (مستودع جديد).
2. ستفتح لك صفحة إنشاء المستودع. في قسم "General" (عام):
   • تأكد أن اسم حسابك موجود تحت "Owner".
   • اكتب اسماً لمشروعك في خانة "Repository name".
   • يمكنك كتابة وصف بسيط للمشروع في خانة "Description" (وهي خطوة اختيارية).
3. انزل لأسفل إلى قسم "Configuration" (الإعدادات)، واضغط على "Choose visibility" لتحديد نوع المستودع:
   • المستودع العام (Public): متاح للجميع. أي شخص يمكنه رؤية الكود وتحميله (مفيد لمعرض أعمالك أو المشاريع المفتوحة).
   • المستودع الخاص (Private): سري ومغلق. لا أحد يستطيع رؤيته غيرك ومن تدعوهم (مفيد لمشاريع العملاء أو الأكواد الحساسة).
4. في نفس القسم (الإعدادات)، تأكد من ترك الخيارات التالية كما هي تماماً (لأننا سنرفع ملفاتنا الجاهزة من الجهاز ولانريد إضافة ملفات تعارضها):
   • خيار Add README: تأكد أنه مغلق (Off).
   • خيار Add .gitignore: تأكد أنه على (No .gitignore).
   • خيار Add license: تأكد أنه على (No license).
5. اضغط على الزر الأخضر بالأسفل "Create repository".
6. ستظهر لك صفحة بها أوامر، تأكد من الضغط على زر SSH وليس HTTPS، ثم انسخ الرابط الذي يظهر (سيبدأ بـ git@github.com).

الخطوة 6: حماية ملفاتك بملف .gitignore

الآن نعود إلى جهازك. اذهب إلى مجلد مشروعك باستخدام أمر cd، مثال:

cd /path/to/your/project

قبل أن نرفع كل شيء، يجب أن نعلم أن هناك ملفات يجب ألا تصل إلى GitHub أبداً (مثل ملفات كلمات المرور، أو المجلدات الضخمة، أو ملفات النظام المؤقتة). هنا يأتي دور ملف .gitignore.

لإنشائه، اكتب في الطرفية:

touch .gitignore

ثم افتح هذا الملف بأي محرر نصوص واكتب داخله أسماء الملفات أو المجلدات التي تريد تجاهلها. مثال:

nano .gitignore

# تجاهل مجلد ضخم
node_modules/

# تجاهل ملف يحتوي على كلمات مرور
.env

# تجاهل ملفات النظام المؤقتة
*.log

احفظ الملف. الآن أداة Git ستتجاهل هذه الملفات بذكاء ولن ترفعها.

الخطوة 7: رفع مشروعك المحلي إلى الموقع

وأنت داخل مجلد مشروعك في الطرفية، نفذ الأوامر التالية بالترتيب:

تهيئة المشروع:

git init

تجهيز كل الملفات للرفع: (النقطة تعني كل الملفات، وسيتم استثناء ما ذكرناه في .gitignore)

git add .

كتابة رسالة توضح ما فعلناه:

git commit -m "أول رفع للمشروع"

تسمية الفرع الرئيسي:

git branch -M main

ربط مشروعك المحلي بالموقع: (استبدل الرابط بالرابط الذي نسخته في الخطوة 5)

git remote add origin git@github.com:username/your-repo.git

الرفع الفعلي:

git push -u origin main

مبروك! إذا قمت بتحديث صفحة GitHub الآن ستجد ملفاتك هناك.

كيف أرفع التحديثات لاحقاً؟

هذا هو الجزء الأسهل! إذا قمت بتعديل أي ملف، أو إضافة ملفات جديدة لمشروعك في المستقبل، لن تحتاج لإعادة كل الخطوات السابقة.

فقط افتح الطرفية داخل مجلد المشروع واكتب هذه الأوامر الثلاثة:

نُجهز التعديلات:

git add .

نكتب رسالة سريعة توضح التعديل (مثال: أضفت صفحة جديدة):

git commit -m "أضفت صفحة جديدة للمشروع"

نرفع التعديلات فوراً (بدون باسورد بفضل المفتاح الذي صنعناه!):

git push

معلومة إضافية للمحترفين:

نظام Git مليء بالأوامر المفيدة التي ستكتشفها مع الوقت. كأحد مستخدمي نظام لينكس، يمكنك دائماً كتابة الأمر التالي في الطرفية:

man git

هذا الأمر سيفتح لك "الكتيب الإرشادي" (Manual) الخاص بأداة Git. ستجد فيه قائمة بكل الأوامر الإضافية المتاحة مع شرح مفصل لوظيفة كل أمر، لكي تتمكن من تطوير مهاراتك بشكل مستمر!