אבחון בעיות באמצעי הבקרה

סקירה כללית על שכבות ההגנה

מעקות הבטיחות של 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

רמת החומרה: error

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

cassandra_recent_backup_csi upgrade נוספה בגרסה: 1.14.0

רמת החומרה: error

בדיקה שדורשת שהגיבוי מ-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"