התחברות ל-Cloud SQL ל-MySQL באמצעות Cloud SQL Auth Proxy

התחברות ל-Cloud SQL ל-MySQL באמצעות Cloud SQL Auth Proxy

‫MySQL   |  PostgreSQL   |  SQL Server

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

ההוראות בדף הזה מיועדות לסביבת בדיקה בלבד, ולא לסביבות ייצור. למידע נוסף על ההגדרות הנדרשות לסביבות ייצור, ראו שימוש ב-Cloud SQL Auth Proxy בסביבת ייצור והתחברות באמצעות Cloud SQL Auth Proxy.

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

הערה: השם של הפרויקט צריך להיות באורך שבין 4 ל-30 תווים. בזמן שכותבים את השם, בטופס מוצע מזהה פרויקט – אפשר לערוך אותו. מזהה הפרויקט צריך להיות באורך שבין 6 ל-30 תווים. התו הראשון צריך להיות אות קטנה באנגלית. בשאר התווים אפשר להשתמש במקפים, באותיות קטנות או בספרות, אבל התו האחרון לא יכול להיות מקף.

נכנסים לחשבון Google Cloud . אנחנו ממליצים למשתמשים חדשים ב- Google Cloud ליצור חשבון כדי שיוכלו להעריך את הביצועים של המוצרים שלנו בתרחישים מהעולם האמיתי. לקוחות חדשים מקבלים בחינם גם קרדיט בשווי 300$ להרצה, לבדיקה ולפריסה של עומסי העבודה.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

1. מפעילים את ממשקי ה-API הנדרשים של Google Cloud.

   המסוף

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

   לדף APIs

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

   gcloud

   לוחצים על הכפתור הבא כדי לפתוח את Cloud Shell, שמאפשר גישה למשאבים של Google Cloud בממשק שורת פקודה ישירות מהדפדפן. אפשר להשתמש ב-Cloud Shell כדי להריץ את הפקודות של gcloud שמוצגות במדריך למתחילים הזה.

   פתיחת Cloud Shell

   מריצים את הפקודה gcloud services enable באמצעות Cloud Shell כדי להפעיל את ממשקי ה-API שנדרשים למדריך למתחילים:

   gcloud services enable sqladmin.googleapis.com

   הפקודה הזו מפעילה את ממשקי ה-API הבאים:

   • Cloud SQL Admin API

2. צריך לוודא שיש לכם בפרויקט את התפקיד או התפקידים הבאים: אדמין ב-Cloud SQL‏ (roles/cloudsql.admin)

   בדיקת התפקידים

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

      כניסה לדף IAM
   2. בוחרים את הפרויקט.

   3. בעמודה Principal, מחפשים את כל השורות שמזהות אתכם או קבוצה שאתם חברים בה. כדי לברר לאילו קבוצות אתם שייכים, פנו לאדמין.

   4. בכל השורות שבהן אתם מופיעים, בודקים בעמודה Role אם רשימת התפקידים כוללת את התפקידים הנדרשים.

   מתן התפקידים

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

      כניסה לדף IAM
   2. בוחרים את הפרויקט.
   3. לוחצים על Grant access.

   4. בשדה New principals, מזינים את מזהה המשתמש. ‫ בדרך כלל מזהה המשתמש הוא כתובת האימייל של חשבון Google.

      ‫
   5. לוחצים על Select a role ומחפשים את התפקיד.
   6. כדי לתת עוד תפקידים, לוחצים על Add another role ומוסיפים אותם.
   7. לוחצים על Save.

יצירת מכונה של Cloud SQL

במדריך למתחילים הזה משתמשים במסוף Google Cloud . כדי להשתמש ב-CLI של gcloud, ב-curl או ב-PowerShell, קראו את המאמר יצירת מכונות.

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

   כניסה לדף Cloud SQL Instances

2. לוחצים על Create instance.
3. בתפריט Create instance, בוחרים באפשרות New instance.
4. לוחצים על Choose MySQL.
5. בשדה Instance ID, מזינים את הערך myinstance.
6. בשדה Password, מזינים סיסמה למשתמש root.

7. לוחצים על Create instance.

   חוזרים לרשימת המכונות. אפשר ללחוץ מיד על המכונה החדשה כדי לראות את הפרטים, אבל היא לא תהיה זמינה לפעולות אחרות עד שהיא תופעל ותתחיל לפעול.

   הערה: בדוגמה הזו, המכונה נוצרת באמצעות הגדרות ברירת המחדל, כולל כתובת IP ציבורית.

1. מורידים את MySQL Community Server לפלטפורמה שלכם מדף ההורדה של MySQL Community Server.
   Community Server כולל את לקוח MySQL.
2. מתקינים את Community Server לפי ההוראות שבדף ההורדה.

מידע נוסף על התקנת MySQL זמין במאמר Installing and Upgrading MySQL.

התקנת הלקוח של Cloud SQL Auth Proxy

הקובץ הבינארי של Cloud SQL Auth Proxy שאתם מורידים תלוי במערכת ההפעלה שלכם, ובשאלה אם היא משתמשת בליבה של 32 ביט או 64 ביט. רוב החומרות החדשות יותר משתמשות בליבה של 64 ביט. אם אתם לא בטוחים אם במחשב שלכם פועלת ליבה של 32 ביט או 64 ביט, השתמשו בפקודה uname -a ב-Linux או ב-macOS. ב-Windows, עיינו במסמכי התיעוד של Windows.

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

אם אתם משתמשים ב-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.3/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.3/cloud-sql-proxy.linux.386

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

   chmod +x cloud-sql-proxy

macOS‏ 64 סיביות

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

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

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

   chmod +x cloud-sql-proxy

Mac M1

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

     curl -o cloud-sql-proxy https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.26.3/cloud-sql-proxy.darwin.arm64
     

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

     chmod +x cloud-sql-proxy
     

‏Windows‏ 64 סיביות

לוחצים לחיצה ימנית על הקישור https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.26.3/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.3/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.3

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

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

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

איך מקבלים את שם החיבור של המכונה

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

   כניסה לדף Cloud SQL Instances

2. לוחצים על שם המכונה כדי לפתוח את הדף Overview.
3. בקטע Connect to this instance, מעתיקים את הערך של Connection name. שם החיבור הוא בפורמט projectID:region:instanceID.

הפעלת Cloud SQL Auth Proxy

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

בסביבות Linux, משתמשים בפקודה הזו כדי להפעיל את Cloud SQL Auth Proxy:

./cloud-sql-proxy INSTANCE_CONNECTION_NAME

ב-PowerShell ב-Windows, משתמשים בפקודה הזו כדי להפעיל את Cloud SQL Auth Proxy:

.\cloud-sql-proxy.exe INSTANCE_CONNECTION_NAME

מופיעה הודעה דומה לזו:

Listening on 127.0.0.1:3306 for INSTANCE_CONNECTION_NAME
Ready for new connections

מריצים את הפקודה הבאה:

mysql -u root -p --host 127.0.0.1 --port 3306

בהנחיה Enter password:, מזינים את הסיסמה של חשבון משתמש Root ב-MySQL.

מוודאים שמופיעה שורת הפקודה של MySQL. התחברתם למסד הנתונים באמצעות לקוח MySQL.

חוזרים לחלון הטרמינל שבו הפעלתם את Cloud SQL Auth Proxy. אמורה להופיע הודעה דומה לזו:

New connection for myInstance

הסרת המשאבים

כדי לא לצבור חיובים בחשבון Google Cloud על המשאבים שבהם השתמשתם בדף הזה, מבצעים את הפעולות הבאות.

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

   כניסה לדף Cloud SQL Instances

2. בוחרים את המכונה myinstance כדי לפתוח את הדף Instance details.
3. בסרגל הסמלים שבחלק העליון של הדף, לוחצים על מחיקה.
4. בחלון Delete instance, מקלידים את שם המכונה ולוחצים על Delete.

שלבי ניקוי אופציונליים

אם אתם לא משתמשים בממשקי ה-API שהופעלו כחלק מהמדריך למתחילים, אתם יכולים להשבית אותם.

• ממשקי ה-API שהופעלו במדריך למתחילים הזה:
  • Cloud SQL Admin API

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

   לדף APIs

2. בוחרים את Cloud SQL Admin API ולוחצים על הלחצן Disable API.

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

• כך פותרים בעיות ב-Cloud SQL Auth Proxy.

• מידע נוסף על Cloud SQL Auth Proxy

• מידע נוסף על אפשרויות חיבור אחרות