1. مقدمة
تاريخ آخر تعديل: 2020-05-04
التفكير في نوع الرابط
هناك العديد من أنواع التطبيقات وأطر العمل المتاحة. في هذا الدرس التطبيقي، سنتناول الاتصال بخدمة Cloud SQL من أي مكان. يتم تمكين القدرة على الاتصال من خلال السماح لعناوين IP المسموح بها بالاتصال بشكل صريح. يمكن القول إنّ هذا هو الخيار الأقل أمانًا للاتصال بقاعدة بيانات Cloud SQL، ولكنه أيضًا الأسهل في الإعداد والبدء في الاستخدام.
يكون من الضروري أحيانًا إجراء ذلك في مرحلة الإنتاج، ولكن إذا استطعت تجنب ذلك، عليك اختيار بديل أكثر أمانًا (على سبيل المثال، استخدام خادم Cloud SQL الوكيل). هذا الإعداد هو الأنسب للتطوير والاختبار.
ما الذي ستنشئه
هذا الدرس التطبيقي حول الترميز بسيط للغاية. الفكرة هي تقديم إرشادات لك بشأن جميع عناصر قطعة الاتصال، دون التفكير كثيرًا في التطبيق نفسه. في عالم مثالي، يشبه الاتصال بخدمة Cloud SQL الاتصال بأي مثيل آخر من قاعدة بيانات SQL، وبالتالي يجب أن تتمكن من تدوين ما تنشئه في هذا الدرس التطبيقي حول الترميز وتطبيقه على أي تطبيق إنتاج.
ستتضمن التعليمات جولة تفصيلية حول تنفيذ المهام في وحدة تحكُّم Google Cloud Platform، بالإضافة إلى تضمين مكافئات أمر gcloud لاستخدام واجهة سطر الأوامر أو التشغيل الآلي.
الخطوات الفردية هي:
- إنشاء مثيل Cloud SQL (يستخدم هذا البرنامج التعليمي Postgres، ولكنه يعمل بالطريقة نفسها مع MySQL أو SQL Server) وتفويض عناوين IP محدّدة مسموح لها بالاتصال به
المتطلبات
- حساب Google Cloud Platform (GCP) لديك أذونات لتفعيل واجهات برمجة التطبيقات وإنشاء خدمات عليه
- تم تثبيت عميل Postgres للتحقّق من إمكانية الاتصال (أو عميل MySQL إذا كنت تريد استخدام MySQL بدلاً من Postgres).
2. إنشاء مثيل Cloud SQL
خدمة Cloud SQL هي عرض قواعد البيانات الارتباطية المُدارة التابع لنا. وهو يدعم MySQL وPostgreSQL وSQL Server. بالنسبة لهذا الدرس التطبيقي، سننشئ قاعدة بيانات Postgres، لكن التعليمات متشابهة للثلاثة.
على وحدة التحكّم
انتقِل إلى صفحة Cloud SQL، وانقر على الزر 
.
كما ذكرت، فإن معظم هذا الدرس التطبيقي حول الترميز عام لأي صيغة SQL، ولكن بالنسبة لهذا الدرس التطبيقي، اختر PostgreSQL.
- إدخال رقم تعريف للمثيل
- اختيار منطقة قريبة من أي مكان تتواجد فيه
- أدخِل كلمة مرور للمستخدم التلقائي (سيكون اسم المستخدم هو الاسم التلقائي في قاعدة البيانات المحدَّدة، مثل
rootلـ MySQL أوpostgresلـ PostgreSQL) - الانتقال للأسفل والنقر على
show configuration options - توسيع القسم "
Connectivity" - تأكَّد من وضع علامة في المربّع
Public IPوإزالة العلامةPrivate IP. - انقر على الزر
. - الحصول على عنوان IP من المكان الذي يتم الاتصال منه. الطريقة الأسهل هي إجراء بحث في Google عن "ما عنوان IP الخاص بي" وتحتوي نتائج البحث على عنوان IP العلني الخاص بك.
- أدخل مواصفات IP في حقل الشبكة، وأدخل اسمًا لها إذا أردت، وانقر على تم في مربع
New Network. - مرر لأسفل وانقر على "إنشاء"
يستغرق عادةً بدء المثيل بضع دقائق.
بعد الانتهاء من إنشاء المثيل، انقر عليه في القائمة، وفي صفحة النظرة العامة، تحت عنوان Connect to this instance، انسخ public IP address المدرَج هناك. ولن يكون موجودًا حتى يتم إنشاء المثيل بالكامل على الرغم من أنه يمكنك النقر فوق التفاصيل قبل إنشاء مثيل له بالكامل.
استخدام gcloud
عليك أولاً الحصول على عنوان IP الذي تريد السماح له بالاتصال بمثيل Cloud SQL. وتتمثل أسهل طريقة لإجراء ذلك في فتح متصفّح والبحث عن "ما هو عنوان IP الخاص بي؟" وتحتوي نتائج البحث على عنوان IP متاح للجميع. إذا لم يكن بإمكانك فتح متصفح الويب الذي تُجري هذا من خلاله، يمكنك استخدام أداة مساعدة مثل dig.
dig @resolver1.opendns.com ANY myip.opendns.com +short -4
عليك تحديد منطقة لمثيل Cloud SQL الأقرب إلى مكانك. يمكنك الاطّلاع على قائمة المناطق من خلال تنفيذ ما يلي:
gcloud sql tiers list
يتوفّر كل فئة في مناطق معيّنة فقط. في البرنامج التعليمي، سننشئ مثيلاً مصغّرًا فقط في gcloud، ويمكنكم فيه العثور على المناطق التي تتوفّر فيها هذه الفئة من خلال التشغيل تحديدًا (طالما أنّ الأمر grep مثبتًا):
gcloud sql tiers list | grep db-f1-micro
بعد ذلك يظهر أمر إنشاء المثيل نفسه (لا تنس استبدال <AUTHORIZED_IP> بعنوان IP الذي حصلت عليه من المتصفح أو إجراء بحث، و<المنطقة> مع عنوان قريب منك وكلمة مرور للمستخدم الجذر "postgres"):
gcloud sql instances create sql-codelab-00 --database-version=POSTGRES_11 --tier=db-f1-micro --region=<REGION> --authorized-networks=<AUTHORIZED_IP> --root-password=<PASSWORD>
يستغرق إكمال هذه الخطوة بضع دقائق.
وبعد اكتمال هذه العملية، سيتم إدراج PRIMARY_ADDRESS للمثيل في الناتج في واجهة سطر الأوامر. انسخه في الخطوة التالية.
3- اختبار الاتصال والاختتام
للتأكّد من إعداد المثيل بشكل صحيح، يمكنك تشغيل سطر الأوامر من الجهاز الذي أدخلته باستخدام عنوان IP الذي أدخلته:
psql "host=<عنوان IP تم نسخه من الخطوة السابقة>" Port=5432 sslmode=disable user=postgres"
بعد ذلك، حدِّد كلمة مرور المستخدم التلقائي التي أعددتها عند إنشاء مثيل Cloud SQL.
تهانينا! إذا سارت الأمور على ما يرام، من المفترض أن يكون لديك موجه Postgres لتتمكن من تنفيذ الأوامر على قاعدة بياناتك.
الخطوات التالية
اطّلع على بعض هذه الدروس التطبيقية حول الترميز...