إعداد AWS المخصّص - ClickHouse Documentation

VPC مُدار من قِبل العميل (BYO-VPC) لـ AWS

إذا كنت تفضّل استخدام VPC حاليًا لنشر ClickHouse BYOC بدلًا من أن يوفّر ClickHouse Cloud شبكة VPC جديدة، فاتبع الخطوات أدناه. يوفّر هذا النهج قدرًا أكبر من التحكم في إعدادات الشبكة، ويتيح لك دمج ClickHouse BYOC في البنية التحتية الشبكية الحالية لديك.

قم بتهيئة شبكة VPC الحالية لديك

أضِف الوسم clickhouse-byoc="true" إلى VPC.
خصّص ما لا يقل عن 3 شبكات فرعية خاصة موزعة على 3 مناطق توافر مختلفة لتستخدمها ClickHouse Cloud.
تأكد من أن كل شبكة فرعية تحتوي على نطاق CIDR لا يقل عن /23 (على سبيل المثال، 10.0.0.0/23) لتوفير عدد كافٍ من عناوين IP لنشر ClickHouse.
أضِف الوسمين kubernetes.io/role/internal-elb=1 وclickhouse-byoc="true" إلى كل شبكة فرعية لتمكين التهيئة الصحيحة لموازن التحميل.

قم بتهيئة S3 Gateway Endpoint

إذا لم تكن VPC لديك تحتوي بالفعل على S3 Gateway Endpoint مُهيأة، فستحتاج إلى إنشاء واحدة لتمكين اتصال آمن وخاص بين VPC وAmazon S3. تتيح نقطة النهاية هذه لخدمات ClickHouse الوصول إلى S3 من دون المرور عبر الإنترنت العام. يُرجى الرجوع إلى لقطة الشاشة أدناه للاطلاع على مثال على التهيئة.

تأكد من توفر اتصال الشبكة

وصول الإنترنت الصادر يجب أن تسمح VPC لديك، كحد أدنى، بوصول الإنترنت الصادر حتى تتمكن مكونات ClickHouse BYOC من التواصل مع طبقة التحكم الخاصة بـ Tailscale. يُستخدم Tailscale لتوفير شبكة آمنة قائمة على مبدأ انعدام الثقة لعمليات الإدارة الخاصة. يتطلب التسجيل والإعداد الأوليان باستخدام Tailscale اتصالاً بالإنترنت العام، ويمكن تحقيق ذلك إما مباشرة أو عبر NAT gateway. هذا الاتصال ضروري للحفاظ على خصوصية نشر BYOC لديك وأمانه.حلّ أسماء DNS تأكد من أن VPC لديك توفّر حلّ أسماء DNS بشكل سليم، وألا تحظر أسماء DNS القياسية أو تتداخل معها أو تستبدلها. يعتمد ClickHouse BYOC على DNS لحلّ أسماء خوادم التحكم الخاصة بـ Tailscale ونقاط نهاية الخدمة الخاصة بـ ClickHouse. إذا لم يكن DNS متاحًا أو كان مُهيأً بشكل غير صحيح، فقد تفشل خدمات BYOC في الاتصال أو العمل بشكل صحيح.

قم بتهيئة حساب AWS الخاص بك

ينشئ إعداد BYOC الأولي دور IAM ذا امتيازات (ClickHouseManagementRole) يتيح لوحدات التحكم الخاصة بـ BYOC من ClickHouse Cloud إدارة بنيتك التحتية. ويمكن تنفيذ ذلك باستخدام قالب CloudFormation أو وحدة Terraform.عند النشر لإعداد BYO-VPC، اضبط المعلمة IncludeVPCWritePermissions على false لضمان عدم منح ClickHouse Cloud أذونات لتعديل VPC التي يديرها العميل.

حاويات التخزين وعنقود Kubernetes وموارد الحوسبة المطلوبة لتشغيل ClickHouse ليست مضمنة في هذا الإعداد الأولي. سيتم توفيرها في خطوة لاحقة. وعلى الرغم من أنك تتحكم في VPC الخاصة بك، لا تزال ClickHouse Cloud بحاجة إلى أذونات IAM لإنشاء عنقود Kubernetes وإدارته، وأدوار IAM لحسابات الخدمة، وS3 buckets، وغيرها من الموارد الأساسية في حساب AWS الخاص بك.

بديل وحدة Terraform

إذا كنت تفضل استخدام Terraform بدلاً من CloudFormation، فاستخدم الوحدة التالية:

module "clickhouse_onboarding" {
  source                     = "https://s3.us-east-2.amazonaws.com/clickhouse-public-resources.clickhouse.cloud/tf/byoc.tar.gz"
  byoc_env                   = "production"
  include_vpc_write_permissions = false
}

قم بإعداد البنية التحتية لـ BYOC

في ClickHouse Cloud console، قم بتهيئة ما يلي عند إعداد بنية تحتية جديدة:

ضمن تهيئة VPC، اختر استخدام شبكة VPC الحالية.
أدخل VPC ID الخاص بك (على سبيل المثال، vpc-0bb751a5b888ad123).
أدخل معرّفات الشبكات الفرعية الخاصة للشبكات الفرعية الثلاث التي قمت بتهيئتها سابقًا.
اختياريًا، أدخل معرّفات الشبكات الفرعية العامة إذا كان إعدادك يتطلب موازنات تحميل متاحة للعامة.
انقر فوق إعداد البنية التحتية لبدء التوفير.

قد يستغرق إعداد منطقة جديدة ما يصل إلى 40 دقيقة.

أدوار IAM المُدارة من قِبل العميل

بالنسبة إلى المؤسسات ذات متطلبات الأمان المتقدمة أو سياسات الامتثال الصارمة، يمكنك توفير أدوار IAM الخاصة بك بدلًا من أن ينشئها ClickHouse Cloud. يتيح لك هذا النهج تحكمًا كاملًا في أذونات IAM، كما يسمح لك بفرض سياسات الأمان الخاصة بمؤسستك.

أدوار IAM المُدارة من قِبل العميل متاحة حاليًا في معاينة خاصة. تواصل مع ClickHouse Support لتمكين هذه الإمكانية لمؤسستك قبل اتباع الخطوات أدناه.

باستخدام أدوار IAM المُدارة من قِبل العميل، يمكنك:

إنشاء أدوار IAM الخاصة بكل بنية تحتية مسبقًا، وهي الأدوار التي كان ClickHouse Cloud سينشئها لولا ذلك
إزالة أذونات الكتابة على IAM من ClickHouseManagementRole المستخدم للوصول عبر الحسابات
الحفاظ على تحكم كامل في أذونات الأدوار وعلاقات الثقة

تهيئة دور الإدارة بدون أذونات الكتابة على IAM

عند تنفيذ إعداد BYOC الأولي، عطّل أذونات الكتابة على IAM في دور الإدارة. عند استخدام قالب CloudFormation، اضبط المعلَمة IncludeIAMWritePermissions على false. وعند استخدام وحدة Terraform:

module "clickhouse_onboarding" {
  source                        = "github.com/ClickHouse/terraform-byoc-onboarding.git//modules/aws?ref=<version>"
  external_id                   = "<external-id-provided-by-clickhouse>"
  include_iam_write_permissions = false
}

استبدل <version> بأحدث وسم من صفحة الإصدارات الخاصة بالوحدة — واستخدم دائمًا أحدث إصدار.

أنشئ أدوار IAM الخاصة بكل بنية تحتية

قبل تجهيز كل بنية تحتية من BYOC، أنشئ أدوار IAM المطلوبة لها (أدوار هوية كبسولات EKS، ودور وصول ClickHouse إلى S3، ودور إدارة مستوى البيانات) باستخدام وحدة البنية التحتية الفردية من terraform-byoc-onboarding:

module "clickhouse_per_infra_iam" {
  source = "github.com/ClickHouse/terraform-byoc-onboarding.git//modules/aws-per-infra-iam?ref=<version>"

  spoken_name = "<spoken-name-provided-by-clickhouse>"
  region      = "<aws-region-of-the-infrastructure>"
  external_id = "<external-id-provided-by-clickhouse>"
}

استبدل <version> بأحدث وسم من صفحة الإصدارات الخاصة بالوحدة — واستخدم دائمًا أحدث إصدار.

حافظ على تحديث الأدوار الخاصة بكل بنية تحتية

يضيف ClickHouse بشكل دوري أدوارًا وأذونات تتطلبها إمكانيات جديدة في المنصة. عندما يُبلغك ClickHouse بوجود تحديث، أعد تطبيق وحدة البنية التحتية الفردية باستخدام أحدث إصدار — إذ إن تشغيل إصدار قديم قد يؤدي إلى فشل تجهيز البنية التحتية الخاصة بك في BYOC وترقيتها.

للاطلاع على معلومات حول أدوار IAM التي ينشئها ClickHouse Cloud افتراضيًا، راجع مرجع امتيازات BYOC.

​VPC مُدار من قِبل العميل (BYO-VPC) لـ AWS

​بديل وحدة Terraform

​أدوار IAM المُدارة من قِبل العميل

VPC مُدار من قِبل العميل (BYO-VPC) لـ AWS

بديل وحدة Terraform

أدوار IAM المُدارة من قِبل العميل