התחברות ל-AlloyDB מ-Cloud Shell באמצעות שרת proxy לאימות

התחברות ל-AlloyDB מ-Cloud Shell באמצעות שרת proxy לאימות

כדי להתחבר למכונה של AlloyDB ל-PostgreSQL ולהריץ שאילתות SQL ממסוף דפדפן שהוגדר מראש בלי להתקין כלי לקוח מקומיים, אתם יכולים להשתמש ב-Cloud Shell וב-AlloyDB Auth Proxy.

לפני שמתחילים

1. בדף לבחירת הפרויקט במסוף Google Cloud , בוחרים פרויקט ב- Google Cloud או יוצרים אותו.

   כניסה לדף לבחירת הפרויקט

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

3. מוודאים שיש לכם מכונה של AlloyDB שמוגדרת לכתובת IP ציבורית. אי אפשר לחבר את Cloud Shell לכתובת IP פרטית.

התפקידים הנדרשים

כדי להשתמש ב-Auth Proxy, לחשבון המשתמש שלכם צריכים להיות התפקידים הבאים בממשק לניהול הזהויות והרשאות הגישה (IAM):

• לקוח AlloyDB‏ (roles/alloydb.client)
• Service Usage Consumer (roles/serviceusage.serviceUsageConsumer)

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

1. נכנסים לדף IAM במסוף Google Cloud .

   כניסה לדף IAM

2. מאתרים את חשבון המשתמש ברשימת החשבונות הראשיים.

3. לוחצים על Edit principal.

4. לוחצים על הוספת תפקיד.

5. מחפשים ובוחרים את התפקיד AlloyDB Client.

6. לוחצים על אישור.

7. לוחצים על הוספת תפקיד.

8. מחפשים את התפקיד Service Usage Consumer ובוחרים אותו.

9. לוחצים על אישור.

10. לוחצים על Save.

הערה: יכול להיות שיעברו כמה דקות עד שהרשאות IAM חדשות יהיו פעילות.

התחברות למכונה ב-AlloyDB

סביבת Cloud Shell כוללת את שרת ה-proxy לאימות (alloydb-auth-proxy) ואת psql, המסוף האינטראקטיבי של PostgreSQL.

1. מפעילים את Cloud Shell.

   הפעלת Cloud Shell

2. לוחצים על Authorize Cloud Shell. צריך לעשות את זה רק בפעם הראשונה שמשתמשים ב-Cloud Shell.

3. מאשרים את זהות המשתמש בעורך של Cloud Shell. מוודאים שאתם מחוברים לחשבון המשתמש עם התפקידים הנדרשים ב-IAM.

   gcloud config list
   

4. משיגים את ה-URI של החיבור למכונה:

   1. נכנסים לדף Clusters במסוף Google Cloud .

      כניסה לדף Clusters

   2. בוחרים את האשכול ומוצאים את המכונה הראשית.

   3. לוחצים על הצגת הגדרות הקישוריות.

   4. מעתיקים את Connection URI.

5. מפעילים את Auth Proxy. בטרמינל של Cloud Shell, משתמשים ב-URI שהועתק ומציינים את הדגל --public-ip:

   alloydb-auth-proxy CONNECTION_URI --public-ip
   

   מחליפים את מה שכתוב בשדות הבאים:

   • ‫CONNECTION_URI: ה-URI של החיבור שהעתקתם ממסוף Google Cloud .

   ‫Auth Proxy מופעל ומוצגת הודעה שמאשרת שהוא מאזין ב-127.0.0.1:5432.

6. פותחים כרטיסייה חדשה ב-Cloud Shell ומתחברים למסד הנתונים באמצעות psql:

   psql "host=localhost user=POSTGRES_USERNAME dbname=POSTGRES_DATABASE port=5432"
   

   כדי לפתוח חלונית טרמינל חדשה בחלון הקיים של Cloud Shell, לוחצים על Control+b+" או על Add. כך תוכלו להמשיך להריץ את שרת ה-Proxy לאימות בחלונית אחת, בזמן שאתם מריצים פקודות חיבור בחלונית השנייה.

   כדי לעבור בין החלוניות, לוחצים על Control+b+keyboard_arrow_up או על Control+b+keyboard_arrow_down.

   מחליפים את מה שכתוב בשדות הבאים:

   • ‫POSTGRES_USERNAME: המשתמש ב-AlloyDB, בדרך כלל postgres.
   • ‫POSTGRES_DATABASE: השם של מסד הנתונים ב-AlloyDB, בדרך כלל postgres.

7. כשמוצגת בקשה, מזינים את הסיסמה של המשתמש ב-PostgreSQL.

8. כדי לאמת את החיבור, מריצים שאילתת SQL:

   SELECT now();
   

9. כדי להפסיק את psql, מזינים \q.

10. כדי לעצור את Cloud Shell, מזינים exit.

11. כדי לעצור את שרת ה-proxy לאימות, מקישים על Control+c.

הסרת המשאבים

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

1. נכנסים לדף Clusters במסוף Google Cloud .

   כניסה לדף Clusters

2. לוחצים על האשכול שיצרתם.

3. לוחצים על Delete cluster.

4. בתיבת הדו-שיח לאישור, מזינים את מזהה האשכול ולוחצים על Delete כדי למחוק את האשכול ואת המכונות שלו.

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

• דרכים נוספות להתחבר ל-AlloyDB