‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

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

ההליך הזה מתייחס לשדרוג מ-Apigee Hybrid גרסה 1.10.x ל-Apigee Hybrid גרסה 1.11.2, ומגרסאות קודמות של Hybrid 1.11.x לגרסה 1.11.2.

ההליך זהה לשדרוג גרסה משנית (לדוגמה, מגרסה 1.10 לגרסה 1.11) ולשדרוג גרסת תיקון (לדוגמה, מגרסה 1.11.0 לגרסה 1.11.2).

אם אתם משדרגים מגרסה 1.9 או מגרסה ישנה יותר של Apigee Hybrid, אתם צריכים לשדרג קודם לגרסה 1.10 של Hybrid לפני שתשדרגו לגרסה 1.11.2. אפשר לעיין בהוראות בנושא שדרוג Apigee Hybrid לגרסה 1.10.

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

שדרוג לגרסה 1.11 של Apigee Hybrid עשוי לדרוש זמן השבתה.

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

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

אי אפשר לבצע גיבוי ושחזור של Cassandra עם גרסאות מעורבות. לדוגמה, אי אפשר להשתמש בגיבוי מ-Hybrid 1.10 כדי לשחזר מופע של Hybrid 1.11.
הזרמת נתונים של Cassandra לא תפעל בין גרסאות היברידיות מעורבות. לכן, אי אפשר להרחיב את אשכולות Cassandra באופן אופקי.
ההרחבה וההוצאה משימוש של אזורים יושפעו, כי הפעולות האלה תלויות בסטרימינג של נתוני Cassandra.

ב-Hyrid 1.11.2-Hotfix.3 יש בדיקות מחמירות יותר של יצירת מופע של מחלקה.

החל מ-Apigee hybrid 1.11.2-Hotfix.3, ‏JavaCallout policy כולל עכשיו אבטחה נוספת במהלך יצירת מופע של מחלקת Java. אמצעי האבטחה המשופר מונע פריסה של מדיניות שמנסה לבצע פעולות שדורשות הרשאות שאסורות, באופן ישיר או עקיף.

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

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

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

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

ההוראות לשדרוג מניחות שיש לכם גרסה 1.10.x של Apigee hybrid מותקנת, ואתם רוצים לשדרג אותה לגרסה 1.11.2. אם אתם משדרגים מגרסה קודמת, כדאי לעיין בהוראות בנושא שדרוג Apigee hybrid לגרסה 1.10.

תרשימי Helm ו-`apigeectl`

בגרסה 1.11 אפשר לבחור להתקין ולנהל את Apigee Hybrid באמצעות תרשימי Helm או באמצעות apigeectl. מומלץ להשתמש ב-Helm כדי לנהל את ההתקנה.

מעבר לגרסה 1.11 באמצעות Helm מגרסה 1.10 באמצעות `apigeectl`

כדי לשדרג ל-Apigee Hybrid גרסה 1.11 שמנוהלת על ידי Helm מתוך התקנה של Hybrid גרסה 1.10 שמנוהלת באמצעות apigeectl:

קודם כול, מעבירים את התקנת Helm בגרסה 1.10 לפי ההוראות במאמר העברת Apigee Hybrid לתרשימי Helm מגרסה apigeectl.
כדי לשדרג את ההתקנה, פועלים לפי ההוראות לתרשימי Helm שבהמשך.
הערה: כשמשדרגים התקנה שעברה מיגרציה, צריך להוסיף דגל --force לפקודות helm upgrade.

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

הערה: כשעוברים מ-Apigee hybrid v1.10 ל-v1.11, אחרי המעבר מ-apigeectl לתרשימי Helm בשלב הקודם, צריך לפעול לפי ההוראות שבכרטיסייה helm. אחרי המעבר ל-Helm, צריך להמשיך להשתמש ב-Helm בשדרוגים הבאים.

גיבוי של ההתקנה ההיברידית (מומלץ)

Helm

בהוראות האלה נעשה שימוש במשתנה הסביבה APIGEE_HELM_CHARTS_HOME עבור הספרייה במערכת הקבצים שבה התקנתם את תרשימי Helm. אם צריך, משנים את הספרייה לספרייה הזו ומגדירים את המשתנה באמצעות הפקודה הבאה:
Linux
```
export APIGEE_HELM_CHARTS_HOME=$PWD
echo $APIGEE_HELM_CHARTS_HOME
```
Mac OS
```
export APIGEE_HELM_CHARTS_HOME=$PWD
echo $APIGEE_HELM_CHARTS_HOME
```
Windows
```
set APIGEE_HELM_CHARTS_HOME=%CD%
echo %APIGEE_HELM_CHARTS_HOME%
```
יוצרים עותק גיבוי של ספריית $APIGEE_HELM_CHARTS_HOME/ בגרסה 1.10. אפשר להשתמש בכל תהליך גיבוי. לדוגמה, אפשר ליצור קובץ tar של כל הספרייה באמצעות הפקודה:
```
tar -czvf $APIGEE_HELM_CHARTS_HOME/../apigee-helm-charts-v1.10-backup.tar.gz $APIGEE_HELM_CHARTS_HOME
```
מגבים את מסד הנתונים של Cassandra לפי ההוראות במאמר בנושא גיבוי ושחזור של Cassandra.

אם אתם משתמשים בקובצי אישורים של שירות (.json) בשינויים שלכם כדי לאמת חשבונות שירות, ודאו שקובצי האישורים של חשבונות השירות נמצאים בספריית תרשימי ה-Helm הנכונה. תרשימי Helm לא יכולים לקרוא קבצים מחוץ לספרייה של כל תרשים.

לא צריך לבצע את השלב הזה אם משתמשים בסודות של Kubernetes או ב-Workload Identity כדי לאמת חשבונות שירות.

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

Prod

חשבון שירות	שם קובץ ברירת מחדל	ספריית תרשימי Helm
`apigee-cassandra`	`PROJECT_ID-apigee-cassandra.json`	`$APIGEE_HELM_CHARTS_HOME/apigee-datastore/`
`apigee-logger`	`PROJECT_ID-apigee-logger.json`	`$APIGEE_HELM_CHARTS_HOME/apigee-telemetry/`
`apigee-mart`	`PROJECT_ID-apigee-mart.json`	`$APIGEE_HELM_CHARTS_HOME/apigee-org/`
`apigee-metrics`	`PROJECT_ID-apigee-metrics.json`	`$APIGEE_HELM_CHARTS_HOME/apigee-telemetry/`
`apigee-runtime`	`PROJECT_ID-apigee-runtime.json`	`$APIGEE_HELM_CHARTS_HOME/apigee-env`
`apigee-synchronizer`	`PROJECT_ID-apigee-synchronizer.json`	`$APIGEE_HELM_CHARTS_HOME/apigee-env/`
`apigee-udca`	`PROJECT_ID-apigee-udca.json`	`$APIGEE_HELM_CHARTS_HOME/apigee-org/`
`apigee-watcher`	`PROJECT_ID-apigee-watcher.json`	`$APIGEE_HELM_CHARTS_HOME/apigee-org/`

Non-prod

יוצרים עותק של קובץ חשבון השירות apigee-non-prod בכל אחת מהספריות הבאות:

חשבון שירות	שם קובץ ברירת מחדל	ספריות של תרשימי Helm
`apigee-non-prod`	`PROJECT_ID-apigee-non-prod.json`	`$APIGEE_HELM_CHARTS_HOME/apigee-datastore/` `$APIGEE_HELM_CHARTS_HOME/apigee-telemetry/` `$APIGEE_HELM_CHARTS_HOME/apigee-org/` `$APIGEE_HELM_CHARTS_HOME/apigee-env/`

מוודאים שקובצי המפתח ואישור ה-TLS (.crt,‏ .key ו/או .pem) נמצאים בספרייה $APIGEE_HELM_CHARTS_HOME/apigee-virtualhost/.

`apigeectl`

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

hybrid-v1.11-root-directory/
└── apigeectl/
    └── config/
    └── plugins/
    └── templates/
    └── tools/
└── hybrid-files/
    └── overrides/
    └── service-accounts/
    └── certs/
hybrid-v1.10-root-directory/

בהוראות האלה נעשה שימוש במשתנה הסביבה 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%
```
יוצרים עותק גיבוי של ספריית $APIGEECTL_HOME/ בגרסה 1.10. לדוגמה:
```
tar -czvf $APIGEECTL_HOME/../apigeectl-v1.10-backup.tar.gz $APIGEECTL_HOME
```
מגבים את מסד הנתונים של Cassandra לפי ההוראות במאמר בנושא גיבוי ושחזור של Cassandra.

שדרוג גרסת Kubernetes

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

כאן אפשר ללחוץ כדי להרחיב את רשימת הפלטפורמות הנתמכות

	‫1.10 ⁽³⁾	‫1.11	‫1.12
‫GKE ב- Google Cloud	‫1.24.x ‫1.25.x ‫1.26.x ‫1.27.x^{(≥ 1.10.5)} ‫1.28.x^{(≥ 1.10.5)}	‫1.25.x ‫1.26.x ‫1.27.x ‫1.28.x^{(≥ 1.11.2)} ‫1.29.x^{(≥ 1.11.2)}	‫1.26.x ‫1.27.x ‫1.28.x ‫1.29.x^{(≥ 1.12.1)}
‫GKE ב-AWS	‫1.13.x (K8s v1.24.x) ‫1.14.x (K8s v1.25.x) ‫1.26.x⁽¹²⁾ ‫1.27.x^{(≥ 1.10.5)} ‫1.28.x^{(≥ 1.10.5)}	‫1.14.x (K8s v1.25.x) 1.26.x⁽¹²⁾ 1.27.x 1.28.x^{(≥ 1.11.2)} 1.29.x^{(≥ 1.11.2)}	‪1.26.x⁽¹²⁾ 1.27.x 1.28.x 1.29.x^{(≥ 1.12.1)}
‫GKE ב-Azure	‫1.13.x 1.14.x 1.26.x⁽¹²⁾ 1.27.x^{(≥ 1.10.5)} 1.28.x^{(≥ 1.10.5)}	‫1.14.x 1.26.x⁽¹²⁾ 1.27.x 1.28.x^{(≥ 1.11.2)} 1.29.x^{(≥ 1.11.2)}	‫1.26.x⁽¹²⁾ 1.27.x 1.28.x 1.29.x^{(‎≥ 1.12.1)}
‫Google Distributed Cloud (תוכנה בלבד) ב-VMware ⁽¹⁾ ⁽¹³⁾	‫1.13.x ‫1.14.x ‫1.15.x‏ (K8s v1.26.x) ‫1.16.x‏ (K8s v1.27.x) ‫1.27.x^{(≥ 1.10.5)} ‫1.28.x^{(≥ 1.10.5)}	‫1.14.x ‫1.15.x‏ (K8s v1.26.x) ‫1.16.x‏ (K8s v1.27.x) ‫1.28.x^{(≥ 1.11.2)} ‫1.29.x^{(≥ 1.11.2)}	‫1.15.x‏ (K8s v1.26.x) ‫1.16.x‏ (K8s v1.27.x) ‫1.28.x⁽¹²⁾ ‫1.29.x^{(‎≥ 1.12.1)}
‫Google Distributed Cloud (תוכנה בלבד) בשרת פיזי ⁽¹⁾	‫1.13.x ‫1.14.x‏ (K8s v1.25.x) ‫1.15.x‏ (K8s v1.26.x) ‫1.16.x‏ (K8s v1.27.x) ‫1.27.x⁽¹²⁾^{(≥ 1.10.5)} ‫1.28.x^{(≥ 1.10.5)}	‫1.14.x ‫1.15.x (K8s v1.26.x) ‫1.16.x (K8s v1.27.x) ‫1.28.x⁽¹²⁾^{(≥ 1.11.2)} ‫1.29.x^{(≥ 1.11.2)}	‫1.15.x‏ (K8s v1.26.x) ‫1.16.x‏ (K8s v1.27.x) ‫1.28.x⁽¹²⁾ ‫1.29.x^{(‎≥ 1.12.1)}
EKS⁽⁷⁾	‪1.24.x 1.25.x 1.26.x 1.27.x^{(≥ 1.10.5)} 1.28.x^{(≥ 1.10.5)}	‫1.25.x 1.26.x 1.27.x 1.28.x^{(≥ 1.11.2)} 1.29.x^{(≥ 1.11.2)}	‫1.26.x ‫1.27.x ‫1.28.x ‫1.29.x^{(≥ 1.12.1)}
AKS⁽⁷⁾	‪1.24.x 1.25.x 1.26.x 1.27.x^{(≥ 1.10.5)} 1.28.x^{(≥ 1.10.5)}	‫1.25.x 1.26.x 1.27.x 1.28.x^{(≥ 1.11.2)} 1.29.x^{(≥ 1.11.2)}	‫1.26.x ‫1.27.x ‫1.28.x ‫1.29.x^{(≥ 1.12.1)}
OpenShift⁽⁷⁾	‫4.11 4.12 4.14^{(≥ 1.10.5)} 4.15^{(≥ 1.10.5)}	‫4.12 4.13 4.14 4.15^{(≥ 1.11.2)} 4.16^{(≥ 1.11.2)}	‫4.12 4.13 4.14 4.15 4.16^{(≥ 1.12.1)}
Rancher Kubernetes Engine (RKE)	v1.26.2+rke2r1 1.27.x^{(≥ 1.10.5)} 1.28.x^{(≥ 1.10.5)}	‫v1.26.2+rke2r1 v1.27.x 1.28.x^{(≥ 1.11.2)} 1.29.x^{(≥ 1.11.2)}	‫v1.26.2+rke2r1 v1.27.x 1.28.x 1.29.x^{(‎≥ 1.12.1)}
VMware Tanzu	לא רלוונטי	לא רלוונטי	v1.26.x
רכיבים	‫1.10	‫1.11	‫1.12
Anthos Service Mesh	‫1.17.x⁽¹⁰⁾	‫1.18.x⁽¹⁰⁾	‫1.19.x⁽¹⁰⁾
JDK	JDK 11	JDK 11	JDK 11
cert-manager	‫1.10.x 1.11.x 1.12.x	‫1.11.x 1.12.x 1.13.x	‫1.11.x 1.12.x 1.13.x
Cassandra	3.11	3.11	4.0
‏Kubernetes	‫1.24.x ‫1.25.x ‫1.26.x	‫1.25.x ‫1.26.x ‫1.27.x	‫1.26.x ‫1.27.x ‫1.28.x
kubectl			‫1.27.x ‫1.28.x ‫1.29.x
Helm	‫3.10 ומעלה	‫3.10 ומעלה	3.14.2+
Secret Store CSI driver		1.3.4	1.4.1
Vault		‫‎1.13.x	1.15.2
‫⁽¹⁾ ב-Anthos on-premises (Google Distributed Cloud) גרסה 1.13, פועלים לפי ההוראות האלה כדי למנוע התנגשות עם `cert-manager`: התקנה של cert-manager שמתנגשת עם התקנה אחרת ‫⁽²⁾ התמיכה זמינה בגרסה 1.7.2 של Apigee Hybrid ואילך. ^‫(3) תאריכי סוף החיים הרשמיים של גרסאות Apigee Hybrid 1.10 ומגרסאות ישנות יותר כבר חלפו. טלאים חודשיים רגילים כבר לא זמינים. אין יותר תמיכה רשמית בגרסאות האלה, למעט לקוחות עם חריגים מפורשים ורשמיים להמשך התמיכה. לקוחות אחרים צריכים לשדרג. ^‫(4)הסתיימה התמיכה בגרסה 1.12 ובגרסאות קודמות של Anthos on-premises (Google Distributed Cloud). אפשר לעיין במדיניות התמיכה בגרסאות של Distributed Cloud on bare metal וברשימת הגרסאות הנתמכות של Distributed Cloud on VMware. ‫⁽⁵⁾‫Google Distributed Cloud בשרת פיזי או ב-VMware מחייב Anthos Service Mesh בגרסה 1.14 ואילך. מומלץ לשדרג לגרסה 1.8 של Hybrid ולעבור לשער כניסה של Apigee, שלא מחייב יותר התקנה של Anthos Service Mesh באשכול Hybrid. ‫⁽⁶⁾ תמיכה זמינה בגרסה 1.8.4 של Apigee Hybrid ובגרסאות חדשות יותר. ‫⁽⁷⁾ לא נתמך ב-Apigee Hybrid בגרסה 1.8.4 ואילך. ^‫(8) התמיכה זמינה ב-Apigee Hybrid גרסה 1.7.6 ואילך. ^‫(9) לא נתמך ב-Apigee Hybrid בגרסה 1.8.5 ואילך. ‫⁽¹⁰⁾ Anthos Service Mesh מותקן באופן אוטומטי ב-Apigee Hybrid בגרסה 1.9 ואילך. ^‫(11) התמיכה זמינה בגרסה 1.9.2 של Apigee Hybrid ואילך. ‫⁽¹²⁾ מספרי הגרסאות של GKE ב-AWS משקפים עכשיו את גרסאות Kubernetes. פרטים על הגרסה ועל תיקונים מומלצים זמינים במאמר בנושא תמיכה בגרסאות ובשדרוגים של GKE Enterprise. ‫⁽¹³⁾ Vault לא מאושר ב-Google Distributed Cloud ל-VMware. ^‫(14) תמיכה זמינה בגרסה 1.10.5 של Apigee Hybrid ואילך. ‫⁽¹⁵⁾ התמיכה זמינה בגרסה 1.11.2 של Apigee Hybrid ובגרסאות חדשות יותר. ^‫(16) תמיכה זמינה ב-Apigee Hybrid גרסה 1.12.1 ואילך.

מידע על אשכולות מצורפים

בגרסאות היברידיות של Apigee‏ 1.7.x ומטה, צריך להשתמש באשכולות מצורפים של GKE אם רוצים להפעיל את Apigee hybrid בהקשר של ריבוי עננים ב-Elastic Kubernetes Service‏ (EKS), ב-Azure Kubernetes Service‏ (AKS) או בספק שירותי Kubernetes אחר של צד שלישי שנתמך. צירוף אשכולות מאפשר ל-Google למדוד את השימוש ב-Anthos Service Mesh.

אם אתם משתמשים ב-Anthos Service Mesh בשביל שער הכניסה שלכם, אתם צריכים אשכולות מצורפים של GKE ב-Apigee hybrid בגרסה 1.8.x. אם אתם משתמשים בשער כניסה של Apigee, צירוף אשכולות הוא אופציונלי.

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

Helm

הכנה לשדרוג של תרשימי Helm

כדי שהתרשימים apigee-operator ו-apigee-env ישתמשו בתג הנכון, 1.11.2-hotfix.3, צריך לבצע את השינוי הבא בקובץ overrides.yaml:
```
ao:
  image:
    url: "gcr.io/apigee-release/hybrid/apigee-operators"
    tag: "1.11.2-hotfix.3"
runtime:
  image:
    url: "gcr.io/apigee-release/hybrid/apigee-runtime"
    tag: "1.11.2-hotfix.3"
```
הערות המוצר של Apigee 1.11.2-hotfix.3

שולפים את תרשימי Apigee Helm.

תרשימים של Apigee Hybrid מתארחים ב-Google Artifact Registry:

oci://us-docker.pkg.dev/apigee-release/apigee-hybrid-helm-charts

כדי להעתיק את כל תרשימי ה-Helm של Apigee hybrid לאחסון המקומי, משתמשים בפקודה pull הבאה:

export CHART_REPO=oci://us-docker.pkg.dev/apigee-release/apigee-hybrid-helm-charts
export CHART_VERSION=1.11.2
helm pull $CHART_REPO/apigee-operator --version $CHART_VERSION --untar
helm pull $CHART_REPO/apigee-datastore --version $CHART_VERSION --untar
helm pull $CHART_REPO/apigee-env --version $CHART_VERSION --untar
helm pull $CHART_REPO/apigee-ingress-manager --version $CHART_VERSION --untar
helm pull $CHART_REPO/apigee-org --version $CHART_VERSION --untar
helm pull $CHART_REPO/apigee-redis --version $CHART_VERSION --untar
helm pull $CHART_REPO/apigee-telemetry --version $CHART_VERSION --untar
helm pull $CHART_REPO/apigee-virtualhost --version $CHART_VERSION --untar

אם צריך, מתקינים את cert-manager.
אם אתם צריכים לשדרג את הגרסה של cert-manager, אתם יכולים להתקין את הגרסה החדשה באמצעות הפקודה הבאה:
```
kubectl apply -f https://github.com/cert-manager/cert-manager/releases/download/v1.11.1/cert-manager.yaml
```

מתקינים את ה-CRD המעודכנים של Apigee:

הערה: זו השיטה הנתמכת היחידה להתקנת CRD של Apigee. אל תשתמשו ב-kubectl apply בלי -k, ואל תשמיטו את --server-side.

כדי להשתמש בתכונה של הרצה יבשה של kubectl, מריצים את הפקודה הבאה:

kubectl apply -k  apigee-operator/etc/crds/default/ --server-side --force-conflicts --validate=false --dry-run

אחרי האימות באמצעות הפקודה להרצה יבשה, מריצים את הפקודה הבאה:
```
kubectl apply -k  apigee-operator/etc/crds/default/ --server-side --force-conflicts --validate=false
```

מאמתים את ההתקנה באמצעות הפקודה kubectl get crds:

kubectl get crds | grep apigee

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

apigeedatastores.apigee.cloud.google.com                    2023-10-09T14:48:30Z
apigeedeployments.apigee.cloud.google.com                   2023-10-09T14:48:30Z
apigeeenvironments.apigee.cloud.google.com                  2023-10-09T14:48:31Z
apigeeissues.apigee.cloud.google.com                        2023-10-09T14:48:31Z
apigeeorganizations.apigee.cloud.google.com                 2023-10-09T14:48:32Z
apigeeredis.apigee.cloud.google.com                         2023-10-09T14:48:33Z
apigeerouteconfigs.apigee.cloud.google.com                  2023-10-09T14:48:33Z
apigeeroutes.apigee.cloud.google.com                        2023-10-09T14:48:33Z
apigeetelemetries.apigee.cloud.google.com                   2023-10-09T14:48:34Z
cassandradatareplications.apigee.cloud.google.com           2023-10-09T14:48:35Z

בודקים את התוויות בצמתי האשכול. כברירת מחדל, Apigee מתזמן את הפודים של הנתונים בצמתים עם התווית cloud.google.com/gke-nodepool=apigee-data, ואת הפודים של זמן הריצה בצמתים עם התווית cloud.google.com/gke-nodepool=apigee-runtime. אפשר להתאים אישית את תוויות מאגר הצמתים בקובץ overrides.yaml.

מידע נוסף זמין במאמר בנושא הגדרת מאגרי צמתים ייעודיים.

התקנה של תרשימי Helm של Apigee Hybrid

הערה: לפני שמריצים פקודות שדרוג או התקנה של Helm, כדאי להשתמש בתכונה Helm dry-run. כדי לעשות זאת, מוסיפים את האפשרות --dry-run בסוף הפקודה. אפשר להשתמש בפקודה helm -h כדי לראות רשימה של הפקודות, האפשרויות והשימוש הנתמכים.

אם לא, עוברים לספרייה APIGEE_HELM_CHARTS_HOME ומריצים את הפקודות הבאות מתוך הספרייה.

משדרגים את Apigee Operator/Controller:

הערה: השלב הזה דורש הרשאות גבוהות יותר באשכול. מריצים את helm -h או את helm upgrade -h כדי לקבל פרטים

הרצת בדיקה:

helm upgrade operator apigee-operator/ \
  --install \
  --create-namespace \
  --namespace apigee-system \
  -f OVERRIDES_FILE \
  --dry-run

שדרוג התרשים:

helm upgrade operator apigee-operator/ \
  --install \
  --create-namespace \
  --namespace apigee-system \
  -f OVERRIDES_FILE

הערה: אם ההתקנות הועברו מ-apigeectl ל-Helm, צריך להשתמש בפקודה הבאה:

helm upgrade operator apigee-operator/ \
  --install \
  --create-namespace \
  --namespace apigee-system \
  --force \
  -f OVERRIDES_FILE

אימות ההתקנה של Apigee Operator:

helm ls -n apigee-system

NAME           NAMESPACE       REVISION        UPDATED                                 STATUS          CHART                   APP VERSION
operator    apigee-system   3               2023-06-26 00:42:44.492009 -0800 PST    deployed        apigee-operator-1.11.2   1.11.2

כדי לוודא שהיא פועלת, בודקים את הזמינות שלה:

kubectl -n apigee-system get deploy apigee-controller-manager

NAME                        READY   UP-TO-DATE   AVAILABLE   AGE
apigee-controller-manager   1/1     1            1           7d20h

שדרוג מאגר הנתונים של Apigee:

הרצת בדיקה:

helm upgrade datastore apigee-datastore/ \
  --install \
  --namespace apigee \
  -f OVERRIDES_FILE \
  --dry-run

שדרוג התרשים:

helm upgrade datastore apigee-datastore/ \
  --install \
  --namespace apigee \
  -f OVERRIDES_FILE

הערה: אם ההתקנות הועברו מ-apigeectl ל-Helm, צריך להשתמש בפקודה הבאה:

helm upgrade datastore apigee-datastore/ \
  --install \
  --namespace apigee \
  --force \
  -f OVERRIDES_FILE

כדי לוודא ש-apigeedatastore פועל, בודקים את המצב שלו:

kubectl -n apigee get apigeedatastore default

NAME      STATE       AGE
default   running    2d

שדרוג הטלמטרייה של Apigee:

הרצת בדיקה:

helm upgrade telemetry apigee-telemetry/ \
  --install \
  --namespace apigee \
  -f OVERRIDES_FILE \
  --dry-run

שדרוג התרשים:

helm upgrade telemetry apigee-telemetry/ \
  --install \
  --namespace apigee \
  -f OVERRIDES_FILE

הערה: אם ההתקנות הועברו מ-apigeectl ל-Helm, צריך להשתמש בפקודה הבאה:

helm upgrade telemetry apigee-telemetry/ \
  --install \
  --namespace apigee \
  --force \
  -f OVERRIDES_FILE

כדי לוודא שהיא פועלת, בודקים את המצב שלה:

kubectl -n apigee get apigeetelemetry apigee-telemetry

NAME               STATE     AGE
apigee-telemetry   running   2d

שדרוג של Apigee Redis:

הרצת בדיקה:

helm upgrade redis apigee-redis/ \
  --install \
  --namespace apigee \
  -f OVERRIDES_FILE \
  --dry-run

שדרוג התרשים:

helm upgrade redis apigee-redis/ \
  --install \
  --namespace apigee \
  -f OVERRIDES_FILE

הערה: אם ההתקנות הועברו מ-apigeectl ל-Helm, צריך להשתמש בפקודה הבאה:

helm upgrade redis apigee-redis/ \
  --install \
  --namespace apigee \
  --force \
  -f OVERRIDES_FILE

כדי לוודא שהיא פועלת, בודקים את המצב שלה:

kubectl -n apigee get apigeeredis default

NAME      STATE     AGE
default   running   2d

משדרגים את Apigee ingress manager:

הרצת בדיקה:

helm upgrade ingress-manager apigee-ingress-manager/ \
  --install \
  --namespace apigee \
  -f OVERRIDES_FILE \
  --dry-run

שדרוג התרשים:

helm upgrade ingress-manager apigee-ingress-manager/ \
  --install \
  --namespace apigee \
  -f OVERRIDES_FILE

הערה: אם ההתקנות הועברו מ-apigeectl ל-Helm, צריך להשתמש בפקודה הבאה:

helm upgrade ingress-manager apigee-ingress-manager/ \
  --install \
  --namespace apigee \
  --force \
  -f OVERRIDES_FILE

כדי לוודא שהיא פועלת, בודקים את הזמינות שלה:

kubectl -n apigee get deployment apigee-ingressgateway-manager

NAME                            READY   UP-TO-DATE   AVAILABLE   AGE
apigee-ingressgateway-manager   2/2     2            2           2d

משדרגים את הארגון ב-Apigee:

הרצת בדיקה:

helm upgrade ORG_NAME apigee-org/ \
  --install \
  --namespace apigee \
  -f OVERRIDES_FILE \
  --dry-run

שדרוג התרשים:

helm upgrade ORG_NAME apigee-org/ \
  --install \
  --namespace apigee \
  -f OVERRIDES_FILE

הערה: אם ההתקנות הועברו מ-apigeectl ל-Helm, צריך להשתמש בפקודה הבאה:

helm upgrade ORG_NAME apigee-org/ \
  --install \
  --namespace apigee \
  --force \
  -f OVERRIDES_FILE

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

kubectl -n apigee get apigeeorg

NAME                      STATE     AGE
apigee-org1-xxxxx          running   2d

משדרגים את הסביבה.
צריך להתקין סביבה אחת בכל פעם. מציינים את הסביבה באמצעות --set env=ENV_NAME:

הרצת בדיקה:
```
helm upgrade ENV_RELEASE_NAME apigee-env/ \
  --install \
  --namespace apigee \
  --set env=ENV_NAME \
  -f OVERRIDES_FILE \
  --dry-run
```
- ‫ENV_RELEASE_NAME הוא השם שבו התקנתם בעבר את תרשים apigee-env. ב-hybrid v1.10, בדרך כלל זה הנתיב apigee-env-ENV_NAME. ב-Hybrid v1.11 ובגרסאות חדשות יותר, בדרך כלל זה ENV_NAME.
- ‫ENV_NAME הוא שם הסביבה שמשדרגים.
- ‫OVERRIDES_FILE הוא קובץ ההחלפות החדש שלכם לגרסה 1.11.2
שדרוג התרשים:
```
helm upgrade ENV_RELEASE_NAME apigee-env/ \
  --install \
  --namespace apigee \
  --set env=ENV_NAME \
  -f OVERRIDES_FILE
```
הערה: אם ההתקנות הועברו מ-apigeectl ל-Helm, צריך להשתמש בפקודה הבאה:
```
helm upgrade ENV_RELEASE_NAME apigee-env/ \
  --install \
  --namespace apigee \
  --set env=ENV_NAME \
  --force \
  -f OVERRIDES_FILE
```
כדי לוודא שהיא פועלת, בודקים את המצב של סביבת ה-env המתאימה:
```
kubectl -n apigee get apigeeenv
```
```
NAME                          STATE       AGE   GATEWAYTYPE
apigee-org1-dev-xxx            running     2d
```
משדרגים את קבוצות הסביבות (virtualhosts).
1. צריך לשדרג קבוצת סביבות (virtualhost) אחת בכל פעם. מציינים את קבוצת הסביבות באמצעות --set envgroup=ENV_GROUP_NAME. חוזרים על הפקודות הבאות לכל קבוצת סביבות שמוזכרת בקובץ overrides.yaml:
  הרצת בדיקה:
```
helm upgrade ENV_GROUP_RELEASE_NAME apigee-virtualhost/ \
  --install \
  --namespace apigee \
  --set envgroup=ENV_GROUP_NAME \
  -f OVERRIDES_FILE \
  --dry-run
```
  ‫ENV_GROUP_RELEASE_NAME הוא השם שבו התקנתם בעבר את תרשים apigee-virtualhost. ב-hybrid v1.10, בדרך כלל זה הנתיב apigee-virtualhost-ENV_GROUP_NAME. ב-Hybrid v1.11 ובגרסאות חדשות יותר, בדרך כלל מדובר ב-ENV_GROUP_NAME.
  
  שדרוג התרשים:
```
helm upgrade ENV_GROUP_RELEASE_NAME apigee-virtualhost/ \
  --install \
  --namespace apigee \
  --set envgroup=ENV_GROUP_NAME \
  -f OVERRIDES_FILE
```
  הערה: אם ההתקנות הועברו מ-apigeectl ל-Helm, צריך להשתמש בפקודה הבאה:
```
helm upgrade ENV_GROUP_RELEASE_NAME apigee-virtualhost/ \
  --install \
  --namespace apigee \
  --set envgroup=ENV_GROUP_NAME \
  --force \
  -f OVERRIDES_FILE
```
  הערה: הערך של ENV_GROUP_RELEASE_NAME צריך להיות ייחודי במרחב השמות apigee.
  לדוגמה, אם יש לכם סביבה בשם prod וקבוצת סביבות בשם prod, צריך להגדיר את הערך של ENV_GROUP_RELEASE_NAME למשהו ייחודי, כמו prod-envgroup.
2. בודקים את המצב של ApigeeRoute ‏ (AR).
  התקנת virtualhosts יוצרת ApigeeRouteConfig ‏(ARC), שיוצר באופן פנימי ApigeeRoute ‏(AR) אחרי שה-watcher של Apigee שולף פרטים שקשורים לקבוצת הסביבות ממישור הבקרה. לכן, צריך לוודא שהמצב של ה-AR התואם הוא running (פועל):
```
kubectl -n apigee get arc
```
```
NAME                                STATE   AGE
apigee-org1-dev-egroup                       2d
```
```
kubectl -n apigee get ar
```
```
NAME                                        STATE     AGE
apigee-org1-dev-egroup-xxxxxx                running   2d
```

התקנה של 1.11.2-hotfix.3

כדי לאפשר ל-runtime להשתמש בתג הנכון, 1.11.2-hotfix.3, צריך לבצע את השינוי הבא בקובץ overrides.yaml:
```
runtime:
  image:
    url: "gcr.io/apigee-release/hybrid/apigee-runtime"
    tag: "1.11.2-hotfix.3"
```
הערות המוצר של Apigee 1.11.2-hotfix.3
מעדכנים את התרשים apigee-env באמצעות הפקודה helm upgrade וקובץ הביטולים הנוכחי.
חוזרים על הפעולה לכל סביבה.
```
helm upgrade ENV_RELEASE_NAME apigee-env/ \
  --namespace APIGEE_NAMESPACE \
  --set env ENV_NAME \
  --atomic \
  -f OVERRIDES_FILE 
```

`apigeectl`

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

Linux

export VERSION=$(curl -s \
  https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/current-version.txt?ignoreCache=1)

Mac OS

export VERSION=$(curl -s \
  https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/current-version.txt)

Windows

for /f "tokens=*" %a in ('curl -s ^
  https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/current-version.txt') ^
do set VERSION=%a

כדי לוודא שהמשתנה אוכלס במספר גרסה, מריצים את הפקודה הבאה. אם רוצים להשתמש בגרסה אחרת, אפשר לשמור אותה במשתנה סביבה.
```
echo $VERSION
```
אמורה להופיע הגרסה האחרונה של Apigee Hybrid:
```
  1.11.2
```
חשוב לוודא שאתם נמצאים בספריית הבסיס של ההיברידי (הספרייה הראשית שבה נמצא קובץ ההפעלה apigeectl):
```
cd $APIGEECTL_HOME/..
```

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

Linux

‫Linux 64 bit:

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

Mac OS

‫Mac 64 bit:

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

Windows

Windows 64 bit:

curl -LO ^
  https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/%VERSION%/apigeectl_windows_64.zip

משנים את השם של ספריית apigeectl/ הנוכחית לשם של ספריית גיבוי. לדוגמה:

Linux

mv $APIGEECTL_HOME/ $APIGEECTL_HOME-v1.10/

Mac OS

mv $APIGEECTL_HOME/ $APIGEECTL_HOME-v1.10/

Windows

rename %APIGEECTL_HOME% %APIGEECTL_HOME%-v1.10

מחלצים את תוכן קובץ ה-gzip שהורד לספריית הבסיס ההיברידית. ספריית הבסיס ההיברידית היא הספרייה שבה נמצאת הספרייה apigeectl-v1.10 ששמה שונה:
Linux
```
tar xvzf filename.tar.gz -C ./
```
Mac OS
```
tar xvzf filename.tar.gz -C ./
```
Windows
```
tar xvzf filename.zip -C ./
```
כברירת מחדל, התוכן של קובץ ה-tar מורחב לספרייה עם הגרסה והפלטפורמה בשם שלה. לדוגמה: ./apigeectl_1.11.2-xxxxxxx_linux_64. משנים את שם הספרייה ל-apigeectl באמצעות הפקודה הבאה:
Linux
```
mv apigeectl_1.11.2-xxxxxxx_linux_64 apigeectl
```
Mac OS
```
mv apigeectl_1.11.2-xxxxxxx_mac_64 apigeectl
```
Windows
```
rename apigeectl_1.11.2-xxxxxxx_windows_64 apigeectl
```
עוברים לספרייה apigeectl:
```
cd ./apigeectl
```
הספרייה הזו היא ספריית הבית apigeectl. זה המקום שבו נמצאת הפקודה להפעלה apigeectl.
בהוראות האלה נעשה שימוש במשתנה הסביבה $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%
```
כדי לוודא את הגרסה של apigeectl, מריצים את הפקודה version:
```
./apigeectl version
```
```
Version: 1.11.2
```
יוצרים ספרייה בשם hybrid-base-directory/hybrid-files ומעבירים אליה את הקובץ. בספרייה hybrid-files נמצאים קובצי תצורה כמו קובץ ההחלפות, האישורים וחשבונות השירות. לדוגמה:
Linux
```
mkdir $APIGEECTL_HOME/../hybrid-files
```
```
cd $APIGEECTL_HOME/../hybrid-files
```
Mac OS
```
mkdir $APIGEECTL_HOME/../hybrid-files
```
```
cd $APIGEECTL_HOME/../hybrid-files
```
Windows
```
mkdir %APIGEECTL_HOME%/../hybrid-files
```
```
cd %APIGEECTL_HOME%/../hybrid-files
```
מריצים את הפקודה הבאה כדי לוודא שההקשר הנכון מוגדר ל-kubectl. ההקשר הנוכחי צריך להיות מוגדר לאשכול שבו משדרגים את Apigee hybrid.
```
kubectl config get-contexts | grep \*
```
בספרייה 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
```
מבצעים הפעלה ללא שינוי כדי לבדוק אם יש שגיאות:
```
${APIGEECTL_HOME}/apigeectl init -f OVERRIDES_FILE --dry-run=client
```
כאשר OVERRIDES_FILE הוא שם קובץ ההגדרות שלכם, למשל ./overrides/overrides.yaml.

טיפ: אפשר להחליף את OVERRIDES_FILE בקוד לדוגמה שלמעלה בשם ובנתיב של קובץ ההחלפות, וכל מופע בדף הזה יוחלף.
אם אין שגיאות, מאתחלים את hybrid 1.11.2:
```
$APIGEECTL_HOME/apigeectl init -f OVERRIDES_FILE
```
הערה: הפקודה apigeectl init מתקינה ומגדירה את שער הכניסה של Apigee כשמריצים את apigeectl.
בודקים את סטטוס ההפעלה:
```
$APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE
```
אם הפעולה בוצעה ללא שגיאות, הפלט ייראה כך: All containers ready.
```
kubectl describe apigeeds -n apigee
```
בפלט, מחפשים את State: running.
כדי לבדוק אם יש שגיאות, מריצים הרצה יבשה של הפקודה apply באמצעות הדגל --dry-run:
```
$APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE --dry-run=client
```
אם אין שגיאות, מחילים את שינויי ברירת המחדל. בוחרים את ההוראות לסביבות ייצור או לסביבות שאינן סביבות ייצור, בהתאם להתקנה.
ייצור

בסביבות ייצור, צריך לשדרג כל רכיב היברידי בנפרד ולבדוק את הסטטוס של הרכיב המשודרג לפני שממשיכים לרכיב הבא.
1. חשוב לוודא שאתם נמצאים בספרייה hybrid-files.
2. מחילים את ההחלפות כדי לשדרג את Cassandra:
  $APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE --datastore
3. השלמת הבדיקה:
  $APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE
  טיפ: אם הפקודה check-ready נכשלת, אפשר לקבל מידע נוסף על ה-pods באמצעות הפקודה:
  kubectl -n NAMESPACE get pods
  
  כאשר NAMESPACE הוא מרחב השמות של Apigee Hybrid.
  ממשיכים לשלב הבא רק כשהפודים מוכנים.
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.11.2-hotfix.3

כדי לאפשר ל-runtime להשתמש בתג הנכון, 1.11.2-hotfix.3, צריך לבצע את השינוי הבא בקובץ overrides.yaml:
```
runtime:
  image:
    url: "gcr.io/apigee-release/hybrid/apigee-runtime"
    tag: "1.11.2-hotfix.3"
```
הערות המוצר של Apigee 1.11.2-hotfix.3
מתקינים את התיקון הדחוף באמצעות apigeectl init עם קובץ ההחלפות המעודכן.
הרצת בדיקה:
```
${APIGEECTL_HOME}/apigeectl init -f OVERRIDES_FILE --dry-run=client
```
הפעלה:
```
${APIGEECTL_HOME}/apigeectl init -f OVERRIDES_FILE
```

מחילים את התיקון המהיר באמצעות apigeectl apply.

הרצת בדיקה:

${APIGEECTL_HOME}/apigeectl apply -f OVERRIDES_FILE --all-envs --dry-run=client

החלה על:

${APIGEECTL_HOME}/apigeectl apply -f OVERRIDES_FILE --all-envs

אימות המדיניות אחרי שדרוג לגרסה 1.11.2-hotfix.3

אפשר להשתמש בהליך הזה כדי לאמת את ההתנהגות של מדיניות JavaCallout אחרי שמשדרגים ל-Hybrid 1.11.2-hotfix.3.

בודקים אם קובצי ה-Java JAR מבקשים הרשאות מיותרות.
אחרי פריסת המדיניות, בודקים ביומני זמן הריצה אם מופיעה הודעת היומן הבאה: "Failed to load and initialize class ...". אם ההודעה הזו מופיעה, סימן שקובץ ה-JAR שנפרס ביקש הרשאות מיותרות. כדי לפתור את הבעיה, צריך לבדוק את קוד ה-Java ולעדכן את קובץ ה-JAR.
בודקים ומעדכנים את קוד Java.
בודקים את קוד ה-Java (כולל יחסי תלות) כדי לזהות את הסיבה לפעולות שאולי לא מותרות. אם נמצא, משנים את קוד המקור לפי הצורך.
בדיקת מדיניות עם הפעלת בדיקת האבטחה.
בסביבה שאינה סביבת ייצור, מפעילים את סימון בדיקת האבטחה ומפרסים מחדש את המדיניות עם קובץ JAR מעודכן. כדי להגדיר את הסימון:
- בקובץ apigee-env/values.yaml, מגדירים את conf_security-secure.constructor.only לערך true בקטע runtime:cwcAppend:. לדוגמה:
```
# Apigee Runtime
runtime:
  cwcAppend:
    conf_security-secure.constructor.only: true
```
- כדי להחיל את השינוי, צריך לעדכן את התרשים apigee-env של הסביבה. לדוגמה:
```
helm upgrade ENV_RELEASE_NAME apigee-env/ \
  --install \
  --namespace APIGEE_NAMESPACE \
  --set env=ENV_NAME \
  -f OVERRIDES_FILE
```
אם הודעת היומן "Failed to load and initialize class ..." עדיין מופיעה, ממשיכים לשנות ולבדוק את קובץ ה-JAR עד שהודעת היומן לא מופיעה יותר.
הפעלת בדיקת האבטחה בסביבת הייצור.
אחרי שבודקים ומאמתים את קובץ ה-JAR בסביבה שאינה סביבת ייצור, מפעילים את בדיקת האבטחה בסביבת הייצור על ידי הגדרת הדגל conf_security-secure.constructor.only לערך true ועדכון התרשים apigee-env בסביבת הייצור כדי להחיל את השינוי.

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

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

Helm

כדי לחזור לגרסה הקודמת, משתמשים בתרשימים ובקובץ ההחלפות מההתקנה הקודמת.

יוצרים את משתנה הסביבה הבא:
- ‫PREVIOUS_HELM_CHARTS_HOME: הספרייה שבה מותקנים תרשימי ה-Helm הקודמים של Apigee Hybrid. זו הגרסה שאליה חוזרים.
מחזירים את המארחים הווירטואליים לגרסה קודמת. חוזרים על הפקודה הבאה לכל קבוצת סביבות שמוזכרת בקובץ ההגדרות.
```
helm upgrade ENV_GROUP_RELEASE_NAME $PREVIOUS_HELM_CHARTS_HOME/apigee-virtualhost/ \
  --namespace apigee \
  --atomic \
  --set envgroup=ENV_GROUP_NAME \
  -f PREVIOUS_OVERRIDES_FILE
```
‫ENV_GROUP_RELEASE_NAME הוא השם שבו התקנתם בעבר את תרשים apigee-virtualhost. ב-hybrid v1.10, בדרך כלל זה הנתיב apigee-virtualhost-ENV_GROUP_NAME. ב-Hybrid v1.11 ובגרסאות חדשות יותר, בדרך כלל מדובר ב-ENV_GROUP_NAME.
מבטלים את השינויים בסביבות. חוזרים על הפקודה הבאה לכל סביבה שמוזכרת בקובץ הביטולים.
```
helm upgrade apigee-env-ENV_NAME $PREVIOUS_HELM_CHARTS_HOME/apigee-env/ \
  --install \
  --namespace apigee \
  --atomic \
  --set env=ENV_NAME \
  -f PREVIOUS_OVERRIDES_FILE
```
‫ENV_RELEASE_NAME הוא השם שבו התקנתם בעבר את תרשים apigee-env. ב-hybrid v1.10, בדרך כלל זה הנתיב apigee-env-ENV_NAME. ב-Hybrid v1.11 ובגרסאות חדשות יותר, בדרך כלל מדובר ב-ENV_NAME.

החזרה של הארגון לגרסה קודמת:

helm upgrade ORG_NAME $PREVIOUS_HELM_CHARTS_HOME/apigee-org/ \
  --install \
  --namespace apigee \
  --atomic \
  -f PREVIOUS_OVERRIDES_FILE

מחזירים את Ingress Manager למצב קודם:

helm upgrade ingress-manager $PREVIOUS_HELM_CHARTS_HOME/apigee-ingress-manager/ \
  --install \
  --namespace apigee \
  --atomic \
  -f PREVIOUS_OVERRIDES_FILE

החזרה לגרסה קודמת של Redis:

helm upgrade redis $PREVIOUS_HELM_CHARTS_HOME/apigee-redis/ \
  --install \
  --namespace apigee \
  --atomic \
  -f PREVIOUS_OVERRIDES_FILE

החזרה לגרסה קודמת של Apigee Telemetry:

helm upgrade telemetry $PREVIOUS_HELM_CHARTS_HOME/apigee-telemetry/ \
  --install \
  --namespace apigee \
  --atomic \
  -f PREVIOUS_OVERRIDES_FILE

מבטלים את השינויים ב-Apigee Datastore (רכיב מסד הנתונים של Cassandra):

helm upgrade datastore $PREVIOUS_HELM_CHARTS_HOME/apigee-datastore/ \
  --install \
  --namespace apigee \
  --atomic \
  -f PREVIOUS_OVERRIDES_FILE

מחזירים את Apigee Controller לגרסה קודמת:

helm upgrade operator $PREVIOUS_HELM_CHARTS_HOME/apigee-operator/ \
  --install \
  --namespace apigee-system \
  --atomic \
  -f PREVIOUS_OVERRIDES_FILE

מחזירים את ה-CRD של Apigee Hybrid למצב קודם:

  kubectl apply -k  $PREVIOUS_HELM_CHARTS_HOME/apigee-operator/etc/crds/default/ --server-side --force-conflicts --validate=false

`apigeectl`

מנקים את המשימות שהושלמו במרחב השמות של זמן הריצה ההיברידי, כאשר NAMESPACE הוא מרחב השמות שצוין בקובץ ההחלפות, אם צוין מרחב שמות. אם לא, מרחב השמות שמוגדר כברירת מחדל הוא apigee:
```
kubectl delete job -n NAMESPACE \
  $(kubectl get job -n NAMESPACE \
  -o=jsonpath='{.items[?(@.status.succeeded==1)].metadata.name}')
```

ניקוי משימות שהושלמו במרחב השמות apigee-system:

kubectl delete job -n apigee-system \
  $(kubectl get job -n apigee-system \
  -o=jsonpath='{.items[?(@.status.succeeded==1)].metadata.name}')

משנים את המשתנה APIGEECTL_HOME כך שיצביע על הספרייה שמכילה את הגרסה הקודמת של apigeectl. לדוגמה:
```
export APIGEECTL_HOME=PATH_TO_PREVIOUS_APIGEECTL_DIRECTORY
```
מריצים את הפקודות הבאות בספריית הבסיס של ההתקנה שרוצים לחזור אליה. חשוב להשתמש בקובץ המקורי של ההגדרות שבוטלו עבור הגרסה שאליה רוצים לחזור:
1. בספרייה hybrid-files, מריצים את apigeectl apply:
```
$APIGEECTL_HOME/apigeectl apply -f ORIGINAL_OVERRIDES_FILE
```
  ‫ORIGINAL_OVERRIDES_FILE הוא הנתיב היחסי ושם הקובץ של קובץ ההחלפות להתקנה ההיברידית של הגרסה הקודמת, לדוגמה, ./overrides/overrides1.10.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
```

שדרוג Apigee Hybrid לגרסה 1.11 קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.

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

ב-Hyrid 1.11.2-Hotfix.3 יש בדיקות מחמירות יותר של יצירת מופע של מחלקה.

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

תרשימי Helm ו-apigeectl

מעבר לגרסה 1.11 באמצעות Helm מגרסה 1.10 באמצעות apigeectl

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

גיבוי של ההתקנה ההיברידית (מומלץ)

Helm

Linux

Mac OS

Windows

Prod

Non-prod

apigeectl

Linux

Mac OS

Windows

שדרוג גרסת Kubernetes

כאן אפשר ללחוץ כדי להרחיב את רשימת הפלטפורמות הנתמכות

רכיבים

מידע על אשכולות מצורפים

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

Helm

הכנה לשדרוג של תרשימי Helm

התקנה של תרשימי Helm של Apigee Hybrid

התקנה של 1.11.2-hotfix.3

apigeectl

Linux

Mac OS

Windows

Linux

Mac OS

Windows

Linux

Mac OS

Windows

Linux

Mac OS

Windows

Linux

Mac OS

Windows

Linux

Mac OS

Windows

Linux

Mac OS

Windows

ייצור

Non-prod

התקנה של 1.11.2-hotfix.3

אימות המדיניות אחרי שדרוג לגרסה 1.11.2-hotfix.3

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

Helm

apigeectl

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

תרשימי Helm ו-`apigeectl`

מעבר לגרסה 1.11 באמצעות Helm מגרסה 1.10 באמצעות `apigeectl`

`apigeectl`

`apigeectl`

`apigeectl`