התחברות ל-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

   בלחיצה על הכפתור, אתם גם מפעילים את הסביבה הגמישה של Google App Engine.

   gcloud

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

   פתיחת Cloud Shell

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

   gcloud services enable appengineflex.googleapis.com 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

   הפעלת הפקודה שלמעלה מפעילה גם את הסביבה הגמישה של Google App Engine.

הגדרת Cloud SQL

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

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

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

המסוף

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

   כניסה לדף Cloud SQL Instances

2. לוחצים על Create instance.
3. בתפריט יצירת מופע, בוחרים באפשרות מופע חדש.
4. לוחצים על Choose PostgreSQL (בחירת PostgreSQL).
5. מוודאים שמהדורת Cloud SQL שנבחרה למופע היא Enterprise Plus.
6. בשדה Instance ID (מזהה המופע), מזינים את הערך quickstart-instance.
7. בשדה סיסמה, מזינים סיסמה למשתמש 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. נכנסים לדף 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 PostgreSQL (בחירת PostgreSQL).
5. מוודאים שמהדורת Cloud SQL שנבחרה למופע היא Enterprise Plus.
6. בשדה Instance ID (מזהה המופע), מזינים את הערך quickstart-instance.
7. בשדה סיסמה, מזינים סיסמה למשתמש 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. כדי ליצור מכונה עם כתובת 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=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. לוחצים על  יצירת מסד נתונים.
1. בשדה שם מסד הנתונים בתיבת הדו-שיח מסד נתונים חדש, מזינים 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. בוחרים את מופע PostgreSQL‏ quickstart-instance שיצרתם.
3. בתפריט הניווט SQL, בוחרים באפשרות Users (משתמשים).
4. לוחצים על הוספת חשבון משתמש.
5. בדף Add a user account to instance quickstart-instance (הוספת חשבון משתמש למכונה quickstart-instance), מוסיפים את הפרטים הבאים:
   1. בשדה שם משתמש, מזינים את הערך quickstart-user.
   2. בשדה סיסמה, מציינים סיסמה למשתמש במסד הנתונים. חשוב לשמור את הסיסמה הזו כי יהיה צורך בה בהמשך המדריך למתחילים.
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.

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

המסוף

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

   מעבר אל App Engine

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

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

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

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

המשך

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, לוחצים על הצומת הניתן להרחבה שהוא שם המשתמש של חשבון Google Cloud .
6. עוברים אל הקובץ cloudshell_open/golang-samples/cloudsql/postgres/database-sql/app.flexible.yaml ופותחים אותו.
7. מחליפים את ה-placeholders של משתני הסביבה בקובץ app.flexible.yaml בערכים הבאים:
• ‫<PROJECT-ID> במזהה הפרויקט.
• ‫<INSTANCE-REGION> עם us-central1.
• ‫<INSTANCE-NAME> עם quickstart-instance.
• ‫<YOUR_DB_USER_NAME> עם quickstart-user.
• ‫<YOUR_DB_PASSWORD> בסיסמה של quickstart-user שיצרתם ביצירת משתמש.
• ‫<YOUR_DB_NAME> עם quickstart-db.
8. בשורת הפקודה של Cloud Shell, בספרייה cloudshell_open/golang-samples/cloudsql/postgres/database-sql, מריצים את הפקודה gcloud app deploy כדי לפרוס את אפליקציית הדוגמה לסביבה הגמישה של App Engine.

gcloud app deploy app.flexible.yaml

9. כשמוצגת השאלה רוצה להמשיך?, מזינים Y.
10. אחרי שהפעולות שמתבצעות בהרצת הפקודה gcloud app 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, לוחצים על הצומת הניתן להרחבה שהוא שם המשתמש של חשבון Google Cloud .
6. עוברים אל הקובץ cloudshell_open/java-docs-samples/cloud-sql/postgres/servlet/src/main/webapp/WEB-INF/appengine-web.xml ופותחים אותו.
7. מחליפים את ה-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.
8. בשורת הפקודה של Cloud Shell, בספרייה cloudshell_open/java-docs-samples/cloud-sql/postgres/servlet, מריצים את הפקודה mvn clean package של Apache Maven כדי לפרוס את אפליקציית הדוגמה לסביבה גמישה של App Engine.

mvn clean package appengine:deploy -DskipTests

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

gcloud app deploy app.flexible.yaml

9. כשמוצגת השאלה רוצה להמשיך?, מזינים Y.
10. אחרי שהפעולות שמתבצעות בהרצת הפקודה gcloud app 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, לוחצים על הצומת הניתן להרחבה שהוא שם המשתמש של חשבון Google Cloud .
6. עוברים אל הקובץ cloudshell_open/python-docs-samples/cloud-sql/postgres/sqlalchemy/app.flexible.yaml ופותחים אותו.
7. מחליפים את ה-placeholders של משתני הסביבה בקובץ app.flexible.yaml בערכים הבאים:
• ‫<PROJECT-ID> במזהה הפרויקט.
• ‫<INSTANCE-REGION> עם us-central1.
• ‫<INSTANCE-NAME> עם quickstart-instance.
• ‫<YOUR_DB_USER_NAME> עם quickstart-user.
• ‫<YOUR_DB_PASSWORD> בסיסמה של quickstart-user שיצרתם ביצירת משתמש.
• ‫<YOUR_DB_NAME> עם quickstart-db.
8. בשורת הפקודה של Cloud Shell, בספרייה cloudshell_open/python-docs-samples/cloud-sql/postgres/sqlalchemy, מריצים את הפקודה gcloud app deploy כדי לפרוס את אפליקציית הדוגמה לסביבה הגמישה של App Engine.

gcloud app deploy app.flexible.yaml

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

gcloud app browse

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

כתובת IP פרטית

בנתיבי IP פרטיים, מוודאים שהמכונה הווירטואלית של הסביבה הגמישה של App Engine והמכונה של Cloud SQL מתארחות באותה רשת של ענן וירטואלי פרטי (VPC). אם האפליקציה שלכם בסביבה הגמישה של App Engine נמצאת באותה רשת VPC, היא יכולה להתחבר ישירות למופע Cloud SQL בלי להשתמש בשרת proxy ל-Cloud SQL Auth.

המשך

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

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

   כניסה לדף Cloud SQL Instances

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

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

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

פיתוח אפליקציה לדוגמה עם אישורי 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, לוחצים על פתיחה כדי להשלים את תהליך העלאת הקבצים אל Cloud Shell Editor.
6. בתפריט הניווט Explorer של Cloud Shell Editor, לוחצים על הצומת הניתן להרחבה שהוא שם המשתמש של חשבון Google Cloud .
7. עוברים אל הקובץ cloudshell_open/golang-samples/cloudsql/postgres/database-sql/app.flexible.yaml ופותחים אותו.
8. מעתיקים את הקוד הבא ומדביקים אותו בקובץ, במקום התוכן הקיים בקובץ:

runtime: custom
env: flex

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

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

gcloud app deploy app.flexible.yaml

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

gcloud app browse

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

Java

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

למשתמשי Java, המחבר כבר מספק חיבור מאובטח, כך שאין צורך ליצור ולהוריד אישורי 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. בתפריט הניווט Explorer של Cloud Shell Editor, לוחצים על הצומת הניתן להרחבה שהוא שם המשתמש של חשבון Google Cloud .
6. עוברים אל הקובץ cloudshell_open/java-docs-samples/cloud-sql/postgres/servlet/src/main/webapp/WEB-INF/appengine-web.xml ופותחים אותו.
7. מעתיקים את הקוד הבא לקובץ 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>

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

mvn clean package appengine:deploy -DskipTests

10. כשמוצגת השאלה רוצה להמשיך?, מזינים Y.
11. אחרי שהפעולות שמתבצעות בהרצת הפקודה gcloud app 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. לוחצים על הכרטיסייה Connections (קישורים).
4. בקטע Security, לוחצים על Create client certificate.
5. בתיבת הדו-שיח Create a client certificate, מזינים quickstart-key כשם ולוחצים על Create.

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

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

פיתוח אפליקציה לדוגמה עם אישורי 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, לוחצים על פתיחה כדי להשלים את תהליך העלאת הקבצים אל Cloud Shell Editor.
6. בתפריט הניווט Explorer של Cloud Shell Editor, לוחצים על הצומת הניתן להרחבה שהוא שם המשתמש של חשבון Google Cloud .
7. עוברים אל הקובץ cloudshell_open/nodejs-docs-samples/cloud-sql/postgres/knex/app.flexible.yaml ופותחים אותו.
8. מעתיקים את הקוד הבא ומדביקים אותו בקובץ, במקום התוכן הקיים:

runtime: nodejs
env: flex

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

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

gcloud app deploy app.flexible.yaml

11. כשמוצגת השאלה רוצה להמשיך?, מזינים Y.
12. אחרי שהפעולות שמתבצעות בהרצת הפקודה gcloud app 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. לוחצים על הכרטיסייה Connections (קישורים).
4. בקטע Security, לוחצים על Create client certificate.
5. בתיבת הדו-שיח Create a client certificate, מזינים quickstart-key כשם ולוחצים על Create.

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

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

פיתוח אפליקציה לדוגמה עם אישורי 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, לוחצים על פתיחה כדי להשלים את תהליך העלאת הקבצים אל Cloud Shell Editor.
6. בתפריט הניווט Explorer של Cloud Shell Editor, לוחצים על הצומת הניתן להרחבה שהוא שם המשתמש של חשבון Google Cloud .
7. עוברים אל הקובץ cloudshell_open/python-docs-samples/cloud-sql/postgres/sqlalchemy/app.flexible.yaml ופותחים אותו.
8. מעתיקים את הקוד הבא ומדביקים אותו בקובץ, במקום התוכן הקיים:

runtime: custom
env: flex
entrypoint: gunicorn -b :$PORT app:appentrypoint: 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

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

gcloud app deploy app.flexible.yaml

11. כשמוצגת השאלה רוצה להמשיך?, מזינים Y.
12. אחרי שהפעולות שמתבצעות בהרצת הפקודה gcloud app 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 כדי לפתוח את הדף פרטי המופע.
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.

אפשר גם לקרוא על יצירת משתמשי PostgreSQL ומסדי נתונים עבור מופע Cloud SQL.

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

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

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

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

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