تحسينات مجموعة المصادر

بيانات التعزيز الوصفية للمخططات المرتبطة بـ origin_pool. راجع امتدادات OpenAPI للاطلاع على تعريفات الامتدادات.

المخططات المُعزَّزة

النمط

تتلقى جميع المخططات المطابقة لـ origin_pool.*SpecType التعزيزات:

origin_poolCreateSpecType
origin_poolReplaceSpecType
origin_poolGetSpecType

الحقول المطلوبة

الحقل	مطلوب لـ	ملاحظات
`metadata.name`	جميع العمليات	1-63 حرفًا، أحرف صغيرة وأرقام، النمط: `^[a-z0-9]([-a-z0-9]*[a-z0-9])?$`
`metadata.namespace`	جميع العمليات	معرّف مساحة الاسم
`spec.origin_servers`	الإنشاء	الحد الأدنى عنصر واحد
`spec.port`	الإنشاء	1-65535، لا قيمة افتراضية للخادم

الحد الأدنى من التهيئة القابلة للتطبيق

{
  "metadata": {
    "name": "my-origin-pool",
    "namespace": "default"
  },
  "spec": {
    "origin_servers": [
      {
        "public_name": {
          "dns_name": "backend.example.com"
        }
      }
    ],
    "port": 443
  }
}

القيم الافتراضية المُطبَّقة من الخادم

الحقول المُعلَّمة بـ x-f5xc-server-default: true تُطبَّق قيمتها الافتراضية default من قِبل خادم F5 XC API عند حذفها من الطلبات.

الحقول على المستوى الأعلى

الحقل	القيمة الافتراضية	النوع	الوصف
`no_tls`	`{}`	object	TLS إلى المصدر معطَّل
`healthcheck`	`[]`	array	لا فحوصات صحة مُهيَّأة
`loadbalancer_algorithm`	`ROUND_ROBIN`	enum	موازنة تحميل دوارة
`endpoint_selection`	`DISTRIBUTED`	enum	استخدام جميع نقاط النهاية (المحلية + البعيدة)

القيم الافتراضية لـ advanced_options

عند عدم تحديد advanced_options، يتصرف الخادم كما لو كانت هذه القيم مُعيَّنة:

الحقل	القيمة الافتراضية	النوع	الوصف
`connection_timeout`	`2000`	integer	مهلة الاتصال بالميلي ثانية
`http_idle_timeout`	`300000`	integer	مهلة HTTP الخاملة بالميلي ثانية (5 دقائق)
`same_as_endpoint_port`	`{}`	object	يستخدم فحص الصحة منفذ نقطة النهاية
`default_circuit_breaker`	`{}`	object	إعدادات قاطع الدائرة الافتراضية
`disable_outlier_detection`	`{}`	object	اكتشاف الشذوذ معطَّل
`no_panic_threshold`	`{}`	object	لا عتبة ذعر
`disable_subsets`	`{}`	object	موازنة تحميل المجموعات الفرعية معطَّلة
`auto_http_config`	`{}`	object	التفاوض التلقائي على بروتوكول HTTP
`disable_proxy_protocol`	`{}`	object	بروتوكول الوكيل معطَّل
`disable_lb_source_ip_persistance`	`{}`	object	ثبات عنوان IP المصدر لموازن التحميل معطَّل

القيم الافتراضية للكائنات المتداخلة

المسار	القيمة الافتراضية	الوصف
`origin_servers[].labels`	`{}`	كائن تسميات فارغ
`origin_servers[].public_name.refresh_interval`	`0`	استخدام تحديث DNS الافتراضي للنظام

التناقضات بين واجهة المستخدم والقيم الافتراضية للخادم

تُحدِّد واجهة الويب F5 XC قيمًا مسبقة مختلفة عما يُطبِّقه الـ API عند حذف الحقول.

الحقل	مُحدَّد مسبقًا في واجهة المستخدم	مُطبَّق من الخادم	ملاحظة
`loadbalancer_algorithm`	`LB_OVERRIDE`	`ROUND_ROBIN`	الموارد المُنشأة عبر واجهة المستخدم وتلك المُنشأة عبر API تختلف عند حذف الحقل

قيم Enum

loadbalancer_algorithm

القيمة	الوصف	ملاحظات
`ROUND_ROBIN`	يُختار كل نقطة نهاية صحية بترتيب دوار	افتراضي الخادم
`LEAST_REQUEST`	يُختار نقطة النهاية ذات أقل الطلبات النشطة
`RING_HASH`	تجزئة متسقة باستخدام تجزئة حلقية لأسماء نقاط النهاية
`RANDOM`	اختيار عشوائي لنقطة نهاية صحية
`LB_OVERRIDE`	سياسة التجزئة موروثة من موازن التحميل الأصلي	افتراضي واجهة المستخدم

endpoint_selection

القيمة	الوصف	ملاحظات
`DISTRIBUTED`	مراعاة نقاط النهاية البعيدة والمحلية	افتراضي الخادم
`LOCAL_ONLY`	استخدام نقاط النهاية المحلية فقط
`LOCAL_PREFERRED`	تفضيل المحلية، والرجوع إلى البعيدة عند عدم التوفر

مجموعات حقول OneOf

مجموعات حقول متنافية. لا يمكن تحديد سوى حقل واحد من كل مجموعة:

المجموعة	الحقول	افتراضي الخادم
تهيئة المنفذ	`port`, `automatic_port`, `lb_port`	`port` (صريح)
TLS إلى المصدر	`no_tls`, `use_tls`	`no_tls`
منفذ فحص الصحة	`same_as_endpoint_port`, `health_check_port`	`same_as_endpoint_port`
قاطع الدائرة	`default_circuit_breaker`, `disable_circuit_breaker`, `circuit_breaker`	`default_circuit_breaker`
اكتشاف الشذوذ	`disable_outlier_detection`, `outlier_detection`	`disable_outlier_detection`
عتبة الذعر	`no_panic_threshold`, `panic_threshold`	`no_panic_threshold`
موازنة تحميل المجموعات الفرعية	`disable_subsets`, `enable_subsets`	`disable_subsets`
بروتوكول HTTP	`auto_http_config`, `http1_config`, `http2_options`	`auto_http_config`
بروتوكول الوكيل	`disable_proxy_protocol`, `proxy_protocol_v1`, `proxy_protocol_v2`	`disable_proxy_protocol`
عنوان IP المصدر لموازن التحميل	`disable_lb_source_ip_persistance`, `enable_lb_source_ip_persistance`	`disable_lb_source_ip_persistance`
تجمع الاتصالات	`enable_conn_pool_reuse`, `disable_conn_pool_reuse`	`enable_conn_pool_reuse`

قيود الحقول

الحقل	النوع	القيد
`spec.port`	integer	1-65535
`spec.advanced_options.connection_timeout`	integer	0-1,800,000 ms
`spec.advanced_options.http_idle_timeout`	integer	0-600,000 ms
`spec.advanced_options.panic_threshold`	integer	0-100 (نسبة مئوية)
`metadata.name`	string	1-63 حرفًا، النمط: `^[a-z0-9]([-a-z0-9]*[a-z0-9])?$`

خيارات التهيئة في واجهة المستخدم

تعرض وحدة تحكم F5 XC على الويب 15 خيار تهيئة لمجموعات المصادر:

#	تسمية واجهة المستخدم	مسار حقل API	النوع	افتراضي الخادم
1	منفذ خادم المصدر	`spec.[port\|automatic_port\|lb_port]`	OneOf	`port` (صريح)
2	إعادة استخدام تجمع الاتصالات	`spec.[enable_conn_pool_reuse\|disable_conn_pool_reuse]`	OneOf	`enable_conn_pool_reuse`
3	منفذ فحص الصحة	`spec.advanced_options.[same_as_endpoint_port\|health_check_port]`	OneOf	`same_as_endpoint_port`
4	خوارزمية موازن التحميل	`spec.loadbalancer_algorithm`	enum	`ROUND_ROBIN`
5	اختيار نقطة النهاية	`spec.endpoint_selection`	enum	`DISTRIBUTED`
6	TLS إلى المصدر	`spec.[no_tls\|use_tls]`	OneOf	`no_tls`
7	مهلة الاتصال	`spec.advanced_options.connection_timeout`	integer	2000 ms
8	مهلة HTTP الخاملة	`spec.advanced_options.http_idle_timeout`	integer	300000 ms
9	قاطع الدائرة	`spec.advanced_options.[default_circuit_breaker\|disable_circuit_breaker\|circuit_breaker]`	OneOf	`default_circuit_breaker`
10	اكتشاف الشذوذ	`spec.advanced_options.[disable_outlier_detection\|outlier_detection]`	OneOf	`disable_outlier_detection`
11	عتبة الذعر	`spec.advanced_options.[no_panic_threshold\|panic_threshold]`	OneOf	`no_panic_threshold`
12	موازنة تحميل المجموعات الفرعية	`spec.advanced_options.[disable_subsets\|enable_subsets]`	OneOf	`disable_subsets`
13	بروتوكول HTTP	`spec.advanced_options.[auto_http_config\|http1_config\|http2_options]`	OneOf	`auto_http_config`
14	بروتوكول الوكيل	`spec.advanced_options.[disable_proxy_protocol\|proxy_protocol_v1\|proxy_protocol_v2]`	OneOf	`disable_proxy_protocol`
15	ثبات عنوان IP المصدر لموازن التحميل	`spec.advanced_options.[disable_lb_source_ip_persistance\|enable_lb_source_ip_persistance]`	OneOf	`disable_lb_source_ip_persistance`

الوصول إلى البيانات

مواصفات OpenAPI

الملف	المحتوى
`docs/specifications/api/virtual.json`	`origin_poolCreateSpecType`, `origin_poolReplaceSpecType`, `origin_poolGetSpecType`
`docs/specifications/api/openapi.json`	المواصفات المدمجة مع جميع المخططات

بنية validation.json

defaults.resources.origin_pool
├── server_applied      # الحقول ذات x-f5xc-server-default: true
├── recommended         # الحقول ذات x-f5xc-recommended-value
├── advanced_options    # القيم الافتراضية المتداخلة لـ advanced_options
├── oneof_choices       # اختيارات OneOf الافتراضية
└── ui_vs_server        # التناقضات بين واجهة المستخدم والخادم

أنواع خوادم المصادر

يمكن تحديد خوادم المصادر باستخدام متغيرات أنواع مختلفة. يحدد النوع الحقول الإضافية المطلوبة.

الأنواع المُنفَّذة

النوع	الوصف	الحقول المطلوبة	الحالة
`public_name`	خادم مصدر باسم DNS عام	`dns_name`	✅ مكتمل
`public_ip`	خادم مصدر بعنوان IP عام	`ip` (IPv4)	✅ مكتمل

مثال: public_name

{
  "origin_servers": [
    {
      "public_name": {
        "dns_name": "backend.example.com"
      }
    }
  ]
}

مثال: public_ip

{
  "origin_servers": [
    {
      "public_ip": {
        "ip": "8.8.8.8"
      }
    }
  ]
}

TODO: أنواع خوادم المصادر المعتمدة على الموقع

تتطلب أنواع خوادم المصادر التالية تطوير منطق موارد “الموقع” قبل التنفيذ:

النوع	الوصف	الحقول المطلوبة	الحالة
`private_ip`	خادم مصدر بعنوان IP خاص/عام ومعلومات الموقع	`ip`, `site_locator`, `network_choice`, `snat_pool`	🔲 في انتظار منطق الموقع
`private_name`	خادم مصدر باسم DNS ومعلومات الموقع	`dns_name`, `site_locator`, `network_choice`, `snat_pool`	🔲 في انتظار منطق الموقع
`k8s_service`	خدمة Kubernetes مع معلومات الموقع	`service_name`, `site_locator`, `network_choice`	🔲 في انتظار منطق الموقع
`consul_service`	خدمة HashiCorp Consul مع معلومات الموقع	`service_name`, `site_locator`, `network_choice`	🔲 في انتظار منطق الموقع

متطلبات التنفيذ

قبل توثيق هذه الأنواع بالكامل:

اكتشاف موارد الموقع - توثيق مخطط مورد site وأنماط site_locator
Enum اختيار الشبكة - توثيق القيم المقيَّدة لـ network_choice (site_local_inside، site_local_outside، إلخ)
خيارات تجمع SNAT - توثيق أنماط تهيئة تجمع SNAT
مراجع الموارد المتقاطعة - تحديد كيفية إشارة origin_pool إلى موارد الموقع

التتبع

العنصر النائب للتهيئة: config/discovered_defaults.yaml ← origin_pool.origin_server_types.enums
السبرينت ذات الصلة: تعزيزات مخطط مورد الموقع

الوثائق ذات الصلة

دليل التطوير - امتدادات OpenAPI - تعريفات الامتدادات واستخدامها
مواصفات التحقق - تنسيق validation.json وبنيته
تحسينات Healthcheck - تعزيزات مخطط Healthcheck

سجل التغييرات

الإصدار	التاريخ	التغييرات
2.1.2	2026-01-18	إضافة قسم أنواع خوادم المصادر مع public_name/public_ip؛ علامات TODO للأنواع المعتمدة على الموقع
2.1.1	2026-01-18	إعادة الكتابة كمرجع API خالص؛ إزالة أمثلة الكود الدفعية
2.1.0	2026-01-18	تحديث إلى بنية القيم الافتراضية الموحدة في validation.json
2.0.33	2026-01-17	التوثيق الأولي لتحسينات مجموعة المصادر