שדרוג Apigee Hybrid לגרסה 1.9

ההליך הזה מתייחס לשדרוג מ-Apigee hybrid גרסה 1.8.x ל-Apigee hybrid גרסה 1.9.4, ומגרסאות קודמות של hybrid 1.9.x לגרסה 1.9.4.

אפשר להשתמש באותן פעולות לשדרוג גרסה משנית (לדוגמה, מגרסה 1.8 לגרסה 1.9) ולשדרוג גרסת תיקון (לדוגמה, מגרסה 1.9.0 לגרסה 1.9.4).

אם אתם משדרגים מ-Apigee Hybrid בגרסה 1.7 או בגרסה ישנה יותר, אתם צריכים לשדרג קודם לגרסה 1.8 לפני שאתם משדרגים לגרסה 1.9.4. אפשר לעיין בהוראות בנושא שדרוג Apigee Hybrid לגרסה 1.8.

החל מגרסה 1.9.0, ‏ Apigee Hybrid תומך רק ב-Apigee Ingress Gateway כשכבת הכניסה (ingress).

סקירה כללית של שדרוג לגרסה 1.9.4

ההליכים לשדרוג Apigee hybrid מאורגנים בקטעים הבאים:

  1. הכנות לשדרוג
  2. איך מתקינים את גרסת זמן הריצה ההיברידית 1.9.4

דרישות מוקדמות

  • ההנחיות לשדרוג מניחות שגרסה 1.8.x של Apigee Hybrid מותקנת אצלכם, ואתם רוצים לשדרג אותה לגרסה 1.9.4. אם אתם מעדכנים מגרסה קודמת, כדאי לעיין בהוראות לשדרוג Apigee Hybrid לגרסה 1.8.
  • בגרסה 1.8 של Apigee Hybrid, השקנו את Apigee ingress gateway כשכבת Ingress חלופית ל-Anthos Service Mesh. החל מגרסה 1.9.0, ב-Apigee hybrid צריך להשתמש בשער כניסה של Apigee, ואין יותר תמיכה בשימוש ב-Anthos Service Mesh לכניסה. אם ההתקנה שמשדרגים ממנה משתמשת ב-Anthos Service Mesh, צריך קודם לעבור לשימוש בשער כניסה של Apigee לפני שמשדרגים לגרסה 1.9.4.

    שער הכניסה של Apigee משתמש בקבוצת משנה קטנה של תכונות Anthos Service Mesh לשער הכניסה. הניהול והשדרוג של התכונות האלה מתבצעים באופן אוטומטי על ידי Apigee hybrid. לכן לא צריך מומחיות ב-Anthos Service Mesh כדי להתקין, לשדרג ולנהל את שער הכניסה של Apigee Hybrid.

    הוראות מפורטות מופיעות במאמר העברה אל שער כניסה של Apigee בתיעוד של Hybrid v1.8.

הכנה לשדרוג לגרסה 1.9

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

    Linux 

    export APIGEECTL_HOME=$PWD
echo $APIGEECTL_HOME

    Mac OS 

    export APIGEECTL_HOME=$PWD
echo $APIGEECTL_HOME

    Windows 

    set APIGEECTL_HOME=%CD%
echo %APIGEECTL_HOME%
  2. יוצרים עותק גיבוי של ספריית $APIGEECTL_HOME/ בגרסה 1.8. לדוגמה: 
    tar -czvf $APIGEECTL_HOME/../apigeectl-v1.8-backup.tar.gz $APIGEECTL_HOME
  3. מגבים את מסד הנתונים של Cassandra לפי ההוראות במאמר בנושא גיבוי ושחזור של Cassandra.

מוסיפים את התפקיד Cloud Trace Agent לחשבון השירות של זמן הריצה של Apigee. (אופציונלי)

אופציונלי: אם אתם מתכננים להשתמש ב-Cloud Trace ועדיין לא הוספתם את התפקיד Cloud Trace Agent להתקנה היברידית בגרסה 1.8, ודאו שלחשבון השירות שלכם בשירותי זמן הריצה של Apigee יש את תפקיד Google Cloud IAM‏ Cloud Trace Agent‏ (roles/cloudtrace.agent).

בסביבות ייצור, חשבון השירות בזמן הריצה הוא apigee-runtime. בסביבות שאינן סביבות ייצור, חשבון השירות בזמן הריצה הוא apigee-non-prod.

אפשר להוסיף את התפקיד בממשק המשתמש של מסוף Cloud > ‏IAM ואדמין > חשבונות שירות או באמצעות הפקודות הבאות:

  1. כדי לקבל את כתובת האימייל של חשבון השירות, מריצים את הפקודה הבאה:

    ייצור 

    gcloud iam service-accounts list --filter "apigee-runtime"

    אם כתובת האימייל תואמת לדפוס apigee-runtime@$ORG_NAME.iam.gserviceaccount.com, אפשר להשתמש בדפוס הזה בשלב הבא.

    Non-Prod 

    gcloud iam service-accounts list --filter "apigee-non-prod"

    אם הוא תואם לדפוס apigee-non-prod@$ORG_NAME.iam.gserviceaccount.com, אפשר להשתמש בדפוס הזה בשלב הבא.

  2. מקצים לחשבון השירות את התפקיד Cloud Trace Agent:

    ייצור 

    gcloud projects add-iam-policy-binding $PROJECT_ID \
    --member="serviceAccount:apigee-runtime@$PROJECT_ID.iam.gserviceaccount.com" \
    --role="roles/cloudtrace.agent"

    Non-Prod 

    gcloud projects add-iam-policy-binding $PROJECT_ID \
    --member="serviceAccount:apigee-non-prod@$PROJECT_ID.iam.gserviceaccount.com" \
    --role="roles/cloudtrace.agent"

    דוגמה 

    gcloud projects add-iam-policy-binding hybrid-example-project \
    --member="serviceAccount:apigee-runtime@hybrid-example-project.iam.gserviceaccount.com" \
    --role="roles/cloudtrace.agent"

    כאשר: $PROJECT_ID הוא השם של הפרויקט בענן של Google שבו מותקן Apigee Hybrid.

התקנה של שער כניסה (ingress) של Apigee אם ההתקנה משתמשת ב-Anthos Service Mesh

החל מגרסה 1.9, ‏ Apigee Hybrid לא תומך יותר בשימוש ב-Anthos Service Mesh לכניסה. אם ההתקנה שלכם ב-Hybrid משתמשת ב-Anthos Service Mesh, אתם צריכים להעביר את ההתקנה הנוכחית ל-Apigee Ingress Gateway לפני שתתקינו את גרסה 1.9 של Hybrid.

  1. מוסיפים את מאפיין ingressGateways לקובץ ההחלפות.

    תחביר

      ingressGateways:
  - name: INGRESS_NAME
    replicaCountMin: REPLICAS_MIN
    replicaCountMax: REPLICAS_MAX
    resources:
      requests:
        cpu: CPU_COUNT_REQ
        memory: MEMORY_REQ
      limits:
        cpu: CPU_COUNT_LIMIT
        memory: MEMORY_LIMIT
    svcAnnotations:  # optional.
      SVC_ANNOTATIONS_KEY: SVC_ANNOTATIONS_VALUE
    svcLoadBalancerIP: SVC_LOAD_BALANCER_IP # optional

    דוגמה

      ingressGateways:
  - name: prod1
    replicaCountMin: 2
    replicaCountMax: 100
    resources:
      requests:
        cpu: 1
        memory: 1Gi
      limits:
        cpu: 2
        memory: 2Gi
    svcAnnotations:  # optional. See Known issue 243599452.
      networking.gke.io/load-balancer-type: "Internal"
    svcLoadBalancerIP: 198.252.0.123
    • ‫INGRESS_NAME הוא שם הפריסה של ה-ingress. אפשר להשתמש בכל שם שעומד בדרישות הבאות:
      • האורך המקסימלי הוא 17 תווים
      • השם יכול להכיל רק תווים אלפאנומריים באותיות קטנות, '-' או '.'
      • מתחילים בתו אלפאנומרי
      • התו האחרון חייב להיות אלפאנומרי
      מידע נוסף על ingressGateways[].name זמין במאמר בנושא מאפייני הגדרות.
    • ‫REPLICAS_MIN ו-REPLICAS_MAX הם מספר העותקים המינימלי והמקסימלי של שער הכניסה של Apigee בהתקנה. למידע נוסף ולהגדרות ברירת המחדל, אפשר לעיין בingressGateways[].replicaCountMin ובingressGateways[].replicaCountMax בהפניה למאפייני ההגדרה.
    • ‫CPU_COUNT_REQ ו-MEMORY_REQ הם בקשות המעבד והזיכרון לכל עותק של שער הכניסה של Apigee בהתקנה.

      מידע נוסף והגדרות ברירת מחדל זמינים במאמרים ingressGateways[].resources.requests.cpu וingressGateways[].resources.requests.memory בהפניה למאפיין Configuration.

    • ‫CPU_COUNT_LIMIT ו-MEMORY_LIMIT הן המגבלות המקסימליות של CPU וזיכרון לכל רפליקה של שער הכניסה של Apigee בהתקנה.

      מידע נוסף והגדרות ברירת מחדל זמינים במאמרים ingressGateways[].resources.limits.cpu וingressGateways[].resources.limits.memory בהפניה למאפיין Configuration.

    • SVC_ANNOTATIONS_KEY SVC_ANNOTATIONS_VALUE (אופציונלי):

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

      ingressGateways:
    svcAnnotations:
      networking.gke.io/load-balancer-type: "Internal"

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

      מידע נוסף על ingressGateways[].svcAnnotations
    • ‫SVC_LOAD_BALANCER_IP (אופציונלי) מאפשר להקצות כתובת IP סטטית למאזן העומסים. בפלטפורמות שתומכות בהגדרת כתובת ה-IP של מאזן העומסים, מאזן העומסים ייווצר עם כתובת ה-IP הזו. בפלטפורמות שלא מאפשרות לציין את כתובת ה-IP של מאזן העומסים, המאפיין הזה מושבת.

      אם לא הקציתם כתובת IP סטטית למאזן העומסים, אל תכללו את המאפיין הזה בקובץ ההחלפות.

      מידע נוסף על ingressGateways[].svcLoadBalancerIP
  2. מחילים את השינויים כדי להתקין את שער הכניסה של Apigee באמצעות הפקודות הבאות: 
    $APIGEECTL_HOME/apigeectl apply -f overrides/overrides.yaml
  3. חשיפת שער הכניסה של Apigee. פועלים לפי השלבים שמפורטים במאמר בנושא חשיפת שער כניסה של Apigee.
  4. כדי לבדוק את שער הכניסה החדש, צריך להתקשר לפרוקסי. מומלץ לבדוק את כל הפרוקסיים החשובים שפרסתם כרגע.
  5. כדי להעביר את התנועה, צריך לעדכן את רשומות ה-DNS כך שיפנו לכתובת ה-IP של שער הכניסה החדש של Apigee. בהתאם לספק ה-DNS שלכם, יכול להיות שתוכלו להעביר את התעבורה בהדרגה לנקודת הקצה החדשה. טיפ: אפשר למצוא את כתובת ה-IP החיצונית של שער הכניסה של Apigee באמצעות הפקודה הבאה: 
    kubectl get svc -n apigee -l app=apigee-ingressgateway

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

    NAME                                        TYPE           CLUSTER-IP    EXTERNAL-IP     PORT(S)                                      AGE
apigee-ingressgateway-prod-hybrid-37a39bd   LoadBalancer   192.0.2.123   233.252.0.123   15021:32049/TCP,80:31624/TCP,443:30723/TCP   16h
  6. כדי לוודא שכל התנועה בזמן הריצה פועלת, צריך לעקוב אחרי לוחות הבקרה. רק אם הכול פועל כצפוי, ממשיכים לשלב הבא. חשוב לוודא שלא עוברת תנועה דרך שער הכניסה הישן (Anthos Service Mesh), כי יכול להיות שעדכון ה-DNS יתבצע לאט בגלל שמירת ה-DNS במטמון.
  7. כדי להפסיק את אספקת ההגדרות מ-Apigee ל-Anthos Service Mesh, פועלים לפי השלבים במאמר הפסקת אספקת ההגדרות ל-ASM במדריך בנושא ניהול שער הכניסה של Apigee.
  8. בודקים מחדש את תעבורת הנתונים של proxy ל-API ועוקבים אחריה.
  9. פועלים לפי ההוראות שבתיעוד של Anthos Service Mesh כדי להסיר את Anthos Service Mesh מהאשכול.

התקנה של זמן הריצה של hybrid 1.9.4

  1. חשוב לוודא שאתם נמצאים בספריית הבסיס של ההיברידי (הספרייה הראשית שבה נמצא קובץ ההפעלה apigeectl): 
    cd $APIGEECTL_HOME/..

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

    Linux

    ‫Linux 64 bit:

    curl -LO \
  https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/1.9.4/apigeectl_linux_64.tar.gz

    Mac OS

    ‫Mac 64 bit:

    curl -LO \
  https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/1.9.4/apigeectl_mac_64.tar.gz

    Windows

    Windows 64 bit:

    curl -LO ^
  https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/1.9.4/apigeectl_windows_64.zip
  3. משנים את השם של ספריית apigeectl/ הנוכחית לשם של ספריית גיבוי. לדוגמה:

    Linux 

    mv $APIGEECTL_HOME/ $APIGEECTL_HOME-v1.8/

    Mac OS 

    mv $APIGEECTL_HOME/ $APIGEECTL_HOME-v1.8/

    Windows 

    rename %APIGEECTL_HOME% %APIGEECTL_HOME%-v1.8

  4. מחלצים את תוכן קובץ ה-gzip שהורד לספריית הבסיס ההיברידית. ספריית הבסיס ההיברידית היא הספרייה שבה נמצאת הספרייה apigeectl-v1.8 ששמה שונה:

    Linux 

    tar xvzf filename.tar.gz -C ./

    Mac OS 

    tar xvzf filename.tar.gz -C ./

    Windows 

    tar xvzf filename.zip -C ./

  5. כברירת מחדל, התוכן של קובץ ה-tar מורחב לספרייה עם הגרסה והפלטפורמה בשם שלה. לדוגמה: ./apigeectl_1.9.4-xxxxxxx_linux_64. משנים את שם הספרייה ל-apigeectl באמצעות הפקודה הבאה:

    Linux 

    mv apigeectl_1.9.4-xxxxxxx_linux_64 apigeectl

    Mac OS 

    mv apigeectl_1.9.4-xxxxxxx_mac_64 apigeectl

    Windows 

    rename apigeectl_1.9.4-xxxxxxx_windows_64 apigeectl
  6. עוברים לספרייה apigeectl: 
    cd ./apigeectl

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

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

    Linux 

    export APIGEECTL_HOME=$PWD
     
    echo $APIGEECTL_HOME

    Mac OS 

    export APIGEECTL_HOME=$PWD
     
    echo $APIGEECTL_HOME

    Windows 

    set APIGEECTL_HOME=%CD%
     
    echo %APIGEECTL_HOME%
  8. כדי לוודא את הגרסה של apigeectl, מריצים את הפקודה version: 
    ./apigeectl version
     
    Version: 1.9.4
  9. עוברים לספרייה hybrid-base-directory/hybrid-files. בספרייה hybrid-files נמצאים קובצי תצורה כמו קובץ ההחלפות, האישורים וחשבונות השירות. לדוגמה: 
    cd $APIGEECTL_HOME/../hybrid-files
  10. מריצים את הפקודה הבאה כדי לוודא שההקשר הנכון מוגדר ל-kubectl. ההקשר הנוכחי צריך להיות מוגדר לאשכול שבו משדרגים את Apigee hybrid. 
    kubectl config get-contexts | grep \*
  11. בספרייה hybrid-files:
    1. מעדכנים את הקישורים הסמליים הבאים לכתובת $APIGEECTL_HOME. הקישורים האלה מאפשרים להריץ את הפקודה apigeectl שהותקנה לאחרונה מתוך הספרייה hybrid-files: 
      ln -nfs $APIGEECTL_HOME/tools tools
ln -nfs $APIGEECTL_HOME/config config
ln -nfs $APIGEECTL_HOME/templates templates
ln -nfs $APIGEECTL_HOME/plugins plugins
    2. כדי לוודא שהקישורים הסמליים נוצרו בצורה נכונה, מריצים את הפקודה הבאה ומוודאים שנתיבי הקישורים מצביעים על המיקומים הנכונים: 
      ls -l | grep ^l
  12. מבצעים הפעלה ללא שינוי כדי לבדוק אם יש שגיאות: 
    ${APIGEECTL_HOME}/apigeectl init -f OVERRIDES_FILE --dry-run=client

    כאשר OVERRIDES_FILE הוא שם קובץ ההגדרות שלכם, למשל ./overrides/overrides.yaml.

  13. אם אין שגיאות, מפעילים את hybrid 1.9.4: 
    $APIGEECTL_HOME/apigeectl init -f OVERRIDES_FILE
  14. בודקים את סטטוס ההפעלה: 
    $APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE

    אם הפעולה בוצעה ללא שגיאות, הפלט ייראה כך: All containers ready. 

    kubectl describe apigeeds -n apigee

    בפלט, מחפשים את State: running.

  15. כדי לבדוק אם יש שגיאות, מריצים הרצה יבשה של הפקודה apply באמצעות הדגל --dry-run: 
    $APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE --dry-run=client
  16. אם אין שגיאות, מחילים את שינויי ברירת המחדל. בוחרים את ההוראות לסביבות ייצור או לסביבות שאינן סביבות ייצור, בהתאם להתקנה.

    ייצור

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

    1. חשוב לוודא שאתם נמצאים בספרייה hybrid-files.
    2. מחילים את ההחלפות כדי לשדרג את Cassandra: 
      $APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE --datastore
    3. השלמת הבדיקה: 
      $APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE

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

    4. מחילים את ההחלפות כדי לשדרג את רכיבי הטלמטריה ובודקים שהשדרוג הושלם: 
      $APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE --telemetry
       
      $APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE
    5. מפעילים את רכיבי Redis: 
      $APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE --redis
    6. מחילים את השינויים כדי לשדרג את הרכיבים ברמת הארגון (MART, ‏ Watcher ו-Apigee Connect) ובודקים שהשדרוג הושלם: 
      $APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE --org
       
      $APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE
    7. מחילים את השינויים כדי לשדרג את הסביבות. יש שתי אפשרויות:
      • סביבה אחרי סביבה: מחילים את השינויים על סביבה אחת בכל פעם ובודקים שהפעולה הושלמה. חוזרים על השלב הזה לכל סביבה: 
        $APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE --env ENV_NAME
         
        $APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE

        כאשר ENV_NAME הוא שם הסביבה שמשדרגים.

      • כל הסביבות בבת אחת: אפשר להחיל את השינויים על כל הסביבות בבת אחת ולבדוק שהפעולה הושלמה: 
        $APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE --all-envs
         
        $APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE
    8. מחילים את ההחלפות כדי לשדרג את הרכיבים של virtualhosts ובודקים שהשדרוג הושלם: 
      $APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE --settings virtualhosts
       
      $APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE

    Non-prod

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

    1. חשוב לוודא שאתם נמצאים בספרייה hybrid-files.
    2. $APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE
    3. בודקים את הסטטוס: 
      $APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE

התקנת 1.9.4-hotfix.1

כדי להתקין את גרסת התיקון המהיר, 1.9.4-hotfix.1, פועלים לפי השלבים הבאים:

  1. לפני שמבצעים את השלבים האלה, צריך לוודא שמשתמשים ב-Apigee hybrid בגרסה 1.9.4 או בגרסה מאוחרת יותר. אם אתם לא משתמשים בגרסה 1.9.4 או בגרסה מאוחרת יותר, אתם צריכים לשדרג לגרסה 1.9.4 לפני שתמשיכו.
  2. פותחים את קובץ ה-overrides.yaml.
  3. בפסקה istiod, משנים את הגרסה של תג התמונה (אם הוא קיים) לגרסה 1.17.7. לדוגמה: 
    istiod:
  image:
    url: "gcr.io/apigee-release/hybrid/apigee-asm-istiod"
    tag: "1.17.7-asm.0-distroless"
  4. בהתאם לאופן שבו בחרתם להתקין את Apigee hybrid, יכול להיות שיש לכם קטע ingressGateway או ingressGateways. מאתרים את הקטע שמופיע בקובץ ההחלפות ומשנים את הגרסה של תג התמונה (אם יש כזה) לגרסה 1.17.7. לדוגמה, אם יש לכם קטע ingressGateway: 
    ingressGateway:
  image:
    url: "gcr.io/apigee-release/hybrid/apigee-asm-ingress"
    tag: "1.17.7-asm.0-distroless"

    או, אם יש לכם קטע ingressGateways:

    ingressGateways:
  - name: gateway1
    image:
      url: "gcr.io/apigee-release/hybrid/apigee-asm-ingress"
      tag: "1.17.7-asm.0-distroless"
    ...
  - name: gateway2
    image:
      url: "gcr.io/apigee-release/hybrid/apigee-asm-ingress"
      tag: "1.17.7-asm.0-distroless"
    ...
  5. שומרים את הקובץ.
  6. מריצים את הפקודה הבאה כדי לאתחל את הרכיב istiod: 
    $APIGEECTL_HOME/apigeectl init -f OVERRIDES_FILE
     
    $APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE
  7. מריצים את הפקודה הבאה כדי להחיל שינויים על רכיבי ה-ingress של Apigee. אם יש לכם יותר מארגון אחד, צריך לחזור על הפקודה הזו לכל אחד מהם: 
    $APIGEECTL_HOME/apigeectl apply --org -f OVERRIDES_FILE
     
    $APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE
  8. מאמתים את הסטטוס של הפודים: 
    kubectl get pods -n YOUR_APIGEE_NAMESPACE

שדרוג גרסת Kubernetes

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

החזרה למצב הקודם של שדרוג

כדי לחזור לשדרוג קודם:

  1. מנקים את המשימות שהושלמו במרחב השמות של זמן הריצה ההיברידי, כאשר NAMESPACE הוא מרחב השמות שצוין בקובץ ההחלפות, אם צוין מרחב שמות. אם לא, מרחב השמות שמוגדר כברירת מחדל הוא apigee: 
    kubectl delete job -n NAMESPACE \
  $(kubectl get job -n NAMESPACE \
  -o=jsonpath='{.items[?(@.status.succeeded==1)].metadata.name}')
  2. ניקוי משימות שהושלמו במרחב השמות apigee-system: 
    kubectl delete job -n apigee-system \
  $(kubectl get job -n apigee-system \
  -o=jsonpath='{.items[?(@.status.succeeded==1)].metadata.name}')
  3. משנים את המשתנה APIGEECTL_HOME כך שיצביע על הספרייה שמכילה את הגרסה הקודמת של apigeectl. לדוגמה: 
    export APIGEECTL_HOME=PATH_TO_PREVIOUS_APIGEECTL_DIRECTORY
  4. בתיקיית הבסיס של ההתקנה שרוצים לחזור אליה, מריצים את הפקודה apigeectl apply, בודקים את הסטטוס של ה-pods ואז מריצים את הפקודה apigeectl init. חשוב להשתמש בקובץ ההחלפות המקורי של הגרסה שרוצים לחזור אליה:
    1. בספרייה hybrid-files, מריצים את apigeectl apply: 
      $APIGEECTL_HOME/apigeectl apply -f ORIGINAL_OVERRIDES_FILE

      ‫ORIGINAL_OVERRIDES_FILE הוא הנתיב היחסי ושם הקובץ של קובץ ההחלפות להתקנה ההיברידית של הגרסה הקודמת, לדוגמה, ./overrides/overrides1.8.yaml.

    2. בודקים את הסטטוס של ה-Pods: 
      kubectl -n NAMESPACE get pods

      כאשר NAMESPACE הוא מרחב השמות של Apigee Hybrid.

    3. בודקים את הסטטוס של apigeeds: 
      kubectl describe apigeeds -n apigee

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

      Status:
  Cassandra Data Replication:
  Cassandra Pod Ips:
    10.8.2.204
  Cassandra Ready Replicas:  1
  Components:
    Cassandra:
      Last Successfully Released Version:
        Revision:  v1-f8aa9a82b9f69613
        Version:   v1
      Replicas:
        Available:  1
        Ready:      1
        Total:      1
        Updated:    1
      State:        running
  Scaling:
    In Progress:         false
    Operation:
    Requested Replicas:  0
  State:                 running

      ממשיכים לשלב הבא רק אם ה-pod‏ apigeeds פועל.

    4. מריצים את הפקודה הבאה כדי לרשום את הערכים החדשים של מספר העותקים של מעבד ההודעות אחרי השדרוג. אם הערכים האלה לא תואמים לערכים שהגדרתם בעבר, צריך לשנות את הערכים בקובץ הביטולים כך שיתאימו להגדרה הקודמת. 
      apigeectl apply -f ORIGINAL_OVERRIDES_FILE --dry-run=client --print-yaml --env ENV_NAME 2>/dev/null |grep "runtime:" -A 25 -B 1| grep "autoScaler" -A 2

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

            autoScaler:
        minReplicas: 2
        maxReplicas: 10
    5. מריצים את apigeectl init: 
      $APIGEECTL_HOME/apigeectl init -f ORIGINAL_OVERRIDES_FILE