Miglioramenti dell'Origin Pool

Metadati di arricchimento per gli schemi relativi a origin_pool. Vedere Estensioni OpenAPI per le definizioni delle estensioni.

Schemi arricchiti

Pattern

Tutti gli schemi corrispondenti a origin_pool.*SpecType ricevono arricchimenti:

• origin_poolCreateSpecType
• origin_poolReplaceSpecType
• origin_poolGetSpecType

Campi obbligatori

Campo	Obbligatorio per	Note
metadata.name	Tutte le operazioni	1-63 caratteri, alfanumerico minuscolo, pattern: ^[a-z0-9]([-a-z0-9]*[a-z0-9])?$
metadata.namespace	Tutte le operazioni	Identificatore namespace
spec.origin_servers	Creazione	Minimo 1 elemento
spec.port	Creazione	1-65535, nessun valore predefinito del server

Configurazione minima necessaria

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

Valori predefiniti applicati dal server

I campi contrassegnati con x-f5xc-server-default: true hanno il loro valore default applicato dal server API F5 XC quando vengono omessi dalle richieste.

Campi di livello superiore

Campo	Valore predefinito	Tipo	Descrizione
no_tls	{}	object	TLS verso l’origine disabilitato
healthcheck	[]	array	Nessun controllo di integrità configurato
loadbalancer_algorithm	ROUND_ROBIN	enum	Bilanciamento del carico round-robin
endpoint_selection	DISTRIBUTED	enum	Utilizza tutti gli endpoint (locali + remoti)

Valori predefiniti di advanced_options

Quando advanced_options non è specificato, il server si comporta come se fossero impostati questi valori:

Campo	Valore predefinito	Tipo	Descrizione
connection_timeout	2000	integer	Timeout di connessione in millisecondi
http_idle_timeout	300000	integer	Timeout di inattività HTTP in millisecondi (5 min)
same_as_endpoint_port	{}	object	Il controllo di integrità utilizza la porta dell’endpoint
default_circuit_breaker	{}	object	Impostazioni predefinite del circuit breaker
disable_outlier_detection	{}	object	Rilevamento degli outlier disabilitato
no_panic_threshold	{}	object	Nessuna soglia di panico
disable_subsets	{}	object	Bilanciamento del carico per subset disabilitato
auto_http_config	{}	object	Negoziazione automatica del protocollo HTTP
disable_proxy_protocol	{}	object	Protocollo proxy disabilitato
disable_lb_source_ip_persistance	{}	object	Persistenza IP sorgente LB disabilitata

Valori predefiniti degli oggetti annidati

Percorso	Valore predefinito	Descrizione
origin_servers[].labels	{}	Oggetto labels vuoto
origin_servers[].public_name.refresh_interval	0	Utilizza l’aggiornamento DNS predefinito del sistema

Discrepanze tra UI e valori predefiniti del server

L’interfaccia web F5 XC preseleziona valori diversi rispetto a quelli applicati dall’API quando i campi vengono omessi.

Campo	Preselezionato nell’UI	Applicato dal server	Nota
loadbalancer_algorithm	LB_OVERRIDE	ROUND_ROBIN	Le risorse create tramite UI e tramite API differiscono quando il campo viene omesso

Valori enum

loadbalancer_algorithm

Valore	Descrizione	Note
ROUND_ROBIN	Ogni endpoint integro viene selezionato in ordine round-robin	Valore predefinito del server
LEAST_REQUEST	Viene selezionato l’endpoint con il minor numero di richieste attive
RING_HASH	Hashing consistente tramite ring hash dei nomi degli endpoint
RANDOM	Selezione casuale di un endpoint integro
LB_OVERRIDE	Politica di hash ereditata dal load balancer padre	Valore predefinito dell’UI

endpoint_selection

Valore	Descrizione	Note
DISTRIBUTED	Considera sia gli endpoint remoti che quelli locali	Valore predefinito del server
LOCAL_ONLY	Vengono utilizzati solo gli endpoint locali
LOCAL_PREFERRED	Preferisce gli endpoint locali, si affida a quelli remoti se non disponibili

Gruppi di campi OneOf

Gruppi di campi mutuamente esclusivi. È possibile specificare UN SOLO campo per ciascun gruppo:

Gruppo	Campi	Valore predefinito del server
Configurazione porta	port, automatic_port, lb_port	port (esplicito)
TLS verso l’origine	no_tls, use_tls	no_tls
Porta controllo di integrità	same_as_endpoint_port, health_check_port	same_as_endpoint_port
Circuit Breaker	default_circuit_breaker, disable_circuit_breaker, circuit_breaker	default_circuit_breaker
Rilevamento outlier	disable_outlier_detection, outlier_detection	disable_outlier_detection
Soglia di panico	no_panic_threshold, panic_threshold	no_panic_threshold
Subset LB	disable_subsets, enable_subsets	disable_subsets
Protocollo HTTP	auto_http_config, http1_config, http2_options	auto_http_config
Protocollo proxy	disable_proxy_protocol, proxy_protocol_v1, proxy_protocol_v2	disable_proxy_protocol
IP sorgente LB	disable_lb_source_ip_persistance, enable_lb_source_ip_persistance	disable_lb_source_ip_persistance
Pool di connessioni	enable_conn_pool_reuse, disable_conn_pool_reuse	enable_conn_pool_reuse

Vincoli dei campi

Campo	Tipo	Vincolo
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 (percentuale)
metadata.name	string	1-63 caratteri, pattern: ^[a-z0-9]([-a-z0-9]*[a-z0-9])?$

Opzioni di configurazione dell’UI

La console web F5 XC presenta 15 opzioni di configurazione per gli origin pool:

#	Etichetta UI	Percorso campo API	Tipo	Valore predefinito del server
1	Porta del server di origine	spec.[port|automatic_port|lb_port]	OneOf	port (esplicito)
2	Riutilizzo pool di connessioni	spec.[enable_conn_pool_reuse|disable_conn_pool_reuse]	OneOf	enable_conn_pool_reuse
3	Porta controllo di integrità	spec.advanced_options.[same_as_endpoint_port|health_check_port]	OneOf	same_as_endpoint_port
4	Algoritmo LoadBalancer	spec.loadbalancer_algorithm	enum	ROUND_ROBIN
5	Selezione endpoint	spec.endpoint_selection	enum	DISTRIBUTED
6	TLS verso l’origine	spec.[no_tls|use_tls]	OneOf	no_tls
7	Timeout connessione	spec.advanced_options.connection_timeout	integer	2000 ms
8	Timeout inattività HTTP	spec.advanced_options.http_idle_timeout	integer	300000 ms
9	Circuit Breaker	spec.advanced_options.[default_circuit_breaker|disable_circuit_breaker|circuit_breaker]	OneOf	default_circuit_breaker
10	Rilevamento outlier	spec.advanced_options.[disable_outlier_detection|outlier_detection]	OneOf	disable_outlier_detection
11	Soglia di panico	spec.advanced_options.[no_panic_threshold|panic_threshold]	OneOf	no_panic_threshold
12	Bilanciamento del carico per subset	spec.advanced_options.[disable_subsets|enable_subsets]	OneOf	disable_subsets
13	Protocollo HTTP	spec.advanced_options.[auto_http_config|http1_config|http2_options]	OneOf	auto_http_config
14	Protocollo proxy	spec.advanced_options.[disable_proxy_protocol|proxy_protocol_v1|proxy_protocol_v2]	OneOf	disable_proxy_protocol
15	Persistenza IP sorgente LB	spec.advanced_options.[disable_lb_source_ip_persistance|enable_lb_source_ip_persistance]	OneOf	disable_lb_source_ip_persistance

Accesso ai dati

Specifiche OpenAPI

File	Contenuto
docs/specifications/api/virtual.json	origin_poolCreateSpecType, origin_poolReplaceSpecType, origin_poolGetSpecType
docs/specifications/api/openapi.json	Specifica unificata con tutti gli schemi

Struttura di validation.json

defaults.resources.origin_pool
├── server_applied      # Campi con x-f5xc-server-default: true
├── recommended         # Campi con x-f5xc-recommended-value
├── advanced_options    # Valori predefiniti di advanced_options annidati
├── oneof_choices       # Selezioni predefinite OneOf
└── ui_vs_server        # Discrepanze tra UI e server

Tipi di server di origine

I server di origine possono essere specificati utilizzando diversi tipi varianti. Il tipo determina quali campi aggiuntivi sono obbligatori.

Tipi implementati

Tipo	Descrizione	Campi obbligatori	Stato
public_name	Server di origine con nome DNS pubblico	dns_name	✅ Completo
public_ip	Server di origine con indirizzo IP pubblico	ip (IPv4)	✅ Completo

Esempio: public_name

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

Esempio: public_ip

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

TODO: Tipi di server di origine dipendenti dal sito

I seguenti tipi di server di origine richiedono lo sviluppo della logica delle risorse “site” prima dell’implementazione:

Tipo	Descrizione	Campi obbligatori	Stato
private_ip	Server di origine con IP privato/pubblico e informazioni sul sito	ip, site_locator, network_choice, snat_pool	🔲 In attesa della logica del sito
private_name	Server di origine con nome DNS e informazioni sul sito	dns_name, site_locator, network_choice, snat_pool	🔲 In attesa della logica del sito
k8s_service	Servizio Kubernetes con informazioni sul sito	service_name, site_locator, network_choice	🔲 In attesa della logica del sito
consul_service	Servizio HashiCorp Consul con informazioni sul sito	service_name, site_locator, network_choice	🔲 In attesa della logica del sito

Requisiti di implementazione

Prima che questi tipi possano essere completamente documentati:

1. Individuazione delle risorse sito - Documentare lo schema della risorsa site e i pattern site_locator
2. Enum della scelta di rete - Documentare i valori vincolati di network_choice (site_local_inside, site_local_outside, ecc.)
3. Opzioni pool SNAT - Documentare i pattern di configurazione del pool SNAT
4. Riferimenti tra risorse - Definire come origin_pool fa riferimento alle risorse sito

Tracciamento

• Segnaposto di configurazione: config/discovered_defaults.yaml → origin_pool.origin_server_types.enums
• Sprint correlato: Arricchimenti degli schemi delle risorse sito

Documentazione correlata

• Guida allo sviluppo - Estensioni OpenAPI - Definizioni e utilizzo delle estensioni
• Specifica di validazione - Formato e struttura di validation.json
• Miglioramenti Healthcheck - Arricchimenti degli schemi healthcheck

Registro delle modifiche

Versione	Data	Modifiche
2.1.2	2026-01-18	Aggiunta sezione sui tipi di server di origine con public_name/public_ip; marcatori TODO per i tipi dipendenti dal sito
2.1.1	2026-01-18	Riscritto come riferimento API puro; rimossi gli esempi di codice downstream
2.1.0	2026-01-18	Aggiornato alla struttura dei valori predefiniti unificata in validation.json
2.0.33	2026-01-17	Documentazione iniziale dei miglioramenti dell’origin pool