ה- מנדט הוא המקום שבו אתם מגדירים מה CoRoid יכול לעשות בלי לבקש מאדם. יש לו מקום משלו בתפריט הניווט, ליד בקרת איכות, ושני חלקים: סקירה מספר לכם מה הוגדר, ו- הגדרות הוא המקום שבו אתם משנים זאת.
מה שהסקירה מספרת לכם
הסקירה עונה על שאלה אחת: מה CoRoid עושה בלי לבקש מכם?
היא מתחילה במשפט אחד, למשל: "CoRoid מתחיל תיקוני אבטחה באופן אוטומטי ולומד לבצע מיזוג ברקע. כל שלב אחר מחכה לכם." אם CoRoid גם מתקן או חוסם בקשות משיכה באופן עצמאי, שורה שנייה תציין זאת. מתחתיה מופיעים ארבעת השלבים שהמנדט קובע, בסדר שבו העבודה עוברת דרכם:
| שלב | מה המשמעות שלו |
|---|---|
| התחל עבודה | CoRoid מתחיל חלק עבודה שאף אחד לא ביקש, תחת אחת ממטרותיכם. |
| מיזוג | CoRoid מבצע מיזוג של pull request. |
| פריסה | CoRoid מפרסם לאווירה. |
| ביטול פריסה | CoRoid מבטל פריסה שנכשלה. |
כל שלב מציין אחד מהדברים הבאים:
- מבקש מכם. אין הרשאה המכסה זאת, לכן אדם מבצע זאת.
- למידה ברקע. הרשאה מכסה זאת, אך רק רושמת מה היה נעשה. השלב מציין מתי והאם נעשה עד כה.
- עושה זאת בעצמו. הרשאה פעילה מכסה זאת, והשלב מציין לאיזו עבודה וכיצד הוא מודיע לכם.
- נעצר על ידי CoRoid. CoRoid עצר את ההרשאה של השלב בעצמו. פתחו אותה כדי לראות מדוע.
- תיקוני אבטחה בלבד (התחל עבודה). CoRoid מתחיל תיקוני אבטחה תחת הגדרות האבטחה, ואדם מתחיל את כל השאר.
שלב פותח את ההרשאה שלו בהגדרות, או הרשאה חדשה לשלב זה.
מתחת לשלבים:
- תמיד החלטה של אדם: נתיבים מוגנים ומספר הבקשות המשיכה הפתוחות ביותר ש־CoRoid שומר בפרויקט. שינוי בנתיב מוגן לעולם לא ימוזג או יופץ על ידי CoRoid, ללא קשר להגדרות ההרשאה.
- מטרות: למה CoRoid פועל ומה הוא יכול להוציא, ומה קורה עם אותה עבודה.
- פרויקטים: פרויקט שהושהה, או שמצמצם הרשאה, יופיע בשורה. השאר עוקבים אחר הארגון.
בעלים ומנהלי מערכת יכולים להשהות את האוטונומיה מראש הסקירה.
הגדירו זאת
- פתחו מנדט → הגדרות ובחרו התחל מהגדרה מוכנה מראש, או הרשאה חדשה לשלב אחד.
- ההרשאה מתחילה ברקע. תנו לה לפעול זמן מה על העבודה האמיתית שלכם.
- פתחו את ההרשאה וקראו מה היה נעשה. כשהרישום משכנע אתכם, בחרו הפוך לפעיל.
- אם אתם רוצים לקבל התראות על כך ב‑Slack או Telegram, הוסיפו נתיב עבור מה ש־CoRoid עושה תחת הגדרות → חיבורים → נתיבי התראות.
אתם יכולים להחזיר הרשאה לרקע, או להשהות את האוטונומיה, בכל זמן.
הגדרות
בהגדרות מופיע קודם הארגון ואחריו כל פרויקט. כל שורה מציינת מה הוגדר; לחיצה עליה פותחת את עורך ההגדרות בפאנל צדדי. שום דבר לא נערך ישירות בדף עצמו.
| קבוצה | שורות |
|---|---|
| אוטונומיה | השהיה, עם כל העיכובים והשעיות; ה־ רזרבה לשיקום |
| הרשאות | שורה אחת לכל הרשאה, עם התחל מהגדרה מוכנה מראש ו־ הרשאה חדשה |
| מטרות | שורה אחת לכל מטרה, עם מטרה חדשה |
| מגבלות | נתיבים מוגנים, פעולות פריסה, בקשות משיכה פתוחות, סוכנים |
| היסטוריה | כל שינוי במנדט וכל החלטה שנעשתה במסגרתו |
דף הפרויקט מכיל השהיה משלו, את כל ההרשאות שיש לו, ואת ההיסטוריה שלו. המטרות והמגבלות שייכות לארגון.
הרשאות
הרשאה הרשאה היא פעולה אחת ש־CoRoid רשאי לבצע ללא אדם. השורה שלה מציינת את שמה, למשל ״מיזוג עבודה שאדם ביקש״, ומציינת עד כמה היא חלה:
בפאנל שלה ניתן לערוך אותה חלק אחר חלק: השלב, איזו עבודה היא חלה עליה, עד כמה שינוי מסוכן הוא מכסה, אילו פרויקטים, המגבלות, הנתיבים שהיא משאירה בחוץ, וכיצד היא מודיעה לכם.
בחלונית שלה אפשר לערוך אותה חלק אחר חלק: את השלב, על איזו עבודה היא חלה, את רמת הסיכון של השינוי שהיא מכסה, את הפרויקטים, את המגבלות, את הנתיבים שהיא משאירה ללא שינוי ואת אופן ההודעות.
הרשאה שפורסת יכולה גם להגביל את השינויים בפריסה אחת: כמה בקשות משיכה שמוזגו רשאי שחרור לכלול כדי ש־CoRoid יפרוס אותו. שחרור גדול יותר נשאר לפריסה בידי אדם, כך שאצווה שנכשלת רק כשהיא נבדקת יחד לעולם לא תגיע לייצור בלי אדם.
מענק מכסה אחד מארבעת השלבים, או אחת משתי הפעולות ש־CoRoid מבצע על בקשות משיכה:
- תיקון בקשות משיכה. כאשר הבדיקות נכשלות ב־pull request של עבודתו של CoRoid עצמו, CoRoid מתחיל סבב של תיקונים. ללא מענק לעבודה זו, הוא משאיר את הכישלון לאדם המבצע את הסקירה. כאשר אתם בוחרים בעצמכם באפשרות "תיקון בדיקות כושלות", אין צורך במענק.
- חסימה של בקשות משיכה. כאשר CoRoid Review מזהה בעיה שדורשת תיקון, הוא מבקש שינויים, ולכן ה־pull request ממתין לאדם. ללא מענק לפרויקט, הסקירה היא רק הערה והבדיקה שלה אינה נכשלת. מענק חסימה מכסה כל pull request בפרויקטים שלו, ללא קשר למי פתח אותו ולרמת הסיכון שלו, למעט מקרים שבהם הוא נוגע בנתיב שהמענק פוטר ממנו.
שתי הפעולות הללו היו דברים ש־CoRoid כבר עשה לפני שהפכו למענקים. כל ארגון מפעיל אותן כמענקים פעילים, כך שלא השתנה דבר כאשר הפכו להחלטות: צמצום של אחד לפרויקטים מסוימים, או ביטולו, ו־CoRoid יפסיק לפעול. גם הפסקה תעצור אותן.
לוח המענק מציג רק את מה שהשלב שלו דורש. תחילת העבודה, תיקון וביטול שינויים נקבעים לפני שיש שינוי בדירוג, ולכן אין להם רמת סיכון או נתיבים שניתן לפטור מהם. למענק חסימה אין הגדרה של "שייכות לעבודה": הוא מכסה כל pull request.
CoRoid כבר אינו שואל על ביצוע עבודה: תחילת העבודה היא ההחלטה באותו רגע. מענק לביצוע עבודה מציין זאת, וניתן לבטלו.
מענק מתחיל במצב צל
מענק חדש אינו מאפשר דבר. ב צל CoRoid רושם מה היה המענק מאפשר, כך שתוכלו לקרוא זאת לפני שאתם מסתמכים עליו. הפוך לפעיל מפעיל אותו.
עריכה שמאפשרת למענק לבצע יותר פעולות שולחת מענק פעיל חזרה למצב צל. עריכה שרק מצמצמת אותו אינה עושה זאת.
מה שהיה קורה
פתחו מענק כדי לראות:
- כמה פעמים CoRoid ביקש ממנו, ומה היה מאפשר במצב צל;
- עבור מענק שמבצע מיזוג, 30 הימים האחרונים: כמה בקשות משיכה מסוג זה התמזגו, כמה מהמענק היה מאפשר למזג, מדוע לא את השאר, וכל אחת שנמזגה ולאחר מכן בוטלה, תוקנה או טופלה;
- מה נדרש כדי שהמענק יהפוך לפעיל.
מענק לשינויים שדורגו נמוכה אינו דורש דבר נוסף: הכללים מעניקים דירוג זה. מענק לשינויים שדורגו בינונית תלוי במודל, ולכן יהפוך לפעיל רק לאחר רישום: לפחות 30 בקשות משיכה שנבחנו מהסוג הזה ללא אישור שגוי, ולפחות 10 שינויים רעים שנחסמו. עד אז, המענק מציין מה עוד חסר.
התחל ממוגדר מראש
התחל ממוגדר מראש ממלא את ה־Mandate בסדרת מענקים, כולם במצב צל:
| מוגדר מראש | מה שהוא מוסיף |
|---|---|
| תיקון | התחל עבודה לפי היעדים שלך |
| מיזוג | תיקון, ומיזוג של העבודה כאשר היא מדורגת נמוך |
| שליחה | מיזוג, ופריסה לסביבה שתגדירו |
| מעגל סגור | שליחה, וביטול פריסה לסביבה כאשר הפריסה נכשלת |
| שמור על עדכניות תלויות | מיזוג של עדכוני תלויות שדורגו נמוך |
מוגדר מראש אינו מפעיל מענק ואינו מוסיף דבר שכבר קיים.
פרויקט יכול לצמצם מנדט
המענקים של הארגון הם ברירת המחדל עבור כל פרויקט. בדף הפרויקט, בחרו מענק כדי לכבות אותו עבור אותו פרויקט, להנמיך את רמתו, לקצר את הגבולות שלו או להוסיף נתיבים שייפטרו ממנו. פרויקט אינו יכול להעניק לעצמו יותר ממה שהארגון מעניק.
כאשר CoRoid עוצר מענק בעצמו
- נעצר. המבקר של CoRoid או מדרג הסיכון שלו השתנו, והמענק עדיין לא נמדד על הגרסה החדשה. הוא יהפוך לפעיל שוב מעצמו כאשר זה יקרה.
- מושעה ע״י המפסק שלו. המיזוגים שהמענק איפשר נבוטלו, תוקנו או טופלו בתדירות גבוהה יותר מהמיזוגים שבוצעו באותם פרויקטים על ידי אנשים. כישלון בודד אינו גורם לכך. המענק מציג את שני המספרים. אדם מבטל את ההשעיה ומסביר מדוע.
מה המענק יכול למזג
מענק שמבצע מיזוג מציין איזו עבודה הוא מכסה. הוא עדיין מכסה רק שינויים שדורגו ברמתו או נמוכה יותר.
| עבודה | מה שהוא מכסה |
|---|---|
| עבודה שאנשים ביקשו | ־pull request של CoRoid שנפתח עבור משימה שאדם ביקש |
| עבודה לפי יעד | ־pull request של CoRoid שנפתח עבור עבודה שהתחילה תחת אחד מיעדיכם |
| עדכוני תלויות | ־pull request של Dependabot או Renovate (ב־GitLab, בקשת מיזוג שנפתחה על ידי בוט של טוקן גישה של פרויקט או קבוצה מתוך renovate/ ענף) שמעדכן חבילות npm, כל אחת לגרסת תיקון או לגרסה משנית באותה סדרת גרסאות, שפורסמה לפני 7 ימים לפחות, ללא סקריפט התקנה חדש, וקובץ נעילה שתואם package.jsonוללא התראת אבטחה פתוחה. עדכון כזה מסווג כנמוך לאחר חלוף 7 ימים |
| אנשים נבחרים | הרשאה pull request של חבר ששמו מופיע ברשימה, כאשר כל הקומיטים מאז הבסיס נכתבו והתקבלו על ידי חשבון ה־GitHub המקושר של אותו חבר ו־GitHub אישר את חתימתם. ב־GitLab, בקשת המיזוג נפתחה על ידי חשבון ה־GitLab המקושר של החבר, כאשר GitLab אישר את חתימת כל הקומיטים ואת כתובת האימייל של הכותב והמתקין שהיא אחת מהכתובות שהחבר אישר ב־GitLab. קומיט שנוצר בעורך האינטרנט, או נדחף על ידי אדם אחר, משאיר אותו לאדם לטיפול |
כיצד הרשאה מתמזגת
תוכנית המיזוג במפעל מציבה את ה־pull request שהרשאה מכסה תחת ה־CoRoid יכול למזג כעתורכבת המיזוג ממזגת אותו. ברגע שהמיזוג מתבצע, ה־CoRoid מבקש שוב את המנדט, כך שעצירה, השהיה, הגבלה על השימוש או קומיט חדש שנוצר מאז יצירת התוכנית יעצרו אותו.
קומיט המיזוג מציין את שם ההרשאה ואת גרסתה. המיזוג נספר כשייך להרשאה, עבור האדם שהרשאה מגדירה כאחראי, בהיסטוריה ובמגבלות של ההרשאה.
באופן סמוי, תוכנית המיזוג קובעת שהרשאה תמזג את ה־pull request, ואדם מחליט על כך.
הודעה ועצירה
הרשאה קובעת כיצד תודיע לך על מיזוג:
- ראשית, וממתינה לעצירה. כאשר רכבת המיזוג לוקחת את בקשת הפול־ריקווסט, האדם האחראי על ההרשאה והאדם שביקש את העבודה מקבלים התראה. ה־CoRoid ממזג אותה כשהחלון נסגר, למשל לאחר 10 דקות, אלא אם מישהו לוחץ על עצור בהתראה או בתוכנית המיזוג, או, עם חשבון מקושר, בפוסט שלו ב־Slack או Telegram. ה־pull request שנעצר ממתין לאדם.
- לאחר כל אחד. אתה מקבל הודעה כשהמיזוג מתבצע.
קישור חשבונותיך
הרשאה לאנשים נבחרים ו־CoRoid אישורים צריכים לדעת איזה חשבון GitHub או GitLab הוא שלך. עצירה ב־Slack או Telegram צריכה לדעת איזה חשבון Slack או Telegram הוא שלך. ב־ פרופיל → חשבונות מקושרים, קשר כל אחד מהם; הפלטפורמה מאשרת זאת. ה־CoRoid שומר את מזהה החשבון ואת שמו, אך לעולם לא את הטוקן. עבור GitLab הוא גם שומר תמצית של כל אימייל שאישרת שם (לא את האימיילים עצמם), וכך הוא יודע שקומיט הוא שלך; קשר שוב לאחר שתוסיף אימייל. ביטול קישור מסיר את כולו. כאשר הארגון שלך מחבר GitLab מנוהל עצמית, ל־GitLab הזה יש שורה משלו לאחר שבעלים או מנהל הגדירו אותו (קישור חשבונות אנשים ב־GitLab שלך).
מטרות
מטרה מטרה קובעת לאן ה־CoRoid פועל באופן עצמאי, באילו פרויקטים, וכמה הוא יכול להוציא. גרסאות קודמות כינו מטרות מנדטים; מטרות מתארות אותן בפירוט.
מטרה נותנת ל־CoRoid יעד ותקציב. בקשות מהמערכות שלך שהמטרה מקבלת מתחילות כפי שמתואר ב־ כשהעבודה מתחילה. ה־CoRoid מטפל בקבצים בעצמו במסגרת מטרה, כמו המשך לאחר ששינוי לא השיג את התוצאה הרצויה, דורש הרשאה פעילה ל־ התחל עבודה; עד אז הוא ממתין שאדם יתחיל אותה. תיקוני אבטחה הם החריג: הם מתחילים תחת הגדרות האבטחה עצמן.
מגבלות
מה ה־CoRoid לעולם אסור לעשות בעצמו, ללא קשר למה שהרשאה קובעת:
- נתיבים מוגנים. אדם מחליט על כל שינוי בהם. ה־CoRoid מגן על כניסה וגישה, חיוב ותשלומים, סודות ואישורים, הצפנה, מעברי מסד נתונים, קבצי נעילה, נתיבי CI ומכולות ותשתיות, ואתה יכול להוסיף נתיבים משלך. רק בעלים יכול להסיר אחד מה־CoRoid, עם סיבה שנרשמת.
- פעולות פריסה. המרבי שהרשאה יכולה לעשות כאן: מיזוג, פריסה וביטול פריסה, כל אחד מותר, נדרש או נדחה.
- בקשות פול־ריקווסט פתוחות. כמה בקשות פול־ריקווסט משלו ה־CoRoid משאיר פתוחות בפרויקט. כשהמגבלה מושגת, העבודה שהוא מתחיל בעצמו ממתינה; בקשה של אדם תמיד מתחילה.
- סוכנים. עד כמה סוכן יכול להגיע, והאם אוטומציות ולוחות זמנים יכולים ליצור משימות. האם סקירת ה־CoRoid יכולה לחסום את ה־pull request היא הרשאה.
היסטוריה
כל שינוי במנדט וכל החלטה שנעשתה במסגרתו, מהחדש ביותר לישן ביותר: מי פרסם או שינה הרשאה, מה ה־CoRoid הורשה או נאסר לעשות ומדוע, ומה ענו האנשים כשה־CoRoid שאל.
כשה־CoRoid שואל אותך
פעולות מסוימות דורשות תשובה של אדם קודם. כל אחת מהן היא שורה תחת זקוק לך במפעל: מה ה־CoRoid מבקש לעשות, היכן ומדוע. אשרר פעם אחת מאפשר לו לבצע את הפעולה הזו פעם אחת. דחה מונע ממנו לבצע אותה. ראה המפעל.
מי יכול לשנות אותו
הבעלים והמנהלים יכולים לשנות את המנדט. החברים יכולים לקרוא את כולו. הסוכנים וחשבונות השירות של CoRoid אינם יכולים לשנות אותו בשום צורה.
כל החלטה שנעשתה במסגרת מתן הרשאה נרשמת גם בזרם הביקורת של הארגון שלך, כחלק מ-CoRoid, יחד עם מתן ההרשאה וגרסתו.