ניסיון חוזר של משימות

כברירת מחדל, אם משימה ב-Cloud Scheduler לא מקבלת אישור מה-handler שלה, היא נחשבת כמשימה שנכשלה, והמערכת תנסה להפעיל אותה שוב בהתאם להשהיה המעריכית לפני ניסיון חוזר (exponential backoff) שהגדרתם. כשיוצרים או מעדכנים משימה ב-Cloud Scheduler, אפשר להגדיר את התנהגות הניסיונות החוזרים בדרכים הבאות:

ניסיון נוסף להגדיר

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

מספר הניסיונות המקסימלי

מספר הניסיונות שהמערכת תבצע כדי להריץ משימה באמצעות הליך ההשהיה המעריכית לפני ניסיון חוזר (exponential backoff) שמתואר ב-maxDoublings.

תיאור

אם הערך של retryCount הוא מספר שאינו אפס, Cloud Scheduler ינסה שוב להפעיל את המשימה שנכשלה באמצעות השהיה מעריכית לפני ניסיון חוזר (exponential backoff), למשך retryCount פעמים עד שהמשימה תצליח או עד שמספר הניסיונות החוזרים יסתיים. שימו לב: אם הניסיונות החוזרים יימשכו עד למועד ההפעלה המתוזמן הבא, יכול להיות שההפעלה הזו תבוטל.

אם הערך של retryCount הוא 0 (וגם הערך של maxRetryDuration הוא 0), לא יתבצע ניסיון חוזר להפעיל את המשימה אם היא תיכשל. במקום זאת, Cloud Scheduler ימתין לזמן ההפעלה המתוזמן הבא.

אי אפשר להזין ערכים גדולים מ-5 וערכים שליליים.

ברירת מחדל ברירת המחדל היא 0.
תווית המסוף מספר הניסיונות המקסימלי
דגל CLI --max-retry-attempts
שדה API retryCount

משך הזמן המקסימלי לניסיון חוזר

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

תיאור

משך זמן בשניות עם עד תשע ספרות אחרי הנקודה העשרונית, שמסתיים ב-"s" – לדוגמה, "3.5s".

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

ברירת מחדל ברירת המחדל היא 0 שניות.
תווית המסוף משך הזמן המקסימלי לניסיונות חוזרים
דגל CLI --max-retry-duration
שדה API maxRetryDuration

משך זמן מינימלי להמתנה לפני ניסיון חוזר

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

תיאור

משך זמן בשניות עם עד תשע ספרות אחרי הנקודה העשרונית, שמסתיים ב-"s" – לדוגמה, "3.5s".

ברירת מחדל ברירת המחדל היא 5 שניות.
תווית המסוף משך זמן מינימלי להמתנה
דגל CLI --min-backoff
שדה API minBackoffDuration

משך זמן ההמתנה המקסימלי

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

תיאור

משך זמן בשניות עם עד תשע ספרות אחרי הנקודה העשרונית, שמסתיים ב-"s" – לדוגמה, "3.5s".

ברירת מחדל ברירת המחדל היא 3,600 שניות (שעה).
תווית המסוף משך זמן ההמתנה המקסימלי
דגל CLI --max-backoff
שדה API maxBackoffDuration

מספר ההכפלות המקסימלי

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

תיאור הזמן בין הניסיונות החוזרים יוכפל maxDoublings פעמים.

מרווח הזמן בין ניסיונות חוזרים של משימה מתחיל ב-minBackoffDuration, מוכפל maxDoublings פעמים, גדל באופן ליניארי, ולבסוף מתבצע ניסיון חוזר במרווחים של maxBackoffDuration עד retryCount פעמים. לדוגמה:

אם minBackoffDuration הוא 10 שניות, maxBackoffDuration הוא 300 שניות ו-maxDoublings הוא 3:

  1. המערכת תנסה להפעיל את המשימה שוב אחרי 10 שניות.
  2. מרווח הזמן לניסיון חוזר יוכפל שלוש פעמים.
  3. מרווח הזמן בין הניסיונות החוזרים יגדל באופן לינארי ב-‎2^3 * 10s.
  4. אם רלוונטי, המשימה תנסה שוב במרווחים של maxBackoffDuration עד שהמשימה תנסה retryCount פעמים (עד למקסימום של 5 פעמים).

לכן, הבקשות יישלחו שוב אחרי 10, 20, 40, 80 ו-160 שניות.

אם minBackoffDuration הוא 10 שניות, maxBackoffDuration הוא 120 שניות ו-maxDoublings הוא 2:

  1. המערכת תנסה להפעיל את המשימה שוב אחרי 10 שניות.
  2. מרווח הזמן לניסיון חוזר יוכפל פעמיים.
  3. מרווח הזמן בין הניסיונות החוזרים יגדל באופן לינארי ב-‎2^2 * 10s.
  4. אם רלוונטי, המשימה תנסה שוב במרווחים של maxBackoffDuration עד שהמשימה תנסה retryCount פעמים (עד למקסימום של 5 פעמים).

לכן, הבקשות יישלחו שוב אחרי 10 שניות, 20 שניות, 40 שניות, 80 שניות ו-120 שניות.

ברירת מחדל ברירת המחדל היא 5.
תווית המסוף מספר ההכפלות המקסימלי
דגל CLI --max-doublings
שדה API maxDoublings

דוגמאות לניסיון חוזר

הדוגמאות הבאות ממחישות את התנהגות הניסיונות החוזרים כשמשימה ב-Cloud Scheduler לא מסתיימת בהצלחה.

אם גם retryCount וגם maxRetryDuration לא מוגדרות,

שתי ההגדרות מוגדרות כברירת מחדל ל-0, והמשימה לא מנסה שוב בכלל.

שימו לב ש-Cloud Scheduler ינסה להריץ את המשימה בזמן הבא שנקבע להרצה.

אם גם retryCount וגם maxRetryDuration מוגדרות

המשימה תנסה שוב לפחות retryCount פעמים עד שתגיע אל maxRetryDuration.

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

אם המדיניות retryCount מוגדרת והמדיניות maxRetryDuration לא מוגדרת

ערך ברירת המחדל של ההגדרה maxRetryDuration הוא 0, והמשימה תנסה שוב בדיוק retryCount פעמים.

אם retryCount לא מוגדר ו-maxRetryDuration מוגדר

העבודה תנסה שוב מספר כלשהו של פעמים (עד 5 פעמים לכל היותר) או עד שתגיע אל maxRetryDuration.

המאמרים הבאים