记一次酣畅淋漓的 K8s Ingress 排错过程(302,404,503,...)
- 故事开始
- 第 1 关:【流量重定向到 /】
- 第 2 关:【应用返回 302,重定向到 /,引入 503 错误】
- 第 3 关:【静态资源访问遇到 503 问题】
- 第 4 关:【静态资源访问遇到 403 问题】
- 第 5 关:【WebSocket close with status code 1006】
- 最后效果
故事开始
如果你配置过 Ingress,那你一定遇到过各种各样的坑。
如果你尝试在 Kubernetes 集群里部署 OpenVSCode Server,并且通过 Ingress 暴露服务,那…… 祝你好运。
这个应用默认监听 /
路径,并且不支持配置修改。此外这个服务还用到了 302 重定向,Set Cookie,Websocket 等。或许你已经猜到了问题的复杂性……
于是,当你尝试通过 /xxx
在 Ingress 走七层路由访问这个应用的时候,酸爽的体验就开始了……
第 1 关:【流量重定向到 /】
首先我们会在 Ingress 配置里写上类似下列配置内容,将 /vscode
流量转发到具体的 Service:
spec:
rules:
- http:
paths:
- backend:
service:
name: vscode-01
port:
number: 8888
path: /vscode
pathType: Prefix
这时候尝试访问应用,你会收获 404:
404 说明流量已经到了应用,但是路径不对。稍加思考,其实是 Pod 收到了一个路径为 /vscode
的 http 请求,但是 Pod 期待的第一个请求路径是 /
,404 合情合理。
【解决方案】
这时候你可以在 Ingress 的 Annotation 里加上这样一行:
nginx.ingress.kubernetes.io/rewrite-target: /
第 2 关:【应用返回 302,重定向到 /,引入 503 错误】
当配置了 rewrite 实现流量重写到 /
路径后,继续尝试访问应用,可以得到如下错误礼包:
浏览器上首先看到的是 503 错误,但是第一个请求不应该 503。进一步看可以发现服务端先响应了一个 302,将请求重定向到了 /
路径,进而第二个请求发到了 /
,在 Ingress 这一层被拦截了,返回 503。
【解决方案】
可以在 Ingress 里继续加两行配置,实现 302 Location 的修改:
nginx.ingress.kubernetes.io/configuration-snippet: |
more_set_headers "Location: $scheme://$http_host/vscode/";
第 3 关:【静态资源访问遇到 503 问题】
解决了 302 重定向到 /
的问题之后,继续尝试访问应用,很可惜,还有坑等着:
可以看到 302 的下一个请求是 200,问题不大。接着的 503 是什么问题呢?
看来前端需要加载一些在 /stable-xxx/
下的资源,这个请求在 Ingress 这一层过不去,再次 503 了。
因为我们的 Ingress 配置了全局的 rewrite-target: /
,所以 Pod 无论如何收不到路径为 /stable-xxx/
的请求,也就是当前 Ingress 里咋配置都是徒劳了,这个问题解决不了。
【解决方案】
新增一个 Ingress,处理 /stable-xxx/
流量:
spec:
rules:
- http:
paths:
- path: /stable-487e0b6eb726a84faf6b1a95c68a092fba078fd1/static/(.*)
pathType: ImplementationSpecific
backend:
service:
name: vscode-01
port:
number: 8888
第 4 关:【静态资源访问遇到 403 问题】
解决了 503 问题后,继续尝试访问应用,这会会继续遇到 403 错误:
这一步的定位思路稍微有点绕了,我首先尝试用 kubectl port-forward
将 Pod 流量直接暴露出来,然后尝试访问,发现一切正常。接着用 nsenter 进了对应 Pod 的网络命名空间,再通过 tcpdump 尝试抓包分析 http 请求流量,发现 Ingress 方式的请求在 403 这一步少了 Cookie。
进一步分析请求,可以看到:
也就是第一次请求应用的时候,应用的响应头里带了 Set-Cookie: vscode-tkn=eomdZNpW;
,因此第二次浏览器请求 /vscode/xxx
的时候就会带上这个 Cookie,但是静态资源在 /stable-xxx/static
下,由于路径不一致(也不是包含关系),因此第二次请求的 Cookie 就没了。
【解决方案】
因为这个应用不支持配置路径,又是 TS 写的,我也不懂 TS 代码,所以我还是考虑能从 Ingress 角度入手。
既然静态资源都在 /stable-xxx/static
下,那干脆将 /vscode
改成 /stable-xxx/
。
spec:
rules:
- http:
paths:
- backend:
service:
name: vscode-01
port:
number: 8888
path: /stable-487e0b6eb726a84faf6b1a95c68a092fba078fd1/$
pathType: ImplementationSpecific
为了让正则表达式正常工作,还得加这样一行 Annotation:
nginx.ingress.kubernetes.io/use-regex: "true"
此时应用访问地址也就从:
/vscode/?tkn=eomdZNpW
更新成了:/stable-487e0b6eb726a84faf6b1a95c68a092fba078fd1/?tkn=eomdZNpW
注意,Annotation 里的 configuration-snippet
这时候需要同步更新成:
nginx.ingress.kubernetes.io/configuration-snippet |
more_set_headers "Location: $scheme://$http_host/stable-487e0b6eb726a84faf6b1a95c68a092fba078fd1/";
这时候 Cookie Path 相关的 403 问题应该就能绕过去了。
第 5 关:【WebSocket close with status code 1006】
经过前面一顿改之后,现在请求应用,已经几乎接近真相了:
看起来是 Websocket 相关的错误。继续仔细看下 http 信息,可以找到如下一个请求:
我们一开始配置的 path 规则是匹配 /stable-487e0b6eb726a84faf6b1a95c68a092fba078fd1/
,这里却没有 /
。
【解决方案】
更新 path:
spec:
rules:
- http:
paths:
- backend:
service:
name: vscode-01
port:
number: 8888
path: /stable-487e0b6eb726a84faf6b1a95c68a092fba078fd1(/?|$)
pathType: ImplementationSpecific
此时 ws 流量应该也可以被正常匹配到,然后 rewrite 到 /
去了。
最后效果
且看:
不总结了,着急下班。
(好像还得解决多实例的访问问题,现在的 URL 是同一个,固定的。不过,不急,再说吧,着急下班。)