הדף הזה רלוונטי ל-Apigee ול-Apigee Hybrid.
לעיון במסמכי התיעוד של Apigee Edge.
תסמינים
פריסות של שרתי proxy ל-API או של תהליכים משותפים נכשלות עם השגיאה Instance INSTANCE_NAME
is not reporting status for environment group ENV_GROUP_NAME בממשק המשתמש של Apigee Hybrid.
הודעות שגיאה
השגיאה The Instance INSTANCE_NAME is not reporting status for environment group
ENV_GROUP_NAME מוצגת בתפריט proxies ל-API בכרטיסייה Overview כשמעבירים את העכבר מעל סימן הקריאה האדום שמופיע בעמודה Status בקטע Deployments:
סיבות אפשריות
| מטרה | תיאור |
|---|---|
הבורר app: apigee-ingressgateway חסר |
כשמשתמשים ב-Apigee Ingress, הקובץ overrides.yaml צריך לכלול את הסלקטור app: apigee-ingressgateway בקטע virtualhosts. |
ApigeeRoute לא עדכני או סביבה שנמחקה רק במישור הבקרה |
סביבה או פריסה הוסרו ממישור הבקרה או מהאשכול בלי להשלים את תהליך העבודה המלא של Full Delete, וכתוצאה מכך נשארו באשכול משאבים לא עדכניים של ApigeeRoute או של הסביבה. |
| חסימת תעבורת נתונים יוצאת ברשת אל Google APIs | צומתי העובדים של האשכול לא יכולים ליצור חיבורים יוצאים לאימות של Google ולממשקי ה-API של מישור הבקרה של Apigee ב-*.googleapis.com:443. |
| שער הכניסה או פודים של זמן ריצה לא מוכנים | apigee-ingressgateway Pods לא פועלים כשכל הקונטיינרים מוכנים (2/2), או apigee-runtime Pods לא מוכנים (0/1) בגלל בדיקת READINESS:VersionLoadProbe שנכשלה. |
הסיבה: חסר הסלקטור app: apigee-ingressgateway
כשמשתמשים בשער הכניסה של Apigee, הקובץ overrides.yaml כולל קטע להגדרת virtualhosts שבו צריך להגדיר את הבורר app: apigee-ingressgateway.
אבחון
קודם כל, ודאו שאתם משתמשים בשער הכניסה של Apigee שזמין בגרסה 1.8 ומעלה של Apigee Hybrid (ההגדרה הבאה לא פועלת ב-Istio ASM בניהול הלקוח). בקובץ overrides.yaml שכולל את קבוצת הסביבות שמוזכרת בשגיאה, מחפשים את הקטע virtualhosts ובודקים אם חסרים הסלקטורים הבאים:
selector:
app: apigee-ingressgateway
ingress_name: INGRESS_NAMEרזולוציה
עורכים את הקובץ overrides.yaml כך שהקטע virtualhosts[].selector ייראה כמו בדוגמה הבאה:
virtualhosts:
- name: my-environment-group
sslCertPath: my-cert.crt
sslKeyPath: my-cert.key
selector:
app: apigee-ingressgateway
ingress_name: INGRESS_NAME
אחרי שעורכים את הקובץ overrides.yaml, מחילים את ההגדרות החדשות באמצעות Helm:
הרצת בדיקה:
helm upgrade ENV_GROUP_RELEASE_NAME apigee-virtualhost/ \ --namespace APIGEE_NAMESPACE \ --atomic \ --set envgroup=ENV_GROUP \ -f OVERRIDES_FILE \ --dry-run=server
חשוב לכלול את כל ההגדרות שמוצגות, כולל --atomic
כדי שהפעולה תבוטל אם היא תיכשל.
יכול להיות שההתקנה הוגדרה באמצעות ENV_GROUP_RELEASE_NAME שונה מ-ENV_GROUP. למידע על ההגדרות, ראו התקנת Apigee Hybrid באמצעות Helm.
מתקינים את התרשים:
helm upgrade ENV_GROUP_RELEASE_NAME apigee-virtualhost/ \ --namespace APIGEE_NAMESPACE \ --atomic \ --set envgroup=ENV_GROUP \ -f OVERRIDES_FILE
הסיבה: ApigeeRoute לא עדכני או סביבה שנמחקה רק במישור הבקרה
כשמסירים סביבה או פריסת סביבת זמן ריצה ממישור הבקרה או מהאשכול בלי להשלים את כל תהליך העבודה של המחיקה, יכול להיות שמשאבים ישנים של ApigeeRoute או של הסביבה יישארו באשכול. כש-apigee-watcher מנסה להתאים את הניתוב לקבוצת הסביבות ונתקל בשירות Kubernetes, בפריסה או בסביבה של מישור הבקרה שחסרים, הוא לא יכול להשלים את עדכון הניתוב או לדווח על סטטוס הפריסה למישור הבקרה.
אבחון
-
בודקים את יומני ה-Pod של
apigee-watcherכדי לראות אם יש שגיאות שקשורות לשירות או לסביבה חסרים:kubectl logs -n APIGEE_NAMESPACE -l app=apigee-watcher --since=2h
מחפשים רשומות ביומן שדומות לאלה:
-
ApigeeRouteלא עדכני מפנה לשירות זמן ריצה או לפריסה שנמחקו:{"level":"error","caller":"watcher/watcher.go:60","msg":"error during watch","name":"ingressstatus","error":"INTERNAL: NOT_FOUND: failed to get service: services \"apigee-runtime-ORG_ENV_HASH\" not found"}
-
סביבה נמחקה במישור הבקרה, אבל משאבי זמן הריצה שלה נשארו באשכול:
{"level":"error","caller":"watcher/watcher.go:60","msg":"error during watch","name":"ingress","error":"INVALID_ARGUMENT: err fetching environment data: NOT_FOUND: {\n \"error\": {\n \"code\": 404,\n \"message\": \"generic::not_found: resource organizations/ORG_NAME/environments/ENV_NAME not found\",\n \"status\": \"NOT_FOUND\"\n }\n}"}
-
-
בודקים את המשאבים של
ApigeeRouteבמרחב השמות (apigeeכברירת מחדל) כדי לזהות נתיב שמפנה ל-ApigeeDeploymentאו לשירות שלא קיימים:kubectl get ApigeeRoute -n APIGEE_NAMESPACE kubectl describe ApigeeRoute APIGEE_ROUTE_NAME -n APIGEE_NAMESPACE
רזולוציה
-
מוחקים את המשאב הלא תקין של
ApigeeRoute:kubectl delete ApigeeRoute APIGEE_ROUTE_NAME -n APIGEE_NAMESPACE
-
מגדירים מחדש את הנתיב על ידי החלה מחדש של תרשים ה-Helm של
apigee-virtualhost:helm upgrade ENV_GROUP_RELEASE_NAME apigee-virtualhost/ \ -n APIGEE_NAMESPACE \ --atomic \ --set envgroup=ENV_GROUP \ -f OVERRIDES_FILE
-
אם סביבה נמחקה רק במישור הבקרה (מה שגורם ל-
err fetching environment data: NOT_FOUND), מסירים את גרסת ה-Helm של הסביבה (helm delete ENV_RELEASE_NAME -n APIGEE_NAMESPACE) ומסירים את הסביבה מהקובץoverrides.yaml, כמו שמתואר בקטע מחיקת סביבות.
הסיבה: תעבורת הנתונים היוצאת ברשת אל Google APIs חסומה
הרכיב apigee-synchronizer דוגם את מישור הבקרה של Apigee כדי להוריד חוזים של הגדרות זמן ריצה לפודים של apigee-runtime, ו-apigee-watcher מתחבר למישור הבקרה כדי לאחזר את הגדרת ה-Ingress ולדווח על סטטוס הפריסה. אם תעבורת הנתונים היוצאת מצומתי העובדים של האשכול אל Google APIs חסומה, הרכיבים האלה לא יכולים לאמת או לתקשר עם מישור הבקרה.
אבחון
-
בודקים ביומני ה-pod של
apigee-synchronizerאם יש שגיאות אימות ושגיאות של זמן קצוב לתפוגה של החיבור:kubectl logs -n APIGEE_NAMESPACE -l app=apigee-synchronizer --since=2h
מחפשים שגיאות של זמן קצוב לתפוגה מסוג
GoogleAuthExceptionכשמאחזרים טוקן גישה:"logger":"CONTRACT-REPLICATION","exceptionStackTrace":"com.google.auth.oauth2.GoogleAuthException: Error getting access token for service account: connect timed out, iss: SERVICE_ACCOUNT_EMAIL"
-
בודקים את יומני ה-Pod של
apigee-watcherכדי לאתר כשלים בקישוריות של מישור הבקרה:kubectl logs -n APIGEE_NAMESPACE -l app=apigee-watcher --since=2h
מחפשים שגיאות
control-plane connectivity test failedעם זמן קצוב לתפוגה של TCP ליציאה443:{"level":"error","caller":"issuescan/cp_connectivity_scanner.go:68","msg":"control-plane connectivity test failed","organization":"ORG_NAME","error":"Get \"https://apigee.googleapis.com/v1/organizations/ORG_NAME\": oauth2: cannot fetch token: Post \"https://oauth2.googleapis.com/token\": dial tcp IP_ADDRESS:443: i/o timeout"}
רזולוציה
מוודאים שהכללים של חומת האש לתעבורת נתונים יוצאת, שערי ה-NAT, רשימות ה-ACL של הרשת והגדרות שרת ה-proxy להעברת HTTP או HTTPS מאפשרים לצומתי העובדים של האשכול להגיע אל *.googleapis.com:443 (כולל apigee.googleapis.com ו-oauth2.googleapis.com). הרשימה המלאה של הדומיינים הנדרשים והשלבים לפתרון בעיות בקישוריות מפורטים במאמרים כתובות ה-URL של Google Cloud שצריך לאפשר ב-Hybrid ואין קישוריות רשת בין מישור זמן הריצה למישור הבקרה.
הסיבה: פודים של שער Ingress או של סביבת זמן ריצה לא מוכנים
כדי לאמת את סטטוס הפריסה ולדווח עליו, apigee-watcher מאחזר את קובצי ה-dump של הגדרות הניתוב מה-pods של apigee-ingressgateway ובודק את המוכנות של ה-pods של apigee-runtime. אם הפודים של שער הכניסה לא פועלים ומוכנים, או אם הפודים של זמן הריצה לא טענו את חוזה הסביבה, הדיווח על סטטוס הפריסה נכשל.
אבחון
-
בודקים את הסטטוס של הפודים של
apigee-ingressgateway:kubectl get pods -n APIGEE_NAMESPACE -l app=apigee-ingressgateway
מוודאים שכל הפודים של
apigee-ingressgatewayנמצאים במצבRunningעם קונטיינרים של2/2מוכנים. אם הפודים של שער הכניסה לא פועלים,2/2,apigee-watcherלא יכול לאחזר את ה-dump של הגדרת Envoy שנדרש כדי לאמת את הפריסה. -
בודקים את הסטטוס של הפודים של
apigee-runtime:kubectl get pods -n APIGEE_NAMESPACE -l app=apigee-runtime
אם הפודים של
apigee-runtimeהםRunningאבל לא מוכנים (0/1), בודקים את האירועים והיומנים של הפודים:kubectl describe pod RUNTIME_POD_NAME -n APIGEE_NAMESPACE kubectl logs RUNTIME_POD_NAME -n APIGEE_NAMESPACE
מחפשים כשלים בבדיקת המוכנות (
Readiness probe failed: HTTP probe failed with statuscode: 500) ושגיאותREADINESS:VersionLoadProbeשמציינות שחוזה זמן הריצה לא נטען:{"level":"SEVERE","className":"com.apigee.probe.ProbeServiceImpl","severity":"SEVERE","message":"probe \"READINESS:VersionLoadProbe\" execution failed due to Version not loaded by Message Processor","logger":"ProbeServiceImpl"}
רזולוציה
לפני הפריסה מחדש, פותרים בעיות בהפעלת pod, מגבלות על משאבי אשכול (מגבלות מעבד או זיכרון) או בעיות בהורדת חוזה של סנכרון, כדי ש-apigee-ingressgateway pods יגיעו ל-2/2 מוכנים ו-apigee-runtime pods יגיעו ל-1/1 מוכנים. במדריך לפתרון בעיות במעבד הבקשות מפורטים שלבים נוספים לפתרון בעיות שקשורות לכשלים בבדיקת המוכנות של apigee-runtime.
קובצי עזר
- מיפוי מארחים וירטואליים לפריסות של שער הכניסה של Apigee
- מחיקת סביבות
- כתובות URL של Google Cloud שצריך לאשר ל-Hybrid
- מדריך לפתרון בעיות במעבד הבקשות