התחברות ל-Cloud SQL ל-SQL Server מהסביבה הרגילה של App Engine

התחברות ל-Cloud SQL ל-SQL Server מהסביבה הרגילה של App Engine

‫MySQL   |  PostgreSQL   |  SQL Server

במאמר הבא מוסבר איך לפרוס אפליקציה לדוגמה בסביבה רגילה של App Engine שמחוברת למופע של 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. מפעילים את ממשקי ה-API של Cloud שנדרשים להרצת אפליקציית לדוגמה של Cloud SQL בסביבה הרגילה של App Engine.

   המסוף

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

   הפעלת ממשקי API

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

   • Cloud SQL Admin API
   • Compute Engine API
   • Cloud Build API
   • Cloud Logging API

   gcloud

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

   פתיחת Cloud Shell

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

   gcloud services enable sqladmin.googleapis.com compute.googleapis.com \
   cloudbuild.googleapis.com logging.googleapis.com

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

   • Cloud SQL Admin API
   • Compute Engine API
   • Cloud Build API
   • Cloud Logging API

הגדרת Cloud SQL

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

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

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

בסביבה רגילה של App Engine אין תמיכה בחיבור ל-Cloud SQL ל-SQL Server דרך כתובת IP ציבורית באמצעות שקעי Unix, אבל אפשר להתחבר באמצעות מחברי Go,‏ Java ו-Python.

המסוף

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

   כניסה לדף Cloud SQL Instances

2. לוחצים על Create instance.
3. בתפריט יצירת מופע, בוחרים באפשרות מופע חדש.
4. לוחצים על Choose SQL Server.
5. מוודאים שמהדורת Cloud SQL שנבחרה למופע היא Enterprise Plus.
6. בשדה Instance ID (מזהה המופע), מזינים את הערך quickstart-instance.
7. בשדה סיסמה, מזינים סיסמה למשתמש 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. נכנסים לדף VPC networks במסוף Google Cloud .

   מעבר לרשתות VPC

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

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

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

   כניסה לדף Cloud SQL Instances

2. לוחצים על Create instance.
3. בתפריט יצירת מופע, בוחרים באפשרות מופע חדש.
4. לוחצים על Choose SQL Server.
5. מוודאים שמהדורת Cloud SQL שנבחרה למופע היא Enterprise Plus.
6. בשדה Instance ID (מזהה המופע), מזינים את הערך quickstart-instance.
7. בשדה סיסמה, מזינים סיסמה למשתמש 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. כדי ליצור מכונה עם כתובת IP פרטית בלבד, מבטלים את הסימון בתיבת הסימון כתובת IP ציבורית.
14. מסמנים את תיבת הסימון כתובת IP פרטית.
15. מסמנים את התיבה Private Service Access (PSA) (גישה פרטית לשירות).
16. בתפריט הנפתח VPC Network *, בוחרים באפשרות default.
17. בקטע אבטחה, מוודאים שהאפשרות אפשר רק חיבורי SSL מסומנת כדי להפעיל חיבורי 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. לוחצים על  יצירת מסד נתונים.
1. בשדה שם מסד הנתונים בתיבת הדו-שיח מסד נתונים חדש, מזינים quickstart-db.
2. לוחצים על יצירה.

gcloud

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

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

פריסת אפליקציה לדוגמה בסביבה הרגילה של App Engine

יצירת אפליקציית App Engine

יוצרים את אפליקציית App Engine ב Google Cloud פרויקט. הפקודה הזו מפעילה את שירות App Engine, יוצרת אפליקציית App Engine שמוגדרת כברירת מחדל ויוצרת חשבון שירות של App Engine שישמש לחיבור ל-Cloud SQL.

הערה: צריך לבצע את השלב הזה רק פעם אחת לכל פרויקט Google Cloud .

המסוף

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

   מעבר אל App Engine

2. לוחצים על הלחצן יצירת אפליקציה.
3. בתפריט הנפתח Select a region (בחירת אזור), בוחרים באפשרות us-central.
4. לוחצים על הבא.
5. לוחצים על הקישור אעשה זאת מאוחר יותר כשהוא מופיע בדף שנתחיל?.

gcloud

1. מריצים את הפקודה הבאה gcloud app create כדי ליצור אפליקציית App Engine:

gcloud app create

2. כשתוצג בקשה לבחור את האזור שבו רוצים למקם את אפליקציית App Engine, מזינים את הבחירה המספרית עבור us-central.

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

מגדירים את חשבון השירות שבו משתמש App Engine כך שיהיה לו תפקיד לקוח Cloud SQL עם הרשאות להתחבר ל-Cloud SQL.

המסוף

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

   כניסה לדף IAM

2. לגבי חשבון השירות שנקרא App Engine default service account, לוחצים על סמל העיפרון.
   הערה: שם חשבון השירות מופיע לצד החשבון הראשי של החשבון. שם חשבון המשתמש הוא [e-mail].
3. לוחצים על הוספת תפקיד נוסף.
4. מוסיפים את התפקיד שנקרא Cloud SQL Client.
5. לוחצים על Save.

gcloud

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

   gcloud iam service-accounts list

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

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

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

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

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

בסביבה רגילה של App Engine יש תמיכה בחיבור ל-Cloud SQL ל-SQL Server דרך כתובת IP ציבורית באמצעות מחברי Go, ‏ Java ו-Python.

המשך

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

   פתיחת Cloud Shell Editor
2. בתיבת הדו-שיח Open in Cloud Shell, לוחצים על Confirm כדי להוריד את קוד האפליקציה לדוגמה ולפתוח את ספריית האפליקציה לדוגמה ב-Cloud Shell Editor.
3. בשורת הפקודה של Cloud Shell, מריצים את הפקודה הבאה כדי להפעיל את הפרויקט:
   ‫

   gcloud config set project YOUR-PROJECT-ID

   הערה: מחליפים את YOUR-PROJECT-ID במזהה הפרויקט.
4. אם מופיעה תיבת הדו-שיח Authorize Cloud Shell, לוחצים על Authorize.
5. בתפריט הניווט של סייר Cloud Shell Editor, עוברים אל הקובץ golang-samples/cloudsql/sqlserver/database-sql/cmd/app/app.standard.yaml ופותחים אותו.
6. מחליפים את ה-placeholders של משתני הסביבה בקובץ app.standard.yaml בערכים הבאים:
• ‫<PROJECT-ID> במזהה הפרויקט.
• ‫<INSTANCE-REGION> עם us-central1.
• ‫<INSTANCE-NAME> עם מזהה המכונה שמופיע בדף Cloud SQL instances במסוף Google Cloud .
• ‫<YOUR_DB_USER_NAME> עם sqlserver.
• ‫<YOUR_DB_PASSWORD> בסיסמה של quickstart-user שיצרתם ביצירת משתמש.
• ‫<YOUR_DB_NAME> עם quickstart-db.
7. בשורת הפקודה של Cloud Shell, בספרייה golang-samples/cloudsql/sqlserver/database-sql, מריצים את הפקודה gcloud app deploy כדי לפרוס את אפליקציית הדוגמה לסביבה הרגילה של App Engine.

gcloud app deploy cmd/app/app.standard.yaml

8. אם תתבקשו לבחור את האזור ליצירת האפליקציה, מזינים את הבחירה המספרית עבור us-central.
9. כשמוצגת השאלה רוצה להמשיך?, מזינים Y.
10. כשפקודת הפריסה מסתיימת, מריצים את הפקודה gcloud app browse:

gcloud app browse

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

Java

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

   פתיחת Cloud Shell Editor
2. בתיבת הדו-שיח Open in Cloud Shell, לוחצים על Confirm כדי להוריד את קוד האפליקציה לדוגמה ולפתוח את ספריית האפליקציה לדוגמה ב-Cloud Shell Editor.
3. בשורת הפקודה של Cloud Shell, מריצים את הפקודה הבאה כדי להפעיל את הפרויקט:
   ‫

   gcloud config set project YOUR-PROJECT-ID

   הערה: מחליפים את YOUR-PROJECT-ID במזהה הפרויקט.
4. אם מופיעה תיבת הדו-שיח Authorize Cloud Shell, לוחצים על Authorize.
5. בתפריט הניווט של סייר Cloud Shell Editor, עוברים אל הקובץ java-docs-samples/cloud-sql/sqlserver/servlet/src/main/webapp/WEB-INF/appengine-web.xml ופותחים אותו.
6. מחליפים את ה-placeholders של משתני הסביבה בקובץ appengine-web.xml בערכים הבאים:
• ‫project-name:region-name:instance-name עם שם החיבור של המופע שמופיע בדף Cloud SQL instances במסוף Google Cloud .
• ‫my-db-user עם quickstart-user.
• ‫my-db-password עם הסיסמה של sqlserver שיצרתם ביצירת משתמש.
• ‫my_db עם quickstart-db.
7. בשורת הפקודה של Cloud Shell, בספרייה java-docs-samples/cloud-sql/sqlserver/servlet, מריצים את הפקודה mvn clean package של Apache Maven כדי לפרוס את אפליקציית הדוגמה לסביבה הרגילה של App Engine.

mvn clean package appengine:deploy -DskipTests

8. אם תתבקשו לבחור את האזור ליצירת האפליקציה, מזינים את הבחירה המספרית עבור us-central.
9. כשמוצגת השאלה רוצה להמשיך?, מזינים Y.
10. כשפקודת הפריסה מסתיימת, מריצים את הפקודה gcloud app browse:

gcloud app browse

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

Python

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

   פתיחת Cloud Shell Editor
2. בתיבת הדו-שיח Open in Cloud Shell, לוחצים על Confirm כדי להוריד את קוד האפליקציה לדוגמה ולפתוח את ספריית האפליקציה לדוגמה ב-Cloud Shell Editor.
3. בשורת הפקודה של Cloud Shell, מריצים את הפקודה הבאה כדי להפעיל את הפרויקט:
   ‫

   gcloud config set project YOUR-PROJECT-ID

   הערה: מחליפים את YOUR-PROJECT-ID במזהה הפרויקט.
4. אם מופיעה תיבת הדו-שיח Authorize Cloud Shell, לוחצים על Authorize.
5. בתפריט הניווט של סייר Cloud Shell Editor, עוברים אל הקובץ python-docs-samples/cloud-sql/sql-server/sqlalchemy/app.standard.yaml ופותחים אותו.
6. מחליפים את ה-placeholders של משתני הסביבה בקובץ app.standard.yaml בערכים הבאים:
• ‫<PROJECT-ID> במזהה הפרויקט.
• ‫<INSTANCE-REGION> עם us-central1.
• ‫<INSTANCE-NAME> עם מזהה המכונה שמופיע בדף Cloud SQL instances במסוף Google Cloud .
• ‫<YOUR_DB_USER_NAME> עם sqlserver.
• ‫<YOUR_DB_PASSWORD> בסיסמה של quickstart-user שיצרתם ביצירת משתמש.
• ‫<YOUR_DB_NAME> עם quickstart-db.
7. בשורת הפקודה של Cloud Shell, בספרייה python-docs-samples/cloud-sql/sql-server/sqlalchemy, מריצים את הפקודה gcloud app deploy כדי לפרוס את אפליקציית הדוגמה לסביבה הרגילה של App Engine.

gcloud app deploy app.standard.yaml

8. אם תתבקשו לבחור את האזור ליצירת האפליקציה, מזינים את הבחירה המספרית עבור us-central.
9. כשמוצגת השאלה רוצה להמשיך?, מזינים Y.
10. כשפקודת הפריסה מסתיימת, מריצים את הפקודה gcloud app browse:

gcloud app browse

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

כתובת IP פרטית

בנתיבי IP פרטיים, האפליקציה מתחברת ישירות למופע דרך חיבור לרשת (VPC) מאפליקציית serverless. בשיטה הזו נעשה שימוש בשקע TCP כדי להתחבר ישירות למופע Cloud SQL בלי להשתמש בשרת proxy ל-Cloud SQL Auth.

המשך

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

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

   כניסה לדף Cloud SQL Instances

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

יצירת חיבור לרשת (VPC) מאפליקציית serverless לחיבורים למופע באמצעות כתובת IP פרטית

1. במסוף Google Cloud , עוברים לדף Serverless VPC access (חיבור לרשת (VPC) מאפליקציית serverless) – Create connector (יצירת מחבר).

   יצירת מחבר של חיבור לרשת (VPC) מאפליקציית serverless

2. מזינים quickstart-connector בשדה שם.
3. בתפריט הנפתח רשת, בוחרים באפשרות ברירת מחדל.
4. בתפריט הנפתח רשת משנה, בוחרים באפשרות טווח כתובות IP בהתאמה אישית.
5. מזינים 10.8.0.0 בתיבת הקלט טווח כתובות IP.
6. לוחצים על יצירה.

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

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

   פתיחת Cloud Shell Editor
2. בתיבת הדו-שיח Open in Cloud Shell, לוחצים על Confirm כדי להוריד את קוד האפליקציה לדוגמה ולפתוח את ספריית האפליקציה לדוגמה ב-Cloud Shell Editor.
3. בשורת הפקודה של Cloud Shell, מריצים את הפקודה הבאה כדי להפעיל את הפרויקט:
   ‫

   gcloud config set project YOUR-PROJECT-ID

   הערה: מחליפים את YOUR-PROJECT-ID במזהה הפרויקט.
4. אם מופיעה תיבת הדו-שיח Authorize Cloud Shell, לוחצים על Authorize.
5. מעלים את קובץ אישור השרת SSL לתיקייה certs.
   1. בתפריט הניווט של Explorer ב-Cloud Shell Editor, עוברים לתיקייה golang-samples/cloudsql/sqlserver/database-sql/certs.
   2. לוחצים לחיצה ימנית על התיקייה certs ב-Cloud Shell Editor ובוחרים באפשרות Upload Files (העלאת קבצים).
   3. בוחרים את הקובץ הבא במחשב המקומי: server-ca.pem.
   4. אחרי שבוחרים את קובץ אישור השרת SSL, לוחצים על פתיחה כדי להשלים את תהליך ההעלאה של הקובץ אל Cloud Shell Editor.
6. בתפריט הניווט של סייר Cloud Shell Editor, עוברים אל הקובץ golang-samples/cloudsql/sqlserver/database-sql/cmd/app/app.standard.yaml ופותחים אותו.
7. מעתיקים את הקוד הבא ומדביקים אותו בקובץ, במקום התוכן הקיים בקובץ:

runtime: go116

env_variables:
  INSTANCE_CONNECTION_NAME: PROJECT-ID:INSTANCE-REGION:INSTANCE-NAME
  DB_USER: sqlserver
  DB_PASS: YOUR_DB_PASSWORD
  DB_NAME: quickstart-db
  DB_PORT: 1433
  INSTANCE_HOST: INSTANCE_HOST
  DB_ROOT_CERT: certs/server-ca.pem
  PRIVATE_IP: TRUE

vpc_access_connector:
  name: projects/PROJECT_ID/locations/us-central1/connectors/quickstart-connector

8. מחליפים את המשתנים הבאים:
• ‫PROJECT_ID במזהה הפרויקט.
• ‫INSTANCE-REGION עם us-central1.
• ‫INSTANCE-NAME עם מזהה המכונה שמופיע בדף Cloud SQL instances במסוף Google Cloud .
• ‫YOUR_DB_PASSWORD בסיסמה של quickstart-user שיצרתם ביצירת משתמש.
• ‫INSTANCE_HOST עם כתובת ה-IP הפרטית של המכונה שמופיעה בדף Cloud SQL instances במסוף Google Cloud .
9. בשורת הפקודה של Cloud Shell, בספרייה golang-samples/cloudsql/sqlserver/database-sql, מריצים את הפקודה gcloud app deploy כדי לפרוס את אפליקציית הדוגמה לסביבה הרגילה של App Engine.

gcloud app deploy cmd/app/app.standard.yaml

10. אם תתבקשו לבחור את האזור ליצירת האפליקציה, מזינים את הבחירה המספרית עבור us-central.
11. כשמוצגת השאלה רוצה להמשיך?, מזינים Y.
12. כשפקודת הפריסה מסתיימת, מריצים את הפקודה gcloud app browse:

gcloud app browse

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

Node.js

יצירת חיבור לרשת (VPC) מאפליקציית serverless לחיבורים למופע באמצעות כתובת IP פרטית

1. במסוף Google Cloud , עוברים לדף Serverless VPC access (חיבור לרשת (VPC) מאפליקציית serverless) – Create connector (יצירת מחבר).

   יצירת מחבר של חיבור לרשת (VPC) מאפליקציית serverless

2. מזינים quickstart-connector בשדה שם.
3. בתפריט הנפתח רשת, בוחרים באפשרות ברירת מחדל.
4. בתפריט הנפתח רשת משנה, בוחרים באפשרות טווח כתובות IP בהתאמה אישית.
5. מזינים 10.8.0.0 בתיבת הקלט טווח כתובות IP.
6. לוחצים על Create (יצירה) כדי ליצור את המחבר.

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

1. ב-Cloud Shell Editor, פותחים את קוד המקור של אפליקציית הדוגמה.
   פתיחת Cloud Shell Editor
2. בתיבת הדו-שיח Open in Cloud Shell, לוחצים על Confirm כדי להוריד את קוד האפליקציה לדוגמה ולפתוח את ספריית האפליקציה לדוגמה ב-Cloud Shell Editor.
3. בשורת הפקודה של Cloud Shell, מריצים את הפקודה הבאה כדי להפעיל את הפרויקט:
   ‫

   gcloud config set project YOUR-PROJECT-ID

   הערה: מחליפים את YOUR-PROJECT-ID במזהה הפרויקט.
4. אם מופיעה תיבת הדו-שיח Authorize Cloud Shell, לוחצים על Authorize.
5. בתפריט הניווט של סייר Cloud Shell Editor, עוברים אל הקובץ nodejs-docs-samples/cloud-sql/sqlserver/mssql/app.standard.yaml ופותחים אותו.
6. מחליפים את ה-placeholders של משתני הסביבה בקובץ app.standard.yaml בערכים הבאים:
• ‫CLOUD_SQL_INSTANCE_IP_ADDRESS עם כתובת ה-IP הפרטית של המכונה שמופיעה בדף Cloud SQL instances במסוף Google Cloud .
• ‫MY_DB_USER עם quickstart-user.
• ‫MY_DB_PASSWORD עם הסיסמה של quickstart-user שיצרתם ביצירת משתמש.
• ‫MY_DATABASE עם quickstart-db.
• ‫<MY-PROJECT> במזהה הפרויקט.
• ‫<CONNECTOR_NAME> עם quickstart-connector.
7. בשורת הפקודה של Cloud Shell, בספרייה nodejs-docs-samples/cloud-sql/sqlserver/mssql, מריצים את הפקודה gcloud app deploy כדי לפרוס את אפליקציית הדוגמה לסביבה הרגילה של App Engine.

gcloud app deploy app.standard.yaml

8. אם תתבקשו לבחור את האזור ליצירת האפליקציה, מזינים את הבחירה המספרית עבור us-central.
9. כשמוצגת השאלה רוצה להמשיך?, מזינים Y.
10. כשפקודת הפריסה מסתיימת, מריצים את הפקודה gcloud app browse:

gcloud app browse

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

Python

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

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

   כניסה לדף Cloud SQL Instances

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

יצירת חיבור לרשת (VPC) מאפליקציית serverless לחיבורים למופע באמצעות כתובת IP פרטית

1. במסוף Google Cloud , עוברים לדף Serverless VPC access (חיבור לרשת (VPC) מאפליקציית serverless) – Create connector (יצירת מחבר).

   יצירת מחבר של חיבור לרשת (VPC) מאפליקציית serverless

2. מזינים quickstart-connector בשדה שם.
3. בתפריט הנפתח רשת, בוחרים באפשרות ברירת מחדל.
4. בתפריט הנפתח רשת משנה, בוחרים באפשרות טווח כתובות IP בהתאמה אישית.
5. מזינים 10.8.0.0 בתיבת הקלט טווח כתובות IP.
6. לוחצים על יצירה.

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

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

   פתיחת Cloud Shell Editor
2. בתיבת הדו-שיח Open in Cloud Shell, לוחצים על Confirm כדי להוריד את קוד האפליקציה לדוגמה ולפתוח את ספריית האפליקציה לדוגמה ב-Cloud Shell Editor.
3. בשורת הפקודה של Cloud Shell, מריצים את הפקודה הבאה כדי להפעיל את הפרויקט:
   ‫

   gcloud config set project YOUR-PROJECT-ID

   הערה: מחליפים את YOUR-PROJECT-ID במזהה הפרויקט.
4. אם מופיעה תיבת הדו-שיח Authorize Cloud Shell, לוחצים על Authorize.
5. מעלים את קובץ אישור השרת SSL לתיקייה certs.
   1. בתפריט הניווט של Explorer ב-Cloud Shell Editor, עוברים לתיקייה python-docs-samples/cloud-sql/sql-server/sqlalchemy/certs.
   2. לוחצים לחיצה ימנית על התיקייה certs ב-Cloud Shell Editor ובוחרים באפשרות Upload Files (העלאת קבצים).
   3. בוחרים את הקובץ הבא במחשב המקומי: server-ca.pem.
   4. אחרי שבוחרים את קובץ אישור השרת SSL, לוחצים על פתיחה כדי להשלים את תהליך ההעלאה של הקובץ אל Cloud Shell Editor.
6. בתפריט הניווט של סייר Cloud Shell Editor, עוברים אל הקובץ python-docs-samples/cloud-sql/sql-server/sqlalchemy/app.standard.yaml ופותחים אותו.
7. מעתיקים את הקוד הבא ומדביקים אותו בקובץ, במקום התוכן הקיים:

runtime: python37
entrypoint: gunicorn -b :$PORT app:app

env_variables:
  DB_NAME: quickstart-db
  DB_USER: sqlserver
  DB_PASS: YOUR_DB_PASSWORD
  INSTANCE_HOST: INSTANCE_HOST
  DB_PORT: 1433
  DB_ROOT_CERT: certs/server-ca.pem
  PRIVATE_IP: TRUE

vpc_access_connector:
  name: projects/PROJECT_ID/locations/us-central1/connectors/quickstart-connector

8. מחליפים את המשתנים הבאים:
• ‫YOUR_DB_PASSWORD בסיסמה של quickstart-user שיצרתם ביצירת משתמש.
• ‫INSTANCE_HOST עם כתובת ה-IP הפרטית של המכונה שמופיעה בדף Cloud SQL instances במסוף Google Cloud .
• ‫PROJECT_ID במזהה הפרויקט.
9. בשורת הפקודה של Cloud Shell, בספרייה python-docs-samples/cloud-sql/sql-server/sqlalchemy, מריצים את הפקודה gcloud app deploy כדי לפרוס את אפליקציית הדוגמה לסביבה הרגילה של App Engine.

gcloud app deploy app.standard.yaml

10. אם תתבקשו לבחור את האזור ליצירת האפליקציה, מזינים את הבחירה המספרית עבור us-central.
11. כשמוצגת השאלה רוצה להמשיך?, מזינים Y.
12. כשפקודת הפריסה מסתיימת, מריצים את הפקודה gcloud app browse:

gcloud app browse

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

הסרת המשאבים

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

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

   כניסה לדף Cloud SQL Instances

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

כדי להשבית אפליקציית App Engine ולשמור את הנתונים שלה:

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

   כניסה לדף Settings

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

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

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

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

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

   כניסה לדף IAM

2. לוחצים על סמל העריכה (שנראה כמו עיפרון) של חשבון ה-IAM שנקרא חשבון שירות שמוגדר כברירת מחדל ב-Compute Engine.
3. מוחקים את התפקיד Cloud SQL client.
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 שרוצים להשבית ולוחצים על הלחצן השבתת 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