איך מתחברים מהמחשב הנייד

כדי לבדוק את AlloyDB ל-PostgreSQL או לעבוד בסביבת פיתוח מקומית, אתם יכולים ליצור חיבור מאובטח מהמחשב הנייד או מתחנת העבודה המקומית למכונה של AlloyDB באמצעות AlloyDB Auth Proxy דרך כתובת IP ציבורית.

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

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

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

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

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

הפעלת כתובת IP ציבורית במכונה של AlloyDB

הדרך הכי פשוטה להתחבר מהמחשב הנייד היא להפעיל כתובת IP ציבורית במכונה של AlloyDB. אפשר להפעיל כתובת IP ציבורית כשיוצרים מכונה או כשמעדכנים מכונה קיימת כדי להפעיל אותה.

המסוף

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

    כניסה לדף Clusters

  2. כדי לראות את פרטי האשכול, לוחצים על אשכול ב-Resource Name.

  3. בקטע Instances in your cluster, מאתרים את המכונה שרוצים להתחבר אליה.

  4. לוחצים על Instance actions ואז על Edit.

  5. בקטע Connectivity, בוחרים באפשרות Enable Public IP.

  6. כדי לשמור את השינויים, לוחצים על Update instance.

gcloud

משתמשים בפקודה gcloud alloydb instances update כדי להפעיל כתובת IP ציבורית במכונה:

gcloud alloydb instances update INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --assign-inbound-public-ip=ASSIGN_IPV4

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

  • ‫INSTANCE_ID: המזהה של מכונת AlloyDB.
  • ‫CLUSTER_ID: מזהה האשכול.
  • ‫REGION_ID: האזור שבו נמצא האשכול.

אחזור ה-URI של החיבור למכונה

כשמפעילים את לקוח Auth Proxy, צריך לזהות את המכונה באמצעות ה-URI הייחודי שלה לחיבור. מאחזרים את ה-URI של החיבור באמצעות הפקודה alloydb instances describe של ה-CLI של gcloud בטרמינל של המחשב הנייד.

gcloud alloydb instances describe INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --format="value(name)"

הפקודה מחזירה את ה-URI של החיבור, בפורמט שדומה לזה:

projects/myproject/locations/us-central1/clusters/mycluster/instances/myprimary

הפעלת AlloyDB Auth Proxy עם כתובת IP ציבורית

עכשיו, כשיש לכם את ה-URI של החיבור למכונה, אתם יכולים להפעיל את לקוח Auth Proxy באמצעות הטרמינל של המחשב הנייד. משתמשים בדגל --public-ip כדי להורות ל-AlloyDB Auth Proxy להתחבר דרך נתיב הרשת של כתובת ה-IP הציבורית.

./alloydb-auth-proxy CONNECTION_URI --public-ip

מחליפים את CONNECTION_URI במזהה ה-URI של החיבור למכונה שקיבלתם בקטע אחזור מזהה ה-URI של החיבור למכונה.

כשה-AlloyDB Auth Proxy מופעל בהצלחה, בטרמינל מוצג שה-AlloyDB Auth Proxy מאזין לחיבורי TCP מקומיים ביציאה 5432:

Authorizing with Application Default Credentials
Listening on 127.0.0.1:5432
The proxy has started successfully and is ready for new connections!

התחברות למסד הנתונים באמצעות psql

בזמן ש-AlloyDB Auth Proxy פועל, פותחים חלון טרמינל נפרד במחשב הנייד כדי להתחבר למסד הנתונים.

מריצים את כלי הלקוח psql, ומטרגטים את כתובת המאזין המקומית 127.0.0.1 ואת היציאה 5432:

psql -h 127.0.0.1 -U postgres -d postgres

כשמוצגת בקשה, מזינים את הסיסמה של משתמש מסד הנתונים postgres.

הפקודה psql מתחברת ללקוח של שרת ה-proxy לאימות, שמעביר את החיבור דרך מנהרה מאובטחת למכונה של AlloyDB. הפקודה psql מציגה הנחיה שמאשרת שהמחשב הנייד מחובר באופן מאובטח למכונה של AlloyDB:

psql (18.2 (Debian 18.2-1), server 16.11)
Type "help" for help.

postgres=>

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