שדרוג לאחור של רכיבי Apigee ו-NGINX

כרגע מוצג התיעוד של Apigee Edge.
כניסה למסמכי התיעוד של Apigee X. מידע

מהדורת תיקון במרץ 2021

ה-RPM של מהדורת התיקון של Edge for Private Cloud ממרץ 2021, שנדחף אל מאגר הייצור של Apigee, הכיל עדכון בלתי מכוון של התלות ב-apigee-nginx-1.18. לכן הסרנו את ה-RPM מהמאגר והחלפנו אותם ב-RPM הנכון. ה-RPM הלא חוקי היו במאגר ב-25 במרץ 2021 בין השעות 08:45 ל-15:45 לפי שעון החוף המערבי. אם הורדתם והתקנתם RPM של Edge באותו תאריך, יכול להיות שתצטרכו לשדרג לאחור את רכיבי Apigee הבאים לגרסאות קודמות:

  • שער קצה
  • שרת לניהול קצה
  • מעבד הודעות בקצה
  • edge-postgres-server
  • שרת-qpid
  • נתב קצה
  • nginx

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

בדיקה אם עליך לשדרג לאחור

כדי לבדוק אם אתם צריכים לשדרג לאחור את רכיבי Apigee או את NGINX, עליכם לבצע את אחד מההליכים הבאים, בהתאם לסוג Edge שבו אתם משתמשים – Private Cloud 4.50.00 או 4.19.06.

הליך עבור Edge 4.50.00

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

-- apigee-service edge-gateway version

אם מספר הגרסה של edge-gateway הוא:

  • פחות מ-2011, אין צורך לבצע פעולות נוספות.
  • שווה ערך ל-20113, צריך לשדרג לאחור רכיבי Apigee ואת NGINX.
  • אחרי שנת 20113 ואילך, כדי למצוא את גרסת ה-NGINX, מזינים: 
    -- sudo yum list installed apigee-nginx

    הנה פלט לדוגמה מהפקודה:

    Installed Packages
apigee-nginx.x86_64 1.18.0-1.el7
@apigee-thirdparty

    אם הגרסה של NGINX היא apigee-nginx.x86_64 1.18.0-XXX, צריך רק לשדרג לאחור את NGINX.

הליך עבור Edge 4.19.06

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

-- apigee-service edge-gateway version

אם מספר הגרסה של edge-gateway הוא:

  • פחות מ-2011, אין צורך לבצע פעולות נוספות.
  • שווה ערך ל-20114, צריך לשדרג לאחור את רכיבי Apigee ולשדרג לאחור את NGINX.
  • אחרי שנת 20114, כדי למצוא את גרסת ה-NGINX, מזינים: 
    -- sudo yum list installed apigee-nginx

    הנה פלט לדוגמה מהפקודה:

    Installed Packages
apigee-nginx.x86_64 1.18.0-1.el7
@apigee-thirdparty

    אם הגרסה של NGINX היא apigee-nginx.x86_64 1.18.0-XXX, צריך רק לשדרג לאחור את NGINX.

    רכיבים לשדרוג לאחור

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

    רכיבים לשדרוג לאחור של Edge ל-Private Cloud 4.50.00

    edge-gateway-4.50.00-0.0.20113.noarch.rpm
edge-management-server-4.50.00-0.0.20113.noarch.rpm
edge-message-processor-4.50.00-0.0.20113.noarch.rpm
edge-postgres-server-4.50.00-0.0.20113.noarch.rpm
edge-qpid-server-4.50.00-0.0.20113.noarch.rpm
edge-router-4.50.00-0.0.20113.noarch.rpm

    רכיבים לשדרוג לאחור של Edge ל-Private Cloud 4.19.06

    edge-gateway-4.19.06-0.0.20114.noarch.rpm
edge-management-server-4.19.06-0.0.20114.noarch.rpm
edge-message-processor-4.19.06-0.0.20114.noarch.rpm
edge-postgres-server-4.19.06-0.0.20114.noarch.rpm
edge-qpid-server-4.19.06-0.0.20114.noarch.rpm
edge-router-4.19.06-0.0.20114.noarch.rpm

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

    -- apigee-service component version

    שדרוג לאחור של רכיבי Apigee

    כדי לשדרג לאחור רכיבי Apigee, משתמשים בתהליך הבא.

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

    • שער קצה
    • שרת לניהול קצה
    • מעבד הודעות בקצה
    • edge-postgres-server
    • שרת-qpid
    • נתב קצה

    עצירת הרכיב על ידי הזנת

    --apigee-service component stop

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

    -- sudo yum downgrade

    ריכזנו כאן כמה דוגמאות:

    אם שער ומעבד הודעות בקצה מותקנים:

    -- sudo yum downgrade edge-gateway edge-message-processor

    אם השער ונתב הקצה מותקנים:

    -- sudo yum downgrade edge-gateway edge-router

    אם מגדירים AIO:

    -- sudo yum downgrade edge-gateway edge-postgres-server edge-router edge-management-server edge-message-processor edge-qpid-server

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

    --apigee-service  component configure
--apigee-service  component start

    הגרסה הנכונה של ההכנסות לאלף חשיפות (RPM) שהייתם רוצים אחרי השדרוג לאחור מוצגת בהמשך.

    Edge לענן פרטי 4.50.00

    edge-gateway-4.50.00-0.0.20110
Edge-management-server-4.50.00-0.0.20110
edge-message-processor-4.50.00-0.0.20110
edge-postgres-server-4.50.00-0.0.20110
edge-qpid-server-4.50.00-0.0.20110
edge-router-4.50.00-0.0.20110

    Edge לענן פרטי 4.19.06

    edge-gateway-4.19.06-0.0.20112
Edge-management-server-4.19.06-0.0.20112
edge-message-processor-4.19.06-0.0.20112
edge-postgres-server-4.19.06-0.0.20112
edge-qpid-server-4.19.06-0.0.20112
edge-router-4.19.06-0.0.20112

    שדרוג לאחור של NGINX

    כדי לשדרג לאחור את apigee-nginx, צריך לבצע את השלבים הבאים בנתב Edge, עם צומת אחד בכל פעם:

    1. עוצרים את הנתב. 
      --apigee-service edge-router stop
    2. שדרוג לאחור של apigee-ngix. 
       -- sudo yum downgrade apigee-nginx
      הגרסה הצפויה: apigee-nginx לאחר השדרוג לאחור: 
      -- yum list installed apigee-nginx
apigee-nginx.x86_64 -1.16.1-6.el7
    3. מגדירים את הנתב. 
      apigee-service edge-router configure
    4. מפעילים את הנתב. 
      apigee-service edge-router start