ההליך הזה כולל שדרוג מגרסה 1.16.x של Apigee Hybrid לגרסה 1.17.4 של Apigee Hybrid, ומגרסאות קודמות של Apigee Hybrid 1.17.x לגרסה 1.17.4.
השתמשו באותם תהליכים לשדרוג גרסאות משניות (לדוגמה, מגרסה 1.16 לגרסה 1.17) ולשדרוג גרסאות תיקון (לדוגמה, מגרסה 1.17.0 לגרסה 1.17.4).
אם אתם משדרגים מגרסה 1.15 או גרסה ישנה יותר של Apigee Hybrid, קודם אתם צריכים לשדרג לגרסה 1.16 ורק אחר כך לגרסה 1.17.4. איך משדרגים את Apigee Hybrid לגרסה 1.16
שינויים מגרסה 1.16 של Apigee Hybrid
חשוב לשים לב לשינויים הבאים:
- תמיכה ב-Model Context Protocol (MCP): בגרסה 1.17 של Apigee Hybrid נוספה תמיכה ב-Model Context Protocol (MCP), פרוטוקול פתוח שמאפשר לאפליקציות AI אקטיבי להשתמש בממשקי ה-API שלכם ככלים דרך נקודות קצה מנוהלות של MCP. Apigee Hybrid מנתב, מאשר ומאבטח את קריאות ה-API לכלי MCP באותו אופן שבו הוא מנהל את ממשקי ה-API האחרים שלכם, כך שאתם לא צריכים להפעיל או לתחזק שרתי MCP משלכם. מידע נוסף זמין במאמר סקירה כללית של Model Context Protocol (MCP) ב-Apigee ובמדריך למתחילים בנושא MCP.
- רוטציה של אישור CA בסיסי: בגרסה 1.17 של Apigee Hybrid נוספה תמיכה ברוטציה של אישור רשות אישורי הבסיס (CA) שמעגן את האמון בתקשורת TLS בין רכיבי זמן הריצה. עכשיו אפשר להחליף את ה-CA ברמה הבסיסית לפני שהוא פג תוקף, בלי זמן השבתה, באמצעות הליך רוטציה בשלבים. למידע נוסף, קראו את המאמר החלפת אישור ה-CA הבסיסי.
- תמיכה ב-TLS 1.3: בגרסה 1.17 של Apigee Hybrid נוספה תמיכה ב-TLS 1.3, הגרסה האחרונה של פרוטוקול Transport Layer Security. TLS 1.3 מציע לחיצות יד מהירות יותר של חיבורים ואבטחה חזקה יותר בהשוואה לגרסאות קודמות של TLS. למידע על הגדרת TLS בשער הכניסה, קראו את המאמר הגדרת TLS ו-mTLS בשער הכניסה.
- תמיכה בשרת proxy להעברה במדיניות AI: בגרסה 1.17 של Apigee Hybrid נוספה תמיכה בשרת proxy להעברה במדיניות AI, כמו מדיניות Model Armor ומדיניות שמירת נתונים במטמון סמנטי. עכשיו אפשר לנתב שיחות יוצאות שהכללים האלה מבצעים דרך שרת פרוקסי להעברת HTTP, שלא נתמך בגרסאות קודמות של Apigee Hybrid. מידע נוסף זמין במאמר הגדרת שרתי proxy להעברה עבור שרתי proxy ל-API.
- תמיכה בנקודת קצה (endpoint) של Private Service Connect (PSC) במטמון סמנטי: בגרסה 1.17 של Apigee Hybrid נוספה תמיכה בנקודת קצה של Private Service Connect (PSC) לשמירה במטמון סמנטי. עכשיו כללי המדיניות של השמירה במטמון הסמנטי יכולים להגיע לשירותים התומכים שלהם דרך נקודת קצה של Private Service Connect, וכך התנועה הזו נשארת ברשת הפרטית שלכם. מידע נוסף זמין במאמר תחילת העבודה עם כללי מדיניות לשמירה במטמון סמנטי.
מידע נוסף על התכונות בגרסה 1.17 של Apigee Hybrid זמין בנתוני הגרסה של Apigee Hybrid גרסה 1.17.4.
דרישות מוקדמות
לפני שמשדרגים לגרסה 1.17 של Apigee Hybrid, צריך לוודא שההתקנה עומדת בדרישות הבאות:
- אם בהתקנה ההיברידית פועלת גרסה ישנה יותר מ-1.16, צריך לשדרג לגרסה 1.16 לפני השדרוג לגרסה 1.17. מידע נוסף זמין במאמר שדרוג Apigee Hybrid לגרסה 1.16.
- Helm בגרסה 3.14.2 ומעלה.
-
kubectl: גרסה נתמכת שלkubectlשמתאימה לגרסת פלטפורמת Kubernetes. פלטפורמות וגרסאות נתמכות:kubectl - cert-manager: גרסה נתמכת של cert-manager. פלטפורמות וגרסאות נתמכות: cert-manager אם צריך, תשדרגו את cert-manager בקטע הכנה לשדרוג לגרסה 1.17 שבהמשך.
לפני שמשדרגים לגרסה 1.17.4 – מגבלות והערות חשובות
-
בגרסה 1.17.3, סביבת זמן הריצה ממשיכה להשתמש ב-
ApigeeRedis, ואין צורך לשנות את ההגדרות או להתקין את תרשים ה-apigee-valkey. בגרסה 1.17.3 נוספו הפריטים הבאים:- הגדרת המשאב בהתאמה אישית (CRD) של
ApigeeValkey. מתקינים אותו עם הגדרות ה-CRD האחרות בהכנה לשדרוג. - תרשים ה-Helm של
apigee-valkeyומאפייני ההגדרות שלvalkey. - המאפיין
ao.args.valkeyBackend, שערך ברירת המחדל שלו הואfalse. משאירים את הערךfalse.
- הגדרת המשאב בהתאמה אישית (CRD) של
יכול להיות ששדרוג לגרסה 1.17 של Apigee Hybrid ידרוש זמן השבתה.
כשמשדרגים את בקר Apigee לגרסה 1.17.4, כל פריסות Apigee עוברות הפעלה מחדש הדרגתית. כדי לצמצם את זמן ההשבתה בסביבות ייצור היברידיות במהלך הפעלה מחדש הדרגתית, ודאו שאתם מפעילים לפחות שני אשכולות (באותו אזור או מרכז נתונים, או באזורים או מרכזי נתונים שונים). העבירו את כל תנועת הייצור לאשכול אחד, העבירו את האשכול שאתם עומדים לשדרג למצב אופליין, ואז המשיכו בתהליך השדרוג. חוזרים על התהליך בכל אשכול.
אנחנו ממליצים לשדרג את כל האשכולות בהקדם האפשרי אחרי שמתחילים את השדרוג, כדי לצמצם את הסיכויים להשפעה על סביבת הייצור. אין מגבלת זמן לשדרוג של שאר האשכולות אחרי שדרוג האשכול הראשון. עם זאת, עד שכל האשכולות הנותרים ישודרגו, אי אפשר יהיה לגבות ולשחזר את Cassandra בגרסאות מעורבות. לדוגמה, אי אפשר להשתמש בגיבוי מ-Hybrid 1.16 כדי לשחזר מכונה של Hybrid 1.17.
לא צריך להשעות לגמרי את השינויים במישור הניהול במהלך השדרוג. אם נדרשות השעיות זמניות לשינויים במישור הניהול, הן מצוינות בהוראות השדרוג שבהמשך.
סקירה כללית של השדרוג לגרסה 1.17.4
ההליכים לשדרוג Apigee Hybrid מאורגנים בקטעים הבאים:
הכנה לשדרוג לגרסה 1.17
גיבוי ההתקנה ההיברידית
- בהוראות האלה, משתנה הסביבה 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.16. אפשר להשתמש בכל תהליך גיבוי. לדוגמה, אפשר ליצור קובץtarשל כל הספרייה באמצעות:tar -czvf $APIGEE_HELM_CHARTS_HOME/../apigee-helm-charts-v1.16-backup.tar.gz $APIGEE_HELM_CHARTS_HOME - מגבים את מסד הנתונים של Cassandra לפי ההוראות במאמר גיבוי ושחזור של Cassandra.
-
מוודאים שקובצי המפתח ואישור ה-TLS (
.crt,.keyו/או.pem) נמצאים בספרייה$APIGEE_HELM_CHARTS_HOME/apigee-virtualhost/.
שדרוג הגרסה של Kubernetes
בודקים את גרסת פלטפורמת Kubernetes, ואם צריך, משדרגים אותה לגרסה שנתמכת גם ב-hybrid 1.16 וגם ב-hybrid 1.17. אם אתם צריכים עזרה, כדאי לעיין במאמרי העזרה של הפלטפורמה.
מורידים את תרשימי 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-chartsexport CHART_VERSION=1.17.4helm 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
עריכת kustomization.yaml למרחב שמות מותאם אישית של Apigee
אם מרחב השמות של Apigee הוא לא apigee, עורכים את הקובץ apigee-operator/etc/crds/default/kustomization.yaml ומחליפים את הערך namespace במרחב השמות של Apigee.
apiVersion: kustomize.config.k8s.io/v1beta1 kind: Kustomization namespace: APIGEE_NAMESPACE
אם אתם משתמשים ב-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 apigeevalkeys.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.
מידע נוסף זמין במאמר הגדרת מאגרי צמתים ייעודיים.
שדרוג cert-manager
גרסה 1.17 של Apigee Hybrid תומכת בגרסאות 1.16 עד 1.19 של cert-manager. בגרסה 1.18 של cert-manager יש שינוי שיכול לגרום לבעיה בתנועה. בגרסה 1.18 של cert-manager, ערך ברירת המחדל של Certificate.Spec.PrivateKey.rotationPolicy השתנה מ-Never ל-Always. בהתקנות משודרגות של Apigee Hybrid, זה עלול לגרום לבעיה בתנועה. כשמשדרגים לגרסה 1.17 של Apigee Hybrid מגרסה קודמת, צריך לערוך את האישור של apigee-ca כדי לפצות על השינוי הזה, או להשאיר את הגרסה של cert-manager בגרסה 1.17.x או בגרסה קודמת.
לפני שמשדרגים את cert-manager לגרסה 1.18 או 1.19, צריך לערוך את האישור של apigee-ca כדי להגדיר את הערך של Certificate.Spec.PrivateKey.rotationPolicy ל-Never.
-
בודקים את התוכן של האישור
apigee-caכדי לראות אםrotationPolicyמוגדר:kubectl get certificate apigee-ca -n cert-manager -o yaml
מחפשים את הערכים בקטע
spec.privateKeyבפלט:... spec: commonName: apigee-hybrid duration: 87600h isCA: true issuerRef: group: cert-manager.io kind: ClusterIssuer name: apigee-root-certificate-issuer privateKey: algorithm: ECDSA # Note: rotationPolicy would appear here if it is set. size: 256 secretName: apigee-ca ... -
אם
rotationPolicyלא מוגדר או אם הוא מוגדר ל-Always, עורכים את האישורapigee-caכדי להגדיר את הערך שלrotationPolicyל-Never:- קודם מבצעים הרצה יבשה:
kubectl patch Certificate \ --dry-run=server \ -n cert-manager \ --type=json \ -p='[{"op": "replace", "path": "/spec/privateKey/rotationPolicy", "value": "Never"}]' \ -o=yaml \ apigee-ca - מתקנים את האישור:
kubectl patch Certificate \ -n cert-manager \ --type=json \ -p='[{"op": "replace", "path": "/spec/privateKey/rotationPolicy", "value": "Never"}]' \ -o=yaml \ apigee-ca
- קודם מבצעים הרצה יבשה:
-
מוודאים שהערך של
rotationPolicyמוגדר עכשיו כ-Never:kubectl get certificate apigee-ca -n cert-manager -o yaml
הפלט אמור להיראות כך:
... spec: commonName: apigee-hybrid duration: 87600h isCA: true issuerRef: group: cert-manager.io kind: ClusterIssuer name: apigee-root-certificate-issuer privateKey: algorithm: ECDSA rotationPolicy: Never size: 256 secretName: apigee-ca ... -
משדרגים את cert-manager. הפקודה הבאה תוריד ותתקין את cert-manager בגרסה 1.19.2:
kubectl apply -f https://github.com/cert-manager/cert-manager/releases/download/v1.19.2/cert-manager.yaml
רשימת הגרסאות הנתמכות מופיעה במאמר פלטפורמות וגרסאות נתמכות: cert-manager.
אפשר לעיין במאמרים הבאים:
- בעיה מוכרת 465834046
- גרסה 1.18 של cert-manager: ערך ברירת המחדל של
Certificate.Spec.PrivateKey.rotationPolicyהוא עכשיוAlways
התקנת סביבת זמן הריצה של Apigee Hybrid בגרסה 1.17.4
- אם לא, עוברים לספרייה
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.17.4 1.17.4
כדי לוודא שהיא פועלת, בודקים את הזמינות שלה:
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
- שדרוג מנהל תעבורת הנתונים הנכנסת של 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-my-org-my-env 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 בהתקנה. בדרך כלל, זהו אותו ערך כמוENV_NAME. עם זאת, אם לסביבה יש שם זהה לזה של קבוצת הסביבות, צריך להשתמש בשמות שונים לגרסאות של הסביבה ושל קבוצת הסביבות, לדוגמהdev-env-releaseו-dev-envgroup-release. מידע נוסף על גרסאות ב-Helm זמין בקטע Three big concepts במסמכי התיעוד של Helm. - ENV_NAME הוא שם הסביבה שמשדרגים.
- OVERRIDES_FILE הוא קובץ ההחרגות החדש שלך לגרסה 1.17.4
כדי לשדרג את התרשים:
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-my-org-my-env 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) אחרי שה-watcher של Apigee שולף פרטים שקשורים לקבוצת הסביבות ממישור הבקרה. לכן, צריך לבדוק שהמצב של ה-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-123abc running 2d
- צריך לשדרג קבוצת סביבות (virtualhost) אחת בכל פעם. מציינים את קבוצת הסביבות באמצעות
חזרה לגרסה קודמת
כדי לחזור לגרסה הקודמת, משתמשים בגרסת התרשים הישנה יותר כדי להחזיר את תהליך השדרוג בסדר הפוך. מתחילים עם apigee-virtualhost וחוזרים אחורה עד apigee-operator, ואז מחזירים את ה-CRD.
- מבטלים את השינויים בתרשימים. הפקודות הבאות מניחות שאתם משתמשים בתרשימים מהגרסה הקודמת (v1.16.x).
-
מריצים את הפקודה הבאה לכל קבוצת סביבות:
helm upgrade ENV_GROUP_RELEASE_NAME apigee-virtualhost/ \ --install \ --namespace APIGEE_NAMESPACE \ --atomic \ --set envgroup=ENV_GROUP_NAME \ -f 1.16_OVERRIDES_FILE
-
מריצים את הפקודה הבאה לכל סביבה:
helm upgrade ENV_RELEASE_NAME apigee-env/ \ --install \ --namespace APIGEE_NAMESPACE \ --atomic \ --set env=ENV_NAME \ -f 1.16_OVERRIDES_FILE
-
apigee-org:helm upgrade ORG_NAME apigee-org/ \ --install \ --namespace APIGEE_NAMESPACE \ --atomic \ -f 1.16_OVERRIDES_FILE
-
apigee-ingress-manager:helm upgrade ingress-manager apigee-ingress-manager/ \ --install \ --namespace APIGEE_NAMESPACE \ --atomic \ -f 1.16_OVERRIDES_FILE
-
apigee-redis:helm upgrade redis apigee-redis/ \ --install \ --namespace APIGEE_NAMESPACE \ --atomic \ -f 1.16_OVERRIDES_FILE
-
apigee-telemetry:helm upgrade telemetry apigee-telemetry/ \ --install \ --namespace APIGEE_NAMESPACE \ --atomic \ -f 1.16_OVERRIDES_FILE
-
apigee-datastore:helm upgrade datastore apigee-datastore/ \ --install \ --namespace APIGEE_NAMESPACE \ --atomic \ -f 1.16_OVERRIDES_FILE
-
apigee-operator:helm upgrade operator apigee-operator/ \ --install \ --namespace APIGEE_NAMESPACE \ --atomic \ -f 1.16_OVERRIDES_FILE
-
- אם חוזרים לגרסה 1.16, צריך להסיר את ה-webhook של ההמרה מה-CRD של
apigeedatastores,apigeeredisו-apigeevalkeys. בגרסה 1.17 של ה-CRD נוסף להם webhook להמרה, ובגרסה 1.16 אין להם webhook. אם מדלגים על השלב הזה, השלב הבא נכשל עם השגיאהspec.conversion.strategy: Required value. כדי להסיר את ה-webhook של ההמרה, מריצים את הפקודות הבאות:kubectl patch crd apigeedatastores.apigee.cloud.google.com --type=merge \ -p '{"spec":{"conversion":{"strategy":"None","webhook":null}}}'kubectl patch crd apigeeredis.apigee.cloud.google.com --type=merge \ -p '{"spec":{"conversion":{"strategy":"None","webhook":null}}}'kubectl patch crd apigeevalkeys.apigee.cloud.google.com --type=merge \ -p '{"spec":{"conversion":{"strategy":"None","webhook":null}}}' - כדי לחזור לגרסה הקודמת של ה-CRD, מתקינים מחדש את ה-CRD הישנים יותר.
kubectl apply -k apigee-operator/etc/crds/default/ \ --server-side \ --force-conflicts \ --validate=false