מהן בקשות משיכה?

הושלמה

אנו מתחילים ב:

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

סניפים

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

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

מפתחים שעובדים על ענפים עצמאיים הם רעיון נפוץ בפיתוח תוכנה מודרנית. על-ידי יצירת ענף משלו, מפתח יכול לבצע שינויים, הנקראים ביצוע, מבלי לדאוג לגבי האופן שבו התחייבותם משפיעה על מפתחים אחרים שעובדים על הענפים שלהם.

מיזוג ענפים

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

מהי בקשת משיכה?

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

בקשת משיכה משווה שינויים בין שני ענפים:

• הענף השוואה הוא הענף של המפתח עצמו, המכיל את השינויים הספציפיים שהוא ביצע.
• הענף בסיס, המכונה גם הראשי של, הוא הענף שאליו יש למזג את השינויים.

בעת הפעלת בקשת משיכה, GitHub מציג באופן אוטומטי את תצוגת השוואת הענפים.

יצירת בקשת משיכה

כעת נעיין באופן יצירת בקשת משיכה!

1. בGitHub.com, נווט אל העמוד הראשי של המאגר.

2. בתפריט Branch, בחר את ההסתעפות המכילה את ה- commits שלך.

   

3. מעל לרשימת הקבצים, בכרזת הצהובה, בחר בלחצן השווה & בקשת כדי ליצור בקשת משיכה עבור הענף המשויך.

   

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

5. הזן כותרת ותיאור עבור בקשת המשיכה שלך.

6. כדי ליצור בקשת משיכה המוכנה לסקירה, בחר בלחצן צור בקשת משיכה. כדי ליצור בקשת משיכה של טיוטה, בחר את הרשימה הנפתחת ובחר צור בקשת משיכהטיוטה ולאחר מכן בחר בקשת משיכה.

מצבים של בקשות משיכה

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

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

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

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

• בקשת משיכה ממוזגת - מצב בקשת המשיכה הממוזגת פירושו שהעדכונים והפעולות שבוצעו מענף ההשוואה שולבו עם ענף הבסיס. כל מי שיש לו גישה לדחיפה למאגר יכול להשלים את המיזוג.

מיזוג בקשת משיכה

1. תחת שם המאגר שלך, בחר בקשות משיכה.

   

2. ברשימה בקשות, בחר את בקשת המשיכה שברצונך למזג.

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

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

     

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

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

4. אם תתבקש, הזן הודעת ביצוע או קבל את הודעת ברירת המחדל.

5. אם יש לך יותר מכתובת דואר אלקטרוני אחת המשויכת לחשבון שלך ב- GitHub.com, בחר את התפריט הנפתח כתובת דואר אלקטרוני ובחר את כתובת הדואר האלקטרוני שבה יש להשתמש ככתובת הדואר האלקטרוני של מחבר Git. רק כתובות דואר אלקטרוני מאומתות מופיעות בתפריט נפתח זה. אם הפכת את פרטיות כתובת הדואר האלקטרוני לזמינה, דואר אלקטרוני של GitHub ללא תגובה ישמש ככתובת הדואר האלקטרוני של המחבר.

   

6. בחר אשר מיזוג, אשר סקווש ומיזוג, או אשר את ההבסיס מחדש ומיזוג.

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

אפשרויות בקשת משיכה מתקדמות

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

בקשת בודקים

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

1. בעת יצירה או הצגה של בקשת משיכה, מצא את המקטע בודקים בסרגל הצד הימני.
2. חפש ובחר את שמות המשתמש של GitHub של משתפי פעולה שיש להם גישת כתיבה למאגר.
3. הבודקים שנבחרו יקבלו הודעה לבדיקת בקשת המשיכה שלך.

סקירות נדרשות וכללי הגנה על סניפים

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

• לפחות ביקורת מאשרת אחת ממשתף פעולה אחר.
• מעבר כל בדיקות הסטטוס הנדרשות, כגון זרימות עבודה של אינטגרציה רציפה (CI).

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

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

כללים אלה מוגדרים בדרך כלל על-ידי מנהלי מאגרים בהגדרות הגנת הענף.

בדיקות סטטוס ואינטגרציה רציפה (CI)

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

• מבצע בדיקות יחידות
• בדיקת עיצוב קוד
• אימות סריקות אבטחה

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

שמירת מאגרים עם כוכבים

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

כדי לככב במאגר:

1. נווט לדף המאגר ב- GitHub.com.
2. בפינה השמאלית העליונה, בחר בלחצן כוכב ⭐.

אתה יכול לראות את כל המאגרים שסימנת בכוכב על ידי בחירת תמונת הפרופיל שלך ולאחר מכן הכוכבים שלך.

קיצורי מקשים

GitHub מציע קיצורי מקלדת רבים שיעזרו לך להתקדם מהר יותר בעבודה שלך.

כדי להציג את כל הקיצורים הזמינים:

• לחץ ? במקום כלשהו GitHub.com.

תראה רשימה של קיצורי דרך לניווט בבעיות, בקשות משיכה, מאגרים ועוד.

שימוש בלוח הפקודות

לוח הפקודות ב-GitHub עוזר לך לקפוץ במהירות לדפים, להריץ פעולות נפוצות או לחפש במאגרים מבלי להוריד את הידיים מהמקלדת.

כדי לפתוח את לוח הפקודות:

• לחץ על Ctrl+K (Windows/Linux) או ⌘+K (Mac).

אתה יכול להתחיל להקליד פעולות כמו "צור בקשת משיכה", "הצג בעיות" או "החלף ענף" כדי לעבור באופן מיידי לאן שאתה צריך.

יישם את מה שלמדת

לאחר מכן, עליך להשלים תרגיל שנומש את מה שעיין בו ומחל אותו על דוגמה לחיים האמיתיים.