تحسينات موازن تحميل HTTP

بيانات الإثراء الوصفية لمخططات موازن تحميل HTTP. راجع امتدادات OpenAPI لتعريفات الامتدادات.

المخططات المُثرَاة

النمط

تتلقى جميع المخططات المطابقة لـ viewshttp_loadbalancer.*SpecType عمليات الإثراء:

viewshttp_loadbalancerCreateSpecType
viewshttp_loadbalancerReplaceSpecType
viewshttp_loadbalancerGetSpecType

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

يوفر الامتداد x-f5xc-minimum-configuration بيانات وصفية شاملة لواجهة سطر الأوامر لإنشاء موازنات تحميل HTTP قابلة للحياة بحد أدنى من الإعدادات.

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

الحقل	القيد	الوصف
`metadata.name`	تنسيق تسمية DNS: `[a-z0-9]([-a-z0-9]*[a-z0-9])?`	اسم المورد
`metadata.namespace`	تنسيق تسمية DNS	مساحة الاسم
`spec.domains`	مصفوفة، min_items: 1	النطاقات التي سيتم تقديمها

نوع موازن التحميل (مطلوب أحدها)

يجب تحديد أحد أنواع موازنات التحميل التالية:

الصيغة	الوصف
`spec.http`	HTTP فقط
`spec.https`	HTTPS مع شهادة يدوية
`spec.https_auto_cert`	HTTPS مع شهادة تلقائية
`spec.http_https`	كلٌّ من HTTP وHTTPS

ملاحظة: يُشار إلى مجموعة OneOf لنوع موازن التحميل بـ:

lb_type في ملفات التهيئة (الصيغة المختصرة في config/minimum_configs.yaml)
loadbalancer_type في امتدادات المواصفة الأصلية لـ OpenAPI (اسم الحقل الأصلي)

مرجع مخطط API: x-ves-oneof-field-loadbalancer_type: ["http", "https", "https_auto_cert", "http_https"]

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

{
  "metadata": {
    "name": "example-app",
    "namespace": "default"
  },
  "spec": {
    "domains": ["example.com"],
    "https_auto_cert": {
      "port": 443,
      "tls_config": {"default_security": {}}
    },
    "advertise_on_public_default_vip": {},
    "routes": [{"prefix": "/", "origin_pool": {"pool_name": "backend-pool"}}]
  }
}

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

الحقول المُعلَّمة بـ x-f5xc-server-default: true تُطبَّق قيمتها الافتراضية default بواسطة خادم F5 XC API عند حذفها من الطلبات. يمتلك موازن تحميل HTTP عددًا كبيرًا من الإعدادات الافتراضية المُطبَّقة من الخادم لأن معظم ميزات الأمان وخيارات البروتوكول تكون افتراضيًا في حالة معطّلة أو آمنة.

إعدادات HTTPS Auto-Cert الافتراضية

عند تحديد https_auto_cert، يُطبِّق الخادم هذه الإعدادات الافتراضية للحقول المحذوفة:

الحقل	القيمة الافتراضية	النوع	الوصف
`port`	`443`	عدد صحيح	منفذ استماع HTTPS
`http_redirect`	`false`	منطقي	إعادة توجيه HTTP إلى HTTPS
`add_hsts`	`false`	منطقي	رأسية HTTP Strict Transport Security
`tls_config.default_security`	`{}`	كائن	TLS 1.2+ مع تشفيرات قوية
`no_mtls`	`{}`	كائن	Mutual TLS معطّل
`default_header`	`{}`	كائن	معالجة رأسية اسم الخادم الافتراضية
`enable_path_normalize`	`{}`	كائن	تطبيع المسار مُفعَّل
`default_loadbalancer`	`{}`	كائن	إعدادات موازن التحميل الافتراضية
`header_transformation_type.legacy_header_transformation`	`{}`	كائن	تحويل الرأسية القديم
`connection_idle_timeout`	`120000`	عدد صحيح	مهلة الاتصال الخاملة بالميلي ثانية (دقيقتان)
`http_protocol_options.http_protocol_enable_v1_v2`	`{}`	كائن	HTTP/1.1 وHTTP/2 مُفعَّلان
`coalescing_options.default_coalescing`	`{}`	كائن	دمج اتصال HTTP/2 الافتراضي

إعدادات ميزات الأمان الافتراضية

جميع ميزات الأمان تكون معطّلة افتراضيًا عند حذفها:

الحقل	القيمة الافتراضية	الوصف
`disable_waf`	`{}`	جدار حماية تطبيقات الويب (WAF) معطّل
`disable_bot_defense`	`{}`	دفاع Bot معطّل
`disable_rate_limit`	`{}`	تحديد معدل الطلبات معطّل
`disable_api_discovery`	`{}`	اكتشاف API معطّل
`disable_api_testing`	`{}`	اختبار API معطّل
`disable_api_definition`	`{}`	تعريف API معطّل
`disable_malware_protection`	`{}`	حماية البرمجيات الخبيثة معطّلة
`disable_client_side_defense`	`{}`	الدفاع من جهة العميل معطّل
`disable_ip_reputation`	`{}`	سمعة IP معطّلة
`disable_threat_mesh`	`{}`	شبكة التهديدات معطّلة
`disable_malicious_user_detection`	`{}`	اكتشاف المستخدم الخبيث معطّل

إعدادات حماية DDoS والتحكم في الوصول الافتراضية

الحقل	القيمة الافتراضية	الوصف
`l7_ddos_protection.mitigation_block`	`{}`	حجب حركة مرور DDoS (إجراء التخفيف الافتراضي)
`l7_ddos_protection.default_rps_threshold`	`{}`	استخدام حد RPS الافتراضي
`l7_ddos_protection.clientside_action_none`	`{}`	لا يوجد تحقق من جهة العميل لـ DDoS
`l7_ddos_protection.ddos_policy_none`	`{}`	لا توجد إشارة إلى سياسة DDoS
`no_challenge`	`{}`	لا يوجد تحدٍّ للعميل
`user_id_client_ip`	`{}`	تحديد هوية المستخدمين عبر IP العميل
`disable_trust_client_ip_headers`	`{}`	عدم الثقة برأسيات IP العميل

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

الحقل	القيمة الافتراضية	النوع	الوصف
`advertise_on_public_default_vip`	`{}`	كائن	الإعلان على VIP العام الافتراضي
`round_robin`	`{}`	كائن	خوارزمية موازنة التحميل Round-Robin
`add_location`	`true`	منطقي	إضافة رأسية الموقع إلى الاستجابات
`system_default_timeouts`	`{}`	كائن	استخدام مهل النظام الافتراضية
`service_policies_from_namespace`	`{}`	كائن	توارث سياسات الخدمة من مساحة الاسم
`default_sensitive_data_policy`	`{}`	كائن	استخدام سياسة البيانات الحساسة الافتراضية

مجموعات الحقول المتنافية

الحقول المُعلَّمة بـ x-f5xc-conflicts-with تشير إلى أنماط OneOf. يمكن تحديد حقل واحد فقط من كل مجموعة.

مجموعات التهيئة الأساسية

اسم المجموعة	الحقول	الوصف
`lb_type`	`http`، `https`، `https_auto_cert`، `http_https`	نوع بروتوكول موازن التحميل
`advertising`	`advertise_on_public_default_vip`، `advertise_on_public`، `advertise_custom`، `do_not_advertise`	طريقة الإعلان عن موازن التحميل
`load_balancing_algorithm`	`round_robin`، `least_request`، `ring_hash`، `random`	خوارزمية توزيع حركة المرور

مجموعات تهيئة HTTPS (10 مجموعات)

تهيئة TLS

اسم المجموعة	الحقول	الوصف
`tls_config`	`default_security`، `medium_security`، `low_security`، `custom_security`	مستوى أمان TLS
`mtls`	`no_mtls`، `use_mtls`	Mutual TLS مُفعَّل أو معطّل

البروتوكول والرأسيات

اسم المجموعة	الحقول	الوصف
`http_protocol`	`http_protocol_enable_v1_only`، `http_protocol_enable_v1_v2`، `http_protocol_enable_v2_only`	إصدارات بروتوكول HTTP
`header_transformation`	`legacy_header_transformation`، `proper_header_transformation`، `preserve_case_header_transformation`	نوع تحويل رأسية HTTP
`server_name_header`	`default_header`، `append_server_name_header`، `pass_through_server_name_header`	معالجة رأسية اسم الخادم

إدارة الاتصال

اسم المجموعة	الحقول	الوصف
`path_normalize`	`enable_path_normalize`، `disable_path_normalize`	تطبيع المسار مُفعَّل أو معطّل
`loadbalancer_choice`	`non_default_loadbalancer`، `default_loadbalancer`	موازن التحميل الافتراضي أو غير الافتراضي
`coalescing`	`default_coalescing`، `disable_coalescing`، `enable_for_same_origin`	خيارات دمج اتصال HTTP/2

مجموعات ميزات الأمان (11 مجموعة)

اسم المجموعة	الحقول	الوصف
`waf`	`disable_waf`، `enable_waf`	جدار حماية تطبيقات الويب (WAF)
`bot_defense`	`disable_bot_defense`، `enable_bot_defense`	اكتشاف Bot والتخفيف منه
`rate_limit`	`disable_rate_limit`، `enable_rate_limit`	تحديد معدل الطلبات
`api_discovery`	`disable_api_discovery`، `enable_api_discovery`	اكتشاف API
`api_testing`	`disable_api_testing`، `enable_api_testing`	اختبار API
`api_definition`	`disable_api_definition`، `enable_api_definition`	تعريف API
`malware_protection`	`disable_malware_protection`، `enable_malware_protection`	حماية البرمجيات الخبيثة
`client_side_defense`	`disable_client_side_defense`، `enable_client_side_defense`	الدفاع من جهة العميل
`ip_reputation`	`disable_ip_reputation`، `enable_ip_reputation`	سمعة IP
`threat_mesh`	`disable_threat_mesh`، `enable_threat_mesh`	شبكة التهديدات
`malicious_user_detection`	`disable_malicious_user_detection`، `enable_malicious_user_detection`	اكتشاف المستخدم الخبيث

مجموعات حماية DDoS (4 مجموعات)

اسم المجموعة	الحقول	الوصف
`ddos_mitigation`	`mitigation_block`، `mitigation_challenge`، `mitigation_none`	إجراء التخفيف من DDoS
`ddos_rps_threshold`	`default_rps_threshold`، `custom_rps_threshold`	حد الطلبات في الثانية
`ddos_clientside_action`	`clientside_action_none`، `clientside_action_javascript`، `clientside_action_captcha`	إجراء التحقق من DDoS من جهة العميل
`ddos_policy`	`ddos_policy_none`، `ddos_policy_ref`	الإشارة إلى سياسة DDoS أو لا شيء

مجموعات الإعدادات الأخرى (6 مجموعات)

اسم المجموعة	الحقول	الوصف
`challenge`	`no_challenge`، `js_challenge`، `captcha_challenge`	نوع تحدي العميل لاكتشاف Bot
`user_identification`	`user_id_client_ip`، `user_identification`	طريقة تحديد هوية المستخدم
`client_ip_headers`	`disable_trust_client_ip_headers`، `enable_trust_client_ip_headers`	الثقة برأسيات IP العميل أو عدمها
`timeouts`	`system_default_timeouts`، `custom_timeouts`	استخدام مهل النظام الافتراضية أو المخصصة
`service_policies_source`	`service_policies_from_namespace`، `active_service_policies`	سياسات الخدمة من مساحة الاسم أو القائمة النشطة
`sensitive_data_policy`	`default_sensitive_data_policy`، `custom_sensitive_data_policy`	استخدام سياسة البيانات الحساسة الافتراضية أو المخصصة

توصيات صيغة OneOf (امتداد مستقبلي)

الحالة: لم تُطبَّق بعد على مخططات http_loadbalancer.

على عكس healthcheck الذي يتضمن x-f5xc-recommended-oneof-variant للإشارة إلى الخيار الأكثر شيوعًا لمجموعات OneOf، يفتقر http_loadbalancer حاليًا إلى هذا الامتداد.

المقارنة مع Healthcheck

Healthcheck (مُنفَّذ):

viewshealthcheckCreateSpecType:
  x-f5xc-recommended-oneof-variant:
    health_check: "http_health_check"

HTTP LoadBalancer (غير مُنفَّذ بعد):

viewshttp_loadbalancerCreateSpecType:
  x-f5xc-recommended-oneof-variant: null  # Would indicate recommended lb_type variant

التنفيذ المستقبلي

لإضافة هذا الامتداد لـ http_loadbalancer:

رصد الاختيارات الافتراضية في وحدة تحكم F5 XC (مثل نوع lb_type الذي يكون محددًا مسبقًا في واجهة المستخدم)
إضافة التهيئة إلى config/discovered_defaults.yaml
إعادة تشغيل خط أنابيب الإثراء لتطبيق الامتداد

البنية المتوقعة عند الإضافة:

viewshttp_loadbalancerCreateSpecType:
  x-f5xc-recommended-oneof-variant:
    loadbalancer_type: "https_auto_cert"  # Example - requires verification

سيُمكِّن هذا الامتداد الأدوات الخارجية من تحديد الصيغة الأكثر استخدامًا مسبقًا عند عرض خيارات التهيئة للمستخدمين.

بيانات القيود الوصفية

الحقول المُعلَّمة بـ x-f5xc-constraints تتضمن قيود التحقق المكتشفة من تحليل API.

قيود المصفوفات

الحقل	minItems	maxItems	uniqueItems
`spec.domains`	1	-	false
`spec.routes`	1	256	false
`spec.blocked_clients`	1	128	true
`spec.trusted_clients`	1	128	true
`spec.data_guard_rules`	1	256	true

قيود الأعداد الصحيحة

الحقل	الحد الأدنى	الحد الأقصى	الافتراضي	الوصف
`spec.https_auto_cert.port`	1	65535	443	رقم منفذ HTTPS
`spec.https_auto_cert.connection_idle_timeout`	1000	3600000	120000	مهلة الاتصال الخاملة (بالميلي ثانية، من 1 ثانية إلى 1 ساعة)

قيود التعداد

الحقل	القيم	الافتراضي	الوصف
`spec.https_auto_cert.tls_config`	`default_security`، `medium_security`، `low_security`، `custom_security`	`default_security`	مستوى أمان TLS
`spec.https_auto_cert.header_transformation_type`	`legacy_header_transformation`، `proper_header_transformation`، `preserve_case_header_transformation`	`legacy_header_transformation`	تحويل رأسية HTTP
`spec.https_auto_cert.http_protocol_options`	`http_protocol_enable_v1_only`، `http_protocol_enable_v1_v2`، `http_protocol_enable_v2_only`	`http_protocol_enable_v1_v2`	إصدارات بروتوكول HTTP
`spec.https_auto_cert.coalescing_options`	`default_coalescing`، `disable_coalescing`، `enable_for_same_origin`	`default_coalescing`	دمج اتصال HTTP/2
`spec.load_balancing_algorithm`	`round_robin`، `least_request`، `ring_hash`، `random`	`round_robin`	خوارزمية موازنة التحميل
`spec.l7_ddos_protection.mitigation`	`mitigation_block`، `mitigation_challenge`، `mitigation_none`	`mitigation_block`	إجراء التخفيف من DDoS للطبقة السابعة
`spec.l7_ddos_protection.rps_threshold`	`default_rps_threshold`، `custom_rps_threshold`	`default_rps_threshold`	حد RPS لاكتشاف DDoS
`spec.l7_ddos_protection.clientside_action`	`clientside_action_none`، `clientside_action_javascript`، `clientside_action_captcha`	`clientside_action_none`	التحقق من DDoS من جهة العميل
`spec.challenge`	`no_challenge`، `js_challenge`، `captcha_challenge`	`no_challenge`	نوع تحدي العميل
`spec.advertising`	`advertise_on_public_default_vip`، `advertise_on_public`، `advertise_custom`، `do_not_advertise`	`advertise_on_public_default_vip`	إعلان موازن التحميل

تكامل سير العمل الموجَّه

يضيف خط أنابيب الإثراء بيانات x-f5xc-guided-workflows الوصفية على مستوى المواصفة. توفر هذه سير العمل إرشادات نشر خطوة بخطوة يستهلكها مساعدو الذكاء الاصطناعي وأدوات سطر الأوامر.

نشر موازن تحميل HTTP

سير عمل من 5 خطوات لإنشاء موازن تحميل HTTP مهيَّأ بالكامل مع مجموعة خادم المصدر الخلفي (مُعرَّف في config/guided_workflows.yaml):

الخطوة	الإجراء	المورد	الحقول المطلوبة	اختياري
1	إنشاء Origin Pool	`origin_pool`	`name`، `origin_servers`، `port`	لا
2	تهيئة فحص الصحة	`healthcheck`	`name`، `http_health_check`	نعم
3	إرفاق فحص الصحة	-	-	نعم
4	إنشاء موازن تحميل HTTP	`http_loadbalancer`	`name`، `domains`، `http.port`	لا
5	التحقق من النشر	-	-	لا

المتطلبات الأساسية: مساحة اسم صالحة في المستأجر المستهدف، تطبيق خلفي يمكن الوصول إليه عبر IP أو DNS، شهادة SSL (اختيارية لـ HTTPS).

نشر موازن تحميل HTTPS مع TLS

سير عمل من 7 خطوات لإنشاء موازن تحميل HTTPS مع إنهاء SSL/TLS:

الخطوة	الإجراء	المورد	الحقول المطلوبة	اختياري
1	رفع شهادة SSL	`certificate`	`name`، `certificate_chain`، `private_key`	لا
2	إنشاء Origin Pool	`origin_pool`	`name`، `origin_servers`	لا
3	تهيئة فحص الصحة	`healthcheck`	-	نعم
4	تهيئة سياسة WAF	`app_firewall`	-	نعم
5	إنشاء موازن تحميل HTTPS	`http_loadbalancer`	`name`، `domains`، `https.tls_parameters`	لا
6	إرفاق سياسة WAF	-	-	نعم
7	التحقق من نشر HTTPS	-	-	لا

المتطلبات الأساسية: مساحة اسم صالحة في المستأجر المستهدف، شهادة SSL ومفتاح خاص، تطبيق خلفي يمكن الوصول إليه.

استهلاك سير العمل

تستخدم الأدوات الخارجية هذه سير العمل لإرشاد المستخدمين خلال عمليات النشر متعددة الخطوات:

xcsh CLI: يعرض سير العمل كأوامر موجَّهة تفاعلية (مثل xcsh deploy http-lb)
إضافة VS Code: تعرض خطوات سير العمل في لوحة جانبية مع تتبع التقدم
مساعدو الذكاء الاصطناعي: يتبعون خطوات سير العمل بشكل تسلسلي، وينشئون كل مورد ويتحققون من التبعيات

مرجع امتدادات OpenAPI

تُضاف هذه الامتدادات الخاصة بالبائع إلى مخطط OpenAPI القياسي لنقل البيانات الوصفية الخاصة بـ F5 XC.

x-f5xc-cli-domain

النوع: string

يشير إلى تصنيف النطاق لتنظيم واجهة سطر الأوامر والأدوات.

viewshttp_loadbalancerCreateSpecType:
  type: object
  x-f5xc-cli-domain: "virtual"

x-f5xc-minimum-configuration

النوع: object

يوفر بيانات وصفية شاملة لإنشاء الحد الأدنى من التهيئات القابلة للتطبيق. يتضمن:

الوصف
الحقول المطلوبة مع القيود
المجموعات المتنافية
أمثلة التهيئة (YAML، JSON)
أمثلة أوامر curl

viewshttp_loadbalancerCreateSpecType:
  type: object
  x-f5xc-minimum-configuration:
    description: "HTTP/HTTPS load balancer for distributing traffic across origin pools"
    required_fields:
      - "metadata.name"
      - "metadata.namespace"
      - "spec.domains"
    mutually_exclusive_groups:
      - name: "lb_type"
        fields: ["spec.http", "spec.https", "spec.https_auto_cert", "spec.http_https"]
        reason: "Choose exactly one load balancer type"
    example_yaml: |
      ...
    example_json: |
      ...
    example_curl: |
      ...

x-f5xc-server-default

النوع: boolean

عندما تكون true، يشير إلى أن قيمة default المرفقة يُطبِّقها خادم F5 XC API. يمكن حذف الحقول التي تحمل هذا الامتداد بأمان من طلبات API — يُطبِّق الخادم القيمة الافتراضية تلقائيًا.

disable_waf:
  type: object
  default: {}
  x-f5xc-server-default: true

x-f5xc-conflicts-with

النوع: array of strings

يسرد أسماء الحقول التي تتعارض مع الحقل الحالي، مشيرًا إلى أنماط OneOf.

advertise_custom:
  type: object
  x-f5xc-conflicts-with:
    - advertise_on_public
    - advertise_on_public_default_vip
    - do_not_advertise

x-f5xc-constraints

النوع: object

يوفر قيود التحقق بما فيها حدود حجم المصفوفة، ونطاقات الأعداد الصحيحة، ومتطلبات التفرد، وبيانات الاكتشاف الوصفية.

routes:
  type: array
  x-f5xc-constraints:
    constraintType: "array"
    minItems: 1
    maxItems: 256
    uniqueItems: false
    metadata:
      source: "discovery"
      confidence: 0.99
      validatedAt: "2026-01-19T12:00:00Z"

port:
  type: integer
  x-f5xc-constraints:
    constraintType: "number"
    minimum: 1
    maximum: 65535
    metadata:
      source: "discovery"
      confidence: 0.99

x-f5xc-description-short وx-f5xc-description-medium

النوع: string

يوفر أطوالًا بديلة للوصف لحالات الاستخدام المختلفة:

x-f5xc-description-short: 60 حرفًا كحد أقصى (أعمدة CLI، الشارات)
x-f5xc-description-medium: 150 حرفًا كحد أقصى (تلميحات الأدوات، الملخصات)

domains:
  type: array
  description: "List of domains the load balancer will serve"
  x-f5xc-description-short: "Domains to serve"
  x-f5xc-description-medium: "List of domains for which the load balancer accepts traffic"

x-f5xc-example

النوع: any (يطابق نوع الحقل)

يوفر أمثلة حقل ملموسة للتوثيق والأدوات.

name:
  type: string
  x-f5xc-example: "example-app"

domains:
  type: array
  x-f5xc-example: ["example.com", "www.example.com"]

x-f5xc-required-for

النوع: array of strings

يشير إلى المتطلبات الخاصة بالسياق باستخدام الأعلام: minimum_config، create، update، read.

metadata.name:
  type: string
  x-f5xc-required-for: ["minimum_config", "create"]

metadata.uid:
  type: string
  x-f5xc-required-for: ["read"]

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

مواصفات OpenAPI

الملف	المحتوى
`docs/specifications/api/virtual.json`	جميع مخططات http_loadbalancer مع عمليات الإثراء
`docs/specifications/api/openapi.json`	المواصفة المدموجة مع جميع المخططات

ملفات التهيئة

الملف	الغرض
`config/minimum_configs.yaml`	مصدر بيانات الحد الأدنى من التهيئة الوصفية
`config/constraint_patterns.yaml`	تعريفات نمط القيود
`config/guided_workflows.yaml`	تعريفات خطوات سير العمل الموجَّهة
`config/domain_descriptions.yaml`	بيانات وصف مستوى النطاق الوصفية

المخططات المُثرَاة

viewshttp_loadbalancerCreateSpecType - مخطط عملية الإنشاء
viewshttp_loadbalancerReplaceSpecType - مخطط عملية التحديث
viewshttp_loadbalancerGetSpecType - مخطط عملية القراءة

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

دليل التطوير - امتدادات OpenAPI - تعريفات الامتدادات واستخدامها
تحسينات Healthcheck - إثراءات مخطط Healthcheck (تتضمن x-f5xc-recommended-oneof-variant)
تحسينات Origin Pool - إثراءات مخطط Origin Pool
دليل بيانات القيود الوصفية - توثيق مفصّل للتحقق من القيود

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

الإصدار	التاريخ	التغييرات
2.0.46	2026-04-18	إضافة الإعدادات الافتراضية المُطبَّقة من الخادم، وتكامل سير العمل الموجَّه، وتوسيع قسم الحد الأدنى من التهيئة
2.0.45	2026-01-20	التوثيق الأوّلي لإثراءات http_loadbalancer