שדרוג Kf ב-Google Cloud

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

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

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

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

תצטרכו:

  • קלאסטר קיים שבו מותקן 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.7.3
  Server version:                   v1.21.6-gke.1500
  kf["app.kubernetes.io/version"]:  v2.7.3
...

אם הערכים של Kf client ו-Kf server לא זהים, אבל גרסת השרת היא v2.7.x, צריך להתקין את Kf v2.9.0 CLI לפני שממשיכים.

אם ערך השרת של Kf הוא ישן יותר מ-v2.7.x, צריך קודם לבצע שדרוג מצטבר ל-Kf v2.7.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.9.0/operator.yaml"

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

  1. שדרוג Tekton:

    kubectl apply -f "https://storage.googleapis.com/tekton-releases/pipeline/previous/v0.32.1/release.yaml"

  2. שדרוג ל-Cloud Service Mesh גרסה 1.12:

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

  1. שדרוג או התקנה של Config Connector:

    כדי לשדרג מ-Kf גרסה 2.8: פועלים לפי השלבים בקטע 'התקנה של Config Connector' במאמר התקנה של Kf.

    לשדרוג מ-Kf גרסה 2.7:

    1. מורידים את קובץ ה-tar של Config Connector Operator שנדרש.

    2. מחלצים את קובץ ה-tar.

      tar zxvf release-bundle.tar.gz

    3. מתקינים את האופרטור של Config Connector באשכול.

      kubectl apply -f operator-system/configconnector-operator.yaml

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

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

    Linux

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

    gcloud storage cp gs://kf-releases/v2.9.0/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.9.0/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.9.0/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.9.0/kf-windows.exe kf.exe

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

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

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

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

    kf doctor --retries=20

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

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

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