מדריך עבודה עם git ו- github

ראשית, התקנות וחשבון משתמש

אז git אנחנו חייבים להתקין, ואני ממליצה לא לוותר על הסינכרון מול הענן, אפילו אם אתם עובדים לבד.
ההתקנות פשוטות ולהלן הסברים ההתקנה:

התקנת Git באופן מקומי - מה באמת צריך להתקין?

התקנה וחיבור ל- github

אם נרצה לסנכרן את המידע המקומי לענן, למשל כדי לעבוד בצוות או כדי שנוכל להציג את תיק העבודות שלנו בקישור לעולם, עלינו ליצור חשבון באחד משירותי הענן. במדריך זה אסביר על פלטפורמת github.

1- יצירת חשבון חינמי באתר github

2- אתחול עבודה מול ה- github בפעם הראשונה

כדי להתממשק בין הגרסה המקומית לענן באופן פשוט דרך סביבת העבודה, יש להתקין את ממשק העבודה מול ה- github לוקאלית במחשב, וזהו הכלי gh.

winget install --id GitHub.cli

3- לאחר ההתקנה נרצה לסנכרן את ההתקנה לחשבון ה- github שלנו ולכן נקליד בטרמינל:

gh auth login

במהלך החיבור הוא ישאל אתכם לפרטי חשבון ה- github שלכם והאם אתם רוצים להתחבר דרך ה- web (כן!). הוא יציג לכם קוד מספרי שאותו תשימו ב- github בתהליך האישור, ובסיום המחשב שלכם מקושר לחשבון שלכם!

אם הפקודה gh אינה מזוהה, כנראה המחשב לא עידכן את המסלול שלה, ולכן יש לפנות אליה עם המסלול המלא באופן הבא דרך הטרמינל:

& "C:\Program Files\GitHub CLI\gh.exe"

& "C:\Program Files\GitHub CLI\gh.exe" auth login

gh auth status

ולראות שאנחנו אכן מחוברים.

ואת ההתקנות האלו כמובן צריך לעשות בפעם הראשונה בלבד.

⬆ חזרה לתוכן העניינים

עבודה בסיסית עם Git בממשק הקונסול

יצירת Repository (מאגר) מקומי מתוך פרויקט קיים

כאשר יש לכם תיקייה עם קוד קיים ואתם רוצים להתחיל לנהל אותה באמצעות Git, צריך "להפוך" אותה ל- repository מקומי. לכן יש לפתוח טרמינל בסביבת העבודה ולהגיע לתיקיה בה נמצא הפרוייקט באמצעות פקודת cd (change directory) ושם לכתוב את הפקודה:

git init

הפקודה יוצרת תיקיית git. נסתרת שמכילה את כל המידע הדרוש לניהול הגרסאות.

בדיקת מצב הקבצים: git status

פקודה זו מציגה מה מצב הפרויקט כרגע: אילו קבצים חדשים, אילו קבצים השתנו, האם יש commits שלא נדחפו ועוד.

git status

הוספת שינויים לאזור ההכנה (Stage): git add

כדי ש־Git יכלול שינויים ב־commit הבא, צריך "להעלות" אותם ל־stage.

הוספת כל השינויים:

git add .

הוספת קבצים מסוימים:

git add file1.js file2.css

השלב הזה מאפשר לכם שליטה מלאה על אילו קבצים ייכנסו ל־commit הבא.

יצירת commit עם תיאור: git commit

Commit הוא נקודת שמירה בהיסטוריה של הקוד - כמו שמירת "גרסה רשמית".

git commit -m "תיאור ברור של מה השתנה"

חשוב שהתיאור יהיה משמעותי: הוא חלק מההיסטוריה המקצועית של הקוד, וכמובן באנגלית!!

דחיפה לשרת מרוחק: git push

אחרי יצירת commits מקומיים, צריך לדחוף אותם לשרת המרוחק (כגון GitHub).
בפעם הראשונה שרוצים להעלות את הפרוייקט לענן, יש לייצר repository (מאגר) עבור הפרוייקט בענן:

gh repos create "<project name>" --public --source

לאחר פקודה זו אתם יכולים להיכנס לחשבון שלכם באתר של github וממש לראות את את תיקיית הפרוייקט, שכרגע עדיין תהיה ריקה, מאחר ועדיין לא "דחפנו" אליה את הקבצים המקומיים שלנו.

כדי להעלות את קבצי הפרוייקט לענן בפעם הראשונה:

git push -u origin main

בחלק מהמקרים שם repository ברירת המחדל יקרא master (ולא main) ואז יש להחליף בפקודה את המילה main במילה master. כדי להיות בטוחים מה שמו ניתן לכתוב:

git status

git push

הפקודה תשלח ל-GitHub את כל ה־commits החדשים ותעדכן את הקוד בענן.

⬆ חזרה לתוכן העניינים

עבודה עם Branch (סניף)

1. יצירת Branch חדש ומעבר אליו

יצירת סניף חדש ומיד לעבור אליו:

git checkout -b feature/my-new-feature

או בשני שלבים נפרדים:

git branch feature/my-new-feature   # יצירת הסניף
git checkout feature/my-new-feature # מעבר לסניף החדש

2. ביצוע שינויים בקבצים

בשלב זה פשוט עורכים את הקבצים בעזרת ה־IDE או עורך הטקסט שלך.

3. בדיקה אילו קבצים השתנו

git status

4. הוספת (Stage) של שינויים ל-Commit

הוספת כל הקבצים שהשתנו:

git add .

או הוספת קבצים מסוימים בלבד:

git add file1.js file2.js

5. יצירת Commit עם תיאור

git commit -m "תיאור ברור של מה ששינית"

6. דחיפת ה-Branch ל-GitHub בפעם הראשונה

בפעם הראשונה שדוחפים את הסניף לשרת, משתמשים ב־-u כדי לקשר בין הסניף המקומי לסניף המרוחק:

git push -u origin feature/my-new-feature

7. דחיפות נוספות (אחרי הפעם הראשונה)

לאחר שהקישור הוגדר, מספיק להריץ:

git push

⬆ חזרה לתוכן העניינים

שינוי שם של Branch מקומי

שינוי שם כשנמצאים כרגע בתוך ה-Branch

git branch -m new-name

שינוי שם כשלא נמצאים בתוך ה-Branch

מציינים גם את השם הישן וגם את החדש:

git branch -m old-name new-name

⬆ חזרה לתוכן העניינים

מיזוג שינויים מה-Branch הנוכחי ל-main (Branch ראשי של Production)

1. מעבר ל-main

git checkout main

2. משיכת השינויים האחרונים מהשרת

כדי לוודא שה־main המקומי מעודכן לפני המיזוג:

git pull origin main

3. מיזוג ה-Feature Branch אל main

בדוגמה זו, שם הסניף הוא feature/ask-for-input-in-generated-algorithm:

git merge feature/ask-for-input-in-generated-algorithm

4. דחיפת השינויים ל-GitHub

git push origin main

⬆ חזרה לתוכן העניינים

קבלת הגרסה מהשרת ודריסת שינויים מקומיים

1. דריסת כל השינויים המקומיים כך שהתיקייה תיראה כמו origin/main

משתמשים בשיטה זו כאשר רוצים להתעלם מכל השינויים המקומיים (גם כאלה שלא בוצע להם commit) ולהפוך את הקוד המקומי לזהה למה שנמצא ב־origin/main, בלי קשר לאיזה Branch מקומי אנחנו עומדים כרגע.

אזהרה: הפקודה reset --hard מוחקת שינויים מקומיים שלא נשמרו ב-commit.

git fetch --all
git reset --hard origin/main

2. התאמת ה-Branch המקומי לגרסה שלו בשרת

כאשר רוצים שהסניף המקומי הנוכחי יהיה זהה לחלוטין לסניף המתאים בשרת (אותו שם), כולל היסטוריית ה-commits. כאן מניחים שאת כבר נמצאת על ה-Branch המתאים.

git fetch
git reset --hard your-branch-name

גם כאן, כל השינויים המקומיים הלא שמורים (לא ב-commit) יימחקו, והסניף ייראה בדיוק כמו בשרת.

⬆ חזרה לתוכן העניינים

פקודות Git שימושיות נוספות

צפייה בכל ה-Branches

git branch -a

מעבר בין Branches

git checkout branch-name

מחיקת Branch מקומי (אחרי מיזוג)

משתמשים בדרך כלל אחרי שהסניף מוזג ל-main (או לסניף אחר) ולא צריך אותו יותר:

git branch -d feature/my-new-feature

מחיקת Branch מרוחק ב-GitHub

git push origin --delete feature/my-new-feature

צפייה ב-Commits האחרונים

לדוגמה, צפייה ב־5 ה-commits האחרונים בפורמט מקוצר:

git log --oneline -5

עריכת ה- commits האחרונים

הפקודה מבקשת מ- git את האפשרות לערוך את n ה- commits האחרונים:

git rebase -i HEAD~n

הפקודה פותחת ממשק ובו אפשרויות לשנות את ההודעה ב- commit, למחוק אותם לגמרי, לאחד כמה commits לאחד וכו'.

⬆ חזרה לתחילת העמוד