כדי לבדוק את AlloyDB ל-PostgreSQL או לעבוד בסביבת פיתוח מקומית, אתם יכולים ליצור חיבור מאובטח מהמחשב הנייד או מתחנת העבודה המקומית למכונה של AlloyDB באמצעות AlloyDB Auth Proxy דרך כתובת IP ציבורית.
לפני שמתחילים
לפני שמתחברים מהמחשב הנייד, צריך לבצע את הפעולות הבאות:
- מתקינים ומפעילים את ה-CLI של gcloud. משתמשים ב-CLI של gcloud כדי לאמת את הפקודות ולאחזר את פרטי המכונה.
- מתקינים את כלי שורת הפקודה של
psql. משתמשים בכלי הלקוחpsqlבתור לקוח מסד הנתונים של מסוף PostgreSQL. - הורדת הלקוח של Auth Proxy. משתמשים בלקוח Auth Proxy כדי ליצור מנהרה מאובטחת למכונה של AlloyDB.
- הגדרת התפקידים הנדרשים.
התפקידים הנדרשים
כדי להתחבר מהמחשב הנייד, צריך להקצות לחשבון המשתמש (חשבון משתמש או חשבון שירות) בניהול הזהויות והרשאות הגישה (IAM) את התפקידים המוגדרים מראש הבאים:
- לקוח AlloyDB (
roles/alloydb.client) - Service Usage Consumer (
roles/serviceusage.serviceUsageConsumer)
הפעלת כתובת IP ציבורית במכונה של AlloyDB
הדרך הכי פשוטה להתחבר מהמחשב הנייד היא להפעיל כתובת IP ציבורית במכונה של AlloyDB. אפשר להפעיל כתובת IP ציבורית כשיוצרים מכונה או כשמעדכנים מכונה קיימת כדי להפעיל אותה.
המסוף
נכנסים לדף Clusters במסוף Google Cloud .
כדי לראות את פרטי האשכול, לוחצים על אשכול ב-Resource Name.
בקטע Instances in your cluster, מאתרים את המכונה שרוצים להתחבר אליה.
לוחצים על Instance actions ואז על Edit.
בקטע Connectivity, בוחרים באפשרות Enable Public IP.
כדי לשמור את השינויים, לוחצים על 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=>