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

שדרוג של Apigee Hybrid

אתם צריכים לבצע התקנה חדשה.

שדרוג לגרסה 1.2.0

כדי לשדרג את Apigee Hybrid לגרסה 1.2.0:

שלב 1: שדרוג Kubernetes והורדה של חבילת הגרסה

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

פלטפורמה	שדרוג לגרסה
GKE	‫1.14.x
Anthos	1.2
AKS	‫1.14.x

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

‫Mac 64 bit:

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

‫Linux 64 bit

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

Mac 32 bit:

curl -LO \
    https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/1.2.0/apigeectl_mac_32.tar.gz

‫Linux 32 bit

curl -LO \
    https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/1.2.0/apigeectl_linux_32.tar.gz

שלב 2: הגדרה מחדש של ספריית ההתקנה

מזהים את ספריית ההתקנה הבסיסית שנוצרה כשהתקנתם במקור את Apigee Hybrid. הספרייה הבסיסית היא הספרייה שבה נמצאת הספרייה $APIGEEGTL_HOME. בדוגמה הבאה, ספריית הבסיס היא /Users/myhome/hybrid:
```
echo $APIGEECTL_HOME
/Users/myhome/hybrid/apigeectl
```
מחלצים את התוכן של קובץ ה-gzip שהורד אל ספריית הבסיס של Apigee Hybrid:
```
tar xvzf filename.tar.gz -C path-to-base-directory
```
‫cd לספריית הבסיס.
כברירת מחדל, התוכן של קובץ ה-tar מורחב לתוך ספרייה עם הגרסה והפלטפורמה בשם שלה. לדוגמה: ./apigeectl_1.2.0-f7b96a8_linux_64.
משנים את השם של ספריית apigeectl הנוכחית. לדוגמה, אם הגרסה הנוכחית היא 1.1.1, משנים את השם של הספרייה apigeectl ל-apigeectl_1.1.1.
משנים את השם של ספריית ההתקנה שחולצה ל-apigeectl. זה המקום שאליו מצביעה הסביבה $APIGEECTL_HOME.

שלב 3: מעדכנים את קובץ ההחרגות

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

מעדכנים את קובץ ההחלפות עם השינויים שמתוארים בהמשך:

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

המאפיין envs[].hostAlias הוסר והוחלף במאפיין virtualhosts.hostAliases[] החדש.
הערה: אם השתמשתם בתו כללי יחיד '*' עבור הכינוי של מארח הסביבה בגרסה קודמת, בגרסה 1.2.0 אתם חייבים להשתמש בשם DNS שמוגדר במלואו או בתו כללי של תת-דומיין בהגדרת הכינוי של המארח הווירטואלי. לדוגמה: *.mydomain.com. ההגדרה של תו כללי יחיד לחיפוש hostAliases['*'] כבר לא נתמכת.
צריך להוסיף את מאפיין ההגדרה החדש הנדרש virtualhosts.
צריך להעביר את הנכסים envs[].sslCertPath ו-envs[].sslKeyPath מהדומיין envs אל הדומיין virtualhosts.
צריך להוסיף את ה-stanza של ההגדרה virtualhosts.routingRules. המאפיין virtualhosts.routingRules מחליף את המאפיין הקודם envs[].paths. אם יש לכם envs[].paths בקובץ ההחלפות, אתם צריכים להסיר אותו. מידע נוסף על הגדרת מארחים וירטואליים זמין במאמר הגדרת מארחים וירטואליים.

בטבלה הבאה מוצגים ההבדלים בין קובץ של גרסה 1.1.1 לבין קובץ של גרסה 1.2.0. הדוגמה נועדה להדגיש את סוגי השינויים שצריך לבצע בגרסה 1.2.0:

הגדרות בגרסה v1.1.x	הגדרות אישיות בגרסה 1.2.0
envs: - name: test1 hostAlias: "api.example.com" sslCertPath: ./certs/fullchain.pem sslKeyPath: ./certs/privkey.pem serviceAccountPaths: synchronizer: ./sa/sync.json udca: ./sa/udca.json paths: uri: prefixes: - /orders - /items - name: test2 hostAlias: "api.example.com" sslCertPath: ./certs/fullchain.pem sslKeyPath: ./certs/privkey.pem serviceAccountPaths: synchronizer: ./sa/sync.json udca: ./sa/udca.json paths: uri: prefixes: - /v0/hello - /httpbin	virtualhosts: - name: default hostAliases: ["api.example.com"] sslCertPath: ./certs/fullchain.pem sslKeyPath: ./certs/privkey.pem routingRules: - paths: - /orders - /items env: test1 - paths: - /v0/hello - /httpbin env: test2 envs: - name: test1 serviceAccountPaths: synchronizer: ./sa/synchronizer.json udca: ./sa/udca.json - name: test2 serviceAccountPaths: synchronizer: ./sa/synchronizer.json udca: ./sa/udca.json

הגדרות בגרסה v1.1.x

הגדרות אישיות בגרסה 1.2.0

envs:
  - name: test1
    hostAlias: "api.example.com"
    sslCertPath: ./certs/fullchain.pem
    sslKeyPath: ./certs/privkey.pem
    serviceAccountPaths:
      synchronizer: ./sa/sync.json
      udca: ./sa/udca.json
    paths:
      uri:
        prefixes:
          - /orders
          - /items
  - name: test2
    hostAlias: "api.example.com"
    sslCertPath: ./certs/fullchain.pem
    sslKeyPath: ./certs/privkey.pem
    serviceAccountPaths:
      synchronizer: ./sa/sync.json
      udca: ./sa/udca.json
    paths:
      uri:
        prefixes:
          - /v0/hello
          - /httpbin

virtualhosts:
  - name: default
    hostAliases: ["api.example.com"]
    sslCertPath: ./certs/fullchain.pem
    sslKeyPath: ./certs/privkey.pem
    routingRules:
      - paths:
        - /orders
        - /items
        env: test1
      - paths:
        - /v0/hello
        - /httpbin
        env: test2

envs:
  - name: test1
    serviceAccountPaths:
      synchronizer: ./sa/synchronizer.json
      udca: ./sa/udca.json
  - name: test2
    serviceAccountPaths:
      synchronizer: ./sa/synchronizer.json
      udca: ./sa/udca.json

הערה: אם לא מציינים את envs[].paths (כמו שמופיע בטבלה שלמעלה), אפשר להשמיט את המאפיין virtualhosts[].routingRules.paths[] בשדרוג. נתיב ברירת המחדל הוא '/'. לדוגמה, אם רוצים להשתמש בנתיב ברירת המחדל '/', אפשר להגדיר את virtualhosts[].routingRules כך:

virtualhosts:
  - name: default
    hostAliases: ["api.example.com"]
    sslCertPath: ./certs/fullchain.pem
    sslKeyPath: ./certs/privkey.pem
    routingRules:
      - env: test1
  - name: prod
    hostAliases: ["api.example.com"]
    sslCertPath: ./certs/fullchain.pem
    sslKeyPath: ./certs/privkey.pem
    routingRules:
      - env: test2

שלב 4: החלת השדרוג על האשכול

אם הפעלתם את Apigee Connect בהתקנה של גרסה 1.1.1, אתם צריכים להסיר את הפריסה:
1. קודם כול, מציגים את רשימת הפריסות של Apigee:
```
kubectl -n namespace get ad
```
2. מוחקים את הפריסה של Apigee Connect:
```
kubectl -n namespace delete ad apigee-connect-name
```
מציגים את הפודים:
```
kubectl get pods -n namespace
```
מוחקים את ה-Pod‏ apigee-cps-setup מהאשכול. משתמשים בשם המלא של ה-Pod, שכולל את שם הארגון, כפי שמוחזר בפקודה הקודמת. לדוגמה:
```
kubectl -n namespace delete pod apigee-cps-setup-org
```
מוחקים את ה-pod‏ apigee-cps-create-user באותו מרחב שמות:
```
kubectl -n namespace delete pod apigee-cps-create-user
```
מנקים את המשימות שהושלמו במרחב השמות של זמן הריצה ההיברידי, כאשר 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}')

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

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

cd לספרייה ./hybrid-files:

מפעילים את apigeectl בגרסה החדשה:

$APIGEECTL_HOME/apigeectl init -f overrides/overrides-file.yaml

כדי לדעת מתי האתחול מסתיים:

$APIGEECTL_HOME/apigeectl check-ready -f overrides/overrides-file.yaml

כש-check-ready משיב "All containers are ready" (כל מאגרי התגים מוכנים), אפשר לנסות התקנה של dry run. מפעילים את הפקודה apply עם הדגל --dry-run=true. הרצה יבשה מאפשרת לבדוק אם יש שגיאות לפני שמבצעים שינויים באשכול:
```
$APIGEECTL_HOME/apigeectl apply -f overrides/overrides-file.yaml --dry-run=true
```
אם אין שגיאות, אפשר להחיל על האשכול את רכיבי זמן הריצה הספציפיים ל-Apigee:
```
$APIGEECTL_HOME/apigeectl apply -f overrides/overrides-file.yaml
```
מריצים מחדש את check-ready כדי לדעת מתי השדרוג מסתיים.

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

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

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