פתרון בעיות בהתקנה של Apigee

הדף הזה מתייחס ל-Apigee, אבל לא ל-Apigee Hybrid.

לעיון במסמכי התיעוד של Apigee Edge

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

יצירת מופע חדש

בקטע הזה מתוארות שגיאות נפוצות ופתרונות אפשריים אחרי שליחת בקשה ל-Apigee ליצירת מופע חדש:

  • ‫401 (UNAUTHENTICATED) מציין שפרטי הכניסה שלכם עשויים להיות לא בתוקף. כדאי לנסות לחדש את אסימון ההרשאה, כמו בדוגמה הבאה: 
    AUTH="Authorization: Bearer $(gcloud auth print-access-token)"
  • ‫RANGES_EXHAUSTED מציין שלא הייתה אפשרות לספק את טווח כתובות ה-IP שביקשתם בהתחלה, ולכן עליכם לבקש טווח חדש. יצרתם בקשת טווח בשלב 2: הגדרת רשתות.
    1. יצירת משתני הסביבה האלה 
      2. RANGE_NAME_1=YOUR_RANGE_NAME_1
  RANGE_NAME_2=YOUR_RANGE_NAME_2
  NETWORK_NAME=YOUR_NETWORK_NAME
    2. בודקים את הפרטים של טווחי הכתובות הקיימים ומוודאים שלא תהיה חפיפה עם הטווח החדש. 
      3.  gcloud compute addresses list --global --project=$PROJECT_ID
       
       gcloud compute addresses describe $RANGE_NAME_1 --global --project=$PROJECT_ID
    3. כדי לבקש טווח חדש שממנו Apigee בוחר כתובת IP לחיבורים פרטיים לשירותים, מריצים את פקודת gcloud הבאה: 
      4.  gcloud compute addresses create $RANGE_NAME_2
            --project=$PROJECT_ID --global --prefix-length=16
            --description="additional peering range for Google services" --network=$NETWORK_NAME
            --purpose=VPC_PEERING

      הפקודה הזו יוצרת טווח חדש בשם $RANGE_NAME_2.

    4. אימות הפרטים של טווח הכתובות הישן והחדש 
      5.  gcloud compute addresses list --global --project=$PROJECT_ID 
       gcloud compute addresses describe $RANGE_NAME_1 --global --project=$PROJECT_ID 
       gcloud compute addresses describe $RANGE_NAME_2 --global --project=$PROJECT_ID
    5. מאמתים את פרטי ה-VPC Peering הקיימים: 
      6.  gcloud services vpc-peerings list \
            --network=$NETWORK_NAME \
            --service=servicenetworking.googleapis.com \
            --project=$PROJECT_ID
    6. מריצים את הפקודה הבאה כדי לעדכן את בקשת החיבור: 
      7.  gcloud services vpc-peerings update
            --service=servicenetworking.googleapis.com --network=$NETWORK_NAME
            --ranges=$RANGE_NAME_1,$RANGE_NAME_2 --project=$PROJECT_ID
    7. מאמתים את פרטי ה-VPC Peering הקיימים: 
      8.  gcloud services vpc-peerings list \
            --network=$NETWORK_NAME \
            --service=servicenetworking.googleapis.com \
            --project=$PROJECT_ID

יצירת ארגון Apigee

בדוגמה הבאה מוצגת שגיאה נפוצה ש-Apigee עשוי להציג כשמנסים ליצור ארגון בפעם הראשונה:

  Apigee API (staging) has not been used in project 59387731598 before or it is disabled.
  Enable it by visiting https://console.developers.google.com/apis/api/staging-apigee.sandbox.googleapis.com/overview?project=59387731598 then retry.
  If you enabled this API recently, wait a few minutes for the action to propagate to our systems and retry.

המשמעות היא שאחד או יותר מממשקי ה-API הנדרשים לא מופעלים. בודקים את ממשקי ה-API שמפורטים בשלב 1: הפעלת ממשקי ה-API הנדרשים ומוודאים שכל ממשקי ה-API מופעלים לפני שממשיכים.

בנוסף, יכול להיות שתקבלו אחת משגיאות ה-HTTP הבאות:

  • ‫401 (UNAUTHENTICATED) מציין שפרטי הכניסה שלכם עשויים להיות לא בתוקף. כדאי לנסות לחדש את אסימון ההרשאה, כמו בדוגמה הבאה: 
    AUTH="Authorization: Bearer $(gcloud auth print-access-token)"
  • הערך 404 (Not Found) יכול להיות התוצאה של הפעולות הבאות:
    • הזנתם נקודת קצה שגויה או כתובת URL שגויה של בקשה. בודקים שציינתם את apigee.googleapis.com עבור הדומיין של קריאת ה-API.
    • יכול להיות שהפרויקט שלכם עדיין לא הוקצה. פונים אל מחלקת המכירות של Apigee.
  • 409 (Conflict) בדרך כלל מציין ששם הארגון שצוין כבר קיים. שמות הארגונים צריכים להיות ייחודיים באופן גלובלי. צריך לבחור שם אחר לארגון ולהפעיל מחדש את הפקודה. (מציינים את השם במטען הייעודי (payload) של הבקשה אם יוצרים ארגון בשורת הפקודה. חשוב לזכור שצריך ליצור ארגון עם אותו שם כמו הפרויקט, ולכן זה לא אמור לקרות אלא אם יש טעות הקלדה).

יכול להיות שתופיע השגיאה הבאה כשבודקים את הסטטוס של בקשה חדשה ליצירת ארגון ב-Apigee:

  • ‫403 (Permission Denied) יכול להצביע על כך שהארגון עדיין לא נוצר. מחכים עוד דקה ומנסים שוב. אם Apigee מחזיר 403 כשמנסים ליצור את הארגון החדש בפעם הראשונה, יכול להיות שאחד או יותר מממשקי ה-API שלכם לא הופעלו. חשוב לוודא שהפעלתם את כל ממשקי ה-API כמו שמתואר בשלב 1: הפעלת ממשקי ה-API הנדרשים .

פריסת דוגמאות

מאזן העומסים לא תקין

כשפורסים proxy לדוגמה, יכול להיות שמערכת Apigee תחזיר 502 (Bad Gateway) שגיאת HTTP. במקרה כזה, נסו את הפעולות הבאות:

  1. בודקים את תקינות מאזן העומסים. בכרטיסייה Load balancer (מאזן עומסים) מוצגים כל מאזני העומסים של הפרויקט והסטטוסים שלהם. משולש צהוב מציין שהשירות לקצה העורפי של מאזן העומסים לא תקין.

    נכנסים לדף Network services > Load balancing במסוף Google Cloud .

    כניסה לדף Load balancing

  2. אחרי שמאשרים שיש בעיה במאזן העומסים, בודקים את מכונות ה-VM במופע זמן הריצה כדי לוודא שהן פועלות ותקינות.
  3. כדאי לעיין בקובצי היומן כדי לראות אם יש שגיאה או בעיה אחרת שיכולה לגרום לבעיה. מידע נוסף על הפעלה וצפייה ביומנים זמין במאמר בנושא צפייה ביומנים.
  4. אפשר לנסות לבצע הפעלה מחדש מדורגת של קבוצת המופעים במסוף Cloud:

    1. במסוף Google Cloud , נכנסים לדף Compute Engine > Instance groups.

      כניסה לדף Instance groups

    2. ברשימת קבוצות המופעים, לוחצים על הקבוצה שלא מגיבה בעמודה Name.
    3. לוחצים על הפעלה מחדש/החלפה.
    4. במסך הבא, לוחצים על הפעלה מחדש.

      הפעולה הזו תפעיל מחדש את מופע Envoy.

כתובת ה-IP של המכונה שגויה

אם מוחקים ויוצרים מחדש את מופע Apigee, כתובת ה-IP של מופע Apigee משתנה ויכול להיות שהיא לא תהיה מסונכרנת עם כתובת ה-IP של נקודת הקצה בתבנית של קבוצת מופעי מכונה מנוהלים (MIG). לדוגמה, בתבנית ה-MIG עדיין תופיע כתובת ה-IP הישנה מהמופע שנמחק. תבנית ה-MIG נוצרה במהלך תהליך ההקצאה של Apigee. במצב כזה, אפשר לנסות את השלבים הבאים כדי לעדכן את תבנית ה-MIG עם כתובת ה-IP הנכונה של Apigee:

  1. במסוף Google Cloud , נכנסים לדף Apigee > Admin > Instances.

    כניסה לדף Instances

  2. שימו לב לכתובת ה-IP של המכונה. תצטרכו לדעת את כתובת ה-IP הזו בשלב מאוחר יותר. לדוגמה: 10.117.200.2.

  3. נכנסים לדף Instance templates במסוף Google Cloud .

    כניסה לדף Instance templates

  4. פותחים את תבנית של הגדרות מכונה. צריך לפתוח את תבנית של הגדרות מכונה שמשמשת את הבק-אנד שממופה למאזן העומסים (LB).
  5. גוללים למטה כדי למצוא את ENDPOINT ה-IP בקטע Custom metadata (מטא נתונים בהתאמה אישית).
  6. אם כתובת ה-IP של נקודת הקצה שונה מזו שרשמתם בממשק המשתמש של Apigee, עליכם לשנות את כתובת ה-IP של תבנית של הגדרות מכונה כך שתהיה זהה לכתובת ה-IP של מכונת Apigee. מידע נוסף זמין במאמר בנושא שינוי כתובות IP של מכונות.