שדרוג Kf

במאמר הזה מוסבר איך לשדרג התקנה קיימת של Kf ואת התלות שלה.

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

  • מוודאים שאפשר לשדרג את גרסת Kf הנוכחית לגרסה Kf v2.5.4.
  • שדרוג ל-Kf גרסה 2.5.4.
  • משדרגים את התלויות (אם צריך).

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

תצטרכו:

  • קלאסטר קיים עם Kf מותקן.
  • גישה למחשב שמותקנים בו gcloud, ‏kf ו-kubectl.

הכנות לשדרוג

התחברות לאשכול היעד

gcloud container clusters get-credentials CLUSTER_NAME \
 --zone CLUSTER_ZONE \
 --project CLUSTER_PROJECT_ID

איך מוודאים שגרסת ה-CLI וגרסת השרת של Kf זהות

מריצים את הפקודה kf debug ומוודאים שהגרסאות של Kf CLI ושל שרת Kf זהות.

  • גרסת ה-CLI מופיעה בקטע Kf Client.
  • גרסת השרת של Kf מופיעה בקטע kf["app.kubernetes.io/version"].
$ kf debug
...
Version:
  Kf Client:                        v2.4.1
  Server version:                   v1.20.6-gke.1000
  kf["app.kubernetes.io/version"]:  v2.4.1
...

אם הערכים של לקוח Kf ושרת Kf לא זהים, אבל גרסת השרת היא v2.4.x, צריך להתקין את Kf v2.5.4 CLI לפני שממשיכים.

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

אישור תקינות של Kf לפני שדרוג

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

$ kf doctor
...
=== RUN doctor/user
=== RUN doctor/user/ContainerRegistry
--- PASS: doctor/user
   --- PASS: doctor/user/ContainerRegistry
...

אם מופיעות הודעות FAIL או Error: environment failed checks, פועלים לפי ההנחיות בפלט kf doctor או מעיינים במדריך לפתרון בעיות כדי לפתור את הבעיה ומנסים שוב להריץ את הפקודה עד שהיא מצליחה.

שדרוג האופרטור

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

  1. החלת קובץ ה-YAML של האופרטור:

    kubectl apply -f "https://storage.googleapis.com/kf-releases/v2.5.4/operator.yaml"

שדרוג יחסי התלות של Kf

  1. שדרוג Tekton:

  2. שדרוג לגרסה העדכנית של Cloud Service Mesh:

    1. פועלים לפי השלבים שבמדריך לשדרוג Cloud Service Mesh.

  3. שדרוג Config Connector.

שדרוג ל-Kf v2.5.4 CLI

  1. מתקינים את ה-CLI:

    Linux

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

    gcloud storage cp gs://kf-releases/v2.5.4/kf-linux /tmp/kf
chmod a+x /tmp/kf
sudo mv /tmp/kf /usr/local/bin/kf

    Mac

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

    gcloud storage cp gs://kf-releases/v2.5.4/kf-darwin /tmp/kf
chmod a+x /tmp/kf
sudo mv /tmp/kf /usr/local/bin/kf

    Cloud Shell

    הפקודה הזו מתקינה את kf במכונת Cloud Shell אם משתמשים ב-bash. יכול להיות שיהיה צורך לשנות את ההוראות עבור מעטפות אחרות.

    mkdir -p ~/bin
gcloud storage cp gs://kf-releases/v2.5.4/kf-linux ~/bin/kf
chmod a+x ~/bin/kf
echo "export PATH=$HOME/bin:$PATH" >> ~/.bashrc
source ~/.bashrc

    Windows

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

    gcloud storage cp gs://kf-releases/v2.5.4/kf-windows.exe kf.exe

  2. מוודאים שהגרסאות של Kf CLI ושל שרת Kf זהות:

    • גרסת ה-CLI מופיעה בקטע Kf Client.
    • גרסת השרת של Kf מופיעה בקטע kf["app.kubernetes.io/version"].
    $ kf debug
...
Version:
  Kf Client:                        v2.5.4
  Server version:                   v1.20.6-gke.1000
  kf["app.kubernetes.io/version"]:  v2.5.4
...

אימות השדרוג של Kf

  1. מריצים את הפקודה doctor כדי לוודא שהגרסה החדשה שהותקנה תקינה:

    kf doctor --retries=20

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

    אם הפקודה נכשלת עם ההודעה Error: environment failed checks, צריך לפעול לפי ההנחיות בפלט doctor כדי לפתור את הבעיה ולנסות שוב להריץ את הפקודה עד שהיא תצליח.

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