تشخيص المتغير الغائب والنوع الخاطئ والتجاوز

افهم الأسباب المحتملة

• تشمل الأسباب مفتاحاً غائباً وحقائق معطلة أو قديمة ونتيجة متجاوزة وتجاوزاً وتصادماً وافتراض نوع أو ثقة. لا يعني الغائب الجرد تلقائياً ولا يضمن الاقتباس النوع. كما يجب التمييز بين عدم وجود القيمة أصلاً وعدم توفرها بعد في الموضع الذي يقيم الشرط أو القالب، فلكل منهما مسار تحقق مختلف.

1. حفظ أول قيمة فاشلة وموضع تقييمها

سجل المسار والمطلوب والهوية والسياق والفئة وافحص المنتج: نفذ أو تجاوز أو فشل أو تنبأ. لا تطبع hostvars كلها لحساسية وتشويش، وأعد ببيانات وبنية مماثلة. لا يضمن عرض سابق توفر اللاحق ومعناه. وقد تكون نتيجة المنتج محدودة في check mode حتى لو كان الاسم صحيحاً تماماً، لذلك لا يكفي البحث النصي عن تعريف المتغير لإثبات توفر حقله.

2. تتبع الملكية والأولوية لا موضع الملف

اسرد الافتراضي والجرد وplay والمهمة والتسجيل وextra vars وافصلها من الإعداد والخيار والكلمة. طبق الفئة والنطاق لا آخر ملف، وقد يعلو الغائب. احفظ أصلاً دون السر وقارن العقد بملكية المستدعي. ويفيد تسجيل ملكية كل مصدر في منع التصحيح العارض داخل دور يعاد استخدامه، إذا كانت القيمة في الأصل مدخلاً يجب أن يملكه المستدعي.

- name: Illustrate a required typed input
  hosts: lab_nodes
  gather_facts: false
  vars:
    report_settings:
      enabled: true
      workers: 2
  tasks:
    - name: Validate the synthetic input contract
      ansible.builtin.assert:
        that:
          - report_settings.enabled is boolean
          - report_settings.workers is integer
          - report_settings.workers > 0

3. التحقق من عقد النوع كاملاً

ميز المنطق والنص والعدد والمعرف والقائمة والمجمع ولا تحول إلا بالعقد. when تعبير لا يحتاج الأقواس عادة. غيرت2.19 كشف الأنماط فراجع الترحيل ولا تضعف الصرامة. ليفشل المطلوب بوضوح لا بديل يخفي إعداداً خاطئاً. وتشمل حالات التحقق المطلوبة قيمة false الصحيحة أيضاً، حتى لا يرفض البرنامج المدخل السليم لمجرد أنه لا يختار فرع التنفيذ الموجب.

candidate = {'enabled': 'false', 'workers': 2}
checks = {'enabled_boolean': type(candidate.get('enabled')) is bool, 'workers_positive_integer': type(candidate.get('workers')) is int and candidate['workers'] > 0}
for name, passed in checks.items():
    print(f'{name}={passed}')

enabled_boolean=False
workers_positive_integer=True

4. تصحيح المصدر المملوك وحفظ الرفض

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

امنع تكرار المشكلة

• استخدم أسماء نطاقية ومخططاً وسجل أولوية وافصل الحقيقة والسياسة ووثق البديل. ثبت المحرك وراجع الترحيل واحفظ الغائب والنوع والتوفر والمستدعين دون dump كامل. واجعل حالات الرفض جزءاً من العقد المنشور للدور، بحيث تبقى أخطاء المدخل واضحة بدلاً من تحولها إلى إعداد افتراضي غير مقصود.