התחברות ל-Cloud SQL ל-MySQL מהמחשב המקומי

איך פורסים אפליקציה לדוגמה במחשב מקומי שמבוסס על Linux, ‏macOS או Windows ומחובר למכונה של MySQL, באמצעות מסוף Cloud de Confiance ואפליקציית לקוח.

אם תבצעו את כל השלבים בזמן, המשאבים שנוצרו במדריך למתחילים הזה יעלו בדרך כלל פחות מדולר אחד (USD).

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

  1. In the Cloud de Confiance console, on the project selector page, select or create a Cloud de Confiance 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.

    Go to project selector

  2. Verify that billing is enabled for your Cloud de Confiance project.

  3. מוודאים שיש לכם את ההרשאות הנדרשות כדי להשלים את המדריך למתחילים.
  4. מפעילים את ממשקי ה-Cloud API שנדרשים כדי להריץ אפליקציה לדוגמה של Cloud SQL במחשב המקומי.

    המסוף

    לוחצים על הכפתור Enable APIs כדי להפעיל את ממשקי ה-API שנדרשים למדריך למתחילים.

    הפעלת ממשקי API

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

    • Cloud SQL Admin API
    • IAM API

    gcloud

    מתקינים את ה-CLI של gcloud, שנותן גישה למשאבים של Cloud de Confiance באמצעות שורת הפקודה. משתמשים ב-CLI של gcloud כדי להריץ את פקודות ה-gcloud CLI שמוצגות במדריך למתחילים. כל הפקודות מעוצבות כך שניתן להריץ אותן בטרמינל של Linux/macOS או ב-Windows Powershell.

    פותחים את הטרמינל ומריצים את הפקודה הבאה של gcloud:

    gcloud services enable sqladmin.googleapis.com iam.googleapis.com

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

    • Cloud SQL Admin API
    • IAM API

התפקידים הנדרשים

כדי לקבל את ההרשאות שדרושות להגדרת Cloud SQL מהמחשב המקומי, צריך לבקש מהאדמין להקצות לכם את תפקידי ה-IAM הבאים בפרויקט שאתם רוצים ליצור ולהתחבר אליו:

  • יצירה או מחיקה של מכונה, מסד נתונים ומשתמש: תפקיד אדמין ב-Cloud SQL‏ (roles/cloudsql.admin).
  • יצירה או מחיקה של חשבון שירות ב-IAM: תפקיד אדמין של חשבון שירות ב-IAM‏ (roles/iam.serviceAccountAdmin).
  • הוספה או הסרה של קישור למדיניות IAM: תפקיד אדמין IAM של פרויקט (roles/resourcemanager.projectIamAdmin).
  • יצירה, ניהול ורוטציה של מפתחות לחשבונות שירות: אדמין של מפתחות לחשבונות שירות (roles/iam.serviceAccountKeyAdmin).

להסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

יכול להיות שאפשר לקבל את ההרשאות הנדרשות גם באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש.

הגדרת Cloud SQL

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

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

    כניסה לדף Cloud SQL Instances

  2. בוחרים בכרטיסייה MySQL ולוחצים על Create Sandbox instance בתיבה Sandbox. לחלופין, אפשר ללחוץ על Create Instance ולבצע את הפעולות הבאות:
    1. לוחצים על Choose MySQL.
    2. בוחרים במהדורת Enterprise.
    3. בוחרים את ההגדרה הקבועה מראש Sandbox.
  3. אם מוצגת בקשה להפעיל את Compute API, לוחצים על הלחצן Enable API.
  4. בקטע Instance info, מזינים את הערך quickstart-instance בשדה Instance ID.
  5. מזינים סיסמה למשתמש ה-root. חשוב לזכור את הסיסמה שיוצרים, כי תצטרכו להשתמש בה בהמשך.
  6. בקטע Choose region and zonal availability, בוחרים באפשרות Single zone.
  7. לוחצים על Create instance.

יצירת מסד נתונים

המסוף

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

    כניסה לדף Cloud SQL Instances

  2. בוחרים באפשרות quickstart-instance.
  3. פותחים את הכרטיסייה Databases.
  4. לוחצים על Create database.
    1. בתיבת הדו-שיח Create a database, מזינים את השם quickstart_db למסד הנתונים, ואם רוצים גם את ערכת התווים וההשוואה.
    2. לוחצים על יצירה.

gcloud

מריצים את הפקודה gcloud sql databases create כדי ליצור מסד נתונים.

gcloud sql databases create quickstart_db --instance=quickstart-instance

יצירת משתמש

המסוף

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

    כניסה לדף Cloud SQL Instances

  2. כדי לפתוח את הדף Overview של מכונה, לוחצים על שם המכונה.
  3. בתפריט הניווט של SQL, לוחצים על Users.
  4. לוחצים על הוספת חשבון משתמש.
    • בדף Add a user account to instance instance_name, מוסיפים את הפרטים הבאים:
      • שם משתמש: מגדירים לערך quickstart-user
      • סיסמה: מציינים סיסמה למשתמש במסד הנתונים. חשוב לזכור את השם הזה כי תצטרכו אותו בשלב מאוחר יותר במדריך למתחילים.
      • בקטע שם מארח, ברירת המחדל היא Allow any host, כלומר המשתמש יכול להתחבר מכל כתובת IP.

        אם רוצים, בוחרים באפשרות הגבלת המארח לפי כתובת IP או טווח כתובות ומזינים כתובת IP או טווח כתובות בקטע מארח. המשתמש יוכל להתחבר רק מכתובת ה-IP או מהכתובות שצוינו.

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

gcloud

מחליפים את מה שכתוב בשדות הבאים:

  1. ‫PASSWORD מחליפים בסיסמה של המשתמש במסד הנתונים. חשוב לזכור את השם הזה כי תצטרכו אותו בשלב מאוחר יותר במדריך למתחילים.

מריצים את הפקודה gcloud sql users create כדי ליצור את המשתמש.

gcloud sql users create quickstart-user --instance=quickstart-instance --password=PASSWORD

מגבלות האורך של שמות המשתמשים ב-Cloud SQL זהות לאלה של MySQL מקומי: 32 תווים ב-MySQL 8.0 ואילך, ו-16 תווים בגרסאות קודמות.

הגדרה של חשבון שירות

יוצרים ומגדירים Cloud de Confiance by S3NS חשבון שירות עם התפקיד לקוח Cloud SQL והרשאות להתחברות ל-Cloud SQL. אחרי שיוצרים חשבון שירות, יכול להיות שיהיה צריך להמתין 60 שניות לפחות לפני שאפשר להשתמש בו.

המסוף

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

  1. במסוף Cloud de Confiance , נכנסים לדף Create service account.
  2. כניסה לדף Create service account

  3. בוחרים פרויקט ב- Cloud de Confiance .
  4. מזינים את quickstart-service-account בתור השם של חשבון השירות.
  5. אופציונלי: מזינים תיאור לחשבון השירות.
  6. לוחצים על Create and continue וממשיכים לשלב הבא.
  7. בוחרים את התפקיד "לקוח Cloud SQL" כדי להקצות אותו לחשבון השירות בפרויקט.
  8. לוחצים על Continue.
  9. לוחצים על Done כדי לסיים ליצור את חשבון השירות.

יצירה והורדה של קובץ המפתח של חשבון השירות

  1. נכנסים לדף Service accounts במסוף Cloud de Confiance .
  2. כניסה לדף Service accounts

  3. בוחרים פרויקט.
  4. לוחצים על כתובת האימייל של חשבון השירות ב-quickstart-service-account שרוצים ליצור לו מפתח.
  5. לוחצים על הכרטיסייה Keys.
  6. לוחצים על התפריט הנפתח Add key ובוחרים באפשרות Create new key.
  7. בוחרים באפשרות JSON בתור Key type ולוחצים על Create.

לחיצה על Create מורידה קובץ מפתח של חשבון השירות. אחרי שמורידים את קובץ המפתח, אי אפשר להוריד אותו שוב.

חשוב לאחסן את קובץ המפתח באופן מאובטח כי הוא יכול לשמש לצורך אימות כחשבון השירות שלכם. אפשר להעביר את הקובץ לאן שרוצים ולשנות את השם שלו למה שרוצים.

gcloud

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

  1. כדי ליצור את חשבון השירות, מריצים את הפקודה gcloud iam service-accounts create:
  2. gcloud iam service-accounts create quickstart-service-account --description="DESCRIPTION" --display-name="quickstart-service-account"

    מחליפים את הערך הבא:

    • ‫DESCRIPTION: תיאור אופציונלי של חשבון השירות
  3. כדי להקצות לחשבון השירות את התפקיד "לקוח Cloud SQL" בפרויקט, מריצים את הפקודה gcloud projects add-iam-policy-binding. מחליפים את PROJECT_ID במזהה הפרויקט ב-Google Cloud:
    gcloud projects add-iam-policy-binding PROJECT_ID --member="serviceAccount:quickstart-service-account@PROJECT_ID.s3ns.iam.gserviceaccount.com" --role="roles/cloudsql.client"

יצירה והורדה של קובץ המפתח של חשבון השירות

כדי להשתמש בחשבון השירות שיצרתם מהמחשב המקומי, אתם צריכים קובץ מפתח של חשבון שירות כדי לאמת את האפליקציה לדוגמה כחשבון השירות. כדי ליצור ולהוריד את קובץ המפתח של חשבון השירות, מריצים את הפקודה gcloud iam service-accounts keys create:

gcloud iam service-accounts keys create KEY_FILE --iam-account=quickstart-service-account@PROJECT_ID.s3ns.iam.gserviceaccount.com

מחליפים את הערכים הבאים:

  • ‫KEY_FILE: הנתיב לקובץ פלט חדש של המפתח הפרטי, לדוגמה ~/sa-private-key.json.
  • PROJECT_ID: מזהה הפרויקט ב-Google Cloud.

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

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

הגדרת סביבת פיתוח לשפת תכנות

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

המשך

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

  1. עוברים אל מדריך ההגדרה של סביבת פיתוח ב-Go.
  2. מבצעים את ההוראות שבקטע Install Go.

Java

כדי להגדיר את סביבת הפיתוח להרצת האפליקציה לדוגמה ב-Java, פועלים לפי השלבים הבאים.

  1. עוברים אל מדריך ההגדרה של סביבת פיתוח ב-Java.
  2. מבצעים את ההוראות בקטע התקנת JDK (ערכת פיתוח ל-Java).
  3. כדי להגדיר את Apache Maven, פועלים לפי ההוראות במאמר התקנה של כלי אוטומציה לבנייה.

Node.js

כדי להגדיר את סביבת הפיתוח להרצת האפליקציה לדוגמה ב-Node.js, צריך לבצע את השלבים הבאים.

  1. עוברים אל המדריך להגדרת סביבת פיתוח ב-Node.js.
  2. מבצעים את ההוראות שבקטע התקנת Node.js ו-npm.

Python

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

  1. מדריך להגדרת סביבת פיתוח ב-Python
  2. מבצעים את ההוראות בקטע התקנת Python.

התקנת Git

מתקינים את Git, מערכת לניהול גרסאות בקוד פתוח.

שכפול אפליקציה לדוגמה

משכפלים אפליקציה לדוגמה למחשב המקומי באמצעות הפקודה git clone.

המשך

מריצים את הפקודות הבאות כדי לשכפל את האפליקציה לדוגמה ב-Go למחשב המקומי, ולשנות את הספרייה לספרייה שמכילה את האפליקציה לדוגמה.

  1. משכפלים את האפליקציה לדוגמה.
    git clone https://github.com/GoogleCloudPlatform/golang-samples
  2. עוברים לספרייה שמכילה את האפליקציה לדוגמה.
    cd golang-samples/cloudsql/mysql/database-sql

Java

מריצים את הפקודות הבאות כדי לשכפל את האפליקציה לדוגמה ב-Java למחשב המקומי, ולשנות את הספרייה לספרייה שמכילה את האפליקציה לדוגמה.

  1. משכפלים את האפליקציה לדוגמה.
    git clone https://github.com/GoogleCloudPlatform/java-docs-samples
  2. עוברים לספרייה שמכילה את האפליקציה לדוגמה.
    cd java-docs-samples/cloud-sql/mysql/servlet

Node.js

מריצים את הפקודות הבאות כדי לשכפל את האפליקציה לדוגמה ב-Node.js למחשב המקומי, ולשנות את הספרייה לספרייה שמכילה את האפליקציה לדוגמה.

  1. משכפלים את האפליקציה לדוגמה.
    git clone https://github.com/GoogleCloudPlatform/nodejs-docs-samples
  2. עוברים לספרייה שמכילה את האפליקציה לדוגמה.
    cd nodejs-docs-samples/cloud-sql/mysql/mysql

Python

מריצים את הפקודות הבאות כדי לשכפל את האפליקציה לדוגמה ב-Python למחשב המקומי, ולשנות את הספרייה לספרייה שמכילה את האפליקציה לדוגמה.

  1. משכפלים את האפליקציה לדוגמה.
    git clone https://github.com/GoogleCloudPlatform/python-docs-samples
  2. עוברים לספרייה שמכילה את האפליקציה לדוגמה.
    cd python-docs-samples/cloud-sql/mysql/sqlalchemy

הגדרה והפעלה של אפליקציה לדוגמה

מגדירים ומריצים את האפליקציה לדוגמה.

הסרת המשאבים

כדי לא לצבור חיובים לחשבון Cloud de Confiance על המשאבים שבהם השתמשתם בדף הזה:

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

    כניסה לדף Cloud SQL Instances

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

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

אם אתם לא משתמשים בתפקיד לקוח Cloud SQL שהקציתם לחשבון השירות quickstart-service-account, אתם יכולים להסיר אותו.

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

    כניסה לדף IAM

  2. לוחצים על סמל העריכה (שנראה כמו עיפרון) של חשבון ה-IAM שנקרא quickstart-service-account.
  3. מוחקים את התפקיד לקוח Cloud SQL.
  4. לוחצים על Save.

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

  • ממשקי ה-API שהופעלו במדריך למתחילים הזה:
    • Cloud SQL Admin API
    • ‫API של ניהול זהויות והרשאות גישה (IAM)
  1. נכנסים לדף APIs במסוף Cloud de Confiance .

    כניסה אל APIs

  2. בוחרים את ה-API שרוצים להשבית ולוחצים על הכפתור Disable API.

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

בהתאם לצרכים שלכם, אתם יכולים לקרוא מידע נוסף על יצירת מכונות של Cloud SQL.

אתם יכולים גם לקרוא איך יוצרים משתמשי MySQL ומסדי נתונים למכונה של Cloud SQL.

למידע נוסף על התמחור, ראו התמחור של Cloud SQL ל-MySQL.

למידע נוסף על:

בנוסף, אתם יכולים לקרוא איך מתחברים למכונה של Cloud SQL מאפליקציות אחרות של Google Cloud: