בדף הזה מופיע מידע כללי לפתרון בעיות וקישורים לדפים אחרים עם מידע נוסף.
שגיאות בפריסת ההגדרה של 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.
לפרטים על ESP שנפרס ב-Cloud Run, אפשר לעיין במאמר יצירת אימג' חדש של ESPv2 במדריך Cloud Run.
לפרטים על ESP שפרוס ב-Compute Engine, אפשר לעיין במאמר בדיקת ההרשאות הנדרשות במדריך בנושא Compute Engine.
לפרטים על ESP שפריסתו מתבצעת ב-GKE, אפשר לעיין במאמר בדיקת ההרשאות הנדרשות במדריך ל-GKE.
בדיקת מידע על תוצאות ניפוי הבאגים
הפעלת Google Cloud CLI עם רמת פירוט של ניפוי באגים עוזרת בניפוי באגים.
gcloud --verbosity=debug COMMAND
הפקודה הזו גורמת ל-Google Cloud CLI להדפיס יומן מפורט של השגיאה. בהתאם לפקודה שמריצים, הפלט יכול לכלול מידע על הבקשה והתגובה מהשרת.
הפעלת שירות
אפשר לבדוק אם שירות מסוים מופעל באמצעות gcloud.
gcloud services list
כדי להציג את ההגדרה של שירות מסוים, משתמשים בפקודה הבאה:
gcloud endpoints services describe SERVICE_NAME
ה-OAuth של ה-Proxy נכשל, אבל הבקשות עוברות
מוודאים שיש קטע authentication עם הגדרת ה-OAuth בקובץ התצורה של gRPC API. קובץ הגדרות לדוגמה זמין בדוגמה של חנות ספרים ב-GitHub.