Skip to main content
يمكنك استخدام AWS PrivateLink لإنشاء اتصال آمن بين شبكات VPC، وخدمات AWS، وأنظمتك داخل بيئتك المحلية، وClickHouse Cloud، من دون تعريض حركة المرور إلى الإنترنت العام. توضح هذه الوثيقة وظيفة نقطة النهاية الخاصة العكسية في ClickPipes، التي تتيح إعداد نقطة نهاية VPC لـ AWS PrivateLink.

​
مصادر بيانات ClickPipes المدعومة

تقتصر ميزة نقطة نهاية خاصة عكسية في ClickPipes على أنواع مصادر البيانات التالية:
  • Kafka
  • Postgres
  • MySQL
  • MongoDB
بالنسبة إلى Kafka، يمكن الوصول إلى سجل المخططات عبر نقطة النهاية الخاصة العكسية نفسها التي تستخدمها الوسطاء — ولا يلزم أن يكون متاحًا عبر الإنترنت العام — شريطة أن يُحل اسم المضيف الخاص به إلى عناوين IP الخاصة بنقطة النهاية.
يمكن تهيئة نقطة نهاية خاصة عكسية في ClickPipes باستخدام أحد خيارات AWS PrivateLink التالية:

​
مورد VPC

الاتصال بين المناطق غير مدعوم.
يمكن الوصول إلى موارد VPC الخاصة بك في ClickPipes باستخدام PrivateLink. ولا يتطلب هذا الأسلوب إعداد موازن حمل أمام مصدر البيانات. يمكن أن تستهدف تهيئة المورد مضيفًا محددًا أو ARN لعنقود RDS. وهو الخيار المفضل لـ Postgres CDC عند استيعاب البيانات من عنقود RDS. لإعداد PrivateLink مع مورد VPC:
  1. أنشئ بوابة مورد
  2. أنشئ تهيئة مورد
  3. أنشئ مشاركة مورد
1

إنشاء بوابة موارد

بوابة الموارد هي النقطة التي تستقبل حركة المرور للموارد المحددة داخل VPC لديك.
يُوصى بأن تتوفر في الشبكات الفرعية المرتبطة ببوابة الموارد لديك عناوين IP كافية. كما يُوصى بأن يكون قناع الشبكة الفرعية لكل شبكة فرعية /26 على الأقل.لكل نقطة نهاية VPC (لكل Reverse Private Endpoint)، تتطلب AWS كتلة متتالية من 16 عنوان IP لكل شبكة فرعية. (قناع شبكة فرعية /28) إذا لم يتم استيفاء هذا الشرط، فسوف ينتقل Reverse Private Endpoint إلى حالة فشل.
يمكنك إنشاء بوابة موارد من وحدة تحكم AWS أو باستخدام الأمر التالي:
سيشمل الناتج معرّفًا لـ resource gateway، وستحتاج إليه في الخطوة التالية.قبل أن تتمكن من المتابعة، ستحتاج إلى الانتظار حتى تدخل resource gateway في الحالة Active. يمكنك التحقق من الحالة بتشغيل الأمر التالي:
2

إنشاء Resource-Configuration لمورد VPC

يتم ربط Resource-Configuration ببوابة المورد لإتاحة الوصول إلى موردك.يمكنك إنشاء Resource-Configuration من وحدة تحكم AWS أو باستخدام الأمر التالي:
أبسط نوع من أنواع تهيئة المورد هو Resource-Configuration واحدة. يمكنك التهيئة باستخدام ARN مباشرةً، أو مشاركة عنوان IP أو اسم نطاق يمكن حله علنًا.على سبيل المثال، للتهيئة باستخدام ARN لعنقود RDS:
لا يمكنك إنشاء تهيئة مورد لعنقود متاح للوصول العام. إذا كان عنقودك متاحًا للوصول العام، فيجب تعديل العنقود ليصبح خاصًا قبل إنشاء تهيئة المورد أو استخدام قائمة السماح لعناوين IP بدلًا من ذلك. لمزيد من المعلومات، راجع وثائق AWS.
سيحتوي الناتج على ARN لتهيئة المورد، وستحتاج إليه في الخطوة التالية. وسيحتوي أيضًا على معرّف تهيئة المورد، والذي ستحتاج إليه لإعداد اتصال ClickPipe باستخدام مورد VPC.
3

إنشاء Resource-Share

لمشاركة المورد الخاص بك، يلزم إنشاء Resource-Share. ويتم ذلك من خلال Resource Access Manager (RAM).
لا يمكن استخدام Resource-Share إلا مع Reverse Private Endpoint واحد، ولا يمكن إعادة استخدامه. إذا كنت بحاجة إلى استخدام Resource-Configuration نفسه مع عدة Reverse Private Endpoints، فيجب إنشاء Resource-Share منفصل لكل endpoint. يظل Resource-Share موجودًا في AWS account الخاص بك بعد حذف Reverse Private Endpoint، ويجب إزالته يدويًا إذا لم تعد بحاجة إليه.
يمكنك إضافة Resource-Configuration إلى Resource-Share عبر AWS console أو بتشغيل الأمر التالي باستخدام ClickPipes account ID 072088201116 (arn:aws:iam::072088201116:root):
سيحتوي الناتج على ARN لمشاركة المورد، وستحتاج إليه لإعداد اتصال ClickPipe باستخدام VPC resource.أنت الآن جاهز لإنشاء ClickPipe باستخدام Reverse private endpoint مع VPC resource. ستحتاج إلى ما يلي:
  • تعيين VPC endpoint type إلى VPC Resource.
  • تعيين Resource configuration ID إلى معرّف Resource-Configuration الذي تم إنشاؤه في الخطوة 2.
  • تعيين Resource share ARN إلى ARN الخاص بـ Resource-Share الذي تم إنشاؤه في الخطوة 3.
لمزيد من التفاصيل حول PrivateLink مع VPC resource، راجع وثائق AWS.

​
MSK multi-VPC connectivity

تُعد Multi-VPC connectivity ميزة مضمّنة في AWS MSK تتيح لك ربط عدة شبكات VPC بعنقود MSK واحد. يتوفر دعم private DNS افتراضيًا ولا يتطلب أي إعداد إضافي. لا يتم دعم الاتصال عبر المناطق. يُوصى بهذا الخيار مع ClickPipes for MSK. راجع دليل بدء الاستخدام لمزيد من التفاصيل.
حدّث سياسة عنقود MSK لديك، وأضف 072088201116 إلى الكيانات المسموح لها بالوصول إلى عنقود MSK. راجع دليل AWS حول إرفاق سياسة عنقود لمزيد من التفاصيل.
اتبع دليل إعداد MSK لـ ClickPipes لمعرفة كيفية إعداد الاتصال.

​
VPC endpoint service

تُعد VPC endpoint service طريقةً أخرى لمشاركة مصدر البيانات لديك مع ClickPipes. ويتطلب ذلك إعداد NLB ‏(Network Load Balancer) أمام مصدر البيانات لديك وتهيئة VPC endpoint service لاستخدام NLB. يمكن تهيئة VPC endpoint service باستخدام private DNS، بحيث تكون متاحة داخل VPC الخاصة بـ ClickPipes. لا يكون private DNS المُدار من AWS PrivateLink خيارًا مناسبًا دائمًا:
  • أنت لا تملك domain name الخاص بمصدر البيانات لديك، لذلك لا يمكنك التحقق منه عبر AWS
  • يتطلب المزوّد من المستهلكين إدارة DNS resolution، كما تفعل Confluent Cloud في هذه الحالات، راجع DNS خاص مخصص.
It’s a preferred choice for: راجع دليل البدء لمزيد من التفاصيل.
أضِف معرّف حساب ClickPipes ‏072088201116 إلى الجهات المسموح لها في VPC endpoint service الخاصة بك. راجع دليل AWS بشأن إدارة الأذونات لمزيد من التفاصيل.
الوصول عبر المناطق يمكن تهيئته لـ ClickPipes. أضِف منطقة ClickPipe الخاصة بك إلى المناطق المسموح بها في VPC endpoint service الخاصة بك.
بالنسبة إلى عناقيد MSK، راجع AWS PrivateLink VPC endpoint service for MSK cluster للاطلاع على إعداد broker لكل endpoint service يستخدم أسماء DNS خاصة مخصصة.

​
DNS خاص مخصص

ميزة DNS خاص مخصص ما تزال في Private Preview. تواصل مع فريق دعم ClickHouse لتمكينها لخدمتك.
يوفّر AWS PrivateLink private DNS مُدارًا لخدمات VPC endpoint service ذات النطاق الذي تم التحقق منه. وتتطلب بعض الخدمات من كل مستهلك إدارة DNS resolution داخل VPC الخاصة به؛ فعلى سبيل المثال، تتطلب Confluent Cloud من المستهلكين حل أسماء مضيفي broker إلى PrivateLink endpoint. في هذه الحالات، يدعم ClickPipes إرفاق أسماء DNS خاص مخصص بـ نقطة نهاية خاصة عكسية. ويقوم ClickPipes بحل هذه الأسماء إلى العناوين الخاصة بـ endpoint، بحيث يمكن الوصول إلى مصدر البيانات لديك باستخدام اسم المضيف الخاص به عبر اتصال خاص. يُكمل DNS خاص مخصص private DNS المُدار — ولا يحل محله. وإذا كانت خدمة PrivateLink لديك توفّر بالفعل أسماء private DNS، فلست بحاجة إلى أسماء مخصصة. تتوفّر أسماء DNS خاص مخصص لنوعي endpoint VPC endpoint service وVPC resource. ويوفّر MSK multi-VPC private DNS مُدارًا بشكل افتراضي، ولا يدعم الأسماء المخصصة.
تدعم وحدة تحكم ClickHouse Cloud حاليًا اسم DNS خاص مخصص واحدًا لكل نقطة نهاية خاصة عكسية. إذا كنت بحاجة إلى إدارة عدة أسماء DNS خاص مخصص على نقطة النهاية نفسها، فاستخدم OpenAPI أو Terraform.
تنطبق القواعد التالية على أسماء DNS خاص مخصص:
  • الأسماء المطابقة تمامًا (kafka.internal.example.com) وأسماء wildcard (*.example.com) مدعومة. ويطابق wildcard تسمية DNS واحدة — على سبيل المثال، *.abcde12345.us-east-1.aws.confluent.cloud يطابق b0-lkc123.abcde12345.us-east-1.aws.confluent.cloud.
  • يجب أن تكون الأسماء فريدة على مستوى جميع نقاط نهاية خاصة عكسية التابعة لخدمة ClickHouse، بما في ذلك حالات التداخل بين أسماء wildcard والأسماء المطابقة تمامًا.
  • تُرفض الأسماء الواقعة ضمن اللاحقات المحجوزة (مثل local وlocalhost وinternal وcorp وprivate).
لتهيئة أسماء DNS خاص مخصص:
  • في وحدة تحكم ClickHouse Cloud، املأ الحقل Custom private DNS name عند إنشاء نقطة نهاية خاصة عكسية. يظهر هذا الحقل بمجرد تمكين الميزة لخدمتك.
  • باستخدام OpenAPI، عيّن customPrivateDnsMappings عند إنشاء نقطة نهاية خاصة عكسية، أو حدّث endpoint موجودًا باستخدام طلب PATCH. تستبدل التحديثات القائمة الكاملة لعمليات الربط؛ وتؤدي القائمة الفارغة إلى إزالة جميع الأسماء المخصصة.
  • باستخدام Terraform، استخدم المورد clickhouse_clickpipes_reverse_private_endpoint_custom_private_dns لإدارة عمليات الربط على نقطة نهاية خاصة عكسية موجودة.

​
إنشاء ClickPipe باستخدام نقطة نهاية خاصة عكسية

  1. افتح SQL Console الخاصة بخدمة ClickHouse Cloud.
  1. حدِّد زر Data Sources من القائمة الجانبية اليسرى، ثم انقر على “Set up a ClickPipe”
  1. حدِّد Kafka أو Postgres كمصدر بيانات.
  1. حدِّد خيار Reverse private endpoint.
  1. حدِّد أيًّا من نقاط نهاية خاصة عكسية الموجودة، أو أنشئ واحدة جديدة.
إذا كان الوصول عبر مناطق متعددة مطلوبًا لـ RDS، فستحتاج إلى إنشاء VPC endpoint service، ويفترض أن يوفّر هذا الدليل نقطة انطلاق جيدة لإعداده.أما للوصول ضمن المنطقة نفسها، فإن إنشاء مورد VPC هو النهج الموصى به.
  1. أدخِل Required parameters لنوع endpoint المحدد.
  • بالنسبة إلى مورد VPC، أدخِل configuration share ARN وconfiguration ID.
    • بالنسبة إلى MSK multi-VPC، أدخِل cluster ARN وauthentication method المستخدمة مع endpoint التي تم إنشاؤها.
    • بالنسبة إلى VPC endpoint service، أدخِل service name.
    • اختياريًا، أدخِل اسم DNS خاص مخصص.
  1. انقر على Create وانتظر حتى تصبح نقطة نهاية خاصة عكسية جاهزة. إذا كنت تنشئ endpoint جديدة، فسيستغرق إعدادها بعض الوقت. ستُحدَّث الصفحة تلقائيًا بمجرد أن تصبح endpoint جاهزة. قد يتطلب VPC endpoint service قبول connection request في AWS console الخاصة بك.
  1. بمجرد أن تصبح endpoint جاهزة، يمكنك استخدام DNS name للاتصال بمصدر البيانات. في قائمة endpoints، يمكنك رؤية DNS name الخاصة بـ endpoint المتاحة. وقد تكون هذه DNS name اسم DNS وفّرته ClickPipes داخليًا، أو private DNS name مقدَّمًا من خدمة PrivateLink، أو اسم DNS خاص مخصص. لا تُعد DNS name عنوان شبكة كاملًا. أضِف Port وفقًا لمصدر البيانات. يمكن الوصول إلى MSK connection string من AWS console. للاطلاع على القائمة الكاملة لأسماء DNS، انتقل إليها من إعدادات cloud service.

​
إدارة نقاط نهاية خاصة عكسية الحالية

يمكنك إدارة نقاط نهاية خاصة عكسية الحالية في إعدادات خدمة ClickHouse Cloud:
  1. في الشريط الجانبي، ابحث عن زر Settings وانقر عليه.
  2. انقر على Reverse private endpoints في قسم ClickPipe reverse private endpoints. تُعرض المعلومات التفصيلية الخاصة بنقطة نهاية خاصة عكسية في اللوحة المنبثقة. يمكن إزالة نقطة النهاية من هنا. سيؤثر ذلك على أي ClickPipes تستخدم نقطة النهاية هذه.
يقتصر دعم AWS PrivateLink في ClickPipes على مناطق AWS محددة. يرجى الرجوع إلى قائمة مناطق ClickPipes للاطّلاع على المناطق المتاحة. لا ينطبق هذا القيد على VPC endpoint service عند تفعيل الاتصال عبر المناطق.

​
القيود

لا يوجد ما يضمن أن نقاط نهاية AWS PrivateLink الخاصة بـ ClickPipes التي يتم إنشاؤها في ClickHouse Cloud ستُنشأ في منطقة AWS نفسها التي توجد فيها خدمة ClickHouse Cloud. حاليًا، خدمة VPC endpoint service وحدها هي التي تدعم الاتصال عبر المناطق. ترتبط نقاط النهاية الخاصة بخدمة ClickHouse محددة، ولا يمكن نقلها بين الخدمات. ويمكن لعدة ClickPipes ضمن خدمة ClickHouse واحدة إعادة استخدام نقطة النهاية نفسها. يدعم AWS MSK نقطة PrivateLink (VPC endpoint) واحدة فقط لكل عنقود MSK ولكل نوع authentication ‏(SASL_IAM أو SASL_SCRAM). ونتيجة لذلك، لا يمكن لعدة خدمات ClickHouse Cloud أو مؤسسات إنشاء اتصالات PrivateLink منفصلة إلى عنقود MSK نفسه باستخدام نوع authentication نفسه.

​
التنظيف التلقائي لنقاط النهاية غير النشطة

تُزال نقاط النهاية الخاصة العكسية التي تبقى في حالة نهائية تلقائيًا بعد فترة سماح محددة. وهذا يضمن عدم بقاء نقاط النهاية غير المستخدمة أو المُعدّة بشكل غير صحيح إلى أجل غير مسمى. تُطبَّق فترات السماح التالية بحسب حالة نقطة النهاية: بمجرد انتهاء فترة السماح، تُحذف نقطة النهاية وجميع الموارد المرتبطة بها تلقائيًا. لمنع الإزالة التلقائية، عالِج المشكلة الأساسية قبل انتهاء فترة السماح. على سبيل المثال، وافق على طلب اتصال معلّق في AWS Console، أو أعد إنشاء نقطة النهاية إذا دخلت في حالة فشل.
آخر تعديل في ٢٤ يوليو ٢٠٢٦