התחברות ל-Cloud SQL ל-PostgreSQL מסביבת ברירת המחדל ב-App Engine

התחברות ל-Cloud SQL ל-PostgreSQL מסביבת ברירת המחדל ב-App Engine

MySQL   |  PostgreSQL   |  SQL Server

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

המסוף

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

   כניסה לדף Cloud SQL Instances

2. לוחצים על Create instance.
3. בתפריט Create instance, בוחרים באפשרות New instance.
4. לוחצים על Choose PostgreSQL.
5. מוודאים שהמהדורה שנבחרה למכונה של Cloud SQL היא Enterprise Plus.
6. בשדה Instance ID, מזינים את הערך quickstart-instance.
7. בשדה Password, מזינים סיסמה למשתמש postgres. שמרו את הסיסמה הזו לשימוש עתידי.
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=POSTGRES_14 \
 --cpu=1 \
 --memory=4GB \
 --region=us-central \
 --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 PostgreSQL.
5. מוודאים שהמהדורה שנבחרה למכונה של Cloud SQL היא Enterprise Plus.
6. בשדה Instance ID, מזינים את הערך quickstart-instance.
7. בשדה Password, מזינים סיסמה למשתמש postgres. שמרו את הסיסמה הזו לשימוש עתידי.
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=POSTGRES_14 \
 --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

יצירת משתמש

המסוף

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

   כניסה לדף Cloud SQL Instances

2. כדי לפתוח את הדף Overview של מכונה, לוחצים על שם המכונה.
3. בתפריט הניווט של SQL, לוחצים על Users.
4. לוחצים על הוספת חשבון משתמש.
5. בדף Add a user account to instance instance_name, מוסיפים את הפרטים הבאים:
   1. בשדה שם משתמש, מזינים את הערך quickstart-user.
   2. בשדה Password, מציינים סיסמה למשתמש במסד הנתונים. חשוב לשמור את הסיסמה הזו כי תצטרכו אותה בשלב מאוחר יותר במדריך למתחילים.
6. לוחצים על הוספה.

gcloud

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

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

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

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

מגבלות האורך של שמות המשתמשים ב-Cloud SQL זהות לאלה של PostgreSQL מקומי.

פריסת אפליקציה לדוגמה בסביבת ברירת המחדל ב-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. לוחצים על הכפתור Create application.
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.
5. לוחצים על Save.

gcloud

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

   gcloud iam service-accounts list

2. מעתיקים את כתובת האימייל של חשבון השירות של App Engine.
3. מריצים את הפקודה הבאה כדי להוסיף את התפקיד לקוח Cloud SQL לחשבון השירות של 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 ציבורית

בנתיבים של כתובות IP ציבוריות, סביבת ברירת המחדל ב-App Engine מספקת הצפנה ומתחברת באמצעות Cloud SQL Auth Proxy דרך שקעי Unix.

המשך

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. בתפריט הניווט של Explorer ב-Cloud Shell Editor, עוברים לקובץ golang-samples/cloudsql/postgres/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> ב-quickstart-user.
• ‫<YOUR_DB_PASSWORD> בסיסמה של quickstart-user שיצרתם בקטע יצירת משתמש.
• thought <YOUR_DB_NAME> עם quickstart-db.
7. בשורת הפקודה של Cloud Shell, בספרייה golang-samples/cloudsql/postgres/database-sql, מריצים את הפקודה הבאה של gcloud app deploy כדי לפרוס את האפליקציה לדוגמה בסביבת ברירת המחדל ב-App Engine.

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

8. אם מוצגת בקשה לבחור את האזור ליצירת האפליקציה, מזינים את הבחירה המספרית של us-central.
9. כשמוצגת השאלה Do you want to continue?‎, מזינים Y.
10. כשהפקודה deploy מסתיימת, מריצים את הפקודה 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. בתפריט הניווט של Explorer ב-Cloud Shell Editor, עוברים לקובץ java-docs-samples/cloud-sql/postgres/servlet/src/main/webapp/WEB-INF/appengine-web.xml ופותחים אותו.
6. מחליפים את ה-placeholders של משתני הסביבה בקובץ appengine-web.xml בערכים הבאים:
• my-project:region:instance בשם החיבור של המכונה, שמופיע בדף Cloud SQL instances במסוף Google Cloud .
• ‫my-db-user ב-quickstart-user.
• ‫my-db-password בסיסמה של quickstart-user שיצרתם בקטע יצירת משתמש.
• my_db עם quickstart-db.
7. בשורת הפקודה של Cloud Shell, בספרייה java-docs-samples/cloud-sql/postgres/servlet, מריצים את הפקודה הבאה של Apache Maven (mvn clean package) כדי לפרוס את האפליקציה לדוגמה בסביבת ברירת המחדל ב-App Engine.

mvn clean package appengine:deploy -DskipTests

8. אם מוצגת בקשה לבחור את האזור ליצירת האפליקציה, מזינים את הבחירה המספרית של us-central.
9. כשמוצגת השאלה Do you want to continue?‎, מזינים Y.
10. כשהפקודה deploy מסתיימת, מריצים את הפקודה gcloud app browse:

gcloud app browse

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

Node.js

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. בתפריט הניווט של Explorer ב-Cloud Shell Editor, עוברים לקובץ nodejs-docs-samples/cloud-sql/postgres/knex/app.standard.yaml ופותחים אותו.
6. מחליפים את ה-placeholders של משתני הסביבה בקובץ app.standard.yaml בערכים הבאים:
• ‫<MY-PROJECT> במזהה הפרויקט.
• <INSTANCE-REGION> ב-us-central1.
• ‫<INSTANCE-NAME> במזהה המכונה שמופיע בדף Cloud SQL instances במסוף Google Cloud .
• ‫MY_DB_USER עם quickstart-user.
• ‫MY_DB_PASSWORD בסיסמה של quickstart-user שיצרתם בקטע יצירת משתמש.
• MY_DATABASE עם quickstart-db.
7. בשורת הפקודה של Cloud Shell, בספרייה nodejs-docs-samples/cloud-sql/postgres/knex, מריצים את הפקודה הבאה של gcloud app deploy כדי לפרוס את האפליקציה לדוגמה בסביבת ברירת המחדל ב-App Engine.

gcloud app deploy app.standard.yaml

8. אם מוצגת בקשה לבחור את האזור ליצירת האפליקציה, מזינים את הבחירה המספרית של us-central.
9. כשמוצגת השאלה Do you want to continue?‎, מזינים Y.
10. כשהפקודה deploy מסתיימת, מריצים את הפקודה 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. בתפריט הניווט של Explorer ב-Cloud Shell Editor, עוברים לקובץ python-docs-samples/cloud-sql/postgres/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> ב-quickstart-user.
• ‫<YOUR_DB_PASSWORD> בסיסמה של quickstart-user שיצרתם בקטע יצירת משתמש.
• thought <YOUR_DB_NAME> עם quickstart-db.
7. בשורת הפקודה של Cloud Shell, בספרייה python-docs-samples/cloud-sql/postgres/sqlalchemy, מריצים את הפקודה הבאה של gcloud app deploy כדי לפרוס את האפליקציה לדוגמה בסביבת ברירת המחדל ב-App Engine.

gcloud app deploy app.standard.yaml

8. אם מוצגת בקשה לבחור את האזור ליצירת האפליקציה, מזינים את הבחירה המספרית של us-central.
9. כשמוצגת השאלה Do you want to continue?‎, מזינים Y.
10. כשהפקודה deploy מסתיימת, מריצים את הפקודה gcloud app browse:

gcloud app browse

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

כתובת IP פרטית

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

המשך

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

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

   כניסה לדף Cloud SQL Instances

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

6. בתיבת הדו-שיח New SSL certificate created, לוחצים על כל קישור להורדה כדי להוריד את אישורי ה-SSL. אחר כך לוחצים על סגירה.

   חשוב: צריך לאחסן את המפתח הפרטי הזה בצורה מאובטחת. אם תאבדו אותו, תצטרכו ליצור אישור לקוח חדש.

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

1. במסוף Google Cloud , נכנסים לדף Serverless VPC access - Create connector.

   יצירת מחבר VPC ללא שרת (Serverless)

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

פיתוח אפליקציה לדוגמה עם אישורי 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/postgres/database-sql/certs.
   2. לוחצים לחיצה ימנית על התיקייה certs ב-Cloud Shell Editor ובוחרים באפשרות Upload Files.
   3. בוחרים את הקבצים הבאים במחשב המקומי:
   • client-key.pem
   • client-cert.pem
   • server-ca.pem
   4. אחרי שבוחרים את שלושת הקבצים של אישורי ה-SSL, לוחצים על Open כדי להשלים את תהליך ההעלאה של הקבצים ל-Cloud Shell Editor.
6. בתפריט הניווט של Explorer ב-Cloud Shell Editor, עוברים לקובץ golang-samples/cloudsql/postgres/database-sql/cmd/app/app.standard.yaml ופותחים אותו.
7. מעתיקים את הקוד הבא ומדביקים אותו בקובץ, במקום התוכן הקיים:

runtime: go116

env_variables:
  DB_USER: quickstart-user
  DB_PASS: YOUR_DB_PASSWORD
  DB_NAME: quickstart-db
  DB_PORT: 3306
  INSTANCE_HOST: INSTANCE_HOST
  DB_ROOT_CERT: certs/server-ca.pem
  DB_CERT: certs/client-cert.pem
  DB_KEY: certs/client-key.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, בספרייה golang-samples/cloudsql/postgres/database-sql, מריצים את הפקודה הבאה של gcloud app deploy כדי לפרוס את האפליקציה לדוגמה בסביבת ברירת המחדל ב-App Engine.

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

10. אם מוצגת בקשה לבחור את האזור ליצירת האפליקציה, מזינים את הבחירה המספרית של us-central.
11. כשמוצגת השאלה Do you want to continue?‎, מזינים Y.
12. כשהפקודה deploy מסתיימת, מריצים את הפקודה gcloud app browse:

gcloud app browse

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

Java

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

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

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

1. במסוף Google Cloud , נכנסים לדף Serverless VPC access - Create connector.

   יצירת מחבר VPC ללא שרת (Serverless)

2. בשדה Name מזינים quickstart-connector.
3. בתפריט הנפתח Network, בוחרים באפשרות default.
4. בתפריט הנפתח Subnet, בוחרים באפשרות Custom IP range.
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. בתפריט הניווט של Explorer ב-Cloud Shell Editor, עוברים לקובץ java-docs-samples/cloud-sql/postgres/servlet/src/main/webapp/WEB-INF/appengine-web.xml ופותחים אותו.
6. מעתיקים את הקוד הבא ומדביקים אותו בקובץ appengine-web.xml, במקום התוכן הקיים בקובץ:

<runtime>java17</runtime>
  <env-variables>
    <env-var name="INSTANCE_CONNECTION_NAME" value="project-name:region-name:instance-name" />
    <env-var name="DB_PORT" value="5432" />
    <env-var name="DB_USER" value="quickstart-user" />
    <env-var name="DB_PASS" value="my-db-password" />
    <env-var name="DB_NAME" value="quickstart-db" />
  </env-variables>
<vpc-access-connector>
  <name>projects/PROJECT_ID/locations/us-central1/connectors/quickstart-connector</name>
  <egress-setting>all-traffic</egress-setting>
</vpc-access-connector>

7. מחליפים את המשתנים הבאים:
• ‫project-name:region-name:instance-name בשם החיבור של המכונה שמופיע בדף Cloud SQL instances במסוף Google Cloud .
• ‫my-db-password בסיסמה של quickstart-user שיצרתם בקטע יצירת משתמש.
• ‫PROJECT_ID במזהה הפרויקט.
8. בשורת הפקודה של Cloud Shell, בספרייה java-docs-samples/cloud-sql/postgres/servlet, מריצים את הפקודה הבאה של Apache Maven (mvn clean package) כדי לפרוס את האפליקציה לדוגמה בסביבת ברירת המחדל ב-App Engine.

mvn clean package appengine:deploy -DskipTests

9. אם מוצגת בקשה לבחור את האזור ליצירת האפליקציה, מזינים את הבחירה המספרית של us-central.
10. כשמוצגת השאלה Do you want to continue?‎, מזינים Y.
11. כשהפקודה deploy מסתיימת, מריצים את הפקודה gcloud app browse:

gcloud app browse

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

Node.js

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

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

   כניסה לדף Cloud SQL Instances

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

6. בתיבת הדו-שיח New SSL certificate created, לוחצים על כל קישור להורדה כדי להוריד את אישורי ה-SSL. אחר כך לוחצים על סגירה.

   חשוב: צריך לאחסן את המפתח הפרטי הזה בצורה מאובטחת. אם תאבדו אותו, תצטרכו ליצור אישור לקוח חדש.

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

1. במסוף Google Cloud , נכנסים לדף Serverless VPC access - Create connector.

   יצירת מחבר VPC ללא שרת (Serverless)

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

פיתוח אפליקציה לדוגמה עם אישורי 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, עוברים לתיקייה nodejs-docs-samples/cloud-sql/postgres/knex/certs.
   2. לוחצים לחיצה ימנית על התיקייה certs ב-Cloud Shell Editor ובוחרים באפשרות Upload Files.
   3. בוחרים את הקבצים הבאים במחשב המקומי:
   • client-key.pem
   • client-cert.pem
   • server-ca.pem
   4. אחרי שבוחרים את שלושת הקבצים של אישורי ה-SSL, לוחצים על Open כדי להשלים את תהליך ההעלאה של הקבצים ל-Cloud Shell Editor.
6. בתפריט הניווט של Explorer ב-Cloud Shell Editor, עוברים לקובץ nodejs-docs-samples/cloud-sql/postgres/knex/app.standard.yaml ופותחים אותו.
7. מעתיקים את הקוד הבא ומדביקים אותו בקובץ, במקום התוכן הקיים:

runtime: nodejs16

env_variables:
  DB_USER: quickstart-user
  DB_PASS: MY_DB_PASSWORD
  DB_NAME: quickstart-db
  DB_PORT: 5432
  INSTANCE_HOST: INSTANCE_HOST
  DB_ROOT_CERT: certs/server-ca.pem
  DB_CERT: certs/client-cert.pem
  DB_KEY: certs/client-key.pem
  PRIVATE_IP: TRUE

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

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

gcloud app deploy app.standard.yaml

10. אם מוצגת בקשה לבחור את האזור ליצירת האפליקציה, מזינים את הבחירה המספרית של us-central.
11. כשמוצגת השאלה Do you want to continue?‎, מזינים Y.
12. כשהפקודה deploy מסתיימת, מריצים את הפקודה gcloud app browse:

gcloud app browse

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

Python

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

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

   כניסה לדף Cloud SQL Instances

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

6. בתיבת הדו-שיח New SSL certificate created, לוחצים על כל קישור להורדה כדי להוריד את אישורי ה-SSL. אחר כך לוחצים על סגירה.

   חשוב: צריך לאחסן את המפתח הפרטי הזה בצורה מאובטחת. אם תאבדו אותו, תצטרכו ליצור אישור לקוח חדש.

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

1. במסוף Google Cloud , נכנסים לדף Serverless VPC access - Create connector.

   יצירת מחבר VPC ללא שרת (Serverless)

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

פיתוח אפליקציה לדוגמה עם אישורי 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/postgres/sqlalchemy/certs.
   2. לוחצים לחיצה ימנית על התיקייה certs ב-Cloud Shell Editor ובוחרים באפשרות Upload Files.
   3. בוחרים את הקבצים הבאים במחשב המקומי:
   • client-key.pem
   • client-cert.pem
   • server-ca.pem
   4. אחרי שבוחרים את שלושת הקבצים של אישורי ה-SSL, לוחצים על Open כדי להשלים את תהליך ההעלאה של הקבצים ל-Cloud Shell Editor.
6. בתפריט הניווט של Explorer ב-Cloud Shell Editor, עוברים לקובץ python-docs-samples/cloud-sql/postgres/sqlalchemy/app.standard.yaml ופותחים אותו.
7. מעתיקים את הקוד הבא ומדביקים אותו בקובץ, במקום התוכן הקיים:

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

env_variables:
  DB_USER: quickstart-user
  DB_PASS: YOUR_DB_PASSWORD
  DB_NAME: quickstart-db
  DB_PORT: 5432
  INSTANCE_HOST: INSTANCE_HOST
  DB_ROOT_CERT: certs/server-ca.pem
  DB_CERT: certs/client-cert.pem
  DB_KEY: certs/client-key.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/postgres/sqlalchemy, מריצים את הפקודה הבאה של gcloud app deploy כדי לפרוס את האפליקציה לדוגמה בסביבת ברירת המחדל ב-App Engine.

gcloud app deploy app.standard.yaml

10. אם מוצגת בקשה לבחור את האזור ליצירת האפליקציה, מזינים את הבחירה המספרית של us-central.
11. כשמוצגת השאלה Do you want to continue?‎, מזינים Y.
12. כשהפקודה deploy מסתיימת, מריצים את הפקודה 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 כדי לפתוח את הדף Instance details.
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 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 .

   מעבר אל ממשקי ה-API

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

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

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

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

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

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

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

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

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