טריגר של Cloud Scheduler

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

הטריגרים של Cloud Scheduler משתמשים בשירותים של Cloud Scheduler כדי לספק מתזמן משימות cron מנוהל באופן מלא ברמת הארגון בתוך Application Integration. באמצעות הטריגר הזה, אתם יכולים לנהל את כל משימות ה-cron שנוצרו בשילוב, גם מממשק המשתמש של Application Integration וגם מלוח הבקרה של Cloud Scheduler. בנוסף, הטריגר Cloud Scheduler מאפשר גם לפרוס משימות cron באזורים שונים כדי לתזמן את ההרצות של השילובים.

לדוגמה, אם הקצאתם את השילוב ב-us-central1, אתם יכולים להשתמש בטריגר של Cloud Scheduler כדי לפרוס משימת cron ב-asia-east1 (או בכל אחד מההאזורים הנתמכים של Google Cloud עבור Cloud Scheduler) כדי לקרוא לנקודת הקצה של השילוב ב-us-central1.

חשוב: יחולו חיובים נפרדים על השימוש בשירותי Cloud Scheduler בשילוב. החיובים יתבססו על מספר משימות ה-cron שנוצרו באמצעות הטריגר Cloud Scheduler ב-Application Integration. מידע נוסף על החיובים ב-Cloud Scheduler זמין במאמר תמחור של Cloud Scheduler.

לפני שמתחילים

לפני שמגדירים את הטריגר של Cloud Scheduler, צריך לבצע את המשימות הבאות בפרויקט בענן ב-Google Cloud:

1. מפעילים את Cloud Scheduler API ‏ (cloudscheduler.googleapis.com).

   הפעלת Cloud Scheduler API

2. מוודאים שיש לכם חשבון שירות של Google עם התפקיד Application Integration Invoker (הפעלת שילוב אפליקציות). אם אין לכם חשבון שירות, אתם צריכים ליצור חשבון חדש ולהקצות לו את התפקיד Application Integration Invoker.

   מידע על יצירה וניהול של חשבונות שירות זמין במאמר יצירה וניהול של חשבונות שירות.

   מידע על התפקידים המוגדרים מראש של Application Integration זמין במאמר תפקידים מוגדרים מראש ב-IAM.

הוספת הטריגר של Cloud Scheduler

כדי להוסיף טריגר של Cloud Scheduler לשילוב, מבצעים את השלבים הבאים:

1. נכנסים לדף Application Integration במסוף Google Cloud .

   מעבר אל Application Integration

2. בתפריט הניווט, לוחצים על Integrations (שילובים).

   מוצגת רשימה של כל השילובים שזמינים בפרויקט Google Cloud בדף Integrations List.

3. בוחרים שילוב קיים או לוחצים על יצירת שילוב כדי ליצור שילוב חדש.

   אם יוצרים שילוב חדש:

   1. מזינים שם ותיאור בחלונית יצירת שילוב.
   2. בוחרים אזור לשילוב.
      הערה: בתפריט הנפתח Regions (אזורים) מופיעים רק האזורים שהוקצו בפרויקט בענן שלכם ב-Google Cloud. כדי להקצות אזור חדש, לוחצים על הפעלת אזור. מידע נוסף מופיע במאמר בנושא הפעלת אזור חדש.
   3. בוחרים חשבון שירות לאינטגרציה. אפשר לשנות או לעדכן את פרטי חשבון השירות של שילוב בכל שלב מחלונית סיכום השילוב בסרגל הכלים של השילוב.
      הערה: האפשרות לבחור חשבון שירות מוצגת רק אם הפעלתם את האפשרות 'שליטה בשילובים' באזור שנבחר.
   4. לוחצים על יצירה.

   השילוב החדש שנוצר ייפתח בכלי השילובים.

4. בסרגל הניווט של כלי העריכה של השילוב, לוחצים על טריגרים כדי לראות את רשימת הטריגרים הזמינים.
5. לוחצים על הרכיב Cloud Scheduler trigger (טריגר של Cloud Scheduler) וממקמים אותו בכלי לעריכת שילובים.

הגדרת הטריגר של Cloud Scheduler

כדי להגדיר טריגר של Cloud Scheduler:

1. לוחצים על הרכיב Cloud Scheduler trigger (טריגר של Cloud Scheduler) בכלי לעריכת שילובים כדי לפתוח את חלונית הגדרת הטריגר.

   מגדירים את לוח הזמנים של הטריגר של Cloud Scheduler באמצעות אחת מהאפשרויות הבאות:

   • בסיסי: משתמשים בממשק המשתמש כדי להגדיר את לוח הזמנים של משימת ה-cron.
   • מתקדם: משתמשים בביטוי unix-cron כדי להגדיר את לוח הזמנים של משימת ה-cron.
2. (לאפשרות Basic) בוחרים בכרטיסייה Basic ומבצעים את הפעולות הבאות בשדות שמופיעים:
   1. Times: בוחרים את מרווחי הזמן שבהם השילוב צריך לפעול.
      • הפעלה בשעה מסוימת: בוחרים באפשרות הזו כדי להפעיל את השילוב בשעה מסוימת.
      • Repeat by the hour: (חזרה לפי שעה): בוחרים באפשרות הזו כדי להפעיל את השילוב שוב ושוב על בסיס שעתי.
      • Repeat by the minute: Select this option to repeatedly run the integration as per the specified number of minutes
   2. ימים: בוחרים את הימים שבהם השילוב צריך לפעול. אתם יכולים לבחור להפעיל את השילוב כל יום, בימים ספציפיים בשבוע או ביום ספציפי בחודש.
   3. Months(חודשים): בוחרים את החודשים שבהם השילוב צריך לפעול. אפשר לבחור להפעיל את השילוב מדי חודש, או בחודשים ספציפיים.
3. (באפשרות המתקדמת) בוחרים בכרטיסייה מתקדם ומציינים את תזמון משימת ה-cron באמצעות ביטוי cron.

   ביטוי ה-cron כולל חמישה ערכים שצריך לציין בסדר הבא:

   1. דקה (0-59)
   2. שעה (0-23)
   3. היום בחודש (1-‏31)
   4. חודש, אחד מהערכים הבאים:
      • מספר מ-1 עד 12
      • קיצור של החודש באנגלית (לדוגמה, Jan, Feb, Mar)
   5. היום בשבוע, אחד מהערכים הבאים:
      • מספר בין 0 ל-6, כאשר יום ראשון הוא 0
      • קיצור של היום בשבוע (למשל: א', ב', ג')

   לדוגמה, כדי להפעיל את השילוב ביום הראשון של כל חודש, משתמשים בביטוי ה-cron‏ * * 1 * *.

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

4. אזור: בוחרים את האזור שבו משימת Cloud Scheduler תיפרס.
5. כתובת האימייל בחשבון שירות: מזינים את כתובת האימייל בחשבון השירות שנוצר ב-Google.

פלט של טריגר

עבור כל טריגר של Cloud Scheduler שמוגדר ומפורסם בגרסת השילוב, Application Integration יוצר משימה חדשה של Cloud Scheduler בפרויקט בענן שלכם ב-Google Cloud.

כדי למנוע שגיאות כפילות של משימות, משימה של Cloud Scheduler נוצרת באמצעות מוסכמת השמות הבאה:

    INTEGRATION_NAME__VINTEGRATION_VERSION__CLOUD_SCHEDULER_TRIGGER_NUMBER
    

דוגמה: DemoIntegration__V1__1

יומני טריגרים

טריגר של Cloud Scheduler יוצר יומנים בתחילת הביצוע של כל שילוב ובסופו. אפשר לראות את היומנים של הטריגר של Cloud Scheduler בדף Logs Explorer ב-Cloud Logging:

1. נכנסים לדף Cloud Scheduler במסוף Google Cloud .

   כניסה ל-Cloud Scheduler

2. מאתרים את העבודה ב-Cloud Scheduler ולוחצים על הצגה בעמודה יומנים.

   יופיע הדף Logs Explorer ב-Cloud Logging עם היומנים שנוצרו על ידי הטריגר של Cloud Scheduler.

הערה: שירות Application Integration לא שומר או אוסף יומנים שנוצרו על ידי הטריגר Cloud Scheduler. היומנים האלה מאוחסנים בפרויקט בענן שלכם ב-Google Cloud, ואפשר לצפות בהם רק בדף Logs Explorer ב-Cloud Logging.

עריכה של טריגר Cloud Scheduler

Application Integration

אזהרה: עריכת טריגר של Cloud Scheduler מתוך Application Integration תחליף את משימת ה-cron הקיימת במשימת cron חדשה בגרסה חדשה של השילוב.

כדי לערוך את הטריגר של Cloud Scheduler מ-Application Integration:

1. במסוף Google Cloud, עוברים לדף Application Integration.

   מעבר אל Application Integration

2. בתפריט הניווט שמימין, לוחצים על שילובים כדי לפתוח את הדף שילובים.
3. בוחרים את האינטגרציה שרוצים לערוך.
4. בכלי לעריכת שילובים, לוחצים על התפריט הנפתח 'גרסה' ובוחרים את גרסת השילוב שמכילה את הטריגר של Cloud Scheduler שרוצים לערוך.
5. ביטול הפרסום והפעלת העריכה אם הגרסה שנבחרה של השילוב פורסמה (במצב פעיל).
6. לוחצים על הרכיב Cloud Scheduler trigger (טריגר של Cloud Scheduler) בכלי לעריכת שילובים כדי לפתוח את חלונית הגדרת הטריגר.
7. משנים את ההגדרות של המשימות ב-Cloud Scheduler לפי הצורך.

Cloud Scheduler

אפשר לערוך את הטריגר של Cloud Scheduler על ידי שינוי ההגדרה של משימת Cloud Scheduler מתוך Cloud Scheduler:

1. נכנסים אל Cloud Scheduler במסוף Google Cloud .

   כניסה ל-Cloud Scheduler

2. בוחרים את המשימה ב-Cloud Scheduler שרוצים לערוך.
3. לוחצים על Edit.
4. משנים את ההגדרות של המשימות ב-Cloud Scheduler לפי הצורך.

הערה: עריכת משימה ב-Cloud Scheduler מתוך Cloud Scheduler לא משנה את המצב של גרסת השילוב של היעד.

השהיה, המשך או העתקה של משימה ב-Cloud Scheduler

‫Application Integration לא תומך בפעולות השהיה, המשך והעתקה של משימת Cloud Scheduler שנוצרה באמצעות הטריגר Cloud Scheduler.

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

מידע נוסף על הודעות השגיאה של הטריגר של Cloud Scheduler זמין במאמר פתרון בעיות בטריגר של Cloud Scheduler. מידע על השהיה והפעלה מחדש של משימת cron באמצעות Cloud Scheduler זמין במאמר השהיה או הפעלה מחדש של משימה.

מחיקת משימה ב-Cloud Scheduler

אפשר למחוק משימה של Cloud Scheduler מתוך השילוב ב-Application Integration או מתוך Cloud Scheduler.

Application Integration

כדי למחוק משימה של Cloud Scheduler מ-Application Integration:

1. במסוף Google Cloud, עוברים לדף Application Integration.

   מעבר אל Application Integration

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

   המשימה ב-Cloud Scheduler עבור גרסת השילוב המתאימה נמחקת.

Cloud Scheduler

כדי למחוק משימה של Cloud Scheduler מ-Cloud Scheduler, מבצעים את השלבים הבאים:

1. נכנסים אל Cloud Scheduler במסוף Google Cloud .

   כניסה ל-Cloud Scheduler

2. בוחרים את המשימה ב-Cloud Scheduler שרוצים למחוק.
3. לוחצים על Delete.

   המשימה ב-Cloud Scheduler עבור גרסת השילוב המתאימה נמחקת.

הערה:

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

שיטות מומלצות

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

פתרון בעיות בטריגר של Cloud Scheduler

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

מיקום השגיאה	התרחשות השגיאה	הודעת השגיאה	סיבות אפשריות	רזולוציה
חלונית הגדרת הטריגר > הודעת שגיאה	כשהפעולה ב-Cloud Scheduler מפסיקה את ההרצה של השילוב	The configured Cloud Scheduler job CLOUD_SCHEDULER_JOB does not exist. It might be deleted from your Google Cloud project.	המשימה ב-Cloud Scheduler נמחקת באמצעות Cloud Scheduler.	יוצרים גרסה חדשה של השילוב כדי להחליף את המשימה הקיימת ב-Cloud Scheduler.
		The configured Cloud Scheduler job CLOUD_SCHEDULER_JOB is PAUSED. You must RESUME the job from your Google Cloud project.	המשימה של Cloud Scheduler מושהית באמצעות Cloud Scheduler.	ממשיכים את המשימה של Cloud Scheduler מ-Cloud Scheduler.
		The configured Cloud Scheduler job CLOUD_SCHEDULER_JOB is DISABLED due to an internal system error.	כדאי לבדוק את יומני הטריגרים כדי לזהות את הבעיה.	יוצרים גרסה חדשה של השילוב כדי להחליף את המשימה הקיימת ב-Cloud Scheduler.
		The configured Cloud Scheduler job CLOUD_SCHEDULER_JOB is in an UPDATE_FAILED state due to a failed CloudScheduler.UpdateJob operation.	לחשבון השירות שצוין אין את הרשאות ה-IAM הנדרשות.	כדי לשחזר משימה מהמצב הזה, צריך לנסות שוב את הפעולה CloudScheduler.UpdateJob עד שתתקבל תגובה על הצלחה.
		The last execution of the Cloud Scheduler job CLOUD_SCHEDULER_JOB failed due to CLOUD_SCHEDULER_JOB_ISSUE. Learn more.	CLOUD_SCHEDULER_JOB_ISSUE	לא זמין

החרגות בהסכם רמת השירות

הטריגר של Cloud Scheduler תלוי במוצר Cloud Scheduler. מכיוון שהתלות הזו היא חיצונית ל-Application Integration, התנאים וההגבלות של הסכם רמת השירות (SLA) של Application Integration חלים רק כשהביצוע מתוזמן בהצלחה לשילוב active.