OKD4(Router/HAProxy)环境下自定义503错误页的实现与问题排查
OKD 自定义路由503错误页可落地方案
现有操作的问题根因
- 自定义配置被自动还原:
openshift-ingress命名空间下的router-defaultDeployment是Ingress Operator生成的托管资源,手动对Deployment做的非声明式修改,会被Operator的定期同步巡检逻辑判定为“不符合期望状态”,自动回滚为默认配置。 - Pod全节点调度失败:你遇到的9个节点全部不满足调度条件的报错,本质是手动编辑Deployment的过程中,把原有内置的调度规则误删了:原本router组件内置了
infra: reserved污点的容忍配置,删除后2个带该污点的节点无法被调度;原本配置了infra节点的标签选择规则,删除后3个不匹配标签的普通节点无法被选中;原本配置了打散Pod的反亲和规则,修改后4个节点无法匹配拓扑要求,最终全集群节点都不满足条件。另外你贴的配置里存在卷名不匹配的bug:volumeMounts块引用的卷名是haproxy-custom-configs,但volumes块实际定义的卷名是haproxy-custom-configs-error-page,名称不对等也会连带破坏原有配置的一致性。 - 直接挂载覆盖HAProxy配置目录下的文件的方式,本身就和Operator的HAProxy动态配置渲染逻辑冲突,属于强插的非托管配置,本身就不符合组件的运行逻辑,容易被巡检回写。
正确落地步骤
所有修改都要走Ingress Controller提供的官方配置通道,从根源上避免被回滚和破坏调度规则:
- 在
openshift-ingress命名空间下创建存放自定义错误页的ConfigMap,注意文件key必须严格匹配HAProxy的错误页命名规则:# 先将自定义503页面内容保存为本地文件 error-page-503.http,再执行创建命令 oc create configmap custom-haproxy-error-pages \ --from-file=error-page-503.http \ -n openshift-ingress - 编辑全局路由配置(IngressController),将ConfigMap和自定义错误页规则关联,注意全程不要改动原有配置块里的调度、容忍、亲和相关内容,仅追加自定义配置段:
执行编辑命令:oc edit ingresscontrollers.operator.openshift.io default -n openshift-ingress-operator
在spec字段下追加如下配置:spec: # 原有已经存在的所有配置(比如nodePlacement、endpointPublishingStrategy等)全部保留,不要删除 httpErrorCodePages: name: custom-haproxy-error-pages - 等待Operator自动完成配置同步(通常1-2分钟),验证结果:
- 查看新生成的router-default Pod状态,确认没有调度报错,成功调度到infra节点
- 进入Pod验证文件内容:
oc exec -n openshift-ingress <新生成的router-default Pod名> -- cat /var/lib/haproxy/conf/error-page-503.http,确认输出是自定义的错误页内容 - 访问任意后端不可用的Host路由,验证返回的是自定义503页面
踩坑提醒
- 禁止直接手动编辑
router-defaultDeployment的配置,所有对路由组件的持久化修改,必须通过IngressController的配置入口提交,否则一定会被同步逻辑回滚,甚至破坏原有内置调度规则 - 如果之前手动修改Deployment已经导致原有调度规则错乱,不需要手动逐条回滚Deployment配置,只要把Deployment里手动新增的非原生配置块删除,Operator会自动在30秒内将Deployment状态恢复为合规的默认值,重新生成可正常调度的Pod
- ConfigMap里的错误页文件名必须完全符合规范,503页面对应的key必须是
error-page-503.http,否则Operator无法识别加载,配置不会生效
内容的提问来源于stack exchange,提问作者ddakker
相关产品推荐
相关产品推荐

