התחברות ל-Cloud SQL ל-SQL Server מ-Cloud Run

התחברות ל-Cloud SQL ל-SQL Server מ-Cloud Run

‫MySQL   |  PostgreSQL   |  SQL Server

איך פורסים אפליקציה לדוגמה ב-Cloud Run שמחוברת למכונה של SQL Server באמצעות מסוף Google Cloud ואפליקציית לקוח.

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

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

הערה: השם של הפרויקט צריך להיות באורך שבין 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. מוודאים שיש את ההרשאות הנדרשות כדי להשלים את המדריך למתחילים.
2. מפעילים את Cloud APIs שנדרשים כדי להריץ אפליקציה לדוגמה של Cloud SQL ב-Cloud Run.

   המסוף

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

   הפעלת ממשקי API

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

   • Compute Engine API
   • Cloud SQL Admin API
   • Cloud Run API
   • Container Registry API
   • Cloud Build API
   • Service Networking API

   gcloud

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

   פתיחת Cloud Shell

   מריצים את הפקודה הבאה של gcloud באמצעות Cloud Shell:

   gcloud services enable compute.googleapis.com sqladmin.googleapis.com run.googleapis.com \
   artifactregistry.googleapis.com cloudbuild.googleapis.com servicenetworking.googleapis.com

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

   • Compute Engine API
   • Cloud SQL Admin API
   • Cloud Run API
   • Artifact Registry API
   • Cloud Build API
   • Service Networking API

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

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

• יצירה או מחיקה של מאגר ב-Artifact Registry: כותב ב-Artifact Registry (roles/artifactregistry.writer)
• יצירה או מחיקה של מכונה, מסד נתונים ומשתמש: תפקיד אדמין ב-Cloud SQL‏ (roles/cloudsql.admin).
• יצירה או מחיקה של חשבון שירות ב-IAM: תפקיד אדמין של חשבון שירות (roles/iam.serviceAccountAdmin).
• יוצרים חיבור:
  • אדמין של Service Networking ‏ (roles/servicenetworking.networksAdmin))
  • אדמין של שימוש בשירות (roles/serviceusage.serviceUsageAdmin).
• צפייה באובייקטים ובמטא-נתונים שלהם: Storage Object Viewer ‏ (roles/storage.objectViewer)
• לתת הרשאות לניהול כללי מדיניות בפרויקטים: אדמין IAM של פרויקט (roles/resourcemanager.projectIamAdmin).
• גישת קריאה וכתיבה לכל המשאבים של Cloud Run: מפתח Cloud Run ‏ (roles/run.developer).
• פריסה וניהול של משאבים שנפרסו ממקור ב-Cloud Run: מפתח מקור ב-Cloud Run ‏ (roles/run.sourceDeveloper).
• כדי לאפשר גישה ציבורית: אדמין ב-Cloud Run ‏ (roles/run.admin).
• כדי להריץ פעולות בתור חשבון השירות: משתמש בחשבון שירות (roles/iam.serviceAccountUser).

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

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

הגדרת Cloud SQL

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

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

כדי להגדיר מכונה של Cloud SQL שמתחברים אליה באמצעות כתובת IP ציבורית:

ב-Cloud Run אי אפשר להתחבר ל-Cloud SQL ל-SQL Server באמצעות כתובת IP ציבורית דרך שקעי Unix, אבל אפשר להתחבר באמצעות מחברי השפה של Cloud SQL.

המסוף

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

   כניסה לדף Cloud SQL Instances

2. לוחצים על Create instance.
3. בתפריט Create instance, בוחרים באפשרות New instance.
4. לוחצים על Choose SQL Server.
5. מוודאים שהאפשרות Enterprise Plus נבחרה בתור מהדורת Cloud SQL של המכונה.
6. בשדה Instance ID, מזינים את הערך quickstart-instance.
7. בשדה Password, מזינים סיסמה למשתמש sqlserver. שמרו את הסיסמה הזו לשימוש עתידי.
8. בקטע Choose region and zonal availability, בוחרים באפשרות Single zone.
9. לוחצים על התפריט Show configuration options.
10. מרחיבים את הצומת Machine configuration.
11. באזור Machine shapes, בוחרים את הצורה 4 vCPU, 32 GB.
12. לוחצים על Create instance וממתינים עד שהמכונה תופעל.

gcloud

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

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

• ‫--database-version: הסוג והגרסה של המנוע של מסד הנתונים. אם לא מציינים ערך, המערכת משתמשת בערך ברירת המחדל של ה-API. במאמרי העזרה בנושא גרסאות של מסדי נתונים ב-gcloud מפורטות הגרסאות שזמינות כרגע.
• ‫‎--cpu: מספר הליבות הרצוי במכונה.
• ‫‎--memory: ערך של מספר שלם שמציין את כמות הזיכרון הרצויה במכונה. צריך לציין יחידת גודל (לדוגמה, 3072MB או 9GB). אם לא מציינים יחידות, המערכת מניחה שמדובר ב-GB.
• ‫‎--region: המיקום האזורי של המכונה (לדוגמה, asia-east1,‏ us-east1). אם לא מציינים ערך, המערכת משתמשת בערך ברירת המחדל us-central.

מריצים את הפקודה gcloud sql instances create כדי ליצור מכונה של Cloud SQL.

 gcloud sql instances create quickstart-instance \
        --database-version=SQLSERVER_2017_STANDARD \
        --cpu=1 \
        --memory=4GB \
        --region=us-central1 \
        --root-password=DB_ROOT_PASSWORD
        

כתובת IP פרטית

כדי להגדיר מכונה של Cloud SQL שמתחברים אליה באמצעות כתובת IP פרטית:

המסוף

הקצאת טווח של כתובות IP ויצירת חיבור פרטי כדי להגדיר גישה לשירותים פרטיים ב-Cloud SQL

1. במסוף Google Cloud , נכנסים לדף רשתות VPC.

   כניסה לדף VPC networks

2. בוחרים את רשת ה-VPC שנקראת default.
3. לוחצים על הכרטיסייה Private service connection.
4. בוחרים בכרטיסייה Allocated IP ranges for services.
5. לוחצים על Allocate IP range.
6. בשדה Name של הטווח שהוקצה, מציינים google-managed-services-default.
7. בוחרים באפשרות Automatic לטווח כתובות ה-IP ומציינים את אורך הקידומת 16.
8. לוחצים על Allocate כדי ליצור את הטווח שהוקצה.
9. בוחרים בכרטיסייה Private connections to services של רשת ה-VPC‏ default.
10. לוחצים על Create connection כדי ליצור חיבור פרטי בין הרשת שלכם לבין הבעלים של השירות המנוהל.
11. בקטע הקצאה, בוחרים באפשרות google-managed-services-default.
12. לוחצים על קישור כדי ליצור את הקישור.

יצירת מכונה עם כתובת IP פרטית ו-SSL מופעל

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

   כניסה לדף Cloud SQL Instances

2. לוחצים על Create instance.
3. בתפריט Create instance, בוחרים באפשרות New instance.
4. לוחצים על Choose SQL Server.
5. מוודאים שהאפשרות Enterprise Plus נבחרה בתור מהדורת Cloud SQL של המכונה.
6. בשדה Instance ID, מזינים את הערך quickstart-instance.
7. בשדה Password, מזינים סיסמה למשתמש sqlserver. שמרו את הסיסמה הזו לשימוש עתידי.
8. בקטע Choose region and zonal availability, בוחרים באפשרות Single zone.
9. לוחצים על התפריט Show configuration options.
10. מרחיבים את הצומת Machine configuration.
11. באזור Machine shapes, בוחרים את הצורה 4 vCPU, 32 GB.
12. מרחיבים את הצומת Connections.
13. מבטלים את הסימון בתיבה Public IP כדי ליצור מכונה רק עם כתובת IP פרטית.
14. מסמנים את התיבה Private IP.
15. מסמנים את התיבה Private Service Access (PSA).
16. בתפריט הנפתח רשת VPC *, בוחרים באפשרות default.
17. בקטע Security, מוודאים שהאפשרות Allow only SSL connections מסומנת כדי לאפשר חיבורי SSL.
18. לוחצים על Create instance ומחכים שהמכונה תופעל.

gcloud

הקצאת טווח של כתובות IP ויצירת חיבור פרטי כדי להגדיר גישה לשירותים פרטיים ב-Cloud SQL

1. מריצים את הפקודה gcloud compute addresses create כדי להקצות טווח של כתובות IP.

   gcloud compute addresses create google-managed-services-default \
   --global --purpose=VPC_PEERING --prefix-length=16 \
   --description="peering range for Google" --network=default

2. מריצים את הפקודה gcloud services vpc-peerings connect כדי ליצור חיבור פרטי לטווח כתובות ה-IP שהוקצה. מחליפים את YOUR_PROJECT_ID במזהה הפרויקט.

   gcloud services vpc-peerings connect --service=servicenetworking.googleapis.com \
   --ranges=google-managed-services-default --network=default \
   --project=YOUR_PROJECT_ID

יצירת מכונה עם כתובת IP פרטית ו-SSL מופעל

1. לפני שמריצים את הפקודה הבאה, מחליפים את DB_ROOT_PASSWORD בסיסמה של המשתמש במסד הנתונים.

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

   • ‫--database-version: הסוג והגרסה של המנוע של מסד הנתונים. אם לא מציינים ערך, המערכת משתמשת בערך ברירת המחדל של ה-API. כדי לראות את הגרסאות הזמינות כרגע, עיינו במסמכי התיעוד של גרסאות מסד הנתונים של gcloud.
   • ‫‎--cpu: מספר הליבות במכונה.
   • ‫‎--memory: ערך של מספר שלם שמציין את כמות הזיכרון שצריך לכלול במכונה. אפשר לציין יחידת גודל (לדוגמה, 3072MB או 9GB). אם לא מציינים יחידות, המערכת מניחה שמדובר ב-GB.
   • ‫‎--region: המיקום האזורי של המכונה (לדוגמה, asia-east1,‏ us-east1). אם לא מציינים ערך, המערכת משתמשת בערך ברירת המחדל us-central1. רשימת כל האזורים

מריצים את הפקודה gcloud sql instances create כדי ליצור מכונה של Cloud SQL עם כתובת IP פרטית.

gcloud sql instances create quickstart-instance \
--database-version=SQLSERVER_2017_STANDARD \
 --cpu=1 \
 --memory=4GB \
 --region=us-central \
 --root-password=DB_ROOT_PASSWORD \
 --no-assign-ip \
--network=default

2. מריצים את הפקודה gcloud sql instances patch כדי להפעיל את האפשרות רק חיבורי SSL מותרים במכונה.

gcloud sql instances patch quickstart-instance --require-ssl

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

כדי ליצור מסד נתונים:

המסוף

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

   כניסה לדף Cloud SQL Instances

2. בוחרים באפשרות quickstart-instance.
3. בתפריט הניווט של SQL, לוחצים על Databases.
4. לוחצים על  Create database.
1. בשדה Database name בתיבת הדו-שיח New database, מזינים את הערך quickstart-db.
2. לוחצים על יצירה.

gcloud

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

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

פריסת אפליקציה לדוגמה ב-Cloud Run

הגדרת חשבון שירות ב-Cloud Run

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

המסוף

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

   כניסה לדף IAM Service accounts

2. לוחצים על תפריט הפעולות ליד חשבון השירות ואז על ניהול הגישה.
3. לוחצים על Add another role, ואז מחפשים ובוחרים את התפקיד Cloud SQL Client (roles/cloudsql.client) בתפריט הנפתח Role.
4. לוחצים על Add another role, ואז מחפשים ובוחרים את התפקיד Storage Object Viewer (roles/storage.objectViewer) בתפריט הנפתח Role.
5. לוחצים על Save.

gcloud

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

   gcloud iam service-accounts list

2. מעתיקים את כתובת האימייל של חשבון השירות שמוגדר כברירת מחדל ב-Compute Engine.
3. מריצים את הפקודה הבאה כדי להוסיף את התפקיד Cloud SQL Client לחשבון השירות שמוגדר כברירת מחדל ב-Compute Engine:

   gcloud projects add-iam-policy-binding YOUR_PROJECT_ID \
     --member="serviceAccount:SERVICE_ACCOUNT_EMAIL" \
     --role="roles/cloudsql.client"

4. מריצים את הפקודה הבאה כדי להוסיף את התפקיד צפייה באובייקטים באחסון לחשבון השירות שמוגדר כברירת המחדל של Compute Engine:

   gcloud projects add-iam-policy-binding YOUR_PROJECT_ID \
     --member="serviceAccount:SERVICE_ACCOUNT_EMAIL" \
     --role="roles/storage.objectViewer"

הגדרת אפליקציה לדוגמה ב-Cloud SQL

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

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

ב-Cloud Run אפשר להתחבר ל-Cloud SQL ל-SQL Server באמצעות כתובת IP ציבורית, בעזרת מחברי השפה של Cloud SQL. למידע על הגדרת קוד לדוגמה כדי להתחבר באמצעות כתובת IP ציבורית, ראו התחברות מ-Cloud Run.

כתובת IP פרטית

בנתיבי IP פרטיים, האפליקציה מתחברת ישירות למכונה באמצעות Direct VPC egress או מחבר VPC. בשיטה הזו משתמשים בשקע TCP כדי להתחבר ישירות למכונה של Cloud SQL בלי להשתמש ב-Cloud SQL Auth Proxy.

המשך

יצירה והורדה של אישור שרת SSL

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

   כניסה לדף Cloud SQL Instances

2. לוחצים על quickstart-instance כדי לראות את הדף סקירה כללית.
3. לוחצים על הכרטיסייה חיבורים.
4. בקטע אבטחה, לוחצים על הורדת אישורים כדי להוריד את אישור ה-SSL של השרת.

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

1. ב-Cloud Shell Editor, פותחים את קוד המקור של האפליקציה לדוגמה.

   פתיחת Cloud Shell Editor
2. בתיבת הדו-שיח Open in Cloud Shell, לוחצים על Confirm כדי להוריד את קוד האפליקציה לדוגמה ולפתוח את ספריית האפליקציה לדוגמה ב-Cloud Shell Editor.
3. מעלים את קובץ אישור ה-SSL של השרת לתיקייה certs.
   1. לוחצים לחיצה ימנית על התיקייה certs ב-Cloud Shell Editor ובוחרים באפשרות Upload Files.
   2. בוחרים את הקובץ הבא במחשב המקומי: server-ca.pem.
   3. בוחרים את קובץ אישור ה-SSL של השרת ולוחצים על Open כדי להשלים את תהליך ההעלאה של הקובץ לעורך של Cloud Shell.
4. יוצרים מאגר Docker ב-Artifact Registry בשם run-sql באותו אזור של המכונה ב-Cloud SQL. מחליפים את YOUR_PROJECT_ID במזהה הפרויקט ואת YOUR_REGION_NAME בשם האזור.

     gcloud artifacts repositories create run-sql \
       --project=YOUR_PROJECT_ID \
       --repository-format=docker \
       --location=YOUR_REGION_NAME \
       --description="Quickstart Cloud SQL sample app"
     

5. כדי ליצור קונטיינר של Docker ולפרסם אותו ב-Artifact Registry, מריצים את הפקודה הבאה ב-Cloud Shell. מחליפים את YOUR_PROJECT_ID במזהה הפרויקט ואת YOUR_REGION_NAME בשם האזור.

   gcloud builds submit --tag YOUR_REGION_NAME-docker.pkg.dev/YOUR_PROJECT_ID/run-sql/run-sql

Java

יצירה והורדה של אישור שרת SSL

למשתמשי Java, המחבר של Java כבר מספק חיבור מאובטח, כך שאין צורך ליצור ולהוריד את אישור ה-SSL של השרת.

פיתוח אפליקציה לדוגמה

1. ב-Cloud Shell Editor, פותחים את קוד המקור של האפליקציה לדוגמה.

   פתיחת Cloud Shell Editor
2. בתיבת הדו-שיח Open in Cloud Shell, לוחצים על Confirm כדי להוריד את קוד האפליקציה לדוגמה ולפתוח את ספריית האפליקציה לדוגמה ב-Cloud Shell Editor.
3. יוצרים מאגר Docker ב-Artifact Registry בשם run-sql באותו אזור של המכונה ב-Cloud SQL. מחליפים את YOUR_PROJECT_ID במזהה הפרויקט ואת YOUR_REGION_NAME בשם האזור.

     gcloud artifacts repositories create run-sql \
       --project=YOUR_PROJECT_ID \
       --repository-format=docker \
       --location=YOUR_REGION_NAME \
       --description="Quickstart Cloud SQL sample app"
     

4. כדי ליצור קונטיינר של Docker ולפרסם אותו ב-Artifact Registry, מריצים את הפקודה הבאה ב-Cloud Shell. מחליפים את YOUR_PROJECT_ID במזהה הפרויקט ואת YOUR_REGION_NAME בשם האזור.

   gcloud builds submit --tag YOUR_REGION_NAME-docker.pkg.dev/YOUR_PROJECT_ID/run-sql/run-sql

Python

יצירה והורדה של אישור שרת SSL

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

   כניסה לדף Cloud SQL Instances

2. לוחצים על quickstart-instance כדי לראות את הדף סקירה כללית.
3. לוחצים על הכרטיסייה חיבורים.
4. בקטע אבטחה, לוחצים על הורדת אישורים כדי להוריד את אישור ה-SSL של השרת.

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

1. ב-Cloud Shell Editor, פותחים את קוד המקור של האפליקציה לדוגמה.

   פתיחת Cloud Shell Editor
2. בתיבת הדו-שיח Open in Cloud Shell, לוחצים על Confirm כדי להוריד את קוד האפליקציה לדוגמה ולפתוח את ספריית האפליקציה לדוגמה ב-Cloud Shell Editor.
3. מעלים את קובץ אישור ה-SSL של השרת לתיקייה certs.
   1. לוחצים לחיצה ימנית על התיקייה certs ב-Cloud Shell Editor ובוחרים באפשרות Upload Files.
   2. בוחרים את הקובץ הבא במחשב המקומי: server-ca.pem.
   3. בוחרים את קובץ אישור ה-SSL של השרת ולוחצים על Open כדי להשלים את תהליך ההעלאה של הקובץ לעורך של Cloud Shell.
4. יוצרים מאגר Docker ב-Artifact Registry בשם run-sql באותו אזור של המכונה ב-Cloud SQL. מחליפים את YOUR_PROJECT_ID במזהה הפרויקט ואת YOUR_REGION_NAME בשם האזור.

     gcloud artifacts repositories create run-sql \
       --project=YOUR_PROJECT_ID \
       --repository-format=docker \
       --location=YOUR_REGION_NAME \
       --description="Quickstart Cloud SQL sample app"
     

5. כדי ליצור קונטיינר של Docker ולפרסם אותו ב-Artifact Registry, מריצים את הפקודה הבאה ב-Cloud Shell. מחליפים את YOUR_PROJECT_ID במזהה הפרויקט ואת YOUR_REGION_NAME בשם האזור.

   gcloud builds submit --tag YOUR_REGION_NAME-docker.pkg.dev/YOUR_PROJECT_ID/run-sql/run-sql

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

השלבים לפריסת הדוגמה ב-Cloud Run תלויים בסוג כתובת ה-IP שהקציתם למכונה של Cloud SQL.

שיטת החיבור של קובץ האימג' משתנה בהתאם למשתני הסביבה שמוגדרים.

• כדי להתחבר באמצעות TCP, מגדירים את הערך של משתנה הסביבה INSTANCE_HOST. שיטת החיבור הזו מכבדת את האישורים והיציאות שהוגדרו כמשתני סביבה.
• כדי להתחבר באמצעות שקעי Unix, מגדירים את הערך של משתנה הסביבה INSTANCE_UNIX_SOCKET.

  אל תגדירו את הערך של משתנה הסביבה INSTANCE_HOST.

  אין תמיכה מובנית בשקעי Unix ב-Java. אם האפליקציה כתובה ב-Java, צריך להשתמש ב-Cloud SQL Java Connector.

• כדי להתחבר באמצעות אחד ממחברי השפה של Cloud SQL, מגדירים את הערך של משתנה הסביבה INSTANCE_CONNECTION_NAME .

  אל תגדירו את הערכים של משתני הסביבה הבאים:

  • INSTANCE_HOST
  • INSTANCE_UNIX_SOCKET
  • DB_PORT
  • DB_ROOT_CERT
  • DB_CERT
  • DB_KEY
  לא משתמשים בערכים האלה כי מחבר השפה של Cloud SQL כבר מספק חיבור מאובטח באמצעות שרת Cloud SQL Auth Proxy, שיוצר חיבורים ל-Cloud SQL ביציאה 3307.

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

ב-Cloud Run אפשר להתחבר ל-Cloud SQL ל-SQL Server באמצעות כתובת IP ציבורית, בעזרת מחברי השפה של Cloud SQL. במאמר התחברות מ-Cloud Run מוסבר איך פורסים שירות Cloud Run שמחובר ל-Cloud SQL ל-SQL Server באמצעות כתובת IP ציבורית.

כתובת IP פרטית

המסוף

הערה: אם אתם משתמשים במסוף כדי לפרוס פונקציה, אתם צריכים להפעיל את ממשקי ה-API הנדרשים, לקבל את התפקידים הנדרשים וללחוץ על הטופס Write a function.

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

   כניסה ל-Cloud Run

2. לוחצים על Create container ובוחרים באפשרות Service כדי להציג את הטופס Create service.

3. משאירים את האפשרות לפרוס מקובץ אימג' קיים של קונטיינר ולוחצים על Select כדי לציין את קובץ האימג' של הקונטיינר gcr.io/YOUR_PROJECT_ID/run-sql שיצרתם בשלב הקודם.
4. מזינים quickstart-service בשדה Service name.
5. בקטע Authentication, בוחרים באפשרות Allow public access. אם אין לכם הרשאות (תפקיד אדמין ב-Cloud Run) לבחור באפשרות הזו, השירות ייפרס ויידרש אימות.
6. מרחיבים את הקטע Container, Variables & Secrets, Connections, Security .
7. יוצרים את משתני הסביבה הבאים: לוחצים על Add variable בקטע Environment variables. מגדירים את הערכים של משתני הסביבה:
• ‫DB_NAME: מוגדר לערך quickstart-db.
• ‫DB_USER: מוגדר לערך sqlserver.
• ‫DB_PASS: הסיסמה של המשתמש sqlserver שיצרתם ביצירת מכונה של Cloud SQL.
• ‫INSTANCE_CONNECTION_NAME: מגדירים את שם החיבור של המכונה, שמופיע בדף Cloud SQL instances במסוף Google Cloud .
• ‫DB_PORT: מוגדר לערך 1433.
• ‫DB_ROOT_CERT: מוגדר לערך certs/server-ca.pem.
• ‫PRIVATE_IP: מוגדר לערך TRUE.

8. מפעילים את ההתחברות ל-Cloud SQL:

   1. לוחצים על חיבורים.
   2. לוחצים על Add Connection בקטע Cloud SQL connections.
   3. בוחרים את המכונה של quickstart-instance Cloud SQL שיצרתם קודם.
   4. בכרטיסייה Networking, בוחרים באפשרות Connect to a VPC for outbound traffic, ואז בוחרים באפשרות default בשדות Network ו-Subnet.
   5. בוחרים באפשרות Route all traffic to the VPC.

9. כדי לסיים את יצירת שירות Cloud Run, לוחצים על Create.

10. אחרי שפורסים את שירות Cloud Run, כתובת ה-URL של השירות שפועל מופיעה בחלק העליון של הדף Service details. לוחצים על הקישור URL כדי לראות את האפליקציה לדוגמה שנפרסה ב-Cloud Run ומחוברת ל-Cloud SQL.

    

gcloud

הערה: אם אתם משתמשים ב-CLI של gcloud כדי לפרוס מקוד המקור, ודאו שקיבלתם את התפקידים הנדרשים, השתמשו ב---source במקום ב---image והוסיפו את --function אם אתם פורסים פונקציה.

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

• ‫YOUR_PROJECT_ID במזהה הפרויקט.
• ‫INSTANCE_CONNECTION_NAME עם Connection name של המכונה, שמופיע בדף Cloud SQL instances במסוף Google Cloud .
• ‫DB_PASS עם הסיסמה של המשתמש sqlserver שיצרתם בקטע יצירת מכונה של Cloud SQL.

מריצים את הפקודה gcloud run deploy כדי ליצור את שירות Cloud Run. משתני הסביבה משתנים בהתאם לשיטת החיבור שבה רוצים להשתמש:

gcloud run deploy run-sql --image gcr.io/YOUR_PROJECT_ID/run-sql \
    --add-cloudsql-instances INSTANCE_CONNECTION_NAME \
    --vpc-egress=all-traffic \
    --network=default \
    --subnet=default \
    --set-env-vars DB_NAME="quickstart-db" \
    --set-env-vars DB_USER="sqlserver" \
    --set-env-vars DB_PASS="DB_PASS" \
    --set-env-vars INSTANCE_CONNECTION_NAME="INSTANCE_CONNECTION_NAME"
  

מזינים את המספר שמופיע ליד us-central1 כשמוצגת בקשה לציין אזור.

2. כשמופיעה הודעת אישור על פריסת השירות של Cloud Run, לוחצים על הקישור Service URL בהודעה כדי לראות את האפליקציה לדוגמה ב-Cloud Run שמחוברת ל-Cloud SQL.

   

הסרת המשאבים

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

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

   כניסה לדף Cloud SQL Instances

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

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

   כניסה ל-Cloud Run

6. מסמנים את התיבה לצד שם השירות quickstart-service.
7. לוחצים על Delete בחלק העליון של הדף Cloud Run.

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

אם אתם לא משתמשים בתפקיד לקוח Cloud SQL שהקציתם לחשבון השירות של Compute Engine, אתם יכולים להסיר אותו.

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

   כניסה לדף IAM

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

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

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

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

   לדף APIs

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

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

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

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

מידע נוסף על התמחור זמין במאמר התמחור של Cloud SQL ל-SQL Server.

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

• הגדרת מכונת Cloud SQL עם כתובת IP ציבורית.
• הגדרת המכונה של Cloud SQL עם כתובת IP פרטית.

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

• מאפליקציה שפועלת בסביבה הרגילה של App Engine
• מאפליקציה שפועלת ב-Compute Engine
• מאפליקציה שפועלת ב-GKE
• מ-Cloud Run