כיצד משימה הופכת ל-pull request

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

הנתיב#

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

מפרט#

Coroid אינו מתחיל מהמשפט שלך. תחילה הוא הופך את התיאור שלך ל מפרט: מה שייבנה, מה נמצא מחוץ להיקף באופן מפורש, וקריטריוני הקבלה שיקבעו אם העבודה הצליחה.

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

ניתן לקרוא ולערוך את המפרט ב־ מפרט לשונית לפני תחילת הביצוע.

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

תכנון#

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

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

בנייה#

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

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

אימות#

חבילת הבדיקות שלך פועלת תחילה – זהו האות החזק ביותר הזמין, מכיוון שהיא מקודדת את מה שצוותך כבר קבע כחשוב.

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

סקירה#

סוכן בודק קורא את ההבדלים כפי שעמית היה קורא ומייצר ממצאים. ממצאים שניתן לתקן נשלחים חזרה לתיקון; השאר מצורפים ל־pull request כדי שתוכל לראותם.

לכן Coroid pull request מגיע כבר לאחר בדיקה – לא כדי להחליף את הבדיקה שלך, אלא כדי שהבדיקה שלך לא תהיה הראשונה.

בקשת משיכה#

הענף נדחף ו־pull request נפתח מול ענף הבסיס שלך, ונושא את השינוי, הבדיקות, תוצאות האימות וממצאי הבדיקה. אם הקוד כבר מבצע את מה שהמשימה דורשת, אין צורך לדחוף דבר: ה־QA בודק את הקוד שלא השתנה, והמשימה מסתיימת ללא pull request.

כאן מסתיימת אוטומציית המשימות של Coroid. המיזוג הוא באחריותך.

לאחר המיזוג#

פתח גרסאות כדי להכין את ההתחייבות המדויקת שאתה מתכוון לשלוח. גרסה יכולה לכלול מספר בקשות משיכה שמוזגו, התחייבות ישירה, או עבודה שמוזגה מחוץ ל־Coroid. שער הגרסה והאישורים נוגעים להתחייבות זו ולסביבה ספציפית. צינור הייצור שלך מפרסם אותה; Coroid רושם הצלחה שנצפתה או אישור מפורש לפני שהוא מציג אותה כנשלחת. משימה שסומנה כ COMPLETED או pull request שמוזג לבדו אינם מוכיחים פריסה.

סטטוסי משימות#

סטטוס המשימה מראה לך היכן היא נמצאת בדרך שהוזכרה לעיל:

מה קובע את קצב העבודה#

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

הבא#

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