ऑरिजिन पूल संवर्द्धन

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`	बनाना	न्यूनतम 1 आइटम
`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	LB सोर्स IP पर्सिस्टेंस अक्षम

नेस्टेड ऑब्जेक्ट डिफ़ॉल्ट

पथ	डिफ़ॉल्ट मान	विवरण
`origin_servers[].labels`	`{}`	खाली लेबल ऑब्जेक्ट
`origin_servers[].public_name.refresh_interval`	`0`	सिस्टम डिफ़ॉल्ट DNS रिफ्रेश का उपयोग करें

UI और सर्वर डिफ़ॉल्ट के बीच अंतर

F5 XC वेब UI उन मानों को पूर्व-चयनित करता है जो API द्वारा फ़ील्ड छोड़े जाने पर लागू किए गए मानों से भिन्न होते हैं।

फ़ील्ड	UI पूर्व-चयनित	सर्वर लागू	नोट
`loadbalancer_algorithm`	`LB_OVERRIDE`	`ROUND_ROBIN`	जब फ़ील्ड छोड़ा जाए तो UI-निर्मित और API-निर्मित संसाधन भिन्न होते हैं

Enum मान

loadbalancer_algorithm

मान	विवरण	नोट्स
`ROUND_ROBIN`	प्रत्येक स्वस्थ एंडपॉइंट को राउंड-रॉबिन क्रम में चुना जाता है	सर्वर डिफ़ॉल्ट
`LEAST_REQUEST`	सबसे कम सक्रिय अनुरोधों वाला एंडपॉइंट चुना जाता है
`RING_HASH`	एंडपॉइंट नामों के रिंग हैश का उपयोग करके कंसिस्टेंट हैशिंग
`RANDOM`	यादृच्छिक स्वस्थ एंडपॉइंट चयन
`LB_OVERRIDE`	हैश पॉलिसी पैरेंट लोड बैलेंसर से इनहेरिट की गई	UI डिफ़ॉल्ट

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`
सबसेट LB	`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`
LB सोर्स 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])?$`

UI कॉन्फ़िगरेशन विकल्प

F5 XC वेब कंसोल ऑरिजिन पूल के लिए 15 कॉन्फ़िगरेशन विकल्प प्रस्तुत करता है:

#	UI लेबल	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	LB सोर्स 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        # UI और सर्वर के बीच अंतर

ऑरिजिन सर्वर प्रकार

ऑरिजिन सर्वर को विभिन्न प्रकार के वेरिएंट का उपयोग करके निर्दिष्ट किया जा सकता है। प्रकार यह निर्धारित करता है कि कौन से अतिरिक्त फ़ील्ड आवश्यक हैं।

कार्यान्वित प्रकार

प्रकार	विवरण	आवश्यक फ़ील्ड	स्थिति
`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
संबंधित स्प्रिंट: साइट संसाधन स्कीमा संवर्धन

परिवर्तन लॉग

संस्करण	दिनांक	परिवर्तन
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	प्रारंभिक ऑरिजिन पूल संवर्द्धन दस्तावेज़ीकरण