الوصول من Looker PSC إلى Cloud SQL PSC

1. مقدمة

ملاحظة: يتيح Looker استخدام Southbound Producers في أي منطقة. للوصول إلى Looker من الشمال، يجب أن تكون نقطة النهاية أو الخلفية الخاصة بالمستهلك في المنطقة نفسها التي تتوفّر فيها نسخة Looker PSC.

في هذا الدرس التطبيقي حول الترميز، ستجري اتصالاً من الجنوب إلى الشمال بخدمة Cloud SQL التي تم نشرها باستخدام Private Service Connect كمقدّم خدمة.

‫Private Service Connect هي إحدى إمكانات شبكة Google Cloud التي تتيح للمستهلكين الوصول إلى الخدمات المُدارة بشكل خاص من داخل شبكة السحابة الإلكترونية الخاصة الافتراضية (VPC). وبالمثل، يتيح هذا الخيار لمقدّمي الخدمات المُدارة استضافة هذه الخدمات في شبكات VPC منفصلة وتقديم اتصال خاص للمستهلكين. على سبيل المثال، عند استخدام Private Service Connect للوصول إلى Looker، تكون أنت مستهلك الخدمة، وتكون Google هي منتج الخدمة، كما هو موضّح في الشكل 1.

تتيح إمكانية الوصول الصادرة، المعروفة أيضًا باسم PSC العكسي، للمستهلك إنشاء خدمة منشورة بصفتها منتِجًا للسماح لـ Looker بالوصول إلى نقاط النهاية المحلية وفي شبكة VPC وإلى الخدمات المُدارة والإنترنت. يمكن نشر عمليات الربط المتجهة إلى الجنوب في أي منطقة، بغض النظر عن مكان نشر Looker PSC، كما هو موضّح في الشكل 2.

ما ستتعلمه

• إنشاء خدمة منتِج مثيل Cloud SQL باستخدام Private Service Connect
• إنشاء نقطة نهاية Private Service Connect في Looker كمستهلك خدمة

المتطلبات

• مشروع Google Cloud لديه أذونات المالك
• مثيل Looker PSC الحالي

2. ما ستنشئه

ستنشئ مثيلاً من Cloud SQL PSC تم نشره كمقدّم خدمة مرتبط بخدمة Looker PSC كمستهلك خدمة.

تؤكّد الإجراءات التالية إمكانية الوصول إلى خدمة Producer:

• إنشاء نقطة نهاية Private Service Connect في Looker مرتبطة بمرفق خدمة المنتج
• استخدِم Looker Console لإنشاء اتصال قاعدة بيانات بخدمة Cloud SQL PSC
• اختبار إمكانية الاتصال بـ Cloud SQL PSC من خلال المصادقة والوصول إلى مخطط محدّد مسبقًا

3- بنية الدرس التطبيقي حول الترميز

4. الإعداد والمتطلبات

إعداد البيئة بالسرعة التي تناسبك

1. سجِّل الدخول إلى Google Cloud Console وأنشِئ مشروعًا جديدًا أو أعِد استخدام مشروع حالي. إذا لم يكن لديك حساب على Gmail أو Google Workspace، عليك إنشاء حساب.

• اسم المشروع هو الاسم المعروض للمشاركين في هذا المشروع. وهي سلسلة أحرف لا تستخدمها Google APIs. ويمكنك تعديلها في أي وقت.
• رقم تعريف المشروع هو معرّف فريد في جميع مشاريع Google Cloud ولا يمكن تغييره (لا يمكن تغييره بعد ضبطه). تنشئ Cloud Console سلسلة فريدة تلقائيًا، ولا يهمّك عادةً ما هي. في معظم دروس البرمجة، عليك الرجوع إلى رقم تعريف مشروعك (يُشار إليه عادةً باسم PROJECT_ID). إذا لم يعجبك رقم التعريف الذي تم إنشاؤه، يمكنك إنشاء رقم آخر عشوائي. يمكنك بدلاً من ذلك تجربة اسم مستخدم من اختيارك ومعرفة ما إذا كان متاحًا. لا يمكن تغيير هذا الخيار بعد هذه الخطوة ويظل ساريًا طوال مدة المشروع.
• للعلم، هناك قيمة ثالثة، وهي رقم المشروع، وتستخدمها بعض واجهات برمجة التطبيقات. يمكنك الاطّلاع على مزيد من المعلومات حول هذه القيم الثلاث في المستندات.

ملاحظة: رقم تعريف المشروع فريد على مستوى العالم ولا يمكن لأي شخص آخر استخدامه بعد اختياره. أنت المستخدم الوحيد لهذا المعرّف. حتى إذا تم حذف مشروع، لا يمكن استخدام المعرّف مرة أخرى.

ملاحظة: إذا كنت تستخدم حساب Gmail، يمكنك ترك الموقع الجغرافي التلقائي مضبوطًا على لا توجد مؤسسة. إذا كنت تستخدم حسابًا على Google Workspace، اختَر موقعًا جغرافيًا مناسبًا لمؤسستك.

2. بعد ذلك، عليك تفعيل الفوترة في Cloud Console لاستخدام موارد/واجهات برمجة تطبيقات Cloud. لن تكلفك تجربة هذا الدرس البرمجي الكثير، إن وُجدت أي تكلفة. لإيقاف الموارد وتجنُّب تحمّل تكاليف فوترة تتجاوز هذا البرنامج التعليمي، يمكنك حذف الموارد التي أنشأتها أو حذف المشروع. يمكن لمستخدمي Google Cloud الجدد الاستفادة من برنامج الفترة التجريبية المجانية بقيمة 300 دولار أمريكي.

بدء Cloud Shell

على الرغم من إمكانية تشغيل Google Cloud عن بُعد من الكمبيوتر المحمول، ستستخدم في هذا الدرس التطبيقي حول الترميز Google Cloud Shell، وهي بيئة سطر أوامر تعمل في السحابة الإلكترونية.

من Google Cloud Console، انقر على رمز Cloud Shell في شريط الأدوات أعلى يسار الصفحة:

لن يستغرق توفير البيئة والاتصال بها سوى بضع لحظات. عند الانتهاء، من المفترض أن يظهر لك ما يلي:

يتم تحميل هذه الآلة الافتراضية مزوّدة بكل أدوات التطوير التي ستحتاج إليها. توفّر هذه الخدمة دليلًا منزليًا دائمًا بسعة 5 غيغابايت، وتعمل على Google Cloud، ما يؤدي إلى تحسين أداء الشبكة والمصادقة بشكل كبير. يمكن إكمال جميع المهام في هذا الدرس العملي ضمن المتصفّح. لست بحاجة إلى تثبيت أي تطبيق.

5- قبل البدء

تفعيل واجهات برمجة التطبيقات

داخل Cloud Shell، تأكَّد من إعداد رقم تعريف مشروعك:

gcloud config list project
gcloud config set project [YOUR-PROJECT-ID]
project=[YOUR-PROJECT-ID]
region=[YOUR-REGION]
echo $project
echo $region

فعِّل جميع الخدمات اللازمة:

gcloud services enable compute.googleapis.com

6. تحديد مشروع Looker PSC

يتطلّب إنشاء مثيل Cloud SQL PSC تحديد مشاريع PSC المسموح بها، لذا يجب توفير مشروع المستأجر Looker PSC عند إنشاء مثيل Cloud SQL أو تعديله في حال استخدام مثيل حالي.

تحديد مشروع Looker PSC باستخدام gcloud

داخل Cloud Shell، استبدِل [INSTANCE_NAME] باسم مثيل Looker PSC للحصول على رقم تعريف مشروع Looker PSC:

gcloud looker instances describe [INSTANCE_NAME] --region=$region --format=json | grep -i lookerServiceAttachmentUri

في المثال على الناتج، t7ec792caf2a609d1-tp هو مشروع Looker PSC:

gcloud looker instances describe looker-psc-instance --region=us-central1 --format=json | grep -i lookerServiceAttachmentUri
    "lookerServiceAttachmentUri": "projects/t7ec792caf2a609d1-tp/regions/us-central1/serviceAttachments/looker-psc-f51982e2-ac0d-48b1-91bb-88656971c183",

تحديد مشروع Looker PSC باستخدام Cloud Console

في Cloud Console، انتقِل إلى:

‫Looker → نسخة Looker PSC

7. إنشاء مثيل Cloud SQL خاص بموفّر الخدمة

في القسم التالي، ستنشئ مثيلاً لخدمة Cloud SQL Private Service Connect يُستخدم لأغراض الاختبار ويتم نشره باستخدام كلمة مرور محدّدة مسبقًا تحدّد مشروع Looker Private Service Connect في قائمة مشاريع Private Service Connect المسموح بها.

ملاحظة: تم تحديد كلمة مرور الجذر لمثيل Cloud SQL PSC مسبقًا على أنّها password123. يتم استخدام هذه الآلة الافتراضية لأغراض توضيحية.

إنشاء Cloud SQL PSC

في Cloud Shell، أنشئ جهازًا افتراضيًا وفعِّل Private Service Connect، ثمّ عدِّل [INSTANCE_PROJECT] باستخدام رقم تعريف مشروع Looker PSC.

gcloud sql instances create cloud-sql-psc-demo \
--project=$project \
--region=$region \
--enable-private-service-connect \
--allowed-psc-projects=[INSTANCE_PROJECT] \
--availability-type=regional \
--no-assign-ip \
--cpu=2 --memory=4GB \
--database-version=MYSQL_8_0 \
--enable-bin-log \
--root-password=password123

مثال:

gcloud sql instances create cloud-sql-psc-demo \
--project=$project \
--region=$region \
--enable-private-service-connect \
--allowed-psc-projects=t7ec792caf2a609d1-tp \
--availability-type=regional \
--no-assign-ip \
--cpu=2 --memory=4GB \
--database-version=MYSQL_8_0 \
--enable-bin-log \
--root-password=password123

الحصول على مرفق خدمة Cloud SQL

بعد إنشاء مثيل Cloud SQL مع تفعيل Private Service Connect، احصل على معرّف الموارد المنتظم (URI) لمرفق الخدمة المستخدَم في خطوة لاحقة لإنشاء نقطة نهاية Private Service Connect في Looker.

داخل Cloud Shell، اتّبِع الخطوات التالية:

gcloud sql instances describe [INSTANCE_NAME] --project=$project | grep -i pscServiceAttachmentLink

ينتج المثال التالي عنوان URI لمرفق الخدمة:

projects/o6222fa10e2a50865p-tp/regions/us-central1/serviceAttachments/a-39d809aaecae-psc-service-attachment-127fc34733744155

gcloud sql instances describe cloud-sql-psc-demo --project=$project | grep -i pscServiceAttachmentLink:
pscServiceAttachmentLink: projects/o6222fa10e2a50865p-tp/regions/us-central1/serviceAttachments/a-39d809aaecae-psc-service-attachment-127fc34733744155

يمكنك الحصول على "مرفق خدمة" Cloud SQL PSC من Cloud Console باتّباع الخطوات التالية:

في Cloud Console، انتقِل إلى:

SQL → مثيل SQL → عمليات الربط

8. إنشاء اتصال بنقطة نهاية PSC في Looker

في القسم التالي، ستربط Cloud SQL Producers Service Attachment بـ Looker Core PSC من خلال استخدام العلامات ‎–psc-service-attachment في Cloud Shell لنطاق واحد.

ملاحظة: في كل مرة تنفّذ فيها أمر تعديل باستخدام علامات ‎–psc-service-attachment، يجب تضمين كل اتصال تريد تفعيله، بما في ذلك الاتصالات التي تم تفعيلها سابقًا. يمكنك الرجوع إلى مستندات Looker PSC للاطّلاع على مثال.

ملاحظة: يجب تفعيل مثيل Looker PSC قبل المتابعة.

داخل Cloud Shell، أنشئ عملية ربط PSC من خلال تعديل المَعلمات التالية لتتطابق مع بيئتك:

• INSTANCE_NAME: اسم مثيل Looker (المنتج الأساسي من Google Cloud).
• DOMAIN_1: sql.database1.com
• SERVICE_ATTACHMENT_1: معرّف الموارد المنتظم (URI) الذي تم تسجيله عند وصف مثيل Cloud SQL PSC
• المنطقة: المنطقة التي تتم فيها استضافة نسخة Looker (المنتج الأساسي من Google Cloud)

داخل Cloud Shell، اتّبِع الخطوات التالية:

gcloud looker instances update INSTANCE_NAME \
--psc-service-attachment  domain=DOMAIN_1,attachment=SERVICE_ATTACHMENT_URI_1 \
--region=REGION

مثال:

gcloud looker instances update looker-psc-instance \
--psc-service-attachment  domain=sql.database1.com,attachment=projects/o6222fa10e2a50865p-tp/regions/us-central1/serviceAttachments/a-39d809aaecae-psc-service-attachment-127fc34733744155 \
--region=us-central1

داخل Cloud Shell، تحقَّق من أنّ قيمة serviceAttachments.connectionStatus هي "ACCEPTED". احرص على التعديل باستخدام اسم مثيل Looker PSC:

gcloud looker instances describe [INSTANCE_NAME] --region=$region --format=json

مثال:

gcloud looker instances describe looker-psc-instance --region=$region --format=json

مثال:

user@cloudshell$ gcloud looker instances describe looker-psc-instance --region=$region --format=json
{
  "adminSettings": {},
  "createTime": "2024-08-23T00:00:45.339063195Z",
  "customDomain": {
    "domain": "looker.cosmopup.com",
    "state": "AVAILABLE"
  },
  "encryptionConfig": {},
  "lookerVersion": "24.14.18",
  "name": "projects/project/locations/us-central1/instances/looker-psc-instance",
  "platformEdition": "LOOKER_CORE_ENTERPRISE_ANNUAL",
  "pscConfig": {
    "allowedVpcs": [
      "projects/project/global/networks/looker-psc-demo",
      "projects/project/global/networks/looker-shared-vpc"
    ],
    "lookerServiceAttachmentUri": "projects/t7ec792caf2a609d1-tp/regions/us-central1/serviceAttachments/looker-psc-f51982e2-ac0d-48b1-91bb-88656971c183",
    "serviceAttachments": [
      {
        "connectionStatus": "ACCEPTED",
        "localFqdn": "sql.database1.com",
        "targetServiceAttachmentUri": "projects/o6222fa10e2a50865p-tp/regions/us-central1/serviceAttachments/a-39d809aaecae-psc-service-attachment-127fc34733744155"
      }
    ]
  },
  "pscEnabled": true,
  "state": "ACTIVE",
  "updateTime": "2024-09-04T14:40:05.613026012Z"
}

التحقّق من صحة نقطة نهاية PSC في Cloud Console

يمكنك التحقّق من صحة اتصال PSC من Cloud Console

في Cloud Console، انتقِل إلى:

Looker → نسخة Looker → التفاصيل

9. دمج Looker PSC مع Cloud SQL PSC

في القسم التالي، ستستخدم Looker Console لإنشاء عملية ربط بقاعدة بيانات بمثيل Cloud SQL PSC.

انتقِل إلى ADMIN (المشرف) → DATABASE (قاعدة البيانات) → CONNECTIONS (عمليات الربط) → اختَر ADD CONNECTION (إضافة عملية ربط)

املأ تفاصيل الربط وفقًا للقطة الشاشة أدناه، ثم انقر على ربط.

• احرص على مطابقة حقل HOST في Looker Console مع النطاق الذي تم تقديمه سابقًا، sql.database1.com.
• يتطلّب الوضع التجريبي اسم المستخدم "root" وكلمة المرور "password123"

اكتمل إعداد عملية الربط

10. التحقّق من صحة اتصال Looker

في القسم التالي، ستتعرّف على كيفية التحقّق من صحة اتصال Looker بمثيل Cloud SQL PSC باستخدام إجراء "الاختبار" في Looker.

انتقِل إلى Data Connection ADMIN → DATABASE → CONNECTIONS → cloud-sql-psc-demo → Test

بعد اختيار "اختبار"، سيربط Looker بقاعدة بيانات postgres كما هو موضّح أدناه:

تَنظيم

حذف مكوّنات المختبر من نافذة Cloud Shell واحدة

gcloud sql instances delete cloud-sql-psc-demo -q

11. تهانينا

تهانينا، لقد نجحت في ضبط الاتصال بخدمة Cloud SQL PSC والتحقّق منه باستخدام Looker Console المستند إلى Private Service Connect.

لقد أنشأت مثيلات Cloud SQL PSC كخدمة منتِجة ونقطة نهاية Looker PSC التي أتاحت الاتصال بالخدمة المنتِجة.

تعتقد Cosmopup أنّ الدروس التطبيقية حول الترميز رائعة!!

ما هي الخطوات التالية؟

اطّلِع على بعض دروس الترميز التطبيقية هذه...

• استخدام Private Service Connect لنشر الخدمات واستهلاكها
• الاتصال بالخدمات المحلية عبر شبكة مختلطة باستخدام خدمة Private Service Connect وجهاز موازنة الحمل الداخلي الذي يستخدم وكيل TCP
• الوصول إلى جميع دروس Private Service Connect البرمجية المنشورة

مزيد من المعلومات والفيديوهات

• نظرة عامة على Private Service Connect

المستندات المرجعية

• الاتصال بمثيل باستخدام Private Service Connect | Cloud SQL for MySQL | Google Cloud
• gcloud sql instances create | مستندات Google Cloud CLI
• إنشاء مثيل Private Service Connect في Looker (خدمة Google Cloud الأساسية)
• كيفية نشر خدمة باستخدام Private Service Connect