التهيئة القياسية

يمكن تنفيذ إعداد BYOC الأولي باستخدام قالب CloudFormation ‏(AWS)، أو وحدة Terraform ‏(GCP)، أو وحدة Terraform ‏(Azure). ينشئ ذلك هوية بصلاحيات واسعة (دور IAM/حساب خدمة/service principal)، مما يتيح لوحدات تحكم BYOC في ClickHouse Cloud إدارة بنيتك التحتية.

وحدة Terraform لـ AWS

إذا كنت تفضل استخدام Terraform بدلًا من CloudFormation لعمليات النشر على AWS، فاستخدم وحدة terraform-byoc-onboarding:

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

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

تُنتج الوحدة clickhouse_management_role_arn. في المسار القياسي، لا يلزمك اتخاذ أي إجراء بشأنه — إذ تستمر عملية الإعداد في واجهة ClickHouse Cloud — لكن احتفظ به في متناول اليد، إذ سيطلبه ClickHouse إذا كان إعدادك يختلف عن الإعدادات الافتراضية (مثل اسم دور مخصص ومنسق).

المعرّف الخارجي لـ AWS

في AWS، يثق دور IAM الذي يُنشأ أثناء الإعداد بـ ClickHouse Cloud باستخدام معرّف خارجي (sts:ExternalId) للحماية من هجمات «النائب الملتبس». تنشئ واجهة ClickHouse Cloud معرّفًا خارجيًا لحساب AWS الخاص بك عند بدء عملية الإعداد، وتملؤه مسبقًا في رابط CloudFormation؛ وإذا كنت تستخدم Terraform، فمرّر القيمة نفسها باعتبارها external_id. تشترك جميع البنى التحتية لـ BYOC ضمن حساب AWS نفسه في المعرّف الخارجي ذاته.

سيُطلب منك إعداد البنية التحتية من وحدة تحكم ClickHouse Cloud، بما في ذلك حاويات تخزين الكائنات وVPC/VNet وعنقود Kubernetes. يجب تحديد بعض الإعدادات في هذه المرحلة، إذ لا يمكن تغييرها لاحقًا. وتشمل تحديدًا ما يلي:

• المنطقة: تتوفر جميع المناطق العامة المدرجة في وثائق المناطق المدعومة لعمليات نشر BYOC. ولا تُدعم المناطق الخاصة حاليًا.

• نطاق CIDR لـ VPC/VNet: نستخدم افتراضيًا 10.0.0.0/16 كنطاق CIDR لـ VPC الخاص بـ BYOC (في AWS/GCP) أو VNet (في Azure). إذا كنت تخطط لاستخدام VPC/VNet peering مع حساب آخر، فتأكد من عدم تداخل نطاقات CIDR. يختلف الحد الأدنى للحجم حسب السحابة:

  • AWS: /23
  • Azure: /23
  • GCP: /20

  هذه حدود دنيا وليست توصيات: تستهلك كل نسخة متماثلة عناوين IP، لذا تتطلب عمليات النشر الأكبر نطاقًا أكبر.

• مناطق التوافر: إذا كنت تخطط لاستخدام VPC peering، فقد تساعد محاذاة مناطق التوافر بين الحساب المصدر وحساب BYOC على خفض تكاليف حركة المرور بين مناطق التوافر. على سبيل المثال، في AWS، قد تمثل لاحقات مناطق التوافر (a وb وc) معرّفات لمناطق فعلية مختلفة بين الحسابات. راجع دليل AWS لمزيد من التفاصيل.

التحقق المسبق

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

تؤكد عمليات التحقق ما يلي:

• الأذونات — تمتلك هوية الإدارة (دور IAM / حساب خدمة / service principal) الأذونات التي يحتاجها ClickHouse Cloud لتوفير عملية النشر وتشغيلها.
• الخدمات المفعّلة (GCP) — واجهات برمجة تطبيقات Google Cloud المطلوبة (Compute Engine وKubernetes Engine وCloud Storage وNetwork Connectivity وIAM) مفعّلة في مشروعك.
• الشبكة (AWS مع استخدام VPC الخاص بك) — يفي VPC والشبكات الفرعية لديك بـمتطلبات الشبكة: أحجام الشبكات الفرعية، والعلامات المطلوبة، والتوزيع عبر مناطق التوافر، والاتصال الصادر، وعناوين IP المتاحة.
• الحصص والضوابط (AWS) — يحتوي حسابك على حصص خدمة كافية (VPCs وNAT gateways وElastic IPs وعناقيد EKS ووحدات vCPU) ولا توجد سياسة organization ‏(SCP) تحظر إجراءً مطلوبًا.

عند فشل عمليات التحقق، يُدرج كل منها مع الإجراء المقابل له وسبب الفشل (على سبيل المثال، iam:CreateRole · explicitDeny). وسّع Show passed checks لمراجعة جميع العمليات التي نجحت.

لمعالجة حالات الفشل، أعد تشغيل أحدث stack من CloudFormation أو Terraform الخاص بـ ClickHouse — أو امنح الـ actions المُبلّغ عنها لهوية الإدارة (دور IAM / حساب خدمة / service principal) — ثم اختر أحد الخيارين التاليين:

• إعادة التحقق — يعيد تشغيل فحوصات ما قبل التنفيذ. استخدم هذا بعد إصلاح المشكلات المُبلّغ عنها للتأكد من جاهزية إعدادك قبل التوفير.
• المتابعة رغم ذلك — يواصل التوفير رغم فشل الفحوصات. استخدم هذا فقط إذا كنت واثقًا من أن الفشل المُبلّغ عنه إنذار كاذب؛ وإلا فمن المرجح أن يفشل التوفير في منتصف العملية.

استخدم الجدول أدناه لمعالجة حالات الفشل الشائعة.