ההליך הזה כולל שדרוג מגרסה 1.13.x של Apigee Hybrid לגרסה 1.14.10 של Apigee Hybrid, ומגרסאות קודמות של Apigee Hybrid 1.14.x לגרסה 1.14.10.
השתמשו באותם תהליכים לשדרוג גרסאות משניות (לדוגמה, מגרסה 1.13 לגרסה 1.14) ולשדרוג גרסאות תיקון (לדוגמה, מגרסה 1.4.3 לגרסה 1.14.10).
אם אתם משדרגים מגרסה 1.12 או גרסה ישנה יותר של Apigee Hybrid, קודם אתם צריכים לשדרג לגרסה 1.13 ורק אחר כך לגרסה 1.14.10. איך משדרגים את Apigee Hybrid לגרסה 1.13
שינויים מגרסה 1.13 של Apigee Hybrid
חשוב לשים לב לשינויים הבאים:
- עמלות קבועות למונטיזציה: החל מגרסה 1.14.3, Apigee hybrid תומך בעמלות קבועות למונטיזציה. מידע נוסף זמין במאמר הפעלת מונטיזציה ב-Apigee hybrid.
- תווים כלליים לחיפוש (*) בנתיבי בסיס של שרתי proxy: החל מגרסה 1.14.3, יש תמיכה בשימוש בתווים כלליים לחיפוש בנתיבי בסיס של שרתי proxy ב-Apigee. כדי ליישם את השינוי הזה, צריך לפעול לפי ההליך שמפורט בבעיה הידועה 378686709.
- פייפליין נתונים חדש: החל מגרסה 1.14, רכיבי מישור הנתונים כותבים נתונים ישירות למישור הבקרה כברירת מחדל. כך אפשר לשפר את האמינות והתאימות של נתוני ניתוח הנתונים וניפוי הבאגים. מידע נוסף זמין במאמר הגדרת Apigee Hybrid לשימוש בצינור עיבוד הנתונים החדש.
- Anthos (בשרת פיזי או ב-VMware) נקרא עכשיו Google Distributed Cloud (לשרת פיזי או ל-VMware): מידע נוסף זמין בסקירות הכלליות של המוצרים Google Distributed Cloud לשרת פיזי ו-Google Distributed Cloud ל-VMware.
- בדיקות מחמירות יותר של יצירת מופעים של מחלקות: החל מגרסה 1.14.1 של Apigee Hybrid, מדיניות JavaCallout כוללת עכשיו אבטחה נוספת במהלך יצירת מופעים של מחלקות Java. אמצעי האבטחה המשופר מונע פריסה של כללי מדיניות שמנסים, באופן ישיר או עקיף, לבצע פעולות שדורשות הרשאות שאסורות.
ברוב המקרים, כללי המדיניות הקיימים ימשיכו לפעול כצפוי ללא בעיות. עם זאת, יכול להיות שיושפעו כללי מדיניות שמסתמכים על ספריות של צד שלישי, או כללי מדיניות עם קוד בהתאמה אישית שמפעיל באופן עקיף פעולות שדורשות הרשאות מתקדמות.
מידע נוסף על התכונות בגרסה 1.14 של Apigee Hybrid זמין בנתוני הגרסה של Apigee Hybrid גרסה 1.14.0.
דרישות מוקדמות
לפני שמשדרגים לגרסה 1.14 של Apigee Hybrid, צריך לוודא שההתקנה עומדת בדרישות הבאות:
- אם בהתקנה ההיברידית פועלת גרסה ישנה יותר מ-v1.13, צריך לשדרג לגרסה 1.13 לפני השדרוג ל-v1.14. שדרוג Apigee Hybrid לגרסה 1.13
- Helm בגרסה 3.14.2 ומעלה.
-
kubectl: גרסה נתמכת שלkubectlשמתאימה לגרסת פלטפורמת Kubernetes. מידע נוסף זמין במאמר פלטפורמות וגרסאות נתמכות:kubectl. - cert-manager: גרסה נתמכת של cert-manager. פלטפורמות וגרסאות נתמכות: cert-manager אם צריך, תשדרגו את cert-manager בקטע הכנה לשדרוג לגרסה 1.14 שבהמשך.
לפני שמשדרגים לגרסה 1.14.10 – מגבלות והערות חשובות
בגרסה 1.14.10 של Apigee Hybrid יש מגבלה חדשה ומשופרת על מספר שרתי ה-proxy לכל סביבה, שמאפשרת לפרוס יותר שרתי proxy ותהליכים משותפים בסביבה אחת. במאמר מגבלות: שרתי proxy ל-API מוסברות המגבלות על מספר שרתי ה-proxy והתהליכים המשותפים שאפשר לפרוס בכל סביבה. התכונה הזו זמינה רק בארגונים היברידיים חדשים, ואי אפשר להחיל אותה על ארגונים משודרגים. כדי להשתמש בתכונה הזו, צריך להתקין מחדש את גרסה 1.14.10 של Hybrid וליצור ארגון חדש.
התכונה הזו זמינה רק כחלק מתוכנית המינויים של 2024, וכפופה להרשאות שניתנות במסגרת המינוי הזה. מידע נוסף על התכונה הזו זמין במאמר מגבלות משופרות על שרתי proxy לכל סביבה.
יכול להיות ששדרוג לגרסה 1.14 של Apigee Hybrid ידרוש זמן השבתה.
כשמשדרגים את בקר Apigee לגרסה 1.14.10, כל פריסות Apigee עוברות הפעלה מחדש הדרגתית. כדי לצמצם את זמן ההשבתה בסביבות ייצור היברידיות במהלך הפעלה מחדש הדרגתית, ודאו שאתם מפעילים לפחות שני אשכולות (באותו אזור או מרכז נתונים, או באזורים או מרכזי נתונים שונים). העבירו את כל תנועת הייצור לאשכול אחד, העבירו את האשכול שאתם עומדים לשדרג למצב אופליין, ואז המשיכו בתהליך השדרוג. חוזרים על התהליך בכל אשכול.
מומלץ לשדרג את כל האשכולות בהקדם האפשרי אחרי שמתחילים את השדרוג, כדי לצמצם את הסיכויים לפגיעה בסביבת הייצור. אין מגבלת זמן לשדרוג של כל האשכולות שנותרו אחרי שדרוג האשכול הראשון. עם זאת, עד שכל האשכולות הנותרים ישודרגו, אי אפשר יהיה לגבות ולשחזר את Cassandra בגרסאות מעורבות. לדוגמה, אי אפשר להשתמש בגיבוי מגרסה 1.13 של Hybrid כדי לשחזר מכונה של גרסה 1.14 של Hybrid.
לא צריך להשעות לגמרי את השינויים במישור הניהול במהלך השדרוג. אם נדרשות השעיות זמניות לשינויים במישור הניהול, הן מצוינות בהוראות השדרוג שבהמשך.
סקירה כללית של השדרוג לגרסה 1.14.10
ההליכים לשדרוג Apigee Hybrid מאורגנים בקטעים הבאים:
הכנה לשדרוג לגרסה 1.14
גיבוי ההתקנה ההיברידית
- בהוראות האלה משתמשים במשתנה הסביבה APIGEE_HELM_CHARTS_HOME לספרייה במערכת הקבצים שבה התקנתם את תרשימי Helm. אם צריך, משנים את הספרייה לספרייה הזו ומגדירים את המשתנה באמצעות הפקודה הבאה:
Linux
export APIGEE_HELM_CHARTS_HOME=$PWD
echo $APIGEE_HELM_CHARTS_HOMEMac OS
export APIGEE_HELM_CHARTS_HOME=$PWD
echo $APIGEE_HELM_CHARTS_HOMEWindows
set APIGEE_HELM_CHARTS_HOME=%CD%
echo %APIGEE_HELM_CHARTS_HOME% - יוצרים עותק גיבוי של הספרייה
$APIGEE_HELM_CHARTS_HOME/בגרסה 1.13. אתם יכולים להשתמש בכל תהליך גיבוי. לדוגמה, אפשר ליצור קובץtarשל כל הספרייה באמצעות:tar -czvf $APIGEE_HELM_CHARTS_HOME/../apigee-helm-charts-v1.13-backup.tar.gz $APIGEE_HELM_CHARTS_HOME - מגבים את מסד הנתונים של Cassandra לפי ההוראות במאמר גיבוי ושחזור של Cassandra.
- אם אתם משתמשים בקובצי אישורים של שירות (
.json) בשינויים כדי לאמת חשבונות שירות, ודאו שקובצי האישורים של חשבון השירות נמצאים בספרייה הנכונה של תרשים Helm. תרשימי Helm לא יכולים לקרוא קבצים מחוץ לספרייה של כל תרשים.לא צריך לבצע את השלב הזה אם משתמשים בסודות של Kubernetes או ב-Workload Identity כדי לאמת חשבונות שירות.
בטבלה הבאה מוצג היעד של כל קובץ של חשבון שירות, בהתאם לסוג ההתקנה:
Prod
חשבון שירות שם הקובץ שמוגדר כברירת מחדל ספריית תרשימי Helm apigee-cassandraPROJECT_ID-apigee-cassandra.json$APIGEE_HELM_CHARTS_HOME/apigee-datastore/apigee-loggerPROJECT_ID-apigee-logger.json$APIGEE_HELM_CHARTS_HOME/apigee-telemetry/apigee-martPROJECT_ID-apigee-mart.json$APIGEE_HELM_CHARTS_HOME/apigee-org/apigee-metricsPROJECT_ID-apigee-metrics.json$APIGEE_HELM_CHARTS_HOME/apigee-telemetry/apigee-runtimePROJECT_ID-apigee-runtime.json$APIGEE_HELM_CHARTS_HOME/apigee-envapigee-synchronizerPROJECT_ID-apigee-synchronizer.json$APIGEE_HELM_CHARTS_HOME/apigee-env/apigee-udcaPROJECT_ID-apigee-udca.json$APIGEE_HELM_CHARTS_HOME/apigee-org/apigee-watcherPROJECT_ID-apigee-watcher.json$APIGEE_HELM_CHARTS_HOME/apigee-org/לא בסביבת ייצור
יוצרים עותק של קובץ חשבון השירות
apigee-non-prodבכל אחת מהספריות הבאות:חשבון שירות שם הקובץ שמוגדר כברירת מחדל ספריות של תרשימי Helm apigee-non-prodPROJECT_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/.
שדרוג גרסת Kubernetes
בודקים את גרסת פלטפורמת Kubernetes, ואם צריך, משדרגים אותה לגרסה שנתמכת גם ב-hybrid 1.13 וגם ב-hybrid 1.14. אם אתם צריכים עזרה, כדאי לעיין במאמרי העזרה של הפלטפורמה.
התקנת סביבת זמן הריצה של Apigee Hybrid בגרסה 1.14.10
מגדירים את צינור עיבוד הנתונים לאיסוף נתונים.
החל מגרסה 1.14 של Apigee Hybrid, פייפליין חדש לניתוח נתונים ולניפוי באגים מופעל כברירת מחדל בכל הארגונים ב-Apigee Hybrid. כדי להגדיר את תהליך ההרשאה, צריך לפעול לפי השלבים שמפורטים בקטע הפעלת גישה של בעל תוכן דיגיטלי ל-Analytics.
הכנה לשדרוג של תרשימי Helm
- מורידים את תרשימי Apigee Helm.
תרשימי Apigee Hybrid מתארחים ב-Google Artifact Registry:
oci://us-docker.pkg.dev/apigee-release/apigee-hybrid-helm-chartsמשתמשים בפקודה
pullכדי להעתיק את כל תרשימי ה-Helm של Apigee Hybrid לאחסון המקומי:export CHART_REPO=oci://us-docker.pkg.dev/apigee-release/apigee-hybrid-helm-charts
export CHART_VERSION=1.14.10helm pull $CHART_REPO/apigee-operator --version $CHART_VERSION --untarhelm pull $CHART_REPO/apigee-datastore --version $CHART_VERSION --untarhelm pull $CHART_REPO/apigee-env --version $CHART_VERSION --untarhelm pull $CHART_REPO/apigee-ingress-manager --version $CHART_VERSION --untarhelm pull $CHART_REPO/apigee-org --version $CHART_VERSION --untarhelm pull $CHART_REPO/apigee-redis --version $CHART_VERSION --untarhelm pull $CHART_REPO/apigee-telemetry --version $CHART_VERSION --untarhelm 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.16.3/cert-manager.yaml
רשימת הגרסאות הנתמכות מופיעה במאמר פלטפורמות וגרסאות נתמכות: cert-manager.
- אם מרחב השמות של Apigee הוא לא
apigee, עורכים את הקובץapigee-operator/etc/crds/default/kustomization.yamlומחליפים את הערךnamespaceבמרחב השמות של Apigee.apiVersion: kustomize.config.k8s.io/v1beta1 kind: Kustomization namespace: APIGEE_NAMESPACE
אם אתם משתמשים ב-
apigeeכמרחב השמות, אתם לא צריכים לערוך את הקובץ. - מתקינים את ה-CRD המעודכנים של Apigee:
-
משתמשים בתכונה "הרצה ללא שמירה" של
kubectlבאמצעות הפקודה הבאה:kubectl apply -k apigee-operator/etc/crds/default/ --server-side --force-conflicts --validate=false --dry-run=server
-
אחרי האימות באמצעות הפקודה 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 2024-08-21T14:48:30Z apigeedeployments.apigee.cloud.google.com 2024-08-21T14:48:30Z apigeeenvironments.apigee.cloud.google.com 2024-08-21T14:48:31Z apigeeissues.apigee.cloud.google.com 2024-08-21T14:48:31Z apigeeorganizations.apigee.cloud.google.com 2024-08-21T14:48:32Z apigeeredis.apigee.cloud.google.com 2024-08-21T14:48:33Z apigeerouteconfigs.apigee.cloud.google.com 2024-08-21T14:48:33Z apigeeroutes.apigee.cloud.google.com 2024-08-21T14:48:33Z apigeetelemetries.apigee.cloud.google.com 2024-08-21T14:48:34Z cassandradatareplications.apigee.cloud.google.com 2024-08-21T14:48:35Z
-
-
בודקים את התוויות בצמתים של האשכול. כברירת מחדל, Apigee מתזמן פודים של נתונים בצמתים עם התווית
cloud.google.com/gke-nodepool=apigee-dataופודים של זמן ריצה בצמתים עם התוויתcloud.google.com/gke-nodepool=apigee-runtime. אפשר להתאים אישית את התוויות של מאגר הצמתים בקובץoverrides.yaml.מידע נוסף זמין במאמר הגדרת מאגרי צמתים ייעודיים.
התקנת תרשימי Helm של Apigee Hybrid
- אם לא, עוברים לספרייה
APIGEE_HELM_CHARTS_HOME. מריצים את הפקודות הבאות מהספרייה הזו. - משדרגים את Apigee Operator/Controller:
הרצת בדיקה:
helm upgrade operator apigee-operator/ \ --install \ --namespace APIGEE_NAMESPACE \ -f OVERRIDES_FILE \ --dry-run=server
משדרגים את התרשים:
helm upgrade operator apigee-operator/ \ --install \ --namespace APIGEE_NAMESPACE \ -f OVERRIDES_FILE
אימות ההתקנה של Apigee Operator:
helm ls -n APIGEE_NAMESPACE
NAME NAMESPACE REVISION UPDATED STATUS CHART APP VERSION operator apigee 3 2024-08-21 00:42:44.492009 -0800 PST deployed apigee-operator-1.14.10 1.14.10
כדי לוודא שהיא פועלת, בודקים את הזמינות שלה:
kubectl -n APIGEE_NAMESPACE 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_NAMESPACE \ -f OVERRIDES_FILE \ --dry-run=server
משדרגים את התרשים:
helm upgrade datastore apigee-datastore/ \ --install \ --namespace APIGEE_NAMESPACE \ -f OVERRIDES_FILE
כדי לוודא ש-
apigeedatastoreפועל, בודקים את המצב שלו:kubectl -n APIGEE_NAMESPACE get apigeedatastore default
NAME STATE AGE default running 2d
- שדרוג הטלמטריה של Apigee:
הרצת בדיקה:
helm upgrade telemetry apigee-telemetry/ \ --install \ --namespace APIGEE_NAMESPACE \ -f OVERRIDES_FILE \ --dry-run=server
משדרגים את התרשים:
helm upgrade telemetry apigee-telemetry/ \ --install \ --namespace APIGEE_NAMESPACE \ -f OVERRIDES_FILE
כדי לוודא שהיא פועלת, בודקים את המצב שלה:
kubectl -n APIGEE_NAMESPACE get apigeetelemetry apigee-telemetry
NAME STATE AGE apigee-telemetry running 2d
- שדרוג של Apigee Redis:
הרצת בדיקה:
helm upgrade redis apigee-redis/ \ --install \ --namespace APIGEE_NAMESPACE \ -f OVERRIDES_FILE \ --dry-run=server
משדרגים את התרשים:
helm upgrade redis apigee-redis/ \ --install \ --namespace APIGEE_NAMESPACE \ -f OVERRIDES_FILE
כדי לוודא שהיא פועלת, בודקים את המצב שלה:
kubectl -n APIGEE_NAMESPACE get apigeeredis default
NAME STATE AGE default running 2d
- שדרוג מנהל ה-ingress של Apigee:
הרצת בדיקה:
helm upgrade ingress-manager apigee-ingress-manager/ \ --install \ --namespace APIGEE_NAMESPACE \ -f OVERRIDES_FILE \ --dry-run=server
משדרגים את התרשים:
helm upgrade ingress-manager apigee-ingress-manager/ \ --install \ --namespace APIGEE_NAMESPACE \ -f OVERRIDES_FILE
כדי לוודא שהיא פועלת, בודקים את הזמינות שלה:
kubectl -n APIGEE_NAMESPACE 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_NAMESPACE \ -f OVERRIDES_FILE \ --dry-run=server
משדרגים את התרשים:
helm upgrade ORG_NAME apigee-org/ \ --install \ --namespace APIGEE_NAMESPACE \ -f OVERRIDES_FILE
כדי לוודא שהיא פועלת, בודקים את המצב של הארגון הרלוונטי:
kubectl -n APIGEE_NAMESPACE get apigeeorg
NAME STATE AGE apigee-org1-xxxxx running 2d
- משדרגים את הסביבה.
צריך להתקין סביבה אחת בכל פעם. מציינים את הסביבה באמצעות
--set env=ENV_NAME.הרצת בדיקה:
helm upgrade ENV_RELEASE_NAME apigee-env/ \ --install \ --namespace APIGEE_NAMESPACE \ --set env=ENV_NAME \ -f OVERRIDES_FILE \ --dry-run=server
- ENV_RELEASE_NAME הוא שם שמשמש למעקב אחרי ההתקנה והשדרוגים של התרשים
apigee-env. השם הזה חייב להיות ייחודי ושונה משמות אחרים של גרסאות Helm בהתקנה. בדרך כלל, זוהי כתובת ה-URL הסופית שלENV_NAME. עם זאת, אם לסביבה יש שם זהה לזה של קבוצת הסביבות, צריך להשתמש בשמות שונים לגרסאות של הסביבה ושל קבוצת הסביבות, למשלdev-env-releaseו-dev-envgroup-release. מידע נוסף על גרסאות ב-Helm זמין במאמר Three big concepts class="external" במרכז העזרה של Helm. - ENV_NAME הוא שם הסביבה שמשדרגים.
- OVERRIDES_FILE הוא קובץ ההגדרות החדש שלך לגרסה 1.14.10
משדרגים את התרשים:
helm upgrade ENV_RELEASE_NAME apigee-env/ \ --install \ --namespace APIGEE_NAMESPACE \ --set env=ENV_NAME \ -f OVERRIDES_FILE
כדי לוודא שהיא פועלת, בודקים את המצב של הסביבה הרלוונטית:
kubectl -n APIGEE_NAMESPACE get apigeeenv
NAME STATE AGE GATEWAYTYPE apigee-org1-dev-xxx running 2d
- ENV_RELEASE_NAME הוא שם שמשמש למעקב אחרי ההתקנה והשדרוגים של התרשים
-
משדרגים את קבוצות הסביבות (
virtualhosts).- צריך לשדרג קבוצת סביבות (virtualhost) אחת בכל פעם. מציינים את קבוצת הסביבות באמצעות
--set envgroup=ENV_GROUP_NAME. חוזרים על הפקודות הבאות לכל קבוצת סביבות שמוזכרת בקובץ overrides.yaml:הרצת בדיקה:
helm upgrade ENV_GROUP_RELEASE_NAME apigee-virtualhost/ \ --install \ --namespace APIGEE_NAMESPACE \ --set envgroup=ENV_GROUP_NAME \ -f OVERRIDES_FILE \ --dry-run=server
ENV_GROUP_RELEASE_NAME הוא השם שבו התקנתם בעבר את התרשים
apigee-virtualhost. בדרך כלל זה הנתיב ENV_GROUP_NAME.משדרגים את התרשים:
helm upgrade ENV_GROUP_RELEASE_NAME apigee-virtualhost/ \ --install \ --namespace APIGEE_NAMESPACE \ --set envgroup=ENV_GROUP_NAME \ -f OVERRIDES_FILE
- בודקים את המצב של ApigeeRoute (AR).
התקנת
virtualhostsיוצרת את ApigeeRouteConfig (ARC), שיוצר באופן פנימי את ApigeeRoute (AR) אחרי שה-Apigee watcher שולף פרטים שקשורים לקבוצת הסביבות ממישור הבקרה. לכן, צריך לבדוק שהסטטוס של ה-AR התואם הוא "פועל":kubectl -n APIGEE_NAMESPACE get arc
NAME STATE AGE apigee-org1-dev-egroup 2d
kubectl -n APIGEE_NAMESPACE get ar
NAME STATE AGE apigee-org1-dev-egroup-xxxxxx running 2d
- צריך לשדרג קבוצת סביבות (virtualhost) אחת בכל פעם. מציינים את קבוצת הסביבות באמצעות
- אחרי שמוודאים שכל ההתקנות שודרגו, מוחקים את הגרסה הישנה של
apigee-operatorממרחב השמותapigee-system.- מסירים את הגרסה הישנה של
operator:helm delete operator -n apigee-system
- מוחקים את מרחב השמות
apigee-system:kubectl delete namespace apigee-system
- מסירים את הגרסה הישנה של
- משדרגים שוב את
operatorבמרחב השמות של Apigee כדי להתקין מחדש את המשאבים שנמחקו ברמת האשכול:helm upgrade operator apigee-operator/ \ --install \ --namespace APIGEE_NAMESPACE \ --atomic \ -f overrides.yaml
אימות המדיניות אחרי שדרוג לגרסה 1.14.1
כדי לאמת את ההתנהגות של מדיניות JavaCallout אחרי שדרוג מגרסה 1.14.0 או גרסה קודמת לגרסה 1.14.1 או גרסה מאוחרת יותר, צריך לפעול לפי ההוראות הבאות.
- בודקים אם קובצי ה-JAR של Java מבקשים הרשאות מיותרות.
אחרי פריסת המדיניות, בודקים ביומני זמן הריצה אם מופיעה הודעת היומן הבאה:
"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
ENV_RELEASE_NAME הוא שם שמשמש למעקב אחרי ההתקנה והשדרוגים של תרשים
apigee-env. השם הזה חייב להיות ייחודי ושונה משמות אחרים של גרסאות Helm בהתקנה. בדרך כלל, זוהי כתובת ה-URL הסופית שלENV_NAME. עם זאת, אם לסביבה יש שם זהה לקבוצת הסביבות, צריך להשתמש בשמות שונים לגרסאות של הסביבה ושל קבוצת הסביבות, לדוגמהdev-env-releaseו-dev-envgroup-release. מידע נוסף על גרסאות ב-Helm זמין במאמר Three big concepts class="external" במאמרי העזרה של Helm.
אם הודעת היומן
"Failed to load and initialize class ..."עדיין מופיעה, ממשיכים לשנות ולבדוק את ה-JAR עד שהודעת היומן לא מופיעה יותר. - בקובץ
- הפעלת בדיקת האבטחה בסביבת הייצור.
אחרי שבדקתם ואימתתם ביסודיות את קובץ ה-JAR בסביבה שאינה סביבת ייצור, הפעילו את בדיקת האבטחה בסביבת הייצור על ידי הגדרת הדגל
conf_security-secure.constructor.onlyלערךtrueועדכון תרשים ה-apigee-envשל סביבת הייצור כדי להחיל את השינוי.
חזרה לגרסה קודמת
כדי לחזור לגרסה הקודמת, משתמשים בגרסת התרשים הישנה יותר כדי להחזיר את תהליך השדרוג בסדר הפוך. מתחילים עם apigee-virtualhost וחוזרים אחורה עד apigee-operator, ואז מחזירים את ה-CRD.
- מחזירים את התרשימים למצב הקודם. הפקודות הבאות מניחות שאתם משתמשים בתרשימים מהגרסה הקודמת (v1.13.x).
- מריצים את הפקודה הבאה לכל קבוצת סביבות:
helm upgrade ENV_GROUP_RELEASE_NAME apigee-virtualhost/ \ --install \ --namespace APIGEE_NAMESPACE \ --atomic \ --set envgroup=ENV_GROUP_NAME \ -f 1.13_OVERRIDES_FILE
-
מריצים את הפקודה הבאה לכל סביבה:
helm upgrade ENV_RELEASE_NAME apigee-env/ \ --install \ --namespace APIGEE_NAMESPACE \ --atomic \ --set env=ENV_NAME \ -f 1.13_OVERRIDES_FILE
-
apigee-org:helm upgrade ORG_NAME apigee-org/ \ --install \ --namespace APIGEE_NAMESPACE \ --atomic \ -f 1.13_OVERRIDES_FILE
-
apigee-ingress-manager:helm upgrade ingress-manager apigee-ingress-manager/ \ --install \ --namespace APIGEE_NAMESPACE \ --atomic \ -f 1.13_OVERRIDES_FILE
-
apigee-redis:helm upgrade redis apigee-redis/ \ --install \ --namespace APIGEE_NAMESPACE \ --atomic \ -f 1.13_OVERRIDES_FILE
-
apigee-telemetry:helm upgrade telemetry apigee-telemetry/ \ --install \ --namespace APIGEE_NAMESPACE \ --atomic \ -f 1.13_OVERRIDES_FILE
-
apigee-datastore:helm upgrade datastore apigee-datastore/ \ --install \ --namespace APIGEE_NAMESPACE \ --atomic \ -f 1.13_OVERRIDES_FILE
-
apigee-operator:helm upgrade operator apigee-operator/ \ --install \ --namespace APIGEE_NAMESPACE \ --atomic \ -f 1.13_OVERRIDES_FILE
- מריצים את הפקודה הבאה לכל קבוצת סביבות:
- כדי לחזור לגרסה הקודמת של ה-CRD, מתקינים מחדש את ה-CRD הישנים יותר.
kubectl apply -k apigee-operator/etc/crds/default/ \ --server-side \ --force-conflicts \ --validate=false