פתרון בעיות בפריסה של סביבה גמישה ב-App Engine

במסמך הזה מוסבר על טכניקות לפתרון בעיות בפריסות של Cloud Endpoints בסביבות גמישות של App Engine. אם מתקבלת שגיאה בתגובה לבקשה שנשלחה ל-API, אפשר לעיין בפתרון בעיות שקשורות לשגיאות בתגובה כדי לקבל מידע על פתרון השגיאה.

שגיאות פריסה

בקטע הזה מוסבר איך לפתור שגיאות מ-gcloud app deploy.

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

בודקים שבקובץ app.yaml יש קטע readiness_check עם ערך ל-app_start_timeout_sec. אם הוא לא קיים, מוסיפים את הקטע ומגדירים את הערך של app_start_timeout_sec לערך גבוה יותר מברירת המחדל של 300 שניות. מידע נוסף זמין במאמר בנושא בדיקות מוכנות.

חשוב לוודא שהפעלתם את כל Google Cloud השירותים שנדרשים ל-Endpoints ול-ESP. פרטים נוספים מופיעים במאמר בדיקת השירותים הנדרשים.

מוודאים שלרשת ה-VPC שמשויכת לאפליקציה הגמישה של App Engine יש מסלול סטטי מקומי עם יעד 0.0.0.0/0 ושער אינטרנט שמוגדר כברירת מחדל לצעד הבא. אם משתמשים בשירותים פרטיים לשימוש פנימי בלבד, צריך לוודא ש-PGA מופעל בתת-הרשת שנבחרה.

הודעות שגיאה לגבי rollout_strategy

כשמגדירים את app.yaml לפני הפריסה, צריך להוסיף את הקטע endpoints_api_service. ה-Extensible Service Proxy‏ (ESP) צריך את ההגדרות שציינתם בקטע הזה כדי לקבל את ההגדרה של השירות. צריך לציין מזהה הגדרה בשדה config_id או לכלול את האפשרות rollout_strategy: managed, אבל לא את שניהם. האפשרות הזו מגדירה את ESP כך שישתמש בהגדרת השירות האחרונה שפרסתם. אם תבחרו באפשרות הזו, עד 5 דקות אחרי שתפרסו הגדרת שירות חדשה, ESP יזהה את השינוי ויתחיל להשתמש בה באופן אוטומטי. אנחנו ממליצים לציין את האפשרות הזו במקום מזהה תצורה ספציפי לשימוש ב-ESP. לדוגמה:

endpoints_api_service:
  name: example-project-12345.appspot.com
  rollout_strategy: managed

אם הקטע endpoints_api_service לא כולל את המידע ש-ESP צריך כדי לקבל הגדרת שירות, מוצגת אחת מההודעות הבאות:

הודעת השגיאה פתרון בעיות
הערך config_id אסור כש-rollout_strategy מוגדר ל-"managed" אי אפשר לציין גם מזהה תצורה וגם rollout_strategy: managed. אלא אם יש לכם סיבה להשתמש במזהה תצורה ספציפי, מומלץ להסיר את config_id: [YOUR_CONFIG_ID] מ-app.yaml ולהפעיל מחדש את gcloud app deploy.
חובה לציין את config_id אם לא מציינים את rollout_strategy או אם מגדירים את rollout_strategy כ-"fixed" הודעת השגיאה הזו מוצגת אם app.yaml לא כולל את rollout_strategy: managed או אם rollout_strategy מוגדר ל-fixed ולא ציינתם מזהה הגדרה. אלא אם יש לכם סיבה להשתמש במזהה הגדרה ספציפי, מומלץ להוסיף את rollout_strategy: managed לקטע endpoints_api_service של app.yaml ולהפעיל מחדש את gcloud app deploy.

צפייה ביומנים במכונה

יומני קריסה ויומני מערכת של App Engine מספקים מידע על הסיבות לכך שהאפליקציה לא הופעלה או לא פעלה כמצופה. מידע נוסף על ניפוי באגים זמין ביומן של נקודות הקצה.

  1. במסוף Google Cloud , מתחברים למכונה הווירטואלית באמצעות SSH. מידע נוסף זמין במאמר בנושא חיבור למופע.

  2. משתמשים בכלי לצפייה בטקסט כמו tail:

     tail -f /var/log/nginx/error.log

המאמרים הבאים