הדף הזה רלוונטי ל-Apigee ול-Apigee Hybrid.
לעיון במסמכי התיעוד של
Apigee Edge
Apigee חושף בדיקות תקינות ברמות שונות, שאפשר להשתמש בהן בהתאם לתרחיש השימוש.
- בדיקת תקינות ברמת האזור או ברמת מופע Apigee: מחזירה את התקינות של מופע Apigee כולל באזור מסוים.
- בדיקות תקינות ברמת הסביבה: מחזירה את התקינות של סביבה מסוימת במופע Apigee.
- בדיקת תקינות מותאמת אישית דרך proxy ל-API: בתרחישי שימוש מורכבים, אפשר להגדיר proxy ייעודי ל-API כנקודת קצה מותאמת אישית לבדיקת תקינות.
ביצוע בדיקת תקינות ברמה אזורית
Apigee מציעה בדיקת תקינות ברמת האזור או ברמת מופע Apigee, כדי להעריך את סטטוס התקינות הכולל של מופע Apigee באזור מסוים. תבנית בדיקת התקינות הזו, שנמצאת בשימוש נרחב במאזני עומסים, קובעת את סטטוס התקינות של מופעי Apigee ומבצעת מעבר לגיבוי באזור. כדי לבצע בדיקת תקינות ברמת האזור, צריך ליצור את הבקשה באופן הבא:
- נתיב בדיקת תקינות:
/healthz/ingress - הוספת כותרת בקשה:
User-Agent: GoogleHC.
$ curl -H 'User-Agent: GoogleHC' https://$HOST/healthz/ingress Apigee Ingress is healthy
$HOST מייצג את שם המארח שמוגדר בקבוצת סביבות Apigee שמאוזנת על ידי מאזן העומסים.
ביצוע בדיקת תקינות ברמת הסביבה
Apigee מציע בדיקת תקינות ברמת הסביבה כדי להעריך את התקינות של סביבה מסוימת שמוגשת על ידי מופע Apigee. מומלץ להשתמש בתבנית הזו של בדיקת תקינות כשרוצים לבצע מעבר לגיבוי באזור אחר על סמך התקינות של סביבות קריטיות או סלקטיביות מסוימות. כדי לבצע בדיקת תקינות ברמת הסביבה, צריך לקרוא לכל proxy ל-API תקף בסביבה. לשם כך, צריך ליצור את הבקשה באופן הבא:
- הוספה של
/healthz/לתחילת נתיב הבסיס של שרת ה-proxy. - הוספת כותרת בקשה:
User-Agent: GoogleHC.
לדוגמה, נניח ש-/catalog הוא נתיב בסיס של proxy תקין שנפרס בסביבה. כדי לבצע בדיקת תקינות, קוראים לשרת ה-proxy כך:
$ curl -H 'User-Agent: GoogleHC' https://$HOST/healthz/catalog Server Ready
$HOST מייצג את שם המארח שמוגדר בקבוצת הסביבות של Apigee שמשרת מאזן העומסים.
ביצוע בדיקת תקינות בהתאמה אישית באמצעות proxy ל-API
אם רוצים לבצע אימותים נוספים, אפשר להגדיר לוגיקה מותאמת אישית לבדיקת תקינות ב-proxy ל-API שנפרס בסביבה. לדוגמה, יכול להיות שהבדיקה תכשל אם כמה סביבות לא פעילות. או שהבדיקה תיכשל על סמך מצב היעד או זמן האחזור.
במקרה כזה, אפשר לבצע את בדיקת התקינות על ידי ביצוע קריאה רגילה ל-API של השרת הפרוקסי.
לדוגמה, נניח שרוצים לבדוק את תקינות הסביבה שנקראת prod.
פורסים proxy ל-API בסביבה הזו עם נתיב הבסיס /healthcheck-prod.
כדי לבדוק את תקינות סביבת prod שמוגשת על ידי מופע Apigee, צריך להפעיל את ה-proxy באופן הבא:
$ curl https://$HOST/healthcheck-prod
$HOST מייצג את שם המארח שמוגדר בקבוצת הסביבות של Apigee שמשרת מאזן העומסים.
הערות שימוש
בבדיקות תקינות ברמת האזור וברמת הסביבה: אם הבדיקות מבוצעות על ידי מאזני העומסים של Google Cloud, מאזן העומסים מגדיר את הכותרת הנכונה User-Agent. אם הלקוח שלכם צורך את הקריאות האלה ל-API של בדיקת תקינות, אתם צריכים לוודא שהערך הנכון של User-Agent מוגדר.
ב-Apigee Hybrid: התכונה של בדיקת התקינות זמינה רק בגרסה 1.4 ומעלה.