git: تحفَظ كل خطوة وترجعلها، وما تسرّبش أسرارك

أهلًا بيك. تخيل إنك غيّرت في الـ server، وفجأة كل حاجة وقعت، ومش فاكر غيّرت إيه. git بيحل المشكلة دي: بيحفَظ صورة من مشروعك كل ما تقوله، والصورة دي اسمها commit. وتقدر ترجع لأي صورة، وتشوف إيه اللي اتغيّر بين أي اتنين. وأي شركة، من أصغرها لأكبرها، شغالة بـ git. نبدأ. git init بيحوّل الـ folder لمستودع، و dash b main بيسمّي الفرع الأساسي main. وبعدين git config بنقوله إحنا مين، علشان كل commit بيتسجل باسم صاحبه. و git status: إيه الوضع؟

$ git init -q -b main && git config user.name "مُنى" && git config user.email "[email protected]" && git status
On branch main

No commits yet

Untracked files:
  (use "git add <file>..." to include in what will be committed)
	release.sh
	server.js

nothing added to commit but untracked files present (use "git add" to track)

status بيقول: على الفرع main، ولسه مفيش commits، وفيه ملفين untracked، يعني git شايفهم بس مش متابعهم. دلوقتي نعمل أول commit على مرحلتين. git add: بتحط الملف في حاجة اسمها staging area، يعني جاهز للصورة. git commit dash m: بتاخد الصورة، ومعاها رسالة بتوصف إيه اللي اتعمل. add وبعدين commit، وبعدين log.

$ git add . && git commit -q -m "initial" && git log --oneline
5cd678d initial

أول commit، وقدامه رقم غريب، ده الـ hash: بصمة الـ commit، ومستحيل تتكرر. وبعده الرسالة: initial. دلوقتي هنعدّل server dot js. غيّرنا v one لـ v two، وزودنا سطر. git diff بيقولك إيه اللي اتغيّر من آخر commit.

console.log("server v2");
console.log("port 3000");

$ git diff
diff --git a/server.js b/server.js
index 47b905b..68a5ddc 100644
--- a/server.js
+++ b/server.js
@@ -1 +1,2 @@
-console.log("server v1");
+console.log("server v2");
+console.log("port 3000");

السطر اللي بيبدأ بـ minus اتشال: server v one. واللي بيبدأ بـ plus اتضاف: v two و port. الشكل ده اسمه diff، وهتشوفه في كل code review في حياتك. دلوقتي أخطر غلطة بيعملها المبتدئين: إنهم يرفعوا node_modules أو ملف dot env فيه الأسرار. الـ dot env فيه passwords الـ database و keys الـ APIs، ولو اترفع مرة على GitHub، اعتبره اتسرق، حتى لو مسحته بعدها، لأنه متسجل في التاريخ. الحل: ملف dot gitignore، أي اسم فيه git بيتجاهله تمامًا. node_modules بالـ slash: الـ folder كله. dot env. وأي ملف بيخلص بـ dot log. نعمل commit للتعديل ده.

node_modules/
.env
*.log

$ git add . && git commit -q -m "v2 and port" && git log --oneline
482c39a v2 and port
5cd678d initial

دلوقتي فيه اتنين commits، الجديد فوق. والصورة الكاملة: تعدّل، تشوف بـ diff، تجهّز بـ add، تحفَظ بـ commit. وفي الـ CI والـ deploy، الـ servers بتاخد الـ commit ده بالزبط وتشغّله، فلو عايز ترجع لنسخة قديمة، بترجع لـ commit قديم. التحدي: أول commit نضيف. هتكتب في release dot sh أوامر بتعمل ملف dot env فيه سر وهمي. وتتأكد بـ status إنه مش باين. وتعمل commit. وتتأكد بـ ls-files إنه مش متسجل في git. التفاصيل في الكومنت.

الحل. echo بيعمل dot env. status dash dash short. add و commit بـ dash q علشان يبقى هادي. و log و ls-files. نشغّل.

echo "SECRET=123" > .env
git status --short
git add .
git commit -q -m "add gitignore"
git log --oneline
git ls-files

$ bash release.sh
 M release.sh
235eb91 add gitignore
482c39a v2 and port
5cd678d initial
.gitignore
release.sh
server.js

status فيه release dot sh بس، وقدامه M، يعني ملف اتعدّل، و dot env مش موجود خالص. التلات commits. و ls-files: الملفات اللي git متابعها، ومفيش dot env. كده خلصنا تحت الصفر. من الدرس الجاي بندخل في Node بجد: الـ modules، و ESM و CommonJS.