ربط تطبيقك ببيانات 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".

صورة زر تفعيل 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 بسرعة وسهولة!!!