הוראות

מדובר ב מתן הוא הצהרה קבועה על מה ש־Coroid צריך לבצע כשאין מישהו שידרוש זאת: מטרה, הפרויקטים שהוא כולל, תקציב לשבוע או לחודש, ונקודת העצירה. בקשות שמגיעות מהמערכות שלכם – כגון כלי קליטת העבודה API, אוטומציות, אינטגרציות ומערכות ניטור – מתקבלות בהתאם למתנים הפעילים שלכם. בקשות שמגישים בני אדם אינן מתקבלות כך; ראו אילו בקשות נכללות תחת מתן?.

מתן קובע אילו משימות יכולות להתחיל. הוא אינו מאפשר ל־Coroid לאחד או לפרוס דברים. ראו מה Coroid מחליט, ומה נשאר באחריותכם?.

מתי מתן רלוונטי?#

כתבו מתן כאשר עבודה מגיעה ל־Coroid ללא בקשה פרטנית מצד אדם, ואתם רוצים לקבוע מראש את היקף הביצוע:

• כלי מעקב אחר שגיאות או ניטור שמדווח על תקריות דרך כלי קליטת העבודה API;
• הודעות של GitHub, Slack, Telegram או Jira שנשלחות על ידי סיווג העבודה אוטומציה הופכת אותן לבקשות;
• כלי תמיכה או משוב שמעבירים את דיווחי הלקוחות;
• סורק או משימה ב־CI שרושמים ממצאים אחד אחרי השני.

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

איך עוברת בקשה בתהליך?#

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

1. סיווג פועל כמו בכל בקשה: הוא מסיר סיסמאות ונתונים אישיים, בודק את הגרסה הנוכחית, מחפש כפילויות, מאמת את הדיווח ומעריך אותו.
2. קבלה מאתר את המתן שמכסה את חיובים API ובודק, בסדר זה: האם אותה בעיה כבר מטופלת, כאן או בפרויקט אחר; האם ההערכה מצאה שהתנהגות זו מתוכננת; האם אחד משני המקומות של המתן פנויים; האם יש מקום בתקציב של אותו שבוע; והאם ניתן למדוד את התוצאה.
3. מתקבלת, הבקשה הופכת למשימה עם מקום שמור וחלק מהתקציב של השבוע. היא עוברת את התהליך הרגיל – הגדרת דרישות, קוד, בדיקות, שערי איכות, QA וסקירה – ומסתיימת כ־pull request.
4. אדם מבצע איחוד שלה. תוצאת המשימה חוזה התוצאה רושם מה צריך להשיג אותו איחוד: אין אירוע חדש בנוגע לאותה בעיה במשך 24 שעות לאחר 500 בקשות על אותו נתיב.

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

דוגמאות למנדטים#

מניעת הצטברות שגיאות בהפקה#

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

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

טיפול בבאגים שדווחו ב-GitHub#

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

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

לפעול לפי מה שהלקוחות מדווחים עליו#

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

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

להשלים פעולת ניקוי לפני המועד האחרון#

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

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

כאשר אינך זקוק להוראה#

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

היכן נמצאות ההוראות#

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

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

מה כוללת הוראה?#

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

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

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

יעד. עבור הוראה סופית: המדד והערך שמשמעותם השלמת העבודה.

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

היקף.

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

תקציב. סכום הכסף ש־Coroid רשאי להוציא על המנדט בכל חלון זמן, בדולרים אמריקאיים ובשעות סוכן, לשבוע או לחודש. שבוע מתחיל ביום שני בשעה 00 UTC; חודש מתחיל ביום הראשון שלו. התקציב נפתח מחדש באופן אוטומטי.:00 UTC; חודש מתחיל ביום הראשון שלו. התקציב נפתח מחדש באופן אוטומטי.

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

תאריך סקירה. עבור מנדט מתנהל: התאריך שבו אדם מחדש או מבטל אותו.

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

מצב וגרסאות#

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

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

כל פרסום וכל שינוי מצב הם החלטה במסגרת המשימה. מקור, יחד עם האדם שיצר אותה ואירוע בנתיב הביקורת של הארגון שלך (mandate.created, mandate.published, mandate.paused וכן הלאה).

אילו בקשות נכללות תחת משימה#

משימה חלה על בקשות שמגיעות ללא אדם ב־Coroid: מקליטת העבודה API, מאוטומציות ואינטגרציות כגון GitHub או בעיות Jira, וממערכות ניטור.

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

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

מה קובע את קבלת הבקשה#

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

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

כל החלטה וסיבתה נרשמות יחד עם הבקשה.

בקשות שנדחו#

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

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

כיצד עבודת ההוראות משתפת קיבולת#

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

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

בייצוא הגדרות#

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

קשור#

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