CRD de la API de Gateway compatibles

Last published : Oct 02, 2026
Las siguientes secciones describen los parámetros compatibles para cada CRD de la API de Gateway de Kubernetes en la última versión publicada. Cualquier parámetro o CRD fuera de los parámetros compatibles enumerados en este tema no es compatible actualmente.
Related information
Descripción general

CRD de clase de Gateway

Propiedad Descripción Estado
spec.controllerName El nombre del controlador que debe coincidir con el nombre proporcionado al implementar el controlador. Compatible
spec.description Descripción de la GatewayClass legible para humanos. Compatible
status.conditions El estado de esta GatewayClass del controlador se puede encontrar en «Conditions». Compatible

CRD de Gateway

Propiedad Descripción Estado
spec.addresses La lista de direcciones IP. El controlador utiliza todas las direcciones y crea un ipset. El controlador utiliza el ipset como dirección IP virtual de un servidor virtual de conmutación de contenido creado en NetScaler. Compatible
spec.gatewayClassName El nombre de la GatewayClass a la que pertenece esta Gateway. Compatible
spec.listeners La lista de puntos finales de red (listeners) que expone la Gateway. Compatible
spec.listeners.name El nombre del listener. Este nombre debe ser único dentro de una Gateway. Soportado
spec.listeners[].port El número de puerto para el oyente. El controlador utiliza este puerto como puerto de servidor virtual de conmutación de contenido creado en NetScaler. Soportado
spec.listeners[].protocol El protocolo de red que el oyente espera recibir. El controlador utiliza este protocolo como dirección IP del servidor virtual de un servidor virtual de conmutación de contenido creado en NetScaler. Soportado
spec.listeners[].tls.certificateRefs CertificateRefs contiene una serie de referencias a objetos de Kubernetes que contienen certificados TLS y claves privadas. Actualmente, el controlador solo admite secretos de Kubernetes. Parcialmente Soportado

CRD de HTTProute

Propiedad Descripción Estado
spec.hostnames La lista de nombres de host que coincide con esta ruta. El controlador utiliza el nombre de host en la expresión de la regla de la política de conmutación de contenido. Compatible
spec.parentRefs[] Las referencias a las Gateways a las que se adjunta esta ruta. Parcialmente compatible
spec.parentRefs[].kind El controlador solo admite los siguientes parentRefs: Gateway Parcialmente compatible
spec.parentRefs[].name El nombre del recurso Gateway. Compatible
spec.parentRefs[].namespace El espacio de nombres del recurso Gateway. Compatible
spec.rules[] El controlador utiliza estas reglas para generar la expresión de la regla de la política de conmutación de contenido. Compatible
spec.rules[].matches El controlador utiliza la ruta, el método, los parámetros de consulta, los encabezados, etc., para elaborar la regla de la política de conmutación de contenido en NetScaler. Compatible
spec.rules[].backendRefs Actualmente, el controlador solo admite los siguientes backendRefs: service, name, namespace y port. Parcialmente compatible
spec.rules[].filters El controlador admite los siguientes filtros: urlRewrite, requestRedirect, responseHeaderModifier, requestHeaderModifier, extensionRef Parcialmente compatible

CRD de TCPRoute

TCPRoute permite el enrutamiento del tráfico TCP desde un oyente de Gateway a los servicios de backend de Kubernetes.
Propiedad Descripción Estado
spec.parentRefs[] Las referencias a los Gateways a los que se adjunta esta ruta Parcialmente compatible
spec.parentRefs[].kind Actualmente, el controlador solo admite los siguientes parentRefs: Gateway Compatible
spec.parentRefs[].name El nombre del recurso Gateway. Compatible
spec.parentRefs[].namespace El espacio de nombres del recurso Gateway. Compatible
spec.parentRefs[].sectionName El nombre de un listener de Gateway específico al que adjuntar. Soportado
spec.rules[] Lista de reglas que definen cómo se enruta el tráfico TCP a los servicios de backend. Soportado
spec.rules[].backendRefs[] Actualmente, el controlador solo admite los siguientes backendRefs: service, name, namespace, port. Parcialmente soportado

CRD de UDPRoute

UDPRoute permite el enrutamiento del tráfico UDP desde un oyente de Gateway a los servicios de backend de Kubernetes.
Propiedad Descripción Estado
spec.parentRefs[] Las referencias a los Gateways a los que se adjunta esta ruta Parcialmente soportado
spec.parentRefs[].kind Actualmente, el controlador solo admite los siguientes parentRefs: Gateway Compatible
spec.parentRefs[].name El nombre del recurso Gateway. Compatible
spec.parentRefs[].namespace El espacio de nombres del recurso Gateway. Compatible
spec.parentRefs[].sectionName El nombre de un oyente de Gateway específico al que adjuntar. Compatible
spec.rules[] Lista de reglas que definen cómo se enruta el tráfico UDP a los servicios de backend. Compatible
spec.rules[].backendRefs[] Actualmente, el controlador solo admite los siguientes backendRefs: service, name, namespace, port Parcialmente compatible

Puntos a tener en cuenta

  • El controlador solo considera los parámetros admitidos enumerados anteriormente; cualquier parámetro no admitido se ignora.
  • Las versiones futuras podrían ampliar la compatibilidad con parámetros adicionales.
  • Asegúrese de que gatewayClassName esté configurado correctamente para los recursos de Gateway para que el controlador los reconozca.
  • Todos los parentRefs en HTTPRoute deben hacer referencia correctamente a Gateways existentes y válidos.
  • Las actualizaciones de estado se gestionan dinámicamente y pueden tardar en reflejarse según la carga del sistema.
  • Se deben supervisar los registros para detectar cualquier error de análisis o validación al aplicar los CRD.
  • Las direcciones IP utilizadas en Gateway CRD no se pueden compartir con Ingresses o recursos de Citrix® Listener.