סקירה כללית על פתרון בעיות

בדף הזה מופיע מידע כללי לפתרון בעיות וקישורים לדפים אחרים עם מידע נוסף.

שגיאות בפריסת ההגדרה של Cloud Endpoints

אם קיבלתם הודעת שגיאה מהפקודה gcloud endpoints services deploy command, תוכלו להיעזר במאמר פתרון בעיות בהטמעה של הגדרת נקודות קצה כדי לפתור את השגיאה.

שגיאות בהטמעה של קצה העורפי של ה-API

הפריסה של ה-API ושל Extensible Service Proxy ‏ (ESP) בGoogle Cloud קצה עורפי תלויה בפלטפורמה. מידע נוסף זמין במדריכים הבאים לפתרון בעיות:

שגיאות בתגובה

כששולחים בקשה ל-API ומקבלים תגובה עם שגיאה, אפשר לעיין במאמר בנושא פתרון בעיות שקשורות לתגובות עם שגיאות כדי לקבל מידע על פתרון השגיאה.

בדיקת השירותים הנדרשים

בדיקת השירותים הנדרשים

לפחות, צריך להפעיל את שירותי Google הבאים כדי להשתמש ב-Endpoints וב-ESP:
שם כותרת
servicemanagement.googleapis.com Service Management API
servicecontrol.googleapis.com Service Control API

ברוב המקרים, הפקודה gcloud endpoints services deploy מפעילה את השירותים הנדרשים האלה. עם זאת, הפקודה gcloud מסתיימת בהצלחה אבל לא מפעילה את השירותים הנדרשים בנסיבות הבאות:

  • אם השתמשתם באפליקציה של צד שלישי כמו Terraform ולא כללתם את השירותים האלה.

  • הפריסה של הגדרת ה-Endpoints בוצעה בפרויקטGoogle Cloud קיים שבו השירותים האלה הושבתו באופן מפורש.

כדי לוודא שהשירותים הנדרשים מופעלים, משתמשים בפקודה הבאה:

gcloud services list

אם השירותים הנדרשים לא מופיעים ברשימה, צריך להפעיל אותם:

gcloud services enable servicemanagement.googleapis.com
gcloud services enable servicecontrol.googleapis.com

צריך גם להפעיל את שירות Endpoints:

gcloud services enable ENDPOINTS_SERVICE_NAME

כדי לדעת מהו ENDPOINTS_SERVICE_NAME, אפשר:

  • אחרי פריסת ההגדרה של Endpoints, נכנסים לדף Endpoints במסוף Cloud. רשימת האפשרויות האפשריות של ENDPOINTS_SERVICE_NAME מוצגת בעמודה שם השירות.

  • ב-OpenAPI, ‏ ENDPOINTS_SERVICE_NAME הוא הערך שציינתם בשדה host במפרט OpenAPI. ב-gRPC, ‏ ENDPOINTS_SERVICE_NAME הוא הערך שציינתם בשדה name בהגדרות של נקודות הקצה של gRPC.

מידע נוסף על פקודות gcloud זמין במאמר שירותי gcloud.

בדיקת ההרשאות הנדרשות

למופע שבו פועל Extensible Service Proxy נדרשות הרשאות לקריאה ל-Service Management ול-ServiceControl.

בדיקת מידע על תוצאות ניפוי הבאגים

הפעלת Google Cloud CLI עם רמת פירוט של ניפוי באגים עוזרת בניפוי באגים.

gcloud --verbosity=debug COMMAND

הפקודה הזו גורמת ל-Google Cloud CLI להדפיס יומן מפורט של השגיאה. בהתאם לפקודה שמריצים, הפלט יכול לכלול מידע על הבקשה והתגובה מהשרת.

הפעלת שירות

אפשר לבדוק אם שירות מסוים מופעל באמצעות gcloud.

gcloud services list

כדי להציג את ההגדרה של שירות מסוים, משתמשים בפקודה הבאה:

gcloud endpoints services describe SERVICE_NAME

ה-OAuth של ה-Proxy נכשל, אבל הבקשות עוברות

מוודאים שיש קטע security עם הגדרת OAuth במסמך OpenAPI. קובץ מפרט לדוגמה זמין בדוגמה לתחילת העבודה ב-GitHub.

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