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

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

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

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

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

  1. מתקינים את ה-CLI של gcloud.
  2. מתקינים את כלי הלקוח psql.
  3. מוודאים שלחשבון המשתמש ב-IAM יש את התפקיד 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 כדי לבצע אימות כמשתמש 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 של AlloyDB Auth משתמש בפרטי הכניסה של חשבון השירות שצוין כדי לאחזר את פרטי החיבור.

כדי להתחבר באמצעות חשבון שירות שבוצעה אליו התחזות, מוסיפים את הדגל --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

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