Argo CD / الأنظمة المولدة والتعافي المضبوط / الدرس 15

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

افصل تغير المتحكم المشروع عن إخفاء انجراف القصد.

وقت القراءة التقريبي: 4 دقيقةتاريخ مراجعة المحتوى 2026-10-28

في هذه الصفحة

أهداف الدرس

شرح فرق التمثيل والقبول والمتحكم الخارجي.
تمييز ignoreDifferences وسلوك المزامنة المدعوم.

يحتاج الفرق مالكاً ومعنى

قد يأتي الفرق من الافتراض والتطبيع والقبول وصيغة الكمية والترتيب ومتحكم آخر أو تغيير غير مخول. قد يدير autoscaler نسخ Parcel ويبقى image حساساً. لا تتجاهل حقلاً دون مالكه ونمط تغيره. قد تخفي قاعدة واسعة تغييراً مهماً خلف Synced. احفظ مثالاً منقحاً وسبب عدم اشتراط المساواة. لا يكفي أن يتكرر الفرق كثيراً لتبرير إخفائه؛ ربما يكشف قالباً غير حتمي أو صراع مالكين ينبغي تصحيحه بدلاً من إزالة قدرة المقارنة على رؤيته.

تجاهل الهوية والمسار المقصودين فقط

تستهدف القاعدة مجموعة ونوعاً واسماً ونطاقاً ومحدد حقل مدعوماً. أثر العام أوسع ويحتاج مراجعة أوسع. دقق هروب JSON Pointer واختيار القوائم؛ قد لا يطابق الخاطئ أو يوسع الاختيار. لا تخف كل spec لتقليل الضجيج. وثق المالك الخارجي وملاحظة مستقلة لسلوكه. تجاهل replicas ليس تجاهل كل الطرح أو السر. يجب أن يستطيع الاختبار السلبي إظهار فرق حساس خارج الاستثناء، كي يثبت أن التحسين لم يلغ المقارنة التي يحتاجها الإصدار كله.

اقرأ قاعدة مقارنة فقط بعناية

يختار المقطع replicas لنشر افتراضي واحد ولا يطبق ولا يضم RespectIgnoreDifferences. وفق المرجع لا يضمن تجاهل المقارنة استثناء الحقل من sync. للخيار المنفصل دلالة وحدود؛ راجع وجود المورد وطريقة التطبيق. لا تستنتج وعد ملكية كتابة من فرق نظيف. يحتاج القرار فهم ما يحدث عند إنشاء جديد وما يحدث عند تحديث قائم، لا قراءة أسماء خيارات متشابهة كأنها تعني الشيء نفسه. يحدد المثال موضع الاستثناء ولا يدعي أن autoscaler موجود أو مخول فعلاً.

yaml مقطع قاعدة فرق ضيقة

spec:
  ignoreDifferences:
    - group: apps
      kind: Deployment
      name: parcel
      namespace: parcel-lab
      jsonPointers:
        - /spec/replicas

لا يضبط الجزء. يوضح المقارنة فقط ولا يثبت مالكاً أو استثناء كتابة أو نتيجة إدارة حقل.

أبق الانجراف الآخر مرئياً

يحذف النموذج الكامل مفتاح replicas مسطحاً فقط، فيتجاهل العدد ثم يكشف image مختلفاً. ليس JSON Pointer أو التطبيع أو managedFields أو فرق الخادم. يوضح حالة سلبية مفيدة: لا يخفي الاستثناء الضيق حساسية أخرى. تحتاج الحقيقة موارد كاملة ممثلة وتحقق منصة مصرحاً عند أهمية الدلالة. لا يثبت تطابق القاموس أن قاعدة YAML صحيحة أو أن الترتيب والتخزين في المورد الحقيقي لهما السلوك نفسه؛ يوضح المثال ثابت الاختبار الذي ينبغي نقله إلى الأدلة المناسبة فقط.

python نموذج سلبي محدود لحقل متجاهل

def compared(record):
    return {k: v for k, v in record.items() if k != "replicas"}
desired = {"replicas": 2, "image": "parcel-lab-r5"}
live = {"replicas": 4, "image": "parcel-lab-r5"}
print(compared(desired) == compared(live))
live["image"] = "parcel-lab-r6"
print(compared(desired) == compared(live))

الناتج المتوقع

True
False

يقارن قواميس مسطحة ولا يدقق YAML أو يعيد فرق المنصتين.

اجعل الاستثناء مملوكاً قابلاً للمراجعة

قد يصبح تجاهل الحقل خطراً عند إزالة متحكم أو تغير API أو انتقال ملكية. عيّن مالكاً وشروط مراجعة لا قواعد دائمة مجهولة. لاحظ السلوك منفصلاً واحفظ تنبيهاً ذا معنى للقيم الغريبة. أصلح التوليد غير الحتمي أو القالب بدلاً من إسكات كل فرق. تفيد النظافة إذا كانت الاستثناءات عقداً صادقاً يظهر الانجراف ولا يبالغ بالصحة. لا يتحول استمرار ظهور Synced إلى دليل أن السبب الأصلي ما زال موجوداً؛ يحتاج الاستثناء نفسه دورة صيانة مع تغير المكونات المحيطة به.

الأخطاء الشائعة وإصلاحها

تُخفى spec كلها لإظهار Synced.

لماذا يحدث؟: أزال تقليل الضجيج عقد المقارنة.
كيف تصلحه؟: حدد المالك واستثنِ الضيق المبرر.
كيف تتجنب تكراره؟: اختبر بقاء image والهوية والحساس مرئياً.

يُعد تجاهل الفرق مانعاً لكل كتابة.

لماذا يحدث؟: اختلطت المقارنة بالتطبيق.
كيف تصلحه؟: راجع دلالة RespectIgnoreDifferences مستقلة.
كيف تتجنب تكراره؟: صرح بضمان المقارنة والكتابة منفصلين.

يبقى الاستثناء بعد إزالة مالكه.

لماذا يحدث؟: لا مسؤول أو محفز مراجعة.
كيف تصلحه؟: أعد تقييم الملكية والمقارنة المناسبة.
كيف تتجنب تكراره؟: سجل السبب وشرط التقاعد.

اختبر فهمك

1. تُتجاهل النسخ لـ autoscaler. هل يختفي image؟

اعرض الحل المشروح

لا. يجب حفظ الفروق غير المشمولة. يثبت النموذج السلبي ذلك لقاموس فقط؛ تحتاج المحددات والموارد الفعلية إثبات النطاق الحقيقي.

2. كيف يكون Synced ويكتب sync حقلاً متغيراً؟