החזרת Apigee Edge 4.19.06 לגרסה קודמת

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

אפשר להחזיר את Edge 4.19.06 לגרסאות הבאות של Feature Release:

  • גרסה 4.19.01
  • גרסה 4.18.05
  • גרסה 4.18.01

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

  1. חזרה לגרסת פיצ'רים קודמת. לדוגמה, מגרסה 4.19.06 לגרסה 4.18.05.
  2. חזרה לגרסת עדכון קודמת באותועדכון. לדוגמה, מגרסה 4.19.01.02 לגרסה 4.19.01.01.

מידע נוסף זמין במאמר תהליך הפרסום של Apigee Edge.

מי יכול לבצע החזרה לגרסה קודמת

המשתמש שמבצע את החזרה לגרסה קודמת צריך להיות אותו משתמש שעדכן את Edge במקור, או משתמש שפועל כמשתמש בסיסי (root).

כברירת מחדל, רכיבי Edge פועלים בתור המשתמש apigee. במקרים מסוימים, יכול להיות שאתם מפעילים רכיבי Edge כמשתמשים שונים. לדוגמה, אם הנתב צריך לגשת ליציאות עם הרשאות, כמו אלה שמתחת ל-1000, צריך להריץ את הנתב כמשתמש root או כמשתמש עם גישה ליציאות האלה. לחלופין, יכול להיות שאתם מריצים רכיב אחד כמשתמש אחד, ורכיב אחר כמשתמש אחר.

רכיבים עם קוד משותף

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

  • edge-management-server (שרת ניהול)
  • ‫edge-message-processor (מעבד בקשות)
  • edge-router (נתב)
  • edge-postgres-server (שרת Postgres)
  • edge-qpid-server (שרת Qpid)

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

חזרה לגרסת Feature Release קודמת

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

  1. מורידים את קובץ ה-bootstrap.sh של הגרסה שאליה רוצים לחזור:

    • כדי לחזור לגרסה 4.19.01, צריך להוריד את bootstrap_4.19.01.sh: 
      curl https://software.apigee.com/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh
    • כדי לחזור לגרסה 4.18.05, צריך להוריד את bootstrap_4.18.05.sh: 
      curl https://software.apigee.com/bootstrap_4.18.05.sh -o /tmp/bootstrap_4.18.05.sh
    • כדי לחזור לגרסה 4.18.01, צריך להוריד את bootstrap_4.18.01.sh: 
      curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
  2. עוצרים את הרכיב שרוצים להחזיר לגרסה קודמת:
    1. כדי להחזיר לגרסה קודמת את אחד מהרכיבים עם הקוד המשותף בצומת, צריך לעצור את כולם, כמו בדוגמה הבאה: 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-server stop
/opt/apigee/apigee-service/bin/apigee-service edge-router stop
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor stop
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    2. כדי לחזור לגרסה קודמת של רכיב אחר בצומת, עוצרים רק את הרכיב הזה: 
      • /opt/apigee/apigee-service/bin/apigee-service component stop
  3. אם אתם מחזירים את המונטיזציה לגרסה קודמת, צריך להסיר אותה מכל הצמתים של שרת הניהול ומעבד הבקשות: 
    /opt/apigee/apigee-service/bin/apigee-service edge-mint-gateway uninstall
  4. מסירים את הרכיב כדי לחזור לגרסה הקודמת בצומת:
    1. כדי להחזיר לגרסה קודמת את אחד מהרכיבים עם קוד משותף בצומת, צריך להסיר את כולם על ידי הסרת קבוצת הרכיבים edge-gateway, כמו בדוגמה הבאה: 
      /opt/apigee/apigee-service/bin/apigee-service edge-gateway uninstall
    2. כדי להחזיר לגרסה קודמת רכיב אחר בצומת, מסירים רק את הרכיב הזה, כמו בדוגמה הבאה: 
      /opt/apigee/apigee-service/bin/apigee-service component uninstall

      כאשר component הוא שם הרכיב.

    3. כדי להחזיר את Edge Router לגרסה קודמת, צריך למחוק את התוכן של הקובץ /opt/nginx/conf.d בנוסף להסרת ההתקנה של קבוצת הרכיבים edge-gateway: 
      cd /opt/nginx/conf.d
rm -rf *
  5. מסירים את גרסה 4.19.06 של apigee-setup: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall
  6. מתקינים את גרסה 4.19.01,‏ 4.18.05 או 4.18.01 של כלי השירות apigee-service ואת יחסי התלות שלו. בדוגמה הבאה מתקינים את גרסה 4.18.01 של apigee-service: 
    sudo bash /tmp/bootstrap_4.18.01.sh apigeeuser=uName apigeepassword=pWord

    כאשר uName ו-pWord הם שם המשתמש והסיסמה שקיבלתם מ-Apigee. אם לא תציינו את pWord, תתבקשו להזין אותו.

    אם מופיעה הודעת שגיאה, צריך לוודא שהורדתם את הקובץ bootstrap.sh בשלב 1.

  7. התקנת apigee-setup: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  8. מתקינים את הגרסה הישנה יותר של הרכיב: 
    /opt/apigee/apigee-setup/bin/setup.sh -p component -f configFile

    ‫component הוא הרכיב שרוצים להתקין ו-configFile הוא קובץ התצורה של הגרסה הישנה יותר.

  9. אם אתם מחזירים את Qpid לגרסה קודמת, צריך לנקות את iptables: 
    sudo iptables -F
  10. חוזרים על התהליך הזה בכל צומת שמארח את הרכיב שאתם מחזירים לגרסה קודמת.

חזרה לגרסת עדכון קודמת

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

  1. מורידים את הגרסה הספציפית של הרכיב: 
    /opt/apigee/apigee-service/bin/apigee-service component_version install

    כאשר component_version הוא הרכיב וגרסת העדכון שצריך להתקין. לדוגמה:

    /opt/apigee/apigee-service/bin/apigee-service edge-ui-4.18.01-0.0.3749 install

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

    yum --showduplicates list comp

    לדוגמה:

    yum --showduplicates list edge-ui
  2. משתמשים ב-apigee-setup כדי להתקין את הרכיב: 
    /opt/apigee/apigee-setup/bin/setup.sh -p comp -f configFile

    לדוגמה:

    /opt/apigee/apigee-setup/bin/setup.sh -p ui -f configFile

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

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