Mejoras del Pool de Origen

Metadatos de enriquecimiento para esquemas relacionados con origin_pool. Consulte Extensiones de OpenAPI para las definiciones de extensiones.

Esquemas Enriquecidos

Patrón

Todos los esquemas que coinciden con origin_pool.*SpecType reciben enriquecimientos:

• origin_poolCreateSpecType
• origin_poolReplaceSpecType
• origin_poolGetSpecType

Campos Requeridos

Campo	Requerido Para	Notas
metadata.name	Todas las operaciones	1-63 caracteres, alfanumérico en minúsculas, patrón: ^[a-z0-9]([-a-z0-9]*[a-z0-9])?$
metadata.namespace	Todas las operaciones	Identificador de namespace
spec.origin_servers	Creación	Mínimo 1 elemento
spec.port	Creación	1-65535, sin valor predeterminado del servidor

Configuración Mínima Viable

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

Valores Predeterminados Aplicados por el Servidor

Los campos marcados con x-f5xc-server-default: true tienen su valor default aplicado por el servidor de la API de F5 XC cuando se omiten de las solicitudes.

Campos de Nivel Superior

Campo	Valor Predeterminado	Tipo	Descripción
no_tls	{}	object	TLS al origen deshabilitado
healthcheck	[]	array	Sin verificaciones de salud configuradas
loadbalancer_algorithm	ROUND_ROBIN	enum	Balanceo de carga round-robin
endpoint_selection	DISTRIBUTED	enum	Usar todos los endpoints (locales + remotos)

Valores Predeterminados de advanced_options

Cuando no se especifica advanced_options, el servidor se comporta como si estos valores estuvieran configurados:

Campo	Valor Predeterminado	Tipo	Descripción
connection_timeout	2000	integer	Tiempo de espera de conexión en milisegundos
http_idle_timeout	300000	integer	Tiempo de espera de inactividad HTTP en milisegundos (5 min)
same_as_endpoint_port	{}	object	La verificación de salud utiliza el puerto del endpoint
default_circuit_breaker	{}	object	Configuración predeterminada del circuit breaker
disable_outlier_detection	{}	object	Detección de valores atípicos deshabilitada
no_panic_threshold	{}	object	Sin umbral de pánico
disable_subsets	{}	object	Balanceo de carga por subconjunto deshabilitado
auto_http_config	{}	object	Negociación automática del protocolo HTTP
disable_proxy_protocol	{}	object	Protocolo proxy deshabilitado
disable_lb_source_ip_persistance	{}	object	Persistencia de IP de origen de LB deshabilitada

Valores Predeterminados de Objetos Anidados

Ruta	Valor Predeterminado	Descripción
origin_servers[].labels	{}	Objeto de etiquetas vacío
origin_servers[].public_name.refresh_interval	0	Usar actualización DNS predeterminada del sistema

Discrepancias entre la Interfaz de Usuario y el Servidor

La interfaz web de F5 XC preselecciona valores diferentes a los que aplica la API cuando se omiten los campos.

Campo	Preseleccionado en UI	Aplicado por Servidor	Nota
loadbalancer_algorithm	LB_OVERRIDE	ROUND_ROBIN	Los recursos creados desde la UI y los creados por API difieren cuando el campo se omite

Valores de Enumeración

loadbalancer_algorithm

Valor	Descripción	Notas
ROUND_ROBIN	Cada endpoint saludable es seleccionado en orden round-robin	Predeterminado del servidor
LEAST_REQUEST	Se selecciona el endpoint con menos solicitudes activas
RING_HASH	Hashing consistente usando ring hash de nombres de endpoints
RANDOM	Selección aleatoria de endpoint saludable
LB_OVERRIDE	Política de hash heredada del balanceador de carga padre	Predeterminado de UI

endpoint_selection

Valor	Descripción	Notas
DISTRIBUTED	Considerar tanto endpoints remotos como locales	Predeterminado del servidor
LOCAL_ONLY	Solo se usan endpoints locales
LOCAL_PREFERRED	Preferir local, recurrir a remoto si no está disponible

Grupos de Campos OneOf

Grupos de campos mutuamente excluyentes. Solo SE PUEDE especificar UN campo de cada grupo:

Grupo	Campos	Predeterminado del Servidor
Configuración de Puerto	port, automatic_port, lb_port	port (explícito)
TLS al Origen	no_tls, use_tls	no_tls
Puerto de Verificación de Salud	same_as_endpoint_port, health_check_port	same_as_endpoint_port
Circuit Breaker	default_circuit_breaker, disable_circuit_breaker, circuit_breaker	default_circuit_breaker
Detección de Valores Atípicos	disable_outlier_detection, outlier_detection	disable_outlier_detection
Umbral de Pánico	no_panic_threshold, panic_threshold	no_panic_threshold
LB por Subconjunto	disable_subsets, enable_subsets	disable_subsets
Protocolo HTTP	auto_http_config, http1_config, http2_options	auto_http_config
Protocolo Proxy	disable_proxy_protocol, proxy_protocol_v1, proxy_protocol_v2	disable_proxy_protocol
IP de Origen de LB	disable_lb_source_ip_persistance, enable_lb_source_ip_persistance	disable_lb_source_ip_persistance
Pool de Conexiones	enable_conn_pool_reuse, disable_conn_pool_reuse	enable_conn_pool_reuse

Restricciones de Campos

Campo	Tipo	Restricción
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 (porcentaje)
metadata.name	string	1-63 caracteres, patrón: ^[a-z0-9]([-a-z0-9]*[a-z0-9])?$

Opciones de Configuración de la Interfaz de Usuario

La consola web de F5 XC presenta 15 opciones de configuración para los origin pools:

#	Etiqueta en UI	Ruta del Campo API	Tipo	Predeterminado del Servidor
1	Puerto del Servidor de Origen	spec.[port|automatic_port|lb_port]	OneOf	port (explícito)
2	Reutilización del Pool de Conexiones	spec.[enable_conn_pool_reuse|disable_conn_pool_reuse]	OneOf	enable_conn_pool_reuse
3	Puerto de Verificación de Salud	spec.advanced_options.[same_as_endpoint_port|health_check_port]	OneOf	same_as_endpoint_port
4	Algoritmo del Balanceador de Carga	spec.loadbalancer_algorithm	enum	ROUND_ROBIN
5	Selección de Endpoint	spec.endpoint_selection	enum	DISTRIBUTED
6	TLS al Origen	spec.[no_tls|use_tls]	OneOf	no_tls
7	Tiempo de Espera de Conexión	spec.advanced_options.connection_timeout	integer	2000 ms
8	Tiempo de Espera de Inactividad 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	Detección de Valores Atípicos	spec.advanced_options.[disable_outlier_detection|outlier_detection]	OneOf	disable_outlier_detection
11	Umbral de Pánico	spec.advanced_options.[no_panic_threshold|panic_threshold]	OneOf	no_panic_threshold
12	Balanceo de Carga por Subconjunto	spec.advanced_options.[disable_subsets|enable_subsets]	OneOf	disable_subsets
13	Protocolo HTTP	spec.advanced_options.[auto_http_config|http1_config|http2_options]	OneOf	auto_http_config
14	Protocolo Proxy	spec.advanced_options.[disable_proxy_protocol|proxy_protocol_v1|proxy_protocol_v2]	OneOf	disable_proxy_protocol
15	Persistencia de IP de Origen de LB	spec.advanced_options.[disable_lb_source_ip_persistance|enable_lb_source_ip_persistance]	OneOf	disable_lb_source_ip_persistance

Acceso a los Datos

Especificaciones de API

Archivo	Contenido
docs/specifications/api/virtual.json	origin_poolCreateSpecType, origin_poolReplaceSpecType, origin_poolGetSpecType
docs/specifications/api/openapi.json	Especificación unificada con todos los esquemas

Estructura de validation.json

defaults.resources.origin_pool
├── server_applied      # Campos con x-f5xc-server-default: true
├── recommended         # Campos con x-f5xc-recommended-value
├── advanced_options    # Valores predeterminados de advanced_options anidados
├── oneof_choices       # Selecciones predeterminadas de OneOf
└── ui_vs_server        # Discrepancias entre UI y servidor

Tipos de Servidor de Origen

Los servidores de origen pueden especificarse usando diferentes variantes de tipo. El tipo determina qué campos adicionales son requeridos.

Tipos Implementados

Tipo	Descripción	Campos Requeridos	Estado
public_name	Servidor de origen con nombre DNS público	dns_name	✅ Completo
public_ip	Servidor de origen con dirección IP pública	ip (IPv4)	✅ Completo

Ejemplo: public_name

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

Ejemplo: public_ip

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

TODO: Tipos de Servidor de Origen Dependientes de Site

Los siguientes tipos de servidor de origen requieren el desarrollo de lógica de recursos “site” antes de su implementación:

Tipo	Descripción	Campos Requeridos	Estado
private_ip	Servidor de origen con IP privada/pública e información de site	ip, site_locator, network_choice, snat_pool	🔲 Pendiente de lógica de site
private_name	Servidor de origen con nombre DNS e información de site	dns_name, site_locator, network_choice, snat_pool	🔲 Pendiente de lógica de site
k8s_service	Servicio de Kubernetes con información de site	service_name, site_locator, network_choice	🔲 Pendiente de lógica de site
consul_service	Servicio de HashiCorp Consul con información de site	service_name, site_locator, network_choice	🔲 Pendiente de lógica de site

Requisitos de Implementación

Antes de que estos tipos puedan estar completamente documentados:

1. Descubrimiento de Recursos Site - Documentar el esquema del recurso site y los patrones de site_locator
2. Enumeración de Network Choice - Documentar los valores restringidos de network_choice (site_local_inside, site_local_outside, etc.)
3. Opciones de SNAT Pool - Documentar los patrones de configuración del SNAT pool
4. Referencias entre Recursos - Definir cómo origin_pool referencia los recursos site

Seguimiento

• Marcador de configuración: config/discovered_defaults.yaml → origin_pool.origin_server_types.enums
• Sprint relacionado: Enriquecimientos del esquema de recursos site

Documentación Relacionada

• Guía de Desarrollo - Extensiones de OpenAPI - Definiciones y uso de extensiones
• Especificación de Validación - Formato y estructura de validation.json
• Mejoras de Healthcheck - Enriquecimientos del esquema de healthcheck

Registro de Cambios

Versión	Fecha	Cambios
2.1.2	2026-01-18	Se agregó la sección de tipos de servidor de origen con public_name/public_ip; marcadores TODO para tipos dependientes de site
2.1.1	2026-01-18	Reescrito como referencia de API pura; se eliminaron ejemplos de código downstream
2.1.0	2026-01-18	Actualizado a la estructura de valores predeterminados unificada en validation.json
2.0.33	2026-01-17	Documentación inicial de mejoras del origin pool