פתרון בעיות בחיבורים של AlloyDB Auth Proxy

כדי לפתור שגיאות בחיבור, באימות או שגיאות בחיבור לרשת כשמתחברים למכונה של AlloyDB ל-PostgreSQL באמצעות שרת ה-proxy לאימות ב-AlloyDB, כדאי לבדוק את הבעיות והפתרונות הנפוצים הבאים:

  • בודקים בקפידה את הפלט של AlloyDB Auth Proxy ומחפשים שגיאות. לרוב, הודעות השגיאה מספקות את המידע שצריך כדי לזהות את מקור הבעיה ולפתור אותה.

  • אם אתם מקבלים את השגיאה 403 Forbidden ומשתמשים בחשבון שירות כדי לאמת את AlloyDB Auth Proxy, ודאו שלחשבון השירות יש את ההרשאות הנכונות.

    תפקידי ניהול הזהויות והרשאות הגישה (IAM) המוגדרים מראש ב-AlloyDB שמספקים את ההרשאות האלה הם לקוח AlloyDB‏ (roles/alloydb.client) ואדמין AlloyDB‏ (roles/alloydb.admin). בנוסף, צריך להוסיף את התפקיד "צרכן השימוש בשירות" (roles/serviceusage.serviceUsageConsumer).

  • חשוב לוודא ש-AlloyDB API מופעל.

    אם הוא לא מופעל, ביומנים של AlloyDB Auth Proxy יופיע פלט כמו Error 403: Access Not Configured.

  • אם אתם מתחברים באמצעות שקעי UNIX, ודאו שהשקעים נוצרו על ידי הצגת הספרייה שסיפקתם כשהפעלתם את שרת ה-Proxy לאימות ב-AlloyDB.

  • אם יש לכם מדיניות חומת אש לתעבורה יוצאת, ודאו שהיא מאפשרת חיבורים ליציאה 5433 במכונה של AlloyDB.

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

  • אם קיבלתם תשובה מסוג 400 Bad Request עם הודעת שגיאה שמכילה את הטקסט reauth related error, אתם צריכים לרענן את Application Default Credentials באמצעות Google Cloud CLI:

    gcloud auth application-default login

    למידע נוסף, קראו את המאמר סקירה כללית על Application Default Credentials.