K3S下基于Jaeger Operator的Collector配置Ingress暴露gRPC端口供外部Agent访问
核心问题定位与修正方案
一、现有配置的核心错误点
- 所有Ingress注解都是ingress-nginx控制器专属,和K3S默认搭载的Traefik Ingress控制器完全不兼容。之前配置的
kubernetes.io/ingress.class: "nginx"直接让Traefik判定这条Ingress不属于自己的管控范围,完全忽略这条资源,这也是自建的Collector Ingress没有分配入口IP、Traefik日志无相关路由记录、所有请求返回404纯文本响应的根本原因。 - 使用的
networking.k8s.io/v1beta1版本的Ingress API在K3S较新版本中已被弃用,存在资源解析异常的风险。 - 没有针对Traefik适配gRPC后端的转发规则,即使Ingress被正确加载,Traefik默认用HTTP/1.1协议转发流量,会和gRPC的明文HTTP/2协议不匹配,直接触发
Unimplemented类错误。 - 原配置的强制HTTPS跳转规则和当前Agent用80端口明文访问的场景冲突,gRPC客户端不会自动处理301跳转,会直接判定连接异常。
二、Traefik场景下的正确Collector Ingress配置
直接替换原有错误的simple-prod-collector Ingress资源,使用以下配置:
apiVersion: networking.k8s.io/v1 kind: Ingress metadata: name: simple-prod-collector namespace: monitoring annotations: # 指定走K3S默认的Traefik Ingress控制器 kubernetes.io/ingress.class: traefik # 声明后端为明文HTTP/2(h2c)服务,适配gRPC协议转发 traefik.ingress.kubernetes.io/service.server-scheme: h2c # 关闭强制HTTPS跳转,适配当前80端口明文访问的场景 traefik.ingress.kubernetes.io/redirect-entry-point: "" spec: rules: - host: jaeger-collector.my-container-dev http: paths: - path: / pathType: Prefix backend: service: name: simple-prod-collector port: number: 14250
关键配置说明:
- 升级API版本为稳定的
networking.k8s.io/v1,避免版本兼容问题 - 移除所有ingress-nginx专属注解,全部替换为Traefik可识别的规则
- 配置后端转发协议为h2c,匹配Collector 14250端口的明文gRPC通信要求
- 补全新版Ingress要求的path、pathType必填字段,确保路由解析正常
三、部署后验证流程
- 应用新Ingress配置后,执行
kubectl get ingress -n monitoring,确认simple-prod-collector的ADDRESS字段已经分配到和simple-prod-query一致的Traefik入口IP,不再为空。 - 执行
kubectl describe ingress simple-prod-collector -n monitoring,确认事件日志无路由解析报错,后端端点已正确关联到simple-prod-collector服务的14250端口。 - 确认外部Agent所在节点的域名解析配置:把
jaeger-collector.my-container-dev指向Traefik的入口IP(即之前simple-prod-query对应的10.128.107.220地址),可以直接修改Agent节点的hosts文件,也可以配置内部DNS统一解析。 - 重新测试Agent通信:gRPC上报流量从Agent发出后,经过Traefik的80端口转发到Collector的14250端口,原有的404、content-type不匹配的错误会消失,链路数据可正常上报。
四、长期使用注意事项
- 若后续需要为Collector配置TLS加密的gRPC通道,需要在Traefik上为对应域名绑定有效证书,同时在Agent端开启gRPC TLS相关配置,不要保留强制HTTPS跳转规则,避免gRPC协议握手失败。
- 不要把Collector的多端口服务(14268 Thrift HTTP、9411 Zipkin接口)和14250的gRPC接口复用同一个Ingress路由,需要拆分独立host或路径分别配置对应协议的转发规则,避免协议不匹配。
- 检查Traefik的全局配置,确认没有全局强制HTTPS跳转、IP白名单规则拦截该Ingress对应的路由流量,如存在全局规则,需要在当前Ingress上单独配置排除规则。
内容的提问来源于stack exchange,提问作者BearsEars
相关产品推荐
相关产品推荐

