ربط تطبيقك ببيانات 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. تأكَّد من تفعيل الفوترة لمشروعك على 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. فعِّل واجهات برمجة التطبيقات المطلوبة: اتّبِع الرابط وفعِّل واجهات برمجة التطبيقات.

يمكنك بدلاً من ذلك استخدام أمر gcloud لهذا الغرض. راجِع المستندات لمعرفة أوامر gcloud وطريقة استخدامها.

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

في هذا التمرين العملي، سنستخدم Cloud SQL لـ 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 بسرعة وسهولة!!!