التخزين ووحدات التخزين

يشرح هذا الدليل كيفية قيام المشغّل بتوفير التخزين الدائم لـ ClickHouseCluster: وحدة تخزين البيانات الأساسية، وإرفاق أقراص إضافية ضمن بنية متعددة الأقراص (JBOD)، وتوسعة السعة، والقواعد التي تحدد ما يمكنك وما لا يمكنك تغييره بعد إنشاء العنقود.

للاطلاع على المرجع المفصل حسب الحقول، راجع تهيئة → Storage configuration ومرجع واجهة برمجة التطبيقات.

spec.dataVolumeClaimSpec هو PersistentVolumeClaimSpec قياسي في Kubernetes. ويحوّله المشغّل إلى volumeClaimTemplate ضمن StatefulSet، بحيث تُنشئ وحدة تحكم StatefulSet عنصر PersistentVolumeClaim واحدًا لكل نسخة متماثلة وتحتفظ به، ثم تربطه بمسار بيانات ClickHouse /var/lib/clickhouse.

apiVersion: clickhouse.com/v1alpha1
kind: ClickHouseCluster
metadata:
  name: my-cluster
spec:
  dataVolumeClaimSpec:
    storageClassName: fast-ssd   # optional; depends on the installed CSI driver
    resources:
      requests:
        storage: 100Gi

• عند عدم تحديد accessModes، يضبطه المشغّل تلقائيًا على ReadWriteOnce.
• يتم الاحتفاظ بـ PVC الخاص بكل نسخة متماثلة عند حذف الـ عنقود، لذا تبقى البيانات بعد حذف المورد المخصص وإعادة إنشائه. وبالنسبة إلى البيانات الموجودة ضمن سياسة مشفّرة، يتطلّب ذلك أيضًا الحفاظ على مفتاح التشفير — راجع الملاحظة في ذلك القسم.
• يوجد الحقل نفسه أيضًا في KeeperCluster ويعمل بالطريقة نفسها.

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

هذا مخصّص فقط للعناقيد المؤقتة أو الاختبارية. لتوفير وحدة التخزين الخاصة بك بدلًا من dataVolumeClaimSpec — على سبيل المثال emptyDir أو وحدة تخزين مُجهَّزة مسبقًا — عرّفها عبر spec.podTemplate.volumes ثم اربطها في /var/lib/clickhouse باستخدام spec.containerTemplate.volumeMounts.

لتوسيع وحدة تخزين، زِد قيمة resources.requests.storage وطبّق التغيير. سيعمل المشغّل على تحديث وحدات PVC الحالية في مكانها.

spec:
  dataVolumeClaimSpec:
    resources:
      requests:
        storage: 200Gi   # was 100Gi

يقوم spec.additionalVolumeClaimTemplates بإرفاق أقراص إضافية بكل نسخة متماثلة من ClickHouse إلى جانب dataVolumeClaimSpec الأساسية. وكل entry عبارة عن قالب PVC مسمّى — يتكوّن من metadata.name وspec الخاصة بـ PVC — وتتم مواءمته تمامًا مثل قرص البيانات الأساسي، بحيث تُنشئ وحدة تحكم StatefulSet وتُبقي PVC واحدة لكل نسخة متماثلة باسم <name>-<statefulset>-0.

spec:
  dataVolumeClaimSpec:
    storageClassName: fast-ssd
    resources:
      requests:
        storage: 100Gi
  additionalVolumeClaimTemplates:
    - metadata:
        name: disk1
      spec:
        storageClassName: fast-ssd
        resources:
          requests:
            storage: 100Gi
    - metadata:
        name: disk2
      spec:
        storageClassName: fast-ssd
        resources:
          requests:
            storage: 100Gi

يقوم المُشغِّل بربط كل وحدة تخزين إضافية عند /var/lib/clickhouse/disks/<name> ويُنشئ لك storage_configuration الخاصة بـ ClickHouse — لذلك لا تكتبها يدويًا. كما يسجّل كل قرص إضافي ويضيفه إلى سياسة التخزين المضمّنة default.

يشترك قرص البيانات الأساسي (default) وكل قرص إضافي في وحدة تخزين واحدة ضمن سياسة default، لذلك يوزّع ClickHouse data parts الجديدة عليها جميعًا بأسلوب round-robin. وتساوي السعة القابلة للاستخدام مجموع كل أقراص، وكل table لا يحدّد storage_policy خاصته — بما في ذلك جداول system.* — يستخدم هذه المجموعة الموحّدة.

أنت لست بحاجة إلى extraConfig لتخطيط JBOD أعلاه — إذ يُنشئ المُشغِّل سياسة default تلقائيًا. لا تستخدم spec.settings.extraConfig إلا عندما تريد سياسات تخزين تتجاوز الإعداد الافتراضي المُنشأ، مثل سياسة متدرجة للتخزين الساخن/البارد مع move_factor وprefer_not_to_merge، أو قرصًا مدعومًا بـ S3. وأي تهيئة تضيفها هناك تُدمج فوق storage_configuration المُنشأ.

راجع وثائق التخزين في ClickHouse للاطلاع على حقول السياسة.

يؤدي تعيين spec.settings.encryption إلى تفعيل تشفير بيانات الجدول وهي مخزَّنة. ويُنشئ المشغِّل مفتاح AES بطول 16 بايت — يُخزَّن في كائن Secret الخاص بالعنقود المُدار، أو يُوفَّر عبر externalSecret — بالإضافة إلى سياسة تخزين مخصّصة تُغلّف كل قرص بيانات باستخدام نوع القرص encrypted في ClickHouse.

spec:
  settings:
    encryption: {}   # enables the feature; the policy defaults to "encrypted"

يُفعَّل التشفير اختياريًا لكل جدول؛ وتبقى سياسة التخزين الافتراضية غير مشفّرة. حدِّد السياسة المشفّرة عند إنشاء جدول:

CREATE TABLE secret_data (id UInt64) ENGINE = MergeTree ORDER BY id
SETTINGS storage_policy = 'encrypted';

عيّن encryption.policyName لاستخدام اسم سياسة مختلف.

يصبح تخطيط التخزين ثابتًا إلى حدٍّ كبير بمجرد إنشاء عنقود. تُرفض في مرحلة admission التحديثات التي قد تترك PersistentVolumeClaims بدون ارتباط أو تعيد ربطها:

• وجود dataVolumeClaimSpec غير قابل للتغيير — لا يمكنك إضافة وحدة تخزين البيانات إلى عنقود أُنشئ من دونه، ولا إزالته من عنقود أُنشئ معه.
• تكون مجموعة additionalVolumeClaimTemplates ثابتة — لا يمكنك إضافة عناصر أو إزالتها أو إعادة تسميتها بعد الإنشاء.
• يُسمح بتوسيع resources.requests.storage في عنصر موجود (رهناً بدعم StorageClass، راجع توسيع التخزين).
• لا يمكن تعطيل التشفير بعد تفعيله، ولا يمكن إعادة تسمية encryption.policyName — إذ ستصبح الجداول التي تستخدم سياسة التشفير بالفعل غير قابلة للوصول.

• التهيئة — المرجع الكامل للحقول، بما في ذلك extraConfig.
• توسيع نطاق العناقيد — كيفية إضافة النسخ المتماثلة والشظايا وإزالتها.