ربط تطبيقك ببيانات Cloud SQL ونشره على Cloud Run

1. نظرة عامة

من خلال هذا الدرس التطبيقي حول الترميز، سنعرض طريقة بسيطة وسهلة لإعداد Cloud SQL وربط تطبيقنا به. هذا الدرس هو مستوى تعليمي سريع من المستوى 100 لترقية تجربة المطوّرين من أجل دمج تطبيقات الذكاء الاصطناعي المتقدّمة مع ميزات البيانات المتطورة التي توفّرها Cloud SQL.

ما ستنشئه

تطبيق ويب بسيط

كجزء من ذلك، ستنفّذ ما يلي:

  1. إنشاء مثيل Cloud SQL for PostgreSQL من خلال عملية تثبيت بنقرة واحدة
  2. إنشاء نموذج تطبيق للاتصال بهذا المثيل وإعداد البيانات

المتطلبات

  • متصفّح، مثل Chrome أو Firefox
  • مشروع على Google Cloud تم تفعيل الفوترة له

2. قبل البدء

إنشاء مشروع

  1. في Google Cloud Console، في صفحة اختيار المشروع، اختَر مشروعًا على Google Cloud أو أنشِئ مشروعًا.
  2. تأكَّد من تفعيل الفوترة لمشروعك على السحابة الإلكترونية. كيفية التحقّق مما إذا كانت الفوترة مفعّلة في مشروع .
  3. ستستخدم Cloud Shell، وهي بيئة سطر أوامر تعمل على Google Cloud. انقر على تفعيل Cloud Shell في أعلى Google Cloud Console.

صورة زر تفعيل 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. فعِّل واجهات برمجة التطبيقات المطلوبة: اتّبِع الرابط وفعِّل واجهات برمجة التطبيقات.

بدلاً من ذلك، يمكنك استخدام أمر gcloud لهذا الغرض. يُرجى الرجوع إلى المستندات لمعرفة أوامر gcloud واستخدامها.

3. إعداد قاعدة البيانات

في هذا المختبر، سنستخدم Cloud SQL for PostgreSQL كقاعدة بيانات لبيانات الاختبار.

لننشئ مثيل Cloud SQL سيتم تحميل مجموعة بيانات الاختبار فيه.

  1. انقر على الزر أو انسخ الرابط أدناه إلى المتصفّح الذي سجّلت فيه الدخول إلى مستخدم Google Cloud Console.

  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

بعد النشر، من المفترض أن تتلقّى نقطة نهاية Cloud Run تم نشرها تبدو على النحو التالي:

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

6. عرض توضيحي

للتأكّد من أنّ العملية نجحت، يمكنك الاطّلاع على النتيجة في المتصفّح أو في مستكشف السجلّات.

يمكنك الانتقال إلى Cloud SQL على Google Cloud Console وفتح المثيل الذي تم إنشاؤه حديثًا. انقر على Cloud SQL Studio من لوحة التنقّل على يمين الصفحة واتّصِل باستخدام بيانات الاعتماد.

في الاستوديو، في اللوحة على يمين الصفحة، أعِد تحميل عناصر قاعدة البيانات، ومن المفترض أن يظهر الجدول الذي تم إنشاؤه حديثًا:

658d9261e6098139.png

يمكنك الاستعلام عنه بسرعة للتأكّد من أنّ عملية الإدراج قد اكتملت بنجاح:

658d9261e6098139.png

7. تنظيف

بعد الانتهاء من هذا المختبر التجريبي، لا تنسَ حذف مثيل Cloud SQL.

من المفترض أن يؤدي ذلك إلى تنظيف المجموعة بالإضافة إلى مثيلاتها.

8. الخاتمة

ابدأ إعداد بياناتك باستخدام Cloud SQL بسرعة وسهولة.