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

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

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

כדי לשדרג את הגרסה באופן ידני:

כדי לשדרג אשכול, GKE מעדכן את הגרסה שפועלת במישור הבקרה ובצמתים, בפעולות נפרדות. האשכולות משודרגים לגרסה משנית חדשה יותר (לדוגמה, מ-1.33 ל-1.34) או לגרסת תיקון חדשה יותר (לדוגמה, מ-‎1.33.4-gke.1350000 ל-‎1.33.5-gke.1080000). מישור הבקרה והצמתים של האשכול לא בהכרח מריצים את אותה גרסה כל הזמן. למידע נוסף על גרסאות, קראו את המאמר ניהול גרסאות ותמיכה ב-GKE.

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

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

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

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

לפני שמתחילים, חשוב לוודא שביצעתם את המשימות הבאות:

  • מפעילים את Google Kubernetes Engine API.
  • הפעלת Google Kubernetes Engine API
  • כדי להשתמש ב-Google Cloud CLI למשימה הזו, מתקינים ואז מאתחלים את ה-CLI של gcloud. אם כבר התקנתם את ה-CLI של gcloud, הריצו את הפקודה gcloud components update כדי לקבל את הגרסה העדכנית. יכול להיות שגרסאות קודמות של ה-CLI של gcloud לא תומכות בהרצת הפקודות שבמסמך הזה.
  • מוודאים שיש לכם אשכול קיים במצב Autopilot או במצב Standard. כדי ליצור אשכול חדש, קראו את המאמר יצירת אשכול Autopilot.

מידע על השדרוג

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

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

מגבלות

אי אפשר לשדרג אשכולות אלפא.

גרסאות נתמכות

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

gcloud container get-server-config \
    --location=CONTROL_PLANE_LOCATION

מחליפים את CONTROL_PLANE_LOCATION במיקום (אזור או תחום) של מישור הבקרה, למשל us-central1 או us-central1-a.

אם האשכול רשום לערוץ הפצה, אתם יכולים לשדרג לגרסת תיקון בערוץ הפצה אחר עם אותה גרסה משנית כמו של מישור הבקרה. לדוגמה, אתם יכולים לשדרג את האשכול מגרסה 1.33.4-gke.1350000 בערוץ הרגיל לגרסה 1.33.5-gke.1162000 בערוץ המהיר. מידע נוסף זמין במאמר הפעלת גרסאות תיקון מערוץ חדש יותר. כל אשכולות Autopilot רשומים לערוצי הפצה.

מידע על שדרוג לאחור

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

אי אפשר לשדרג לאחור אשכול, חוץ מהתרחישים שמתוארים בנקודות הקודמות. אי אפשר לשדרג לאחור מישור בקרה של אשכול לגרסה משנית קודמת, גם אחרי שדרוג מינורי של מישור הבקרה בשלב אחד. לדוגמה, אם במישור הבקרה פועלת גרסה 1.34 של GKE, אי אפשר לשדרג לאחור לגרסה 1.33. אם תנסו לעשות זאת, תופיע הודעת השגיאה הבאה:

ERROR: (gcloud.container.clusters.upgrade) ResponseError: code=400,
message=Master cannot be upgraded to "1.33.4-gke.1350000": specified version is
not newer than the current version.

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

שדרוג מישור הבקרה של האשכול

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

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

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

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

שדרוג ידני של מישור הבקרה בשלב אחד

אתם יכולים לשדרג ידנית את מישור הבקרה של Autopilot או Standard באמצעות מסוף Google Cloud או Google Cloud CLI.

המסוף

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

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

    כניסה ל-Google Kubernetes Engine

  2. לוחצים על שם האשכול.

  3. בקטע Cluster basics, לוחצים על Upgrade Available ליד Version.

  4. בוחרים את הגרסה החדשה ולוחצים על שמירת השינויים.

gcloud

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

gcloud container get-server-config \
    --location=CONTROL_PLANE_LOCATION

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

gcloud container clusters upgrade CLUSTER_NAME \
    --master \
    --location=CONTROL_PLANE_LOCATION

כדי לשדרג לגרסה ספציפית שהיא לא ברירת המחדל, מציינים את הדגל --cluster-version כמו בפקודה הבאה:

gcloud container clusters upgrade CLUSTER_NAME \
    --master \
    --location=CONTROL_PLANE_LOCATION \
    --cluster-version=VERSION

מחליפים את VERSION בגרסה שאליה רוצים לשדרג את האשכול. אפשר להשתמש בגרסה ספציפית, כמו 1.32.9-gke.1072000, או בכינוי של גרסה, כמו latest. מידע נוסף מופיע במאמר ציון גרסת האשכול.

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

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

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

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

שדרוגים בשני שלבים פועלים באופן הבא:

  1. שדרוג בינארי: GKE משדרג את הקובץ הבינארי של מישור הבקרה לגרסה המשנית החדשה, אבל מדמה את הגרסה המשנית הקודמת:

    • הדמיה של הגרסה הקודמת: האשכול מריץ את הקובץ הבינארי החדש, אבל ממשיך לדמות את ההתנהגות של ה-API של גרסת המשנה הקודמת. לדוגמה, אפשר להפעיל ממשקי API שהוסרו בגרסה המשנית החדשה, אבל עדיין זמינים בגרסה המשנית הקודמת.
    • בדיקת קובץ בינארי חדש: אתם יכולים לבדוק את הקבצים הבינאריים החדשים כדי לראות אם יש רגרסיות, תיקונים ושינויים בביצועים, לפני שאתם מאפשרים גישה לתכונות של Kubernetes שזמינות בגרסה המשנית החדשה. מעקב אחרי מדדי האפליקציה, היומנים, סטטוס ה-Pod, שיעורי השגיאות וזמן האחזור.
    • המתנה להטמעת השינויים: ממתינים בין 6 שעות ל-7 ימים (24 שעות לשדרוגים אוטומטיים) כדי לבדוק ולעקוב אחרי השינויים. אחרי פרק הזמן הזה, GKE מבצע את השדרוג לגרסה המדומה.
    • חזרה לגרסה קודמת או השלמת השדרוג: אפשר לחזור לגרסה קודמת, אם צריך. לחלופין, אם אתם בטוחים בגרסה המשנית החדשה, לא רוצים לחכות עד לסיום זמן הטבילה ומוכנים להתחיל להשתמש בתכונות החדשות ובשינויים ב-API, אתם יכולים לעבור לשלב הבא.
  2. שדרוג הגרסה המדומה: GKE מעדכן את הגרסה המדומה כך שתתאים לגרסה הבינארית החדשה.

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

במהלך הפעולה הזו, חלות המגבלות הבאות:

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

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

התחלת שדרוג בשני שלבים

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

gcloud beta container clusters upgrade CLUSTER_NAME \
  --location=CONTROL_PLANE_LOCATION \
  --cluster-version VERSION \
  --control-plane-soak-duration SOAK_DURATION \
  --master

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

  • ‫CLUSTER_NAME: שם האשכול.
  • ‫CONTROL_PLANE_LOCATION: המיקום (אזור או תחום) של מישור הבקרה, למשל us-central1 או us-central1-a.
  • ‫VERSION: תיקון ספציפי של גרסת המשנה הבאה. לדוגמה, אם באשכול פועלת גרסה 1.33, 1.34.1-gke.1829001.
  • ‫SOAK_DURATION: משך הזמן שצריך להמתין בשלב הבטוח להחזרה למצב קודם. אפשר להגדיר את הערך הזה למינימום של 6 שעות ולמקסימום של 7 ימים באמצעות פורמטים של משך זמן מוחלט, כפי שמוסבר במאמר העזרה בנושא gcloud topic datetimes. לדוגמה, משתמשים ב-2d1h לזמן טבילה של יומיים ושעה.

בדיקת הקובץ הבינארי החדש במהלך שדרוג דו-שלבי

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

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

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

  • כדי לראות פרטים על השדרוג, פועלים לפי ההוראות לקבלת מידע על שדרוגים ברמת האשכול.
  • שימוש בהתראות על אשכולות. ‫GKE שולח התראה מסוג UpgradeEvent כשהשדרוג הבינארי מתחיל, והתראה מסוג UpgradeInfoEvent עם ההודעה Upgrade operation is complete כשהשדרוג הבינארי מסתיים ומתחיל זמן הטבילה.
  • כדי לראות פרטים על האשכול, כולל על השדרוג שמתבצע, מריצים את הפקודה gcloud container clusters describe.
  • לראות את היומנים הרלוונטיים ב-Cloud Logging.
חזרה לגרסה קודמת של שדרוג דו-שלבי אחרי שדרוג הגרסה הבינארית

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

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

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

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

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

    gcloud container clusters upgrade CLUSTER_NAME \
      --location=CONTROL_PLANE_LOCATION \
      --cluster-version VERSION
      --master
    

    הערך של VERSION חייב להיות גרסת התיקון המדויקת שבה השתמשתם קודם. שמרת את הגרסה הזו בשלב הקודם.

אחרי שמריצים את הפקודה הזו ומשדרגים לאחור לגרסה הקודמת, אפשר לבדוק למה עומס העבודה לא פעל כמו שצריך בקובץ הבינארי החדש. במקרה הצורך, אתם יכולים לפנות ל-Cloud Customer Care ולספק את היומנים הרלוונטיים, הודעות השגיאה ופרטים על כשל האימות שנתקלתם בו. איך מקבלים תמיכה?

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

השלמת השדרוג בשני שלבים

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

gcloud beta container clusters complete-control-plane-upgrade CLUSTER_NAME  \
  --location=CONTROL_PLANE_LOCATION

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

שדרוג לאחור של מישור הבקרה לגרסת תיקון קודמת

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

     gcloud container clusters upgrade CLUSTER_NAME \
         --master \
         --location=CONTROL_PLANE_LOCATION \
         --cluster-version=VERSION
    

השבתת השדרוגים האוטומטיים של האשכולות

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

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

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

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

gcloud container operations list --filter="TYPE:UPGRADE_MASTER AND TARGET:CLUSTER_NAME" \
    --location=CONTROL_PLANE_LOCATION

שדרוג מאגרי צמתים

כברירת מחדל, במאגרי צמתים רגילים מופעל שדרוג אוטומטי, ובכל מאגרי הצמתים שמנוהלים על ידי Autopilot באשכולות רגילים תמיד מופעל שדרוג אוטומטי. שדרוגים אוטומטיים של צמתים עוזרים לוודא שמישור הבקרה וגרסת הצומת של האשכול נשארים מסונכרנים ותואמים למדיניות ההטיה של גרסת Kubernetes, שעוזרת לוודא שמישורי הבקרה תואמים לצמתים עד שתי גרסאות משניות לפני מישור הבקרה. לדוגמה, מישורי בקרה של Kubernetes 1.34 תואמים לצומתי Kubernetes 1.32. כברירת מחדל, GKE משדרג באופן אוטומטי רק מאגר צמתים אחד בכל פעם. כדי לשדרג אוטומטית כמה מאגרי צמתים בו-זמנית, אפשר להגדיר שדרוגים בו-זמניים של מאגרי צמתים (גרסת טרום-השקה (Preview)).

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

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

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

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

איך פועלים שדרוגי צמתים

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

במהלך שדרוגים אוטומטיים או ידניים של צמתים, המערכת מכבדת את תקציבי ההפרעה לפודים (PDB) ואת תקופת החסד לסיום הפוד למשך שעה אחת לכל היותר. אם אחרי שעה אי אפשר לתזמן את הפודים שפועלים בצומת לצמתים חדשים, GKE מתחיל את השדרוג בכל מקרה. ההתנהגות הזו חלה גם אם מגדירים את ה-PDB כך שכל הרפליקות יהיו זמינות תמיד, על ידי הגדרת השדה maxUnavailable לערך 0 או 0%, או על ידי הגדרת השדה minAvailable לערך 100% או למספר הרפליקות. בכל התרחישים האלה, GKE מוחק את הפודים אחרי שעה כדי שאפשר יהיה למחוק את הצומת.

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

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

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

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

מכונות חדשות של צמתים מריצות את הגרסה החדשה של Kubernetes, וגם את:

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

שמירת הנתונים בדיסקי אחסון מתמידים (persistent disk) לפני השדרוג

לפני שמשדרגים מאגר של צמתים, צריך לוודא שכל הנתונים שרוצים לשמור מאוחסנים ב-Pod באמצעות אמצעי אחסון מתמידים, שמשתמשים בדיסקים לאחסון מתמיד. במהלך השדרוגים, דיסקי אחסון מתמידים (persistent disk) מנותקים ולא נמחקים, והנתונים שלהם מועברים בין Pods.

ההגבלות הבאות חלות על דיסקים לאחסון מתמיד:

  • הצמתים שבהם פועלים הפודים חייבים להיות מכונות וירטואליות של Compute Engine.
  • המכונות הווירטואליות האלה צריכות להיות באותו פרויקט ובאותו תחום (zone) ב-Compute Engine שבהם נמצא דיסק אחסון מתמיד (persistent disk).

במאמר הוספה או שינוי של הגודל של דיסקים קבועים אזוריים שבמסמכי התיעוד של Compute Engine מוסבר איך מוסיפים דיסק אחסון מתמיד (persistent disk) למכונה קיימת של צומת.

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

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

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

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

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

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

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

המסוף

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

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

    כניסה ל-Google Kubernetes Engine

  2. לוחצים על שם האשכול.

  3. בדף Cluster details, לוחצים על הכרטיסייה Nodes.

  4. בקטע Node Pools, לוחצים על השם של מאגר הצמתים שרוצים לשדרג.

  5. לוחצים על עריכה.

  6. לוחצים על Change בקטע Node version.

  7. בוחרים את הגרסה הנדרשת מהרשימה הנפתחת Node version ולוחצים על Change.

יכול להיות שיחלפו כמה דקות עד שגרסת הצומת תשתנה.

gcloud

המשתנים הבאים משמשים בפקודות שבקטע הזה:

  • ‫CLUSTER_NAME: שם האשכול של מאגר הצמתים שרוצים לשדרג.
  • ‫NODE_POOL_NAME: שם מאגר הצמתים שרוצים לשדרג.
  • ‫CONTROL_PLANE_LOCATION: המיקום (אזור או תחום) של מישור הבקרה, למשל us-central1 או us-central1-a.
  • ‫VERSION: גרסת Kubernetes שאליה משדרגים את הצמתים. לדוגמה, --cluster-version=1.34.1-gke.1293000 או cluster-version=latest.

שדרוג מאגר צמתים:

gcloud container clusters upgrade CLUSTER_NAME \
  --node-pool=NODE_POOL_NAME \
  --location=CONTROL_PLANE_LOCATION

כדי לציין גרסה אחרת של GKE בצמתים, משתמשים בדגל האופציונלי --cluster-version:

gcloud container clusters upgrade CLUSTER_NAME \
  --node-pool=NODE_POOL_NAME \
  --location=CONTROL_PLANE_LOCATION \
  --cluster-version VERSION

למידע נוסף על ציון גרסאות, ראו ניהול גרסאות.

מידע נוסף זמין במאמרי העזרה של gcloud container clusters upgrade.

שדרוג לאחור של מאגרי צמתים

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

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

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

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

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

שינוי הפרמטרים של שדרוג מתח

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

הגדרת שדרוגים בו-זמניים של מאגרי צמתים

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

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

אי אפשר להפעיל את התכונה הזו באשכול שרשום לרצף השקה עם שלבים בהתאמה אישית.

כדי להגדיר שדרוגים בו-זמניים של מאגרי צמתים, מריצים את אחת מהפקודות הבאות:

  • יוצרים אשכול חדש עם הגדרה של שדרוגים בו-זמניים של מאגרי צמתים:

    gcloud beta container clusters create CLUSTER_NAME \
        --project=PROJECT_NAME
        --location CONTROL_PLANE_LOCATION \
        --node-pool-upgrade-concurrency-config=max-count=MAX_COUNT
    
  • עדכון אשכול קיים כדי לשדרג בו-זמנית מאגרי צמתים:

    gcloud beta container clusters update CLUSTER_NAME \
        --project=PROJECT_NAME \
        --location=CONTROL_PLANE_LOCATION \
        --node-pool-upgrade-concurrency-config=max-count=MAX_COUNT
    

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

  • ‫CLUSTER_NAME: שם האשכול.
  • ‫PROJECT_NAME: שם הפרויקט.
  • ‫LOCATION: מיקום המחשוב של האשכול.
  • ‫MAX_COUNT: המספר המקסימלי של מאגרי צמתים שאפשר לשדרג בו-זמנית. הערך צריך להיות מספר שלם בין 1 ל-100. כדי לחזור להתנהגות הרציפה שמוגדרת כברירת מחדל, מגדירים את הערך הזה כ-1.

בדיקת סטטוס השדרוג של מאגר הצמתים

אפשר לבדוק את סטטוס השדרוג באמצעות gcloud container operations.

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

gcloud container operations list \
    --location=CONTROL_PLANE_LOCATION

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

NAME                              TYPE                ZONE           TARGET              STATUS_MESSAGE  STATUS  START_TIME                      END_TIME
operation-1505407677851-8039e369  CREATE_CLUSTER      us-west1-a     my-cluster                          DONE    20xx-xx-xxT16:47:57.851933021Z  20xx-xx-xxT16:50:52.898305883Z
operation-1505500805136-e7c64af4  UPGRADE_CLUSTER     us-west1-a     my-cluster                          DONE    20xx-xx-xxT18:40:05.136739989Z  20xx-xx-xxT18:41:09.321483832Z
operation-1505500913918-5802c989  DELETE_CLUSTER      us-west1-a     my-cluster                          DONE    20xx-xx-xxT18:41:53.918825764Z  20xx-xx-xxT18:43:48.639506814Z

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

gcloud container operations describe OPERATION_ID \
    --location=CONTROL_PLANE_LOCATION

לדוגמה:

gcloud container operations describe operation-1507325726639-981f0ed6
endTime: '20xx-xx-xxT21:40:05.324124385Z'
name: operation-1507325726639-981f0ed6
operationType: UPGRADE_CLUSTER
selfLink: https://container.googleapis.com/v1/projects/.../kubernetes-engine/docs/zones/us-central1-a/operations/operation-1507325726639-981f0ed6
startTime: '20xx-xx-xxT21:35:26.639453776Z'
status: DONE
targetLink: https://container.googleapis.com/v1/projects/.../kubernetes-engine/docs/zones/us-central1-a/clusters/...
zone: us-central1-a

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

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

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

מריצים את הפקודה הבאה:

gcloud container node-pools describe NODE_POOL_NAME \
    --cluster=CLUSTER_NAME \
    --location=CONTROL_PLANE_LOCATION

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

  • ‫NODE_POOL_NAME: שם מאגר הצמתים שרוצים לתאר.
  • ‫CLUSTER_NAME: שם האשכול של מאגר הצמתים שרוצים לתאר.
  • ‫CONTROL_PLANE_LOCATION: המיקום (אזור או תחום) של מישור הבקרה, למשל us-central1 או us-central1-a.

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

upgradeSettings:
  blueGreenSettings:
    nodePoolSoakDuration: 1800s
    standardRolloutPolicy:
      batchNodeCount: 1
      batchSoakDuration: 10s
  strategy: BLUE_GREEN

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

updateInfo:
  blueGreenInfo:
    blueInstanceGroupUrls:
    - https://www.googleapis.com/compute/v1/projects/{PROJECT_ID}/zones/{LOCATION}/instanceGroupManagers/{BLUE_INSTANCE_GROUP_NAME}
    bluePoolDeletionStartTime: {BLUE_POOL_DELETION_TIME}
    greenInstanceGroupUrls:
    - https://www.googleapis.com/compute/v1/projects/{PROJECT_ID}/zones/{LOCATION}/instanceGroupManagers/{GREEN_INSTANCE_GROUP_NAME} 
    greenPoolVersion: {GREEN_POOL_VERSION}
    phase: DRAINING_BLUE_POOL

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

אתם יכולים לבטל את השדרוג בכל שלב. במאמר ביטול שדרוג מתח מוסבר מה קורה כשמבטלים שדרוג מתח. במאמר ביטול שדרוג כחול-ירוק מוסבר מה קורה כשמבטלים שדרוג כחול-ירוק.

  1. מאתרים את מזהה הפעולה של השדרוג:

    gcloud container operations list \
          --location=CONTROL_PLANE_LOCATION
    
  2. ביטול השדרוג:

    gcloud container operations cancel OPERATION_ID \
          --location=CONTROL_PLANE_LOCATION
    

אפשר לקרוא מידע נוסף במאמרי העזרה של gcloud container operations cancel.

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

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

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

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

כדי להמשיך את השדרוג, משתמשים בפקודה הבאה:

gcloud container clusters upgrade CLUSTER_NAME \
  --node-pool=NODE_POOL_NAME \
  --location=CONTROL_PLANE_LOCATION \
  --cluster-version VERSION

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

  • ‫NODE_POOL_NAME: שם מאגר הצמתים שבו רוצים להמשיך את השדרוג.
  • ‫CLUSTER_NAME: שם האשכול של מאגר הצמתים שבו רוצים להמשיך את השדרוג.
  • ‫CONTROL_PLANE_LOCATION: המיקום (אזור או תחום) של מישור הבקרה, למשל us-central1 או us-central1-a.
  • ‫VERSION: גרסת היעד של השדרוג שבוטל במאגר הצמתים.

מידע נוסף זמין במאמרי העזרה של gcloud container clusters upgrade.

חזרה לגרסה קודמת של מאגר צמתים

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

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

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

כדי לחזור לגרסה הקודמת, מריצים את הפקודה הבאה:

gcloud container node-pools rollback NODE_POOL_NAME \
    --cluster CLUSTER_NAME \
    --location=CONTROL_PLANE_LOCATION

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

  • ‫NODE_POOL_NAME: שם מאגר הצמתים שרוצים להחזיר לגרסה קודמת.
  • ‫CLUSTER_NAME: שם האשכול של מאגר הצמתים שרוצים להחזיר לגרסה קודמת.
  • ‫CONTROL_PLANE_LOCATION: המיקום (אזור או תחום) של מישור הבקרה, למשל us-central1 או us-central1-a.

אפשר לקרוא מידע נוסף במאמרי העזרה של gcloud container node-pools rollback.

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

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

במאמר השלמת השדרוג של מאגר צמתים מוסבר איך משלימים את השדרוג של מאגר צמתים.

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

gcloud container node-pools complete-upgrade NODE_POOL_NAME \
    --cluster CLUSTER_NAME \
    --location=CONTROL_PLANE_LOCATION

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

  • ‫NODE_POOL_NAME: שם מאגר הצמתים שרוצים לשדרג.
  • ‫CLUSTER_NAME: שם האשכול של מאגר הצמתים שרוצים לשדרג.
  • ‫CONTROL_PLANE_LOCATION: המיקום (אזור או תחום) של מישור הבקרה, למשל us-central1 או us-central1-a.

אפשר לקרוא מידע נוסף במאמרי העזרה של gcloud container node-pools complete-upgrade.

שדרוג מאגר הצמתים הופסק

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

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

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

בעיות מוכרות

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

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

kubectl get poddisruptionbudget --all-namespaces -o jsonpath='{range .items[?(@.status.disruptionsAllowed==0)]}{.metadata.name}/{.metadata.namespace}{"\n"}{end}'

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

פתרון בעיות

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

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