סקירה כללית על שכבות ההגנה
מעקות הבטיחות של Apigee Hybrid הם מנגנון שמתריע ללקוחות על בעיה פוטנציאלית לפני שהיא משפיעה על מכונה היברידית. במילים אחרות, אם פקודה מסוימת מסכנת את היציבות של מכונה היברידית, מעקות הבטיחות ההיברידיים יעצרו אותה. אם יש הגדרה שגויה או משאב לא מספיק, מעקות הבטיחות ההיברידיים ימנעו שינויים במכונה ההיברידית עד שהסיכון לבעיה יוסר. כך הלקוחות לא צריכים לבזבז זמן על בעיות שבדרך כלל לוקח שעות או ימים לפתור.
שימוש במעקות בטיחות ב-Apigee Hybrid
כדי להשתמש ב-Hybrid Guardrails, מריצים את אותן פקודות Hybrid Helm install או Hybrid Helm upgrade שמתועדות בהוראות להתקנת Hybrid. לא צריך פקודות נוספות כדי להפעיל את Guardrails.
כשמפעילים פקודת Helm ב-Apigee Hybrid, קורים שני דברים לפני שהפקודה מחילה את ההגדרות על המכונה ההיברידית:
- Helm יוצר pod זמני של Guardrails עם ההגדרות האישיות שהחלתם. אם ה-Pod של Guardrails מופעל במצב תקין, ה-Pod יבדוק את המכונה ההיברידית מול ההגדרות שהחלתם. אם הבדיקה עוברת, ה-Pod של Guardrails מסתיים וההגדרות שלכם מוחלות על המכונה ההיברידית של Apigee Hybrid.
- אם הבדיקה נכשלת, ה-Pod של Guardrails נשאר במצב לא תקין כדי לאפשר אבחון של ה-Pod. הפקודה helm תציג הודעת שגיאה שמדווחת על כך שה-pod של Guardrails נכשל.
בדוגמה הבאה מוצג שימוש ב-Guardrails כדי לבדוק את הקישוריות לרשת ממכונה היברידית למישור הבקרה של Apigee, כחלק מההתקנה של הרכיב apigee-datastore. אפשר להשתמש באותו רצף לכל הרכיבים של Apigee Hybrid:
מתקינים את הרכיב apigee-datastore באמצעות הפקודה הבאה:
helm upgrade datastore apigee-datastore/ \ --install \ --namespace apigee \ --atomic \ -f overrides.yaml
אם יש שגיאה מיידית, פקודת Helm תציג גם הודעת שגיאה שמראה שהבדיקות של Guardrails נכשלו, כמו בדוגמה הבאה:
helm upgrade datastore apigee-datastore/ \
--install \
--namespace apigee \
-f my-overrides.yaml
. . .
Error: UPGRADE FAILED: pre-upgrade hooks failed: 1 error occurred:
* pod apigee-hybrid-helm-guardrail-datastore failedכדי לראות איזו בדיקה נכשלה ולמה, בודקים את היומנים של Pod של Guardrails, כמו בדוגמה הבאה:
kubectl logs -n apigee apigee-hybrid-helm-guardrail-datastore
{"level":"INFO","timestamp":"2024-02-01T20:28:55.934Z","msg":"logging enabled","log-level":"INFO"}
{"level":"INFO","timestamp":"2024-02-01T20:28:55.935Z","msg":"","checkpoint":"upgrade","component":"apigee-datastore"}
{"level":"INFO","timestamp":"2024-02-01T20:28:55.935Z","msg":"initiating pre-install checks"}
{"level":"INFO","timestamp":"2024-02-01T20:28:55.935Z","msg":"check validation starting...","check":"controlplane_connectivity"}
{"level":"ERROR","timestamp":"2024-02-01T20:28:55.961Z","msg":"connectivity test failed","check":"controlplane_connectivity","host":"https://apigee.googleapis.com","error":"Get \"https://apigee.googleapis.com\": dial tcp: lookup apigee.googleapis.com on 10.92.0.10:53: no such host"}בדוגמה הזו, הודעת השגיאה בפועל היא החלק הזה:
{"level":"ERROR","timestamp":"2024-02-01T20:28:55.961Z","msg":"connectivity test failed","check":"controlplane_connectivity","host":"https://apigee.googleapis.com","error":"Get \"https://apigee.googleapis.com\": dial tcp: lookup apigee.googleapis.com on 10.92.0.10:53: no such host"}ה-Pod של Guardrails מוקצה באופן אוטומטי כשמפעילים את הפקודה helm. אם בדיקת הקישוריות למישור הבקרה של Apigee עוברת, ה-Pod של Guardrails מסתיים בסוף הביצוע.
בודקים במהירות את הסטטוס של ה-pods אחרי שמפעילים את הפקודה helm install. בפלט לדוגמה הבא, הפודים של Guardrail במצב תקין, כלומר בדיקת הקישוריות של מישור הבקרה עברה בהצלחה:
kubectl get pods -n apigee -w
NAME READY STATUS RESTARTS AGE
apigee-hybrid-helm-guardrail-datastore 0/1 Pending 0 0s
apigee-hybrid-helm-guardrail-datastore 0/1 Pending 0 1s
apigee-hybrid-helm-guardrail-datastore 0/1 ContainerCreating 0 1s
apigee-hybrid-helm-guardrail-datastore 0/1 Completed 0 2s
apigee-hybrid-helm-guardrail-datastore 0/1 Completed 0 3s
apigee-hybrid-helm-guardrail-datastore 0/1 Terminating 0 3s
apigee-hybrid-helm-guardrail-datastore 0/1 Terminating 0 3sאם בדיקת הקישוריות של מישור הבקרה של Apigee נכשלת, ה-Pod של Guardrails יישאר במצב שגיאה, כמו בדוגמה הבאה:
kubectl get pods -n apigee -w
NAME READY STATUS RESTARTS AGE
apigee-hybrid-helm-guardrail-datastore 0/1 Pending 0 0s
apigee-hybrid-helm-guardrail-datastore 0/1 Pending 0 0s
apigee-hybrid-helm-guardrail-datastore 0/1 ContainerCreating 0 0s
apigee-hybrid-helm-guardrail-datastore 0/1 Error 0 4s
apigee-hybrid-helm-guardrail-datastore 0/1 Error 0 5s
apigee-hybrid-helm-guardrail-datastore 0/1 Error 0 6sהשבתה זמנית של Guardrails
אם אתם צריכים להשבית את הבדיקות של Guardrails, הוסיפו את הדגל --no-hooks לפקודת Helm. בדוגמה הבאה מוצג הדגל --no-hooks בפקודת Helm:
helm upgrade datastore apigee-datastore/ \ --install \ --namespace apigee \ -f overrides.yaml \ --no-hooks
בדיקות של שכבות ההגנה
בטבלה הבאה מפורטים חלק מהבדיקות של Guardrails שנכללות בגרסה 1.15 של Apigee Hybrid.| שם | נקודת ביקורת | תיאור |
|---|---|---|
cassandra_backup_enabled |
upgrade |
נוספה בגרסה: 1.14.0
רמת החומרה: בדיקה שדורשת להפעיל את הגיבוי לפני השדרוג. לפני השדרוג צריך לגבות את הנתונים כדי שאפשר יהיה לשחזר את הגרסה הקודמת, אם יהיה צורך. במאמר גיבוי ושחזור של Cassandra מפורטות אפשרויות הגיבוי הזמינות. |
cassandra_recent_backup_csi |
upgrade |
נוספה בגרסה: 1.14.0
רמת החומרה: בדיקה שדורשת שהגיבוי מ-24 השעות האחרונות יהיה קיים לפני השדרוג, אם הגיבוי של CSI מופעל. כך אפשר לצמצם את אובדן הנתונים הפוטנציאלי אם צריך לשחזר את הגרסה הקודמת. למידע נוסף על גיבוי ושחזור של CSI, קראו את המאמר גיבוי CSI. |
הגדרת Guardrails בקובץ השינויים
החל מגרסה 1.12 של Apigee Hybrid, מעקות הבטיחות מוגדרים כברירת מחדל בכל תרשים. אפשר לשנות את כתובת ה-URL של קובץ האימג', את התג ואת המדיניות של משיכת קובץ האימג' בקובץ overrides.
לדוגמה, כתובת ה-URL, התג ומדיניות המשיכה של קובץ האימג' של Guardrails יתווספו לקובץ השינויים:
# Apigee Ingressgateway
ingressGateway:
image:
pullPolicy: Always
## NOTE: The Guardrails config is below. The ingressgateway config above is for position reference only and is NOT required for Guardrails config.
# Apigee Guardrails
guardrails:
image:
url: "gcr.io/ng-hybrid/guardrails/apigee-watcher"
tag: "1.15.10"
pullPolicy: Always
שימוש ב-tolerations של Kubernetes עם Guardrails
אפשר גם להוסיף tolerations ל-Guardrails בקובץ overrides. אם לא הוגדרו טולרנטיות בהגדרות של Guardrails overrides, המערכת תשתמש בטולרנטיות שמוגדרות באופן גלובלי.
לדוגמה, כדי לכלול טולרציות ספציפית בקטע Guardrails בקובץ overrides, צריך להוסיף משהו דומה לבית הבא:
# Apigee Guardrails
guardrails:
image:
url: "gcr.io/ng-hybrid/guardrails/apigee-watcher"
tag: "1.15.10"
pullPolicy: Always
tolerations:
- key: "say"
operator: "Equal"
value: "taunt"
effect: "NoSchedule"