容器与云原生 / 系统课时
建立请求验证工具链
建立请求验证工具链
本课建立一套可重复的入口验证方法:用 kubectl 验证 Kubernetes 对象与控制器状态,用 curl 验证真实 HTTP 请求,再用 Controller 日志把客户端现象和入口处理过程串起来。完成后可以区分“请求没到入口”和“入口到了但后端有问题”。
学习目标
- 能用
kubectl从 Ingress、Service 和 Endpoint 逐层确认配置。 - 能用
curl验证 Host、Path 与 HTTP 响应。 - 能结合 Controller 日志判断请求卡在哪一层。
先准备一个最小可验证链路
验证工具链必须有稳定的测试对象,否则看到失败响应时无法判断故障属于入口还是后端。下面创建一个 Deployment、Service 和 Ingress,形成 curl → Ingress → Service → Pod 的最小链路。
kubectl create deployment demo --image=httpd:2.4 --port=80
kubectl expose deployment demo --port=80
kubectl create ingress demo --class=nginx --rule="demo.localdev.me/*=demo:80"预期结果
deployment.apps/demo created
service/demo exposed
ingress.networking.k8s.io/demo created如果对象已存在,创建命令会返回 already exists,此时不要重复创建,继续执行后面的检查即可。
用 kubectl 建立对象侧证据
第一层检查 Ingress 是否被正确声明,第二层检查 Service 是否存在,第三层检查后端是否真的有 Endpoint。Ingress 配置正确但 Service 没有可用后端时,客户端仍然会失败,因此不能只看 Ingress 对象存在与否。
kubectl get ingress demo -o wide
kubectl get service demo
kubectl get endpoints demo
kubectl get pods -l app=demo -o wide预期结果
NAME CLASS HOSTS ADDRESS PORTS AGE
demo nginx demo.localdev.me 80 <TIME>
NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE
demo ClusterIP <IP> <none> 80/TCP <TIME>
NAME ENDPOINTS AGE
demo <IP>:80 <TIME>
NAME READY STATUS RESTARTS AGE
demo-<ID> 1/1 Running 0 <TIME>实际输出中的 IP、Pod 名称和时间会变化。这里最重要的是 Ingress 的 CLASS 为 nginx,Service 存在,Endpoint 非空,且后端 Pod Ready。
用 curl 验证 HTTP 路由
入口规则通常按 Host 和 Path 匹配,因此直接访问 localhost 并不能证明 demo.localdev.me 这条规则生效。实验环境可以通过端口转发把 Controller 的 HTTP 端口映射到本机,再用 curl 显式设置 Host。
kubectl port-forward -n ingress-nginx service/ingress-nginx-controller <PORT>:80预期结果
Forwarding from 127.0.0.1:<PORT> -> 80
Forwarding from [::1]:<PORT> -> 80保持该进程运行,再执行请求验证:
curl -i -H 'Host: demo.localdev.me' http://127.0.0.1:<PORT>/预期结果
HTTP/1.1 200 OK
Content-Type: text/html
<html>...响应头和 HTML 细节会随 httpd 镜像版本变化。核心证据是 HTTP 请求获得成功响应,而不是 DNS 是否已经配置完成。这里使用 Host 头避免为实验环境额外配置真实域名解析。
用日志把请求与入口处理串起来
当 curl 失败时,马上查看 Controller 最近的日志。这样可以先判断请求是否到达入口,再决定继续检查 Ingress 规则还是后端链路。日志字段可能随 Controller 版本和日志格式变化,所以排障时应关注请求路径、Host、状态码以及 upstream 相关信息。
kubectl logs -n ingress-nginx deployment/ingress-nginx-controller --tail=100 | grep 'demo.localdev.me'预期结果
< TIME > <IP> - - [<TIME>] "GET / HTTP/1.1" 200 ... "demo.localdev.me" ...这里的具体访问日志格式可能不同,甚至默认日志中未出现完全相同的字段。若能找到对应 Host 或请求路径,说明流量至少到达了 Controller;若完全没有对应请求,应优先检查端口转发、入口地址、网络路径或请求是否实际发出。
形成固定排障顺序
面对入口访问失败,不要先修改 NGINX 参数。按照“对象、后端、请求、日志”的顺序采证,可以把问题快速缩小。
- 看 Ingress:
ingressClassName、Host、Path 和后端 Service 是否正确。 - 看 Service 与 Endpoint:Service 端口是否匹配,Endpoint 是否存在。
- 用
curl复现:固定 Host、Path 和入口端口,记录 HTTP 状态码。 - 看 Controller 日志:确认请求是否到达,以及 Controller 选择了什么后端。
这套工具链的价值在于每一步都产生可验证证据:kubectl 回答“集群里配置了什么”,curl 回答“客户端实际得到了什么”,Controller 日志回答“入口处理过程中发生了什么”。三者结合后,入口故障就可以从猜配置转为按证据定位。