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

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

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

מה תפַתחו

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

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

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

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

דרישות

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

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

יצירת פרויקט

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

תמונה של לחצן Activate 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 הזה נשתמש ב-AlloyDB כבסיס הנתונים של נתוני הבדיקה. הוא משתמש באשכולות כדי להכיל את כל המשאבים, כמו מסדי נתונים ויומנים. לכל אשכול יש מופע ראשי שמספק נקודת גישה לנתונים. הטבלאות יכילו את הנתונים בפועל.

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

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

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

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

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

git clone https://github.com/AbiramiSukumaran/verify-easy-alloydb-connection

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

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

5. פריסה ב-Cloud Run

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

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

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

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

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

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

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

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

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

c6365c17d2d49eb7.png

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

480c24fbd45ba150.png

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

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

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

8. סיכום

מתחילים להגדיר את הנתונים ב-AlloyDB בקלות ובמהירות.