התחברות מ-Compute Engine

‫MySQL   |  PostgreSQL   |  SQL Server

בדף הזה מוסבר איך להשתמש בלקוח psql, שמותקן במכונה של Compute Engine, כדי להתחבר ל-Cloud SQL.

אפשר להשתמש בכתובת IP פרטית, בכתובת IP ציבורית, ב-Cloud SQL Auth Proxy או בקובץ אימג' של Docker ל-Cloud SQL Auth Proxy.

להוראות מפורטות להרצת אפליקציית אינטרנט לדוגמה של Compute Engine שמחוברת ל-Cloud SQL, קראו את המדריך למתחילים להתחברות מ-Compute Engine.

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

המשימה הזו לא כוללת הוראות להגדרת מכונה של Compute Engine. אם אתם צריכים עזרה ביצירה ובהגדרה של מכונה ב-Compute Engine, תוכלו להיעזר במאמרי העזרה של Compute Engine.

מוודאים שלמכונה הווירטואלית ב-Compute Engine יש את scope המתאימים כדי להתחבר באמצעות Cloud SQL Admin API.

מגדירים את חשבון השירות כך שיהיה לו אחד מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/sqlservice.admin
• https://www.googleapis.com/auth/cloud-platform

אם המכונה הווירטואלית ב-Compute Engine או רשת ה-VPC מגבילות את תעבורת הנתונים היוצאת, צריך לוודא שהכללים של חומת האש מאפשרים חיבורי TCP יוצאים ביציאות היעד הנדרשות:

• חיבורים ישירים דרך כתובת IP פרטית, כתובת IP ציבורית או Private Service Connect: מאפשרים חיבורי TCP יוצאים ליציאת ברירת המחדל של PostgreSQL, ‏5432, בכתובת ה-IP של המכונה ב-Cloud SQL. בחיבורים ישירים לשרת Managed Connection Pooling, מאפשרים חיבורי TCP יוצאים ליציאה 6432.
• ‫Cloud SQL Auth Proxy או מחברי שפה של Cloud SQL: מאפשרים חיבורי TCP יוצאים ליציאה 3307 בכתובת ה-IP של מכונת Cloud SQL וליציאה 443 לבקשות API של sqladmin.googleapis.com. כשמשתמשים בשקע TCP מקומי ב-VM, לקוח מסד הנתונים מתחבר ל-Cloud SQL Auth Proxy ב-127.0.0.1:5432 או ביציאה שצוינה באמצעות --port.

כתובת IP פרטית

כדי להתחבר ל-Cloud SQL ממכונה של Compute Engine באמצעות כתובת IP פרטית, צריך להגדיר גישה לשירותים פרטיים בסביבה שלכם ולהגדיר את מכונת Cloud SQL כך שתשתמש בכתובת IP פרטית. המכונה של Compute Engine צריכה להיות באותו אזור כמו המכונה של Cloud SQL, וברשת שמוגדרת לחיבור פרטי. מידע נוסף

1. הגדרת המכונה לשימוש בכתובת IP פרטית

משתמשים בהוראות שבמאמר הגדרת קישוריות של כתובת IP פרטית.

2. פותחים חיבור טרמינל של Cloud Shell למכונה של Compute Engine.

משתמשים בהוראות המתאימות, בהתאם למערכת ההפעלה של המכונה:

• ב-Linux, קראו את המאמר התחברות למכונות וירטואליות של Linux.
• ב-Windows, קראו את המאמר התחברות למכונות וירטואליות של Windows.

אם במכונה של Compute Engine פועלת תמונה ציבורית של RHEL או CentOS, יכול להיות ש-SELinux יחסום את החיבור לשרת ה-Proxy. במקרה כזה, צריך להגדיר את התכונה SELinux כך שתאפשר את החיבור.

מידע נוסף על SELinux ל-RHEL זמין ב מאמרי העזרה של RHEL. למידע נוסף על SELinux ל-CentOS, קראו את המסמכים של CentOS.

3. אם הלקוח psql לא מותקן במכונה של Compute Engine, מתקינים אותו.

Debian/Ubuntu

מתקינים את לקוח psql ממנהל החבילות:

sudo apt-get update
sudo apt-get install postgresql-client

CentOS/RHEL

מתקינים את לקוח psql ממנהל החבילות:

sudo yum install postgresql

openSUSE

מתקינים את לקוח psql ממנהל החבילות:

sudo zypper install postgresql

פלטפורמות אחרות

1. מורידים את PostgreSQL Core Distribution לפלטפורמה שלכם מדף ההורדות של PostgreSQL. ‫
   ההפצה הבסיסית כוללת את הלקוח psql.
2. מתקינים את מסד הנתונים של PostgreSQL לפי ההוראות שבדף ההורדה.

4. מתחברים ללקוח psql.

psql -h CLOUD_SQL_PRIVATE_IP_ADDRESS -U USERNAME

אפשר למצוא את כתובת ה-IP הפרטית בדף המכונות של Cloud SQL או על ידי הפעלת הפקודה הבאה של gcloud:

gcloud sql instances list

כתובת IP ציבורית

כדי להתחבר באמצעות כתובת IP ציבורית:

1. אם למכונה של Compute Engine אין כתובת IP סטטית מסוג IPv4, מוסיפים לה כתובת כזו.

אי אפשר להתחבר ל-Compute Engine באמצעות IPv6. למידע על הוספת כתובת IP סטטית, קראו את המאמר שמירת כתובת IP חיצונית סטטית חדשה במסמכי התיעוד של Compute Engine.

2. מאשרים את כתובת ה-IP הסטטית של המכונה ב-Compute Engine כרשת שיכולה להתחבר למכונה ב-Cloud SQL.

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

הערה: צריך לתת הרשאה רק לכתובות IP סטטיות. כתובות IP זמניות הן זמניות. אם תתנו להן גישה למכונה, זה יסכן את האבטחה כי יכול להיות שהן יוקצו למשתמש אחר ב-Compute Engine בהמשך.

3. פותחים חיבור טרמינל של Cloud Shell למכונה של Compute Engine.

משתמשים בהוראות המתאימות, בהתאם למערכת ההפעלה של המכונה:

• ב-Linux, קראו את המאמר התחברות למכונות וירטואליות של Linux.
• ב-Windows, קראו את המאמר התחברות למכונות וירטואליות של Windows.

אם במכונה של Compute Engine פועלת תמונה ציבורית של RHEL או CentOS, יכול להיות ש-SELinux יחסום את החיבור לשרת ה-Proxy. במקרה כזה, צריך להגדיר את התכונה SELinux כך שתאפשר את החיבור.

מידע נוסף על SELinux ל-RHEL זמין ב מאמרי העזרה של RHEL. למידע נוסף על SELinux ל-CentOS, קראו את המסמכים של CentOS.

4. אם הלקוח psql לא מותקן במכונה של Compute Engine, מתקינים אותו.

Debian/Ubuntu

מתקינים את לקוח psql ממנהל החבילות:

sudo apt-get update
sudo apt-get install postgresql-client

CentOS/RHEL

מתקינים את לקוח psql ממנהל החבילות:

sudo yum install postgresql

openSUSE

מתקינים את לקוח psql ממנהל החבילות:

sudo zypper install postgresql

פלטפורמות אחרות

1. מורידים את PostgreSQL Core Distribution לפלטפורמה שלכם מדף ההורדות של PostgreSQL. ‫
   ההפצה הבסיסית כוללת את הלקוח psql.
2. מתקינים את מסד הנתונים של PostgreSQL לפי ההוראות שבדף ההורדה.

5. מתחברים ללקוח psql.

psql -h CLOUD_SQL_PUBLIC_IP_ADDR -U USERNAME

אפשר למצוא את כתובת ה-IP הציבורית בדף המכונות של Cloud SQL או על ידי הפעלת הפקודה הבאה של gcloud:

gcloud sql instances list

דוגמה לחיבור באמצעות SSL מופיעה במאמר חיבור באמצעות SSL.

6. מופיעה ההנחיה psql.

7. אם אתם צריכים להשאיר חיבורים לא פעילים:

מגדירים את TCP keepalive.

למידע נוסף, קראו את המאמר תקשורת בין המכונות שלכם לבין האינטרנט במרכז העזרה של Compute Engine.

החיבורים נשארים פעילים באופן אוטומטי במכונות.

Cloud SQL Auth Proxy

כדי להתחבר באמצעות Cloud SQL Auth Proxy מ-Compute Engine:

1. מפעילים את Cloud SQL Admin API.

התפקידים שנדרשים כדי להפעיל ממשקי API

כדי להפעיל ממשקי API, צריך את ההרשאה serviceusage.services.enable. אם יצרתם את הפרויקט, סביר להניח שכבר יש לכם את ההרשאה הזו דרך התפקיד "בעלים" (roles/owner). אחרת, תוכלו לקבל את ההרשאה הזו דרך התפקיד "אדמין בממשק 'שימוש בשירות'" (roles/serviceusage.serviceUsageAdmin). איך מקצים תפקידים

להפעלת ה-API

2. יוצרים חשבון שירות.

הערה: אם למכונה של Compute Engine יש את ההיקף Full API access או Cloud SQL Admin API, אפשר לדלג על השלב הזה. לא צריך לספק קובץ אישור כשמפעילים את Cloud SQL Auth Proxy.

אם אתם מתחברים מ-Compute Engine, ודאו של-VM יש את scope המתאים להתחברות באמצעות Cloud SQL Admin API.

מגדירים את חשבון השירות כך שיהיה לו אחד מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/sqlservice.admin
• https://www.googleapis.com/auth/cloud-platform

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

   כניסה לדף Service accounts

2. בוחרים את הפרויקט שמכיל את המכונה של Cloud SQL.
3. לוחצים על Create service account.
4. בשדה Service account name, מזינים שם תיאורי לחשבון השירות.
5. משנים את הערך של Service account ID לערך ייחודי וקל לזיהוי, ולוחצים על Create and continue.
6. לוחצים על השדה בחירת תפקיד ובוחרים אחד מהתפקידים הבאים:
   • Cloud SQL > Cloud SQL Client
   • Cloud SQL > Cloud SQL Editor
   • Cloud SQL > Cloud SQL Admin
   הערה: כדי ליצור חשבון שירות עם ההרשאות הנדרשות, צריכה להיות לכם ההרשאה resourcemanager.projects.setIamPolicy. ההרשאה הזו כלולה בתפקידים Project Owner, אדמין IAM בפרויקט ו-Organization Administrator.
   צריך גם להפעיל את Cloud SQL Admin API. אם משתמשים בתפקידים מדור קודם בפרויקט (צפייה, עריכה, בעלים), לחשבון השירות צריך להיות לפחות תפקיד עריכה.
7. לוחצים על Done כדי לסיים ליצור את חשבון השירות.
8. לוחצים על תפריט הפעולות של חשבון השירות החדש ובוחרים באפשרות Manage keys.
9. לוחצים על התפריט הנפתח Add key ואז על Create new key.
10. מוודאים שסוג המפתח הוא JSON ולוחצים על Create.

    קובץ המפתח הפרטי יורד למחשב. אפשר להעביר אותו למיקום אחר. שומרים על אבטחת קובץ המַפְתח.

אם המכונה של Compute Engine נמצאת בפרויקט אחר מזה של המכונה של Cloud SQL, צריך לוודא שלחשבון השירות שלה יש את ההרשאות המתאימות בפרויקט שמכיל את המכונה של Cloud SQL:

1. נכנסים לרשימת המכונות של Compute Engine במסוף Google Cloud .

   לרשימת המכונות של Compute Engine

2. אם צריך, בוחרים את הפרויקט שמשויך למכונה של Compute Engine.
3. בוחרים את המכונה של Compute Engine כדי להציג את המאפיינים שלה.
4. במאפיינים של המכונה ב-Compute Engine, מעתיקים את השם של חשבון השירות.
5. נכנסים לדף IAM & Admin Projects במסוף Google Cloud .

   כניסה לדף IAM & Admin Projects

6. בוחרים את הפרויקט שמכיל את המכונה של Cloud SQL.
7. מחפשים את השם של חשבון השירות.

8. אם חשבון השירות כבר מופיע ויש לו תפקיד שכולל את ההרשאה cloudsql.instances.connect, אתם יכולים להמשיך לשלב 4.

   התפקידים Cloud SQL Client, ‏ Cloud SQL Editor ו-Cloud SQL Admin מספקים את ההרשאה הנדרשת, כמו גם התפקידים הקודמים Editor ו-Owner בפרויקט.

9. אם לא, מוסיפים את חשבון השירות בלחיצה על Add.

10. בתיבת הדו-שיח Add principals, מזינים את השם של חשבון השירות ובוחרים תפקיד שכולל את ההרשאה cloudsql.instances.connect (כל תפקיד מוגדר מראש של Cloud SQL, חוץ מ-Viewer).

    לחלופין, אפשר להשתמש בתפקיד הבסיסי "עריכה" על ידי בחירה באפשרות Project > Editor, אבל התפקיד הזה כולל הרשאות בכל Google Cloud.

    אם התפקידים האלה לא מופיעים, יכול להיות שלמשתמש Google Cloud אין את ההרשאה resourcemanager.projects.setIamPolicy. כדי לבדוק את ההרשאות, נכנסים לדף IAM במסוף Google Cloud ומחפשים את מזהה המשתמש.

11. לוחצים על הוספה.

    עכשיו חשבון השירות מופיע ברשימה עם התפקיד שצוין.

3. פותחים חיבור טרמינל למכונה של Compute Engine.

משתמשים בהוראות המתאימות, בהתאם למערכת ההפעלה של המכונה:

• ב-Linux, קראו את המאמר התחברות למכונות Linux.
• ב-Windows, קראו את המאמר התחברות למכונות של Windows.

אם במכונה של Compute Engine פועלת תמונה ציבורית של RHEL או CentOS, יכול להיות ש-SELinux יחסום את החיבור לשרת ה-Proxy. במקרה כזה, צריך להגדיר את התכונה SELinux כך שתאפשר את החיבור.

מידע נוסף על SELinux ל-RHEL זמין ב מאמרי העזרה של RHEL. למידע נוסף על SELinux ל-CentOS, קראו את המסמכים של CentOS.

4. אם הלקוח psql לא מותקן במכונה של Compute Engine, מתקינים אותו.

Debian/Ubuntu

מתקינים את לקוח psql ממנהל החבילות:

sudo apt-get update
sudo apt-get install postgresql-client

CentOS/RHEL

מתקינים את לקוח psql ממנהל החבילות:

sudo yum install postgresql

openSUSE

מתקינים את לקוח psql ממנהל החבילות:

sudo zypper install postgresql

פלטפורמות אחרות

1. מורידים את PostgreSQL Core Distribution לפלטפורמה שלכם מדף ההורדות של PostgreSQL. ‫
   ההפצה הבסיסית כוללת את הלקוח psql.
2. מתקינים את מסד הנתונים של PostgreSQL לפי ההוראות שבדף ההורדה.

5. מתקינים את Cloud SQL Auth Proxy במכונה של Compute Engine.

לפני שמתחילים, צריך לזהות את הארכיטקטורה של המכונה.

אם אתם משתמשים ב-Linux או ב-Mac, אתם יכולים להריץ את הפקודה הבאה כדי למצוא את הכתובת:

  uname -a
  

‏Linux‏ 64 סיביות

1. מורידים את Cloud SQL Auth Proxy:

   curl -o cloud-sql-proxy https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.26.2/cloud-sql-proxy.linux.amd64

2. הופכים את Cloud SQL Auth Proxy לקובץ הפעלה:

   chmod +x cloud-sql-proxy

‏Linux‏ 32 סיביות

1. מורידים את Cloud SQL Auth Proxy:

   curl -o cloud-sql-proxy https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.26.2/cloud-sql-proxy.linux.386

2. אם הפקודה curl לא נמצאה, מריצים את sudo apt install curl וחוזרים על פקודת ההורדה.
3. הופכים את Cloud SQL Auth Proxy לקובץ הפעלה:

   chmod +x cloud-sql-proxy

‏Windows‏ 64 סיביות

לוחצים לחיצה ימנית על https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.26.2/cloud-sql-proxy.x64.exe ובוחרים באפשרות Save Link As כדי להוריד את Cloud SQL Auth Proxy. משנים את שם הקובץ ל-cloud-sql-proxy.exe.

‏Windows‏ 32 סיביות

לוחצים לחיצה ימנית על https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.26.2/cloud-sql-proxy.x86.exe ובוחרים באפשרות Save Link As כדי להוריד את Cloud SQL Auth Proxy. משנים את שם הקובץ ל-cloud-sql-proxy.exe.

קובץ אימג' של Docker ל-Cloud SQL Auth Proxy

ל-Cloud SQL Auth Proxy יש קובצי אימג' שונים של קונטיינרים, כמו distroless,‏ alpine ו-buster. קובץ האימג' של הקונטיינר שמשמש כברירת מחדל ל-Cloud SQL Auth Proxy משתמש ב-distroless, שלא מכיל מעטפת. אם אתם צריכים מעטפת או כלים קשורים, הורידו קובץ אימג' שמבוסס על alpine או על buster. מידע נוסף מופיע במאמר קובצי אימג' של קונטיינרים של Cloud SQL Auth Proxy.

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

docker pull gcr.io/cloud-sql-connectors/cloud-sql-proxy:2.26.2

הערה: ה-Cloud SQL Auth Proxy משתמש במאגר שתומך בדומיין gcr.io, אבל מציג קובצי אימג' מ-Artifact Registry. מידע נוסף זמין במאמר מעבר מ-Container Registry.

מערכת הפעלה אחרת

במערכות הפעלה אחרות שלא מופיעות כאן, אפשר להדר את Cloud SQL Auth Proxy מהמקור.

6. מפעילים את Cloud SQL Auth Proxy.

הערה: אם למכונה של Compute Engine יש את ההיקף Full API access או Cloud SQL Admin API, לא צריך לספק קובץ אישור כשמפעילים את Cloud SQL Auth Proxy.

בהתאם לשפה ולסביבה שלכם, אתם יכולים להפעיל את Cloud SQL Auth Proxy באמצעות שקעי TCP, שקעי Unix או קובץ אימג' של Docker ל-Cloud SQL Auth Proxy. הקובץ הבינארי של Cloud SQL Auth Proxy מתחבר למכונה אחת או יותר של Cloud SQL שצוינו בשורת הפקודה, ופותח חיבור מקומי כ-TCP או כשקע Unix. אפליקציות ושירותים אחרים, כמו קוד האפליקציה או כלי לקוח לניהול מסדי נתונים, יכולים להתחבר למכונות של Cloud SQL דרך חיבורי ה-TCP או שקעי Unix.

אזהרה: צריך להיזהר כשמקשרים את Cloud SQL Auth Proxy לממשק חיצוני. כל מי שיש לו גישה לממשק או ליציאה הזו יוכל להתחבר למכונה שלכם.

שקעי TCP

בחיבורי TCP, כברירת מחדל שרת ה-Proxy של Cloud SQL Auth מאזין ל-localhost(127.0.0.1). לכן, כשמציינים את --port PORT_NUMBER למכונה, החיבור המקומי הוא ב-127.0.0.1:PORT_NUMBER.

לחלופין, אפשר לציין כתובת אחרת לחיבור המקומי. לדוגמה, כך מגדירים את Cloud SQL Auth Proxy להאזין ב-0.0.0.0:1234 לחיבור המקומי:

./cloud-sql-proxy --address 0.0.0.0 --port 1234 INSTANCE_CONNECTION_NAME

1. מעתיקים את INSTANCE_CONNECTION_NAME. אפשר למצוא את המידע הזה בדף Overview של המכונה במסוףGoogle Cloud , או באמצעות הרצת הפקודה הבאה:

       gcloud sql instances describe INSTANCE_NAME --format='value(connectionName)'

   לדוגמה: myproject:myregion:myinstance.

2. אם למכונה מוגדרות גם כתובת IP ציבורית וגם כתובת IP פרטית, ואתם רוצים ש-Cloud SQL Auth Proxy ישתמש בכתובת ה-IP הפרטית, אתם צריכים לספק את האפשרות הבאה כשאתם מפעילים את Cloud SQL Auth Proxy:

   --private-ip

3. אם אתם משתמשים בחשבון שירות כדי לאמת את Cloud SQL Auth Proxy, שימו לב למיקום במכונת הלקוח של קובץ המפתח הפרטי שנוצר כשיצרתם את חשבון השירות.
4. מפעילים את Cloud SQL Auth Proxy.

   כמה מחרוזות אפשריות להפעלה של Cloud SQL Auth Proxy:

   • שימוש באימות של Cloud SDK:

     ./cloud-sql-proxy --port 5432 INSTANCE_CONNECTION_NAME

     היציאה שצוינה לא יכולה להיות בשימוש, למשל על ידי שרת מסד נתונים מקומי.
   • שימוש בחשבון שירות וציון מפורש של שם החיבור למכונה (מומלץ לסביבות ייצור):

     ./cloud-sql-proxy \
     --credentials-file PATH_TO_KEY_FILE INSTANCE_CONNECTION_NAME &

   למידע נוסף על האפשרויות של Cloud SQL Auth Proxy, ראו אפשרויות לאימות של Cloud SQL Auth Proxy.

שקעי Unix

הערה: בשלב הזה, Cloud SQL Auth Proxy לא תומך בשקעי Unix ב-Windows, ולכן האפשרות הזו זמינה רק בפלטפורמות של Linux ו-macOS.

‫Cloud SQL Auth Proxy יכול להאזין לשקע Unix, שהוא מנגנון סטנדרטי של Posix לשימוש בתיקייה כדי לנהל את התקשורת בין שני תהליכים שפועלים באותו מארח. היתרונות של שימוש בשקעי Unix הם אבטחה משופרת וזמן אחזור קצר יותר, אבל אי אפשר לגשת לשקע Unix ממכונה חיצונית.

הערה: התקן של PostgreSQL דורש סיומת ‎.s.PGSQL.5432 בנתיב של השקע. בחלק מהספריות הסיומת הזו מתווספת באופן אוטומטי, אבל באחרות צריך לציין את נתיב ה-socket באופן הבא:

  /cloudsql/INSTANCE_CONNECTION_NAME/.s.PGSQL.5432
  

כדי ליצור שקע Unix ולהשתמש בו, ספריית היעד צריכה להיות קיימת, וגם ל-Cloud SQL Auth Proxy וגם לאפליקציה צריכה להיות גישת קריאה וכתיבה אליה.

1. מעתיקים את INSTANCE_CONNECTION_NAME. אפשר למצוא את המידע הזה בדף Overview של המכונה במסוףGoogle Cloud , או באמצעות הרצת הפקודה הבאה:

       gcloud sql instances describe INSTANCE_NAME --format='value(connectionName)'

   לדוגמה: myproject:myregion:myinstance.

2. יוצרים את הספרייה שבה יישמרו השקעים של Cloud SQL Auth Proxy:

   sudo mkdir /cloudsql; sudo chmod 777 /cloudsql

3. אם אתם משתמשים בחשבון שירות כדי לאמת את Cloud SQL Auth Proxy, שימו לב למיקום במכונת הלקוח של קובץ המפתח הפרטי שנוצר כשיצרתם את חשבון השירות.
4. פותחים חלון טרמינל חדש ב-Cloud Shell ומפעילים את Cloud SQL Auth Proxy.

   כמה מחרוזות אפשריות להפעלה של Cloud SQL Auth Proxy:

   • שימוש באימות של Google Cloud SDK:

     ./cloud-sql-proxy --unix-socket /cloudsql INSTANCE_CONNECTION_NAME &

   • שימוש בחשבון שירות:

       ./cloud-sql-proxy --unix-socket /cloudsql
       --credentials-file PATH_TO_KEY_FILE INSTANCE_CONNECTION_NAME &

   מפעילים את Cloud SQL Auth Proxy בטרמינל משלו ב-Cloud Shell, כדי שתוכלו לעקוב אחרי הפלט שלו בלי שהוא יתערבב עם פלט מתוכנות אחרות.

   למידע נוסף על האפשרויות של Cloud SQL Auth Proxy, ראו אפשרויות לאימות של Cloud SQL Auth Proxy.

   הערה: כשמשתמשים בשקע של Unix כדי להתחבר ל-Cloud SQL באמצעות Cloud SQL Auth Proxy, חשוב לוודא שאורך שם הקובץ של השקע לא חורג מהמגבלה של המערכת. זה תלוי במערכת, אבל בדרך כלל האורך הוא בין 91 ל-108 תווים. ב-Linux, האורך בדרך כלל מוגדר כ-108, ואפשר להשתמש בפקודה הבאה כדי לבדוק:

   cat /usr/include/linux/un.h | grep "define UNIX_PATH_MAX"

Docker

כדי להריץ את Cloud SQL Auth Proxy בקונטיינר של Docker, משתמשים בקובץ האימג' של Cloud SQL Auth Proxy ל-Docker שזמין ב-Google Container Registry.

אפשר להפעיל את Cloud SQL Auth Proxy באמצעות שקעי TCP או שקעי Unix, בעזרת הפקודות שמוצגות בהמשך. האפשרויות משתמשות ב-INSTANCE_CONNECTION_NAME כמחרוזת החיבור כדי לזהות מכונה של Cloud SQL. אפשר למצוא את הערך של INSTANCE_CONNECTION_NAME בדף Overview של המכונה במסוףGoogle Cloud , או על ידי הרצת הפקודה הבאה:

gcloud sql instances describe INSTANCE_NAME

לדוגמה: myproject:myregion:myinstance.

הערה: Cloud SQL Auth Proxy לא תומך בהאזנה לשקעי דומיין של Unix ב-Windows.

בהתאם לשפה ולסביבה שלכם, אתם יכולים להפעיל את Cloud SQL Auth Proxy באמצעות שקעי TCP או שקעי Unix. אין תמיכה בשקעי Unix באפליקציות שכתובות בשפת התכנות Java או בסביבת Windows.

שימוש בשקעי TCP

docker run -d \
  -v PATH_TO_KEY_FILE:/path/to/service-account-key.json \
  -p 127.0.0.1:5432:5432 \
  gcr.io/cloud-sql-connectors/cloud-sql-proxy:2.26.2 \
  --address 0.0.0.0 --port 5432 \
  --credentials-file /path/to/service-account-key.json INSTANCE_CONNECTION_NAME

אם אתם משתמשים בפרטי הכניסה שסופקו על ידי המכונה של Compute Engine, אל תכללו את הפרמטר --credentials-file ואת השורה -v PATH_TO_KEY_FILE:/path/to/service-account-key.json.

תמיד צריך לציין את הקידומת 127.0.0.1 ב--p כדי ש-Cloud SQL Auth Proxy לא ייחשף מחוץ למארח המקומי. הדגל --address 0.0.0.0 נדרש כדי שהיציאה תהיה נגישה מחוץ לקונטיינר של Docker.

שימוש בשקעי Unix

docker run -d -v /cloudsql:/cloudsql \
  -v PATH_TO_KEY_FILE:/path/to/service-account-key.json \
  gcr.io/cloud-sql-connectors/cloud-sql-proxy:2.26.2 \
  --unix-socket /cloudsql \
  --credentials-file /path/to/service-account-key.json INSTANCE_CONNECTION_NAME

אם אתם משתמשים בפרטי הכניסה שסופקו על ידי המכונה של Compute Engine, אל תכללו את הפרמטר --credentials-file ואת השורה -v PATH_TO_KEY_FILE:/path/to/service-account-key.json.

אם משתמשים בתמונה שעברה אופטימיזציה לקונטיינר, צריך להשתמש בספרייה שניתן לכתוב בה במקום /cloudsql, לדוגמה:

-v /mnt/stateful_partition/cloudsql:/cloudsql

אפשר לציין יותר ממכונה אחת, ולהפריד ביניהן באמצעות רווחים. אפשר גם להשתמש במטא-נתונים של Compute Engine כדי לקבוע באופן דינמי לאילו מכונות להתחבר. מידע נוסף על הפרמטרים של Cloud SQL Auth Proxy

7. מתחילים את הסשן של psql.

מחרוזת החיבור שבה משתמשים תלויה בשאלה אם הפעלתם את Cloud SQL Auth Proxy באמצעות שקע TCP, שקע UNIX או Docker.

שקעי TCP

1. מפעילים את לקוח psql:

   psql "host=127.0.0.1 sslmode=disable dbname=DB_NAME user=USERNAME"

   למרות שהפרמטר sslmode מוגדר לערך disable, Cloud SQL Auth Proxy מספק חיבור מוצפן.

   כשמתחברים באמצעות שקעי TCP, הגישה ל-Cloud SQL Auth Proxy מתבצעת דרך 127.0.0.1.

2. אם מתבקשים, מזינים את הסיסמה.
3. מופיעה ההנחיה psql.

שימוש בשקעי Unix

1. מפעילים את לקוח psql:

   psql "sslmode=disable host=/cloudsql/INSTANCE_CONNECTION_NAME dbname=DB_NAME user=USERNAME"

   למרות שהפרמטר sslmode מוגדר לערך disable, Cloud SQL Auth Proxy מספק חיבור מוצפן.

2. מזינים את הסיסמה.
3. מופיעה ההנחיה psql.

דרושה לך עזרה? לקבלת עזרה בפתרון בעיות ב-Cloud SQL Auth Proxy, אפשר לעיין במאמר פתרון בעיות בחיבורים של Cloud SQL Auth Proxy או בדף התמיכה ב-Cloud SQL.

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

• כאן תוכלו לקבל עזרה בפתרון בעיות בחיבור ל-Cloud SQL Auth Proxy.
• יוצרים משתמשים ומסדי נתונים.
• מידע נוסף על כתובת IP פרטית
• איך מתחברים למכונה מהאפליקציה
• מידע על לקוח psql
• מידע על אפשרויות התמיכה