התראות לגבי אשכולות

במסמך הזה מוסבר איך Google Kubernetes Engine ‏ (GKE) מפרסם התראות על אשכולות ב-Cloud Logging כברירת מחדל (ואופציונלית ב-Pub/Sub) כשאירועים ספציפיים מתרחשים באשכולות GKE. ההתראות האלה כוללות מידע על אירועים שרלוונטיים להגדרות של האשכול, כמו שדרוגים מתוזמנים, זמינים או מתמשכים, עדכוני אבטחה דחופים ותאריכי סיום התמיכה. כדי למצוא את היומנים האלה ב-Cloud Logging, קראו את המאמר הצגת התראות של אשכולות ב-Cloud Logging.

בנוסף, GKE מפרסם התראות על האירועים האלה כהודעות לנושאי Pub/Sub שאתם מגדירים. אתם יכולים לקבל את ההתראות האלה במינוי ל-Pub/Sub, לשלב אותן עם שירותי צד שלישי ולסנן את סוגי ההתראות שאתם רוצים לקבל. איך מגדירים התראות על אשכולות באמצעות Pub/Sub?

בנוסף להתראות על אשכולות, GKE מספק גם התראות על רצף השקה עם שלבים בהתאמה אישית, באופן בלעדי ל-Cloud Logging.

יתרונות

התראות לגבי אשכולות מספקות את היתרונות הבאים:

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

  • אתם יכולים לבחור אם להשתמש ב-Cloud Logging או ב-Pub/Sub:

    • כברירת מחדל, התראות לגבי אשכולות נשלחות ל-Cloud Logging. אתם יכולים להשתמש בכל היכולות של Cloud Logging, כולל שאילתות וצפייה ביומנים, והגדרה של מדיניות התראות שמבוססת על יומנים.
    • ‫Pub/Sub הוא שירות שניתן להרחבה, ומאפשר לכם לעבד את ההתראות הנכנסות בדרכים שונות. לדוגמה, אתם יכולים לשלב את Slack כדי להעביר התראות לערוץ Slack, או להפעיל פונקציות Cloud Run כדי להריץ תהליכים בהתאמה אישית. כשנדרשים תהליכים מותאמים אישית (לדוגמה, תזמון של תהליך עבודה של העברה מסביבת פיתוח לסביבת ייצור כדי לבדוק ולתת אישור לשדרוג), אפשר להשתמש בהתראה כדי להפעיל את תהליכי העבודה האלה באופן אוטומטי.

התראות על רצף ההשקה מודיעות לכם על הדברים הבאים:

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

סוגי התראות על שדרוג

‫GKE שולח את סוגי ההתראות הבאים לגבי אשכולות:

אם צופים בהתראות על אשכולות ב-Cloud Logging, אפשר להשתמש ביכולות של Cloud Logging כדי לסנן את היומנים. אם אתם משתמשים ב-Pub/Sub, אתם יכולים לסנן את ההתראות שאתם מקבלים כדי לקבל התראות רק על אירועים רלוונטיים.

‫GKE שולח את סוגי ההתראות הבאים על רצף ההשקה עבור רצף השקה עם שלבים בהתאמה אישית:

SecurityBulletinEvent

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

UpgradeAvailableEvent

כשגרסה חדשה זמינה בערוץ הפצה, GKE שולח התראה מסוג UpgradeAvailableEvent לאשכולות בערוץ ההפצה הזה כדי להודיע להם שגרסה חדשה זמינה. ההתראה הזו מספקת הודעה מראש של שבוע לגבי גרסאות תיקון, ולפחות 2-4 שבועות לגבי גרסאות משניות (בהתאם לערוץ). מידע נוסף זמין במאמר אילו גרסאות זמינות בערוץ.

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

אם אתם משתמשים במאגרי צמתים של Windows Server, פרטי הגרסה של Windows נשלחים כחלק מההתראה של UpgradeAvailableEvent.

UpgradeEvent

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

ההתראה UpgradeEvent נשלחת בתחילת פעולת השדרוג. מזהה הפעולה מועבר בהודעה.

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

UpgradeInfoEvent

‫GKE שולח התראה מסוג UpgradeInfoEvent לאירועים מסוגים שונים, שמפורטים בקטעים הבאים.

מידע נוסף על סינון לפי סוג ספציפי של UpgradeInfoEvent מופיע במאמר סינון התראות של אשכולות UpgradeInfoEvent.

שדרוגים מתוזמנים של אשכולות

כשמתוזמן שדרוג של אשכול ב-GKE, נשלחת התראה בין 72 ל-96 שעות מראש. מידע נוסף על הפעלת שדרוגים מתוזמנים של אשכולות זמין במאמר בנושא קבלת התראות על שדרוגים מתוזמנים של אשכולות.

פעולת השדרוג הסתיימה

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

  • ‫SUCCEEDED: GKE שדרג בהצלחה את מישור הבקרה או את הצמתים.
  • ‫FAILED: השדרוג של מישור הבקרה או הצמתים ב-GKE נכשל.
  • ‫CANCELED: פעולת השדרוג בוטלה על ידי GKE מסיבות טכניות או עסקיות, או שאתם ביטלתם את פעולת השדרוג.

ההתראה מאפשרת לאשר שהפעולה של השדרוג הצליחה.

מה כלול בהודעה על שדרוג לאימות דו-שלבי

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

  • הגרסה הראשונית
  • גרסת היעד
  • הגרסה הראשונית של האמולטור
  • גרסת היעד המדומה

גרסה משנית בסיום או לקראת סיום התמיכה

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

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

ההתראה כוללת את הפרטים הבאים:

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

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

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

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

ההתראה הזו כוללת את הפרטים הבאים:

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

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

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

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

אירועים שמשבשים את השדרוג של מאגר הצמתים

כשמתרחשים במאגר צמתים סוגים מסוימים של אירועים שמשבשים את השדרוג של מאגר הצמתים, GKE שולח התראה כדי ליידע אתכם על האירוע.

‫GKE שולח התראה על אשכולות לסוגים הבאים של אירועים משבשים:

  • ניקוז הצומת נחסם על ידי התקציב לשיבוש Pod‏ (PDB).
  • הגיע הזמן הקצוב לתפוגה של ה-PDB וה-Pods יימחקו בכוח למרות ההפרה של ה-PDB.

ההתראה הזו כוללת את הפרטים הבאים:

  • הצומת שמושפע מאירוע השיבוש הזה.
  • ה-Pods שהושפעו מאירוע השיבוש הזה.
  • הפעולה שהפעילה את ניקוז הצומת.
  • פסק הזמן של ה-PDB לפני שה-Pods נמחקו בכוח.

RolloutEvent

מערכת GKE שולחת התראות כשהאירועים הבאים מתרחשים במהלך השקה של גרסת GKE ברצף השקה עם שלבים בהתאמה אישית:

  • ROLLOUT_CREATED: נוצרה השקה חדשה.
  • ‫ROLLOUT_STAGE_TRANSITION: שלב בהשקה עבר למצב חדש.
  • ‫ROLLOUT_BLOCKED: ההשקה חסומה כי אי אפשר לשדרג את מישור הבקרה או את מאגר הצמתים.
  • ‫ROLLOUT_AUTO_PAUSED: ההשקה הושהתה אוטומטית על ידי GKE.
  • ‫ROLLOUT_AUTO_RESUMED: ההשקה חודשה אוטומטית אחרי שהושהתה.
  • ‫ROLLOUT_CANCELLATION_WARNING: ההשקה הושהתה למשך זמן רב מדי, ואם היא לא תופעל מחדש, היא תבוטל באופן אוטומטי תוך שבעה ימים.
  • ‫ROLLOUT_AUTO_CANCELLED: ההשקה בוטלה אוטומטית על ידי GKE.
  • ‫ROLLOUT_COMPLETED: ההשקה הושלמה בהצלחה.

RolloutSequenceEvent

‫GKE שולח התראות במצבים הבאים לגבי רצף השקה עם שלבים בהתאמה אישית:

  • ‫SEQUENCE_MISCONFIGURED: רצף ההשקה לא מוגדר נכון, ולכן GKE לא יכול לבצע שדרוגים ברצף עם ההגדרות הנוכחיות.
  • ‫SEQUENCE_DEACTIVATION_WARNING: אזהרה ש-GKE ישבית את רצף ההשקה אם ההגדרה השגויה לא תתוקן.

צפייה בהתראות על אשכולות ב-Cloud Logging

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

כדי לראות את היומנים של אשכולות GKE, אפשר לעיין במאמר בנושא גישה ליומנים.

כדי לבטל את ההסכמה לשמירת היומנים האלה, אתם יכולים להגדיר מסנן החרגה.

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

logName=projects/PROJECT_ID/logs/container.googleapis.com%2Fnotifications

מחליפים את PROJECT_ID במזהה הפרויקט ב- Google Cloud .

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

jsonPayload.@type=type.googleapis.com/google.container.v1beta1.NOTIFICATION_TYPE

מחליפים את NOTIFICATION_TYPE בסוג ההתראה באשכול של היומנים שרוצים לראות.

סינון UpgradeInfoEvent התראות לגבי אשכולות

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

jsonPayload.@type=type.googleapis.com/google.container.v1beta1.UpgradeInfoEvent
jsonPayload.eventType=EVENT_TYPE

מחליפים את EVENT_TYPE באחד מהערכים הבאים:

סינון התראות ל-Pub/Sub

אתם יכולים לסנן את ההתראות מהאשכולות כדי לוודא שאתם מקבלים ב-Pub/Sub רק את ההתראות שאתם רוצים. אפשר להחיל סינון על הודעות ל-Pub/Sub באחת מהדרכים הבאות:

במאמר צפייה בהתראות על אשכול ב-Cloud Logging מוסבר איך לצפות בהתראות ולסנן אותן ב-Cloud Logging.

סינון התראות ל-Pub/Sub ב-GKE

כדי להגדיר סינון ל-Pub/Sub לסוג אחד או יותר של התראות זמינות, כשמפעילים התראות באשכול, מציינים ערכים של filter בדגל --notification-config. הפרמטר filter מקבל רשימה מופרדת בקווים אנכיים ( | ) של סוגי ההתראות שרוצים לקבל.

לדוגמה, אם מציינים filter="UpgradeEvent|SecurityBulletinEvent",‏ GKE ישלח התראות רק לגבי סוגי ההתראות UpgradeEvent ו-SecurityBulletinEvent.

לסינון התראות באמצעות filter יש יתרונות כמו:

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

איך מסננים התראות ב-GKE באמצעות Pub/Sub

סינון ההתראות ב-GKE לא משפיע על היומנים שמופיעים ב-Cloud Logging.

סינון התראות ב-Pub/Sub

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

לדוגמה, כדי לסנן התראות מסוג UpgradeEvent ו-UpgradeAvailableEvent, אפשר להשתמש בתחביר הבא במינוי:

attributes.type_url = "type.googleapis.com/google.container.v1beta1.UpgradeEvent" OR "type.googleapis.com/google.container.v1beta1.UpgradeAvailableEvent"

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

מידע נוסף על סינון המינוי ל-Pub/Sub זמין במאמר סינון הודעות.

התראות על התראות של אשכולות ב-Cloud Logging

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

יצירת התראה שמבוססת על יומן

כדי ליצור התראה לסוג הודעה לצרכנים מסוים, מבצעים את השלבים הבאים. בשלבים הבאים, UpgradeEvent משמש כדוגמה.

  1. במסוף Google Cloud , נכנסים לדף Logs Explorer.

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

    resource.type="RESOURCE_TYPE"
log_id("container.googleapis.com/notifications")
jsonPayload.@type="type.googleapis.com/google.container.v1beta1.NOTIFICATION_TYPE"

    מחליפים את מה שכתוב בשדות הבאים:

    • ‫RESOURCE_TYPE: סוג המשאב שרוצים לסנן, לדוגמה gke_cluster או gke_nodepool, או שילוב שלהם.
    • ‫NOTIFICATION_TYPE: סוג ההתראה של האשכול שרוצים לקבל, כמו UpgradeEvent.

    יש סוגים של התראות שצריך לסנן אותם בצורה נוספת. לדוגמה, אם רוצים לסנן לפי סוג ספציפי של UpgradeInfoEvent, מוסיפים את המסנן jsonPayload.eventType לשאילתה. שאילתת הדוגמה הבאה מסננת את UpgradeInfoEvent שבה סוג האירוע הוא UPGRADE_LIFECYCLE:

    resource.type="RESOURCE_TYPE"
log_id("container.googleapis.com/notifications")
jsonPayload.@type="type.googleapis.com/google.container.v1beta1.UpgradeInfoEvent"
jsonPayload.eventType="UPGRADE_LIFECYCLE"

    מידע נוסף על סינון UpgradeInfoEvent זמין במאמר סינון התראות של אשכול UpgradeInfoEvent.

  3. בתפריט פעולות, לוחצים על יצירת התראה על יומן.

  4. בדף פרטי ההתראה, נותנים שם למדיניות ההתראה ולוחצים על הבא.

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

  5. בקטע Extract log labels (חילוץ תוויות מיומנים), לוחצים על Add a label (הוספת תווית). חילוץ תוויות של יומנים עוזר להפוך את ההתראות לאינפורמטיביות יותר. לדוגמה, כדי לכלול את הגרסה הנוכחית ואת גרסת היעד של שדרוג של UpgradeEvent, אפשר להוסיף את התוויות הבאות:

    • ‫CurrentVersion: jsonPayload.currentVersion
    • TargetVersion: ‏ jsonPayload.targetVersion

  6. לוחצים על הבא.

  7. מגדירים את תדירות ההתראות ואת משך הזמן לסגירה אוטומטית, ולוחצים על Next.

  8. בקטע למי לשלוח התראות?, בוחרים את ערוצי ההתראות שבהם רוצים לקבל את ההתראות ולוחצים על שמירה.

אחרי שמגדירים את ההתראה, ההתראות של UpgradeEvent כוללות את התוויות CurrentVersion ו-TargetVersion, שמספקות הקשר חשוב ישירות בהתראה.

צריכת הודעות Pub/Sub

הודעות Pub/Sub מכילות שני שדות: data (מחרוזת) ו-attributes (מפה של מחרוזת למחרוזת).

בהתראות של GKE, השדה data מכיל מידע שקריא לבני אדם. השדה attributes מכיל מידע כללי על ההתראה, כמו סוג ההתראה, מזהה הפרויקט, שם האשכול ומיקום האשכול. השדה attributes.payload הוא מחרוזת שניתנת לניתוח באמצעות JSON, שמכילה מידע ספציפי על ההתראה, כמו הפרטים של עדכון אבטחה דחוף.

ההתראות תמיד כוללות את המאפיינים הבאים:

מאפיין תיאור דוגמה
project_id מספר הפרויקט שהאשכול בבעלותו. 123456789
cluster_location המיקום של האשכול. us-central1-c
cluster_name שם האשכול. example-cluster
type_url סוג ההתראה. type.googleapis.com/google.container.v1beta1.UpgradeEvent
payload מחרוזת שאפשר לנתח באמצעות JSON, שמכילה מידע ספציפי להתראה. 
{ "resourceType":"MASTER",
  "operation":"operation-1595889094437-87b7254a",
  "operationStartTime":"2020-07-27T22:31:34.437652293Z",
  "currentVersion":"1.15.12-gke.2",
  "targetVersion":"1.15.12-gke.9"}

‫GKE תמיד ישלח את סוגי ההתראות של beta. עם זאת, אפשר לנתח את המטען הייעודי (payload) כדי להציג את סוג ההתראה המתאים ב-GA, אם הוא זמין.

הודעות לדוגמה על אשכולים

בנוסף לטקסט בשדה data, לכל הודעה ש-GKE שולח ל-Cloud Logging או ל-Pub/Sub יש ערכים ספציפיים בשדות attributes.type_url ו-attributes.payload. בטבלאות הבאות מופיעות דוגמאות למידע שאפשר לקבל לגבי כל סוג התראה:

SecurityBulletinEvent

הפלט אמור להיראות כך להודעת SecurityBulletinEvent:

מאפיינים
type_url type.googleapis.com/google.container.v1beta1.SecurityBulletinEvent
payload 
{    "resourceTypeAffected":"RESOURCE_TYPE_CONTROLPLANE",
         "bulletinId":"GCP-2021-001",
         "cveIds":[
            "CVE-2021-3156"
         ],
         "severity":"Medium",
         "briefDescription":"A vulnerability was recently discovered in the Linux utility sudo, described in CVE-2021-3156, that may allow an attacker with unprivileged local shell access on a system with sudo installed to escalate their privileges to root on the system.",
         "affectedSupportedMinors":["1.18", "1.19"],
         "patchedVersions":["1.18.9-gke.1900", "1.19.9-gke.1900"],
         "suggestedUpgradeTarget":"1.19.9-gke.1900",
         "bulletinUri":"https://docs.cloud.google.com/kubernetes-engine/security-bulletins#gcp-2021-001"
      }

UpgradeAvailableEvent

הפלט אמור להיראות כך להודעת UpgradeAvailableEvent:

מאפיינים
type_url type.googleapis.com/google.container.v1beta1.UpgradeAvailableEvent
payload 
{ "version":"1.17.15-gke.800",
  "resourceType":"MASTER",
  "releaseChannel":{"channel":"RAPID"},
  "windowsVersions": [
    {
      "imageType": "WINDOWS_SAC",
      "osVersion": "10.0.18363.1198",
      "supportEndDate": {
        "day": 10,
        "month": 5,
        "year": 2022
      }
    },
    {
      "imageType": "WINDOWS_LTSC",
      "osVersion": "10.0.17763.1577",
      "supportEndDate": {
        "day": 9,
        "month": 1,
        "year": 2024
      }
    }
  ]
}

UpgradeEvent

הפלט של הודעה UpgradeEvent אמור להיראות כך:

מאפיינים
type_url type.googleapis.com/google.container.v1beta1.UpgradeEvent
payload 
{ "resourceType":"MASTER",
  "operation":"operation-1595889094437-87b7254a",
  "operationStartTime":"2020-07-27T22:31:34.437652293Z",
  "currentVersion":"1.15.12-gke.2",
  "targetVersion":"1.15.12-gke.9"}

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

UpgradeInfoEvent

הפלט אמור להיראות כך עבור הודעה של UpgradeInfoEvent כשפעולת שדרוג מסתיימת, כמו בדוגמה הזו לשדרוג של מאגר צמתים:

מאפיינים
type_url type.googleapis.com/google.container.v1beta1.UpgradeInfoEvent
payload 
{ "currentVersion":"1.31.1-gke.1846000",
  "endTime":"2024-11-06T17:12:54.111640650Z",
  "operation":"operation-1730912205658-de2f88a8-6290-4718-b2c1-fb19611060b8",
  "resource":"projects/PROJECT_ID/locations/CLUSTER_LOCATION/clusters/CLUSTER_NAME/nodePools/NODE_POOL_NAME",
  "resourceType":"NODE_POOL"
  "startTime":"2024-11-06T16:56:45.658321844Z",
  "state":"SUCCEEDED",
  "targetVersion":"1.31.1-gke.2105000"}

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

התראה על שדרוג מתוזמן של אשכול

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

מאפיינים
type_url type.googleapis.com/google.container.v1beta1.UpgradeInfoEvent
payload 
{
  "insertId": "[...]",
  "jsonPayload": {
    "description": "Your cluster control plane will be upgraded to 1.32.9-gke.1239000 after 2025-12-13 12:46 UTC",
    "startTime": "2025-12-13T12:46:37.380970854Z",
    "targetVersion": "1.32.9-gke.1239000",
    "@type": "type.googleapis.com/google.container.v1beta1.UpgradeInfoEvent",
    "currentVersion": "1.31.14-gke.1081000",
    "eventType": "UPGRADE_LIFECYCLE",
    "state": "SCHEDULED",
    "resourceType": "MASTER"
  },
  "resource": {
    "type": "gke_cluster",
    "labels": {
      "cluster_name": "CLUSTER_NAME",
      "location": "LOCATION",
      "project_id": "PROJECT_ID"
    }
  },
  "timestamp": "2025-12-10T12:46:37.989407414Z",
  "severity": "NOTICE",
  "logName": "projects/PROJECT_ID/logs/container.googleapis.com%2Fnotifications",
  "receiveTimestamp": "2025-12-10T12:46:38.007312354Z"
}

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

מאפיינים
type_url type.googleapis.com/google.container.v1beta1.UpgradeInfoEvent
payload 
{
  "insertId": "[...]",
  "jsonPayload": {
    "description": "Your cluster node pools will be upgraded to 1.32.9-gke.1239000 (or latest target patch) after 2025-12-13 12:46 UTC: NODE_POOL_1, NODE_POOL_2, [...] and 23 more.",
    "startTime": "2025-12-13T12:46:37.380970854Z",
    "targetVersion": "1.32.9-gke.1239000",
    "@type": "type.googleapis.com/google.container.v1beta1.UpgradeInfoEvent",
    "currentVersion": "1.31.14-gke.1081000",
    "eventType": "UPGRADE_LIFECYCLE",
    "state": "SCHEDULED",
    "resource": "projects/PROJECT_ID/locations/LOCATION/clusters/CLUSTER_NAME/nodePools/NODE_POOL_1",
    "resourceType": "NODE_POOL"
  },
  "resource": {
    "type": "gke_nodepool",
    "labels": {
      "cluster_name": "CLUSTER_NAME",
      "location": "LOCATION",
      "nodepool_name": "NODE_POOL_NAME",
      "project_id": "PROJECT_ID"
    }
  },
  "timestamp": "2025-12-10T12:46:37.989407414Z",
  "severity": "NOTICE",
  "logName": "projects/PROJECT_ID/logs/container.googleapis.com%2Fnotifications",
  "receiveTimestamp": "2025-12-10T12:46:38.007312354Z"
}

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

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