פורמט של משימת Cron ואזור זמן

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

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

פורמט של משימת Cron

כדי להגדיר את לוח הזמנים, אתם יכולים להשתמש במסוף Google Cloud , ב-Google Cloud CLI או ב-API בארכיטקטורת REST של Cloud Scheduler.

לוח הזמנים מוגדר באמצעות פורמט המחרוזת unix-cron‏ (* * * * *), שהוא קבוצה של חמישה שדות בשורה שמציינים מתי צריך להריץ את המשימה.

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

|------------------------------- Minute (0-59)
|     |------------------------- Hour (0-23)
|     |     |------------------- Day of the month (1-31)
|     |     |     |------------- Month (1-12; or JAN to DEC)
|     |     |     |     |------- Day of the week (0-6; or SUN to SAT; or 7 for Sunday)
|     |     |     |     |
|     |     |     |     |
*     *     *     *     *
שדה הפורמט של הערכים התקינים
דקה 0-59
שעה 0-23
יום בחודש 1-31
חודש ‫1-12 (או JAN עד DEC)
היום בשבוע ‫0-6 (או SUN עד SAT, או 7 ליום ראשון)
  • דקה: מציינת כמה דקות אחרי השעה העגולה המשימה פועלת. לדוגמה, אם הדקה מוגדרת ל-0, המשימה תפעל בתחילת השעה (כי זה 0 דקות אחרי השעה). לדוגמה, אם השעה היא 8:00, המשימה תפעל בשעה 8:00.

  • Hour: מציין כמה שעות אחרי חצות המשימה פועלת (מעוגל כלפי מטה לשעה הקרובה, כי הדקות שנותרו מצוינות בשדה minute). חצות הוא 0 וצהריים הוא 12. לדוגמה, אם השעה מוגדרת ל-0, המשימה תפעל בחצות (כי זה 0 שעות אחרי חצות).

  • היום בחודש: מציין את התאריך הקלנדרי של החודש. לדוגמה, 1 ליום הראשון בחודש. ב-Cloud Scheduler אי אפשר להשתמש ב-L כדי לציין את היום האחרון בחודש.

  • חודש: מציין את החודש. ציינו את מספר החודש או את שלוש האותיות הראשונות של שם החודש באותיות רישיות. לדוגמה, 1 לינואר, או JAN.

  • היום בשבוע: מציין את היום בשבוע. לדוגמה, יום שני הוא 1 ויום שלישי הוא 2. גם 0 וגם 7 יכולים לציין את יום ראשון. מציינים את היום בשבוע באמצעות מספר או באמצעות שלוש האותיות הראשונות של שם היום באנגלית, באותיות רישיות (לדוגמה, SUN ליום ראשון).

    • השדה הזה מוערך כ-OR כולל עם השדה day of the month, אלא אם אחד מהשדות האלה מסומן כלא מוגבל באמצעות הכוכבית (*). לדוגמה, אם היום בחודש מוגדר כ-1 והיום בשבוע מוגדר כ-SAT, המשימה תפעל ביום הראשון של החודש וגם בכל יום שבת בחודש, גם אם היום הראשון בחודש הוא לא יום שבת. אם היום בשבוע לא מוגבל (מוגדר כ-*), המשימה תרוץ רק ביום הראשון של החודש.

התאמה לכל הערכים

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

הנה שתי דוגמאות שבהן שדה הדקות נשאר ללא הגבלה:

  • ‫* 0 1 1 1: המשימה פועלת בכל דקה בשעה חצות ב-1 בינואר ובימי שני.
  • ‫* * * * *: המשימה פועלת בכל דקה (בכל שעה, בכל יום בחודש, בכל חודש, בכל יום בשבוע, כי גם כל אחד מהשדות האלה לא מוגבל).

הכוכבית שווה למקרה מיוחד של טווח, שבו הטווח מתחיל בערך התקין הראשון של השדה ומסתיים בערך התקין האחרון של השדה (לדוגמה, 0-59 לשדה הדקות).

התאמה לטווח

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

הדוגמאות הבאות שוות ערך ופועלות בחצות בימי שני, שלישי, רביעי, חמישי ושישי (בכל החודשים):

  • 0 0 * * 1-5
  • 0 0 * * MON-FRI

התאמה לרשימה

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

דוגמאות:

  • ‫0 0,12 * * *: המשימה פועלת בחצות ובצהריים.
  • ‫0-5,30-35 * * * *: המשימה פועלת בכל אחת מחמש הדקות הראשונות של כל חצי שעה (בתחילת השעה ובחצי השעה).

דילוג על ערכים בטווח

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

אפשר להשתמש בכוכבית (*) כדי לציין את טווח כל הערכים בשדה. כשמשתמשים בכוכבית, הערך הראשון בטווח הוא: 0 בשדות של הדקה, השעה והיום בשבוע (יום ראשון), ו-1 בשדות של היום בחודש והחודש.

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

דוגמאות לטווחים שמשתמשים בפונקציות מדרגה:

  • ‫*/2: זו פונקציית שלב תקינה לכל שדה. בשדה הדקות, הוא תואם ל-0, 2, 4, ... , 58. בשדה השעה, הערכים התואמים הם 0, 2, 4, ... , 22. ביום בחודש, הוא תואם ל-1, 3, 5, ... , 31 (בחודש עם 31 ימים). בחודש, הוא תואם ל-1, 3, 5, ... , 11. ביום בשבוע, הוא תואם ל-0, 2, 4, 6.

  • ‫0-12/2: זו פונקציית שלב תקינה לשדות של הדקות והשעות. הוא תואם ל-0, 2, 4, ... , 12.

דוגמאות ללוחות זמנים שמשתמשים בפונקציות של צעד:

  • ‫*/2 * * * *: המשימה פועלת כל שתי דקות.

  • ‫0 0-12/2 * * *: המשימה פועלת כל שעתיים, בשעה עגולה. ההרצה הראשונה מתבצעת בחצות. ההרצה האחרונה מתבצעת בצהריים.

לוחות זמנים לדוגמה

בטבלה הבאה מוצגות כמה דוגמאות ללוחות זמנים של משימות cron והתיאור שלהן:

תזמון פורמט של משימת Cron הסבר
כל דקה * * * * * פועל כל דקה. לדוגמה, 9:00, 9:01, 9:02 וכן הלאה.
כל שעה 0 * * * * פועל כל שעה. לדוגמה, 9:00, 10:00, 11:00 וכן הלאה.
כל יום 0 0 * * * הוא פועל כל יום בשעה 00:00.
כל יום חול
(ראשון-חמישי)
האפשרויות הבאות שוות ערך:
  • 0 0 * * 1-5
  • 0 0 * * MON-FRI
הכלל פועל בשעה 00:00 בימים שני, שלישי, רביעי, חמישי ושישי.
בכל שבוע האפשרויות הבאות שוות ערך:
  • 0 0 * * 0
  • 0 0 * * 7
  • 0 0 * * SUN
הכלל פועל בימי ראשון בשעה 00:00.
מדי חודש 0 0 1 * * הכלל פועל בחצות (00:00 בפורמט של 24 שעות) ביום הראשון של החודש.
כל רבעון האפשרויות הבאות שוות ערך:
  • 0 0 1 1,4,7,10 *
  • 0 0 1 JAN,APR,JUL,OCT *
הדוח פועל בחצות (00:00 בפורמט של 24 שעות) ביום הראשון של הרבעון, לפי לוח זמנים רבעוני רגיל: 1 בינואר, 1 באפריל, 1 ביולי ו-1 באוקטובר.
מדי שנה האפשרויות הבאות שוות ערך:
  • 0 0 1 1 *
  • 0 0 1 JAN *
הפעלה ב-12:00 בלילה (00:00 בפורמט של 24 שעות) ביום הראשון של החודש הראשון בשנה (1 בינואר).

אזור זמן

אתם יכולים לבחור את אזור הזמן להערכת לוח הזמנים במסוףGoogle Cloud (בדף Create a job, בוחרים Timezone מהרשימה), או באמצעות הדגל --time-zone של gcloud כשיוצרים את המשימה.

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

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

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

פורמט חלופי של משרה

אתם יכולים להשתמש בפורמט קריא יותר לאנשים לציון זמן שנקרא groc, שמספק חלופה לביטויי cron. לדוגמה, יכול להיות שיהיה קשה לציין אירועים חוזרים מסוימים באמצעות cron, כמו "יום שלישי השלישי בכל חודש" או "דו-שבועי" (כל 336 שעות). במקרים כאלה, אפשר להשתמש במבנים כמו בדוגמאות הבאות:

03 of month 12:34
1,3,4,7,11,18,29 of jan,jul 12:34
1st friday of quarter 9:00
1st,third monday of month 04:00
2nd,3rd tue,wed,thu of feb,aug 13:50
every 336 hours
every 48 hours
every 5 minutes
every 60 minutes on mon,wed
every day 09:00
every minute
every sun,tue,thu 9:00
every wed of december 00:00
first sunday of month 12:00
second,4th tue,thursday of 3rd month of quarter 18:30

כשמציינים לוח זמנים למשימה באמצעות groc, צריך להשתמש ב-CLI של gcloud או לשלוח בקשה ישירה ל-Cloud Scheduler API.

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

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