חיבור האפליקציה לנתוני Cloud SQL ופריסה ב-Cloud Run

1. סקירה כללית

בשיעור הזה נדגים שיטה פשוטה וקלה להגדרה של Cloud SQL ולחיבור האפליקציה אליו. זהו מדריך למידה מהיר ברמה L100 לשדרוג חוויית המפתחים, כדי לשלב אפליקציות מתקדמות של AI עם תכונות נתונים מתוחכמות ש-Cloud SQL מציע.

מה תפַתחו

אפליקציית אינטרנט פשוטה.

כחלק מהתהליך הזה, תצטרכו:

  1. יצירת מכונה של Cloud SQL ל-PostgreSQL בהתקנה בלחיצה אחת
  2. יצירת אפליקציה לדוגמה כדי להתחבר למופע הזה ולהגדיר נתונים

דרישות

  • דפדפן, כמו Chrome או Firefox
  • פרויקט ב-Google Cloud שהחיוב בו מופעל.

‫2. לפני שמתחילים

יצירת פרויקט

  1. ב-Google Cloud Console, בדף לבחירת הפרויקט, בוחרים או יוצרים פרויקט ב-Google Cloud.
  2. מוודאים שהחיוב מופעל בפרויקט ב-Cloud. כך בודקים אם החיוב מופעל בפרויקט.
  1. תשתמשו ב-Cloud Shell, סביבת שורת פקודה שפועלת ב-Google Cloud. לוחצים על 'הפעלת Cloud Shell' בחלק העליון של מסוף Google Cloud.

תמונה של לחצן ההפעלה של Cloud Shell

  1. אחרי שמתחברים ל-Cloud Shell, אפשר לבדוק שכבר בוצע אימות ושהפרויקט מוגדר לפי מזהה הפרויקט באמצעות הפקודה הבאה:
gcloud auth list
  1. מריצים את הפקודה הבאה ב-Cloud Shell כדי לוודא שפקודת gcloud מכירה את הפרויקט.
gcloud config list project
  1. אם הפרויקט לא מוגדר, משתמשים בפקודה הבאה כדי להגדיר אותו:
gcloud config set project <YOUR_PROJECT_ID>
  1. מפעילים את ממשקי ה-API הנדרשים: לוחצים על הקישור ומפעילים את ממשקי ה-API.

אפשר גם להשתמש בפקודת gcloud. אפשר לעיין במאמרי העזרה בנושא פקודות gcloud ושימוש בהן.

3. הגדרת מסד נתונים

בשיעור ה-Lab הזה נשתמש ב-Cloud SQL ל-PostgreSQL כמסד הנתונים של נתוני הבדיקה.

ניצור מכונה של Cloud SQL שבה ייטען מערך הנתונים של הבדיקה.

  1. לוחצים על הלחצן או מעתיקים את הקישור שלמטה לדפדפן שבו המשתמש מחובר למסוף Google Cloud.

  1. אחרי שתשלימו את השלב הזה, המאגר ישוכפל לעורך המקומי של Cloud Shell ותוכלו להריץ את הפקודה שלמטה מתוך תיקיית הפרויקט (חשוב לוודא שאתם בספריית הפרויקט):
sh run.sh
  1. עכשיו משתמשים בממשק המשתמש (לוחצים על הקישור במסוף או על הקישור 'תצוגה מקדימה באינטרנט' במסוף).
  2. כדי להתחיל, מזינים את הפרטים של מזהה הפרויקט ושם המכונה.
  3. אתם יכולים ללכת לשתות קפה בזמן שהיומנים מתגללים, וכאן תוכלו לקרוא איך זה קורה מאחורי הקלעים.

4. יצירת אפליקציה לדוגמה כדי לבדוק את החיבור

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

git clone https://github.com/flazer99/verify-easy-cloud-sql-connection

cd verify-easy-cloud-sql-connection

מבצעים שינויים בקובץ verify_connection.py בהתאם להגדרת Cloud SQL שהגדרתם בקטע הקודם:

# Replace this with the Private IP of your Cloud SQL Instance
DB_HOST = <<>> 
DB_PORT = "5432"
DB_NAME = "postgres"
DB_USER = "postgres"
# Replace this with your actual Cloud SQL password    
DB_PASS = <<>>

5. פריסה ב-Cloud Run

בטרמינל של Cloud Shell, מוודאים שאתם נמצאים בתוך תיקיית הפרויקט.

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

gcloud run deploy verify-cloudsql \
    --source . \
    --region=us-central1 \
    --network=easy-cloudsql-vpc \
    --subnet=easy-cloudsql-subnet \
    --vpc-egress=all-traffic \
    --allow-unauthenticated

אחרי הפריסה, תקבלו נקודת קצה (endpoint) של Cloud Run שנראית כך:

https://verify-cloudsql-**********-uc.a.run.app/

6. הדגמה (דמו)

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

אפשר לעבור אל Cloud SQL במסוף Google Cloud ולפתוח את המופע החדש שנוצר. לוחצים על Cloud SQL Studio בחלונית הניווט שמימין ומתחברים באמצעות פרטי הכניסה.

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

658d9261e6098139.png

אפשר להריץ עליה שאילתה במהירות כדי לוודא שההוספה בוצעה בהצלחה:

658d9261e6098139.png

7. הסרת המשאבים

לאחר סיום שיעור ה-Lab הזה, אל תשכחו למחוק את מכונת Cloud SQL.

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

8. סיכום

מתחילים להגדיר את הנתונים בקלות ובמהירות באמצעות Cloud SQL.