קישור באמצעות ה-CLI של gcloud

הפקודה gcloud beta alloydb connect מאפשרת ליצור חיבור מוצפן ומורשה למכונה של AlloyDB ל-PostgreSQL. הוא מפעיל באופן אוטומטי את AlloyDB Auth Proxy ומריץ את כלי הלקוח של psql.

השתמשו בפקודה הזו לניהול ולפיתוח ידני של מסדי נתונים מסביבות כמו המכונה המקומית או Cloud Shell.

מידע נוסף זמין בקטע סקירה כללית של החיבור.

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

  1. מתקינים את Google Cloud CLI.
  2. מתקינים את כלי הלקוח של psql.
  3. מוודאים שלחשבון המשתמש שלכם בניהול זהויות והרשאות גישה (IAM) יש את התפקיד "לקוח AlloyDB" (roles/alloydb.client). מידע נוסף זמין במאמר ניהול אימות IAM.

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

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

gcloud beta alloydb connect INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID

חיבור באמצעות כתובת IP ציבורית

אם למכונה יש כתובת IP ציבורית, אפשר להתחבר אליה על ידי הוספת הדגל --public-ip:

gcloud beta alloydb connect INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --public-ip

אימות באמצעות IAM

הפקודה gcloud beta alloydb connect תומכת באימות אוטומטי ב-IAM. משתמשים בדגל --auto-iam-authn כדי לבצע אימות כמשתמש שמחובר ל-CLI של gcloud או כחשבון שירות.

gcloud beta alloydb connect INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --auto-iam-authn

מידע נוסף על אימות IAM זמין במאמר אימות מסד נתונים של IAM.

חיבור באמצעות Private Service Connect

אם אתם משתמשים ב-Private Service Connect, הוסיפו את הדגל --psc:

gcloud beta alloydb connect INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --psc

התחברות למשתמש ולמסד נתונים ספציפיים

כדי להתחבר למסד נתונים ספציפי כמשתמש ספציפי, משתמשים בדגלים --user ו---database:

gcloud beta alloydb connect INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --user=USER_NAME \
    --database=DATABASE_NAME

התחזות לחשבון שירות

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

כדי להתחבר באמצעות חשבון שירות שבוצעה אליו התחזות, מוסיפים את הדגל --impersonate-service-account:

gcloud beta alloydb connect INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --impersonate-service-account=SERVICE_ACCOUNT_EMAIL

שרת ה-proxy לאימות משתמש בחשבון השירות המתחזה כדי לאחזר את פרטי החיבור. עם זאת, הוא לא מבצע אימות אוטומטי למסד הנתונים. כדי לבצע אימות גם למסד הנתונים כחשבון השירות שאליו בוצעה ההתחזות, מוסיפים את הדגל --auto-iam-authn. חשבון השירות שמתחזים אליו צריך להיות משתמש במסד הנתונים.

gcloud beta alloydb connect INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --impersonate-service-account=SERVICE_ACCOUNT_EMAIL \
    --auto-iam-authn

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