容器与云原生 / 系统课时

建立入口变更门禁

建立入口变更门禁

生产入口的变更不能只靠“YAML 能提交”来判断安全。本课把入口发布前后的关键检查收敛为配置合法性、路由接纳与冲突、TLS 证书、回滚能力四道门禁,并给出可直接放进 CI/CD 的验证方式。

学习目标

  • 建立入口变更的服务端校验与对象状态检查
  • 识别主机名、路径、Listener 与后端引用的潜在冲突
  • 在放量前验证证书有效期,并确认上一版能够恢复

把入口变更拆成四道门禁

四道门禁分别回答:对象能否被 API Server 接受、路由是否按预期绑定、TLS 是否覆盖目标域名、失败后能否快速恢复。任何一项失败都应阻断继续放量,而不是等真实流量暴露问题。

入口变更四道门禁

先做服务端合法性校验

本地 YAML 语法检查不足以发现 CRD 字段不兼容、准入策略拒绝等问题。对待发布的 HTTPRoute 先执行服务端 dry-run,并用 -o name 主动要求机器可读的资源名输出,避免把不同 kubectl 版本可能出现的默认提示文本当成门禁依据。

bash
kubectl apply --server-side --dry-run=server -f httproute.yaml -o name

预期结果:

text
httproute.gateway.networking.k8s.io/app-route

以上结果假设文件中的对象名为 app-route。真正的门禁条件是命令退出码为 0;若字段不受当前集群支持、引用格式非法或准入策略拒绝,命令应以非零退出码结束,具体错误文本随 API Server、CRD 和策略而异。

检查路由接纳与冲突

对象可创建,不代表控制器已经接受并解析所有引用。Gateway API 应重点检查 parentRefs、hostnames、路径匹配、Listener 允许范围和 backendRefs;同一 Gateway 上存在重叠路由时,也不能只凭“host/path 重复”判定失败,因为最终匹配还受规范中的优先级规则影响。

bash
kubectl get httproute app-route -n demo -o jsonpath='{range .status.parents[*].conditions[*]}{.type}={.status}:{.reason}{"\n"}{end}'

预期结果示例:

text
Accepted=True:Accepted
ResolvedRefs=True:ResolvedRefs

条件顺序、reason 和控制器补充的其他条件可能不同;较新的实现还可能报告 Programmed。若 Accepted=False,应检查父级绑定、Listener 与主机名约束;若 ResolvedRefs=False,应优先检查 Service、端口、跨命名空间引用和 ReferenceGrant。即使这些状态均正常,存在重叠路由时仍应在放量前做一次目标 Host 与 Path 的实际请求验证。

校验证书与主机名

TLS 门禁至少确认 Secret 存在、证书未过期,并检查 Subject Alternative Name 是否覆盖目标主机名。只看 subject 或 CN 不足以完成现代 TLS 主机名校验。

bash
kubectl get secret web-tls -n demo -o jsonpath='{.data.tls\.crt}' | base64 -d | openssl x509 -noout -subject -dates -ext subjectAltName

预期输出示例:

text
subject=CN = app.example.com
notBefore=<TIME>
notAfter=<TIME>
X509v3 Subject Alternative Name:
    DNS:app.example.com

<TIME> 会随证书变化。若 notAfter 已接近变更窗口,或 SAN 不覆盖 HTTPRoute/Gateway 对外使用的主机名,应先更换证书再继续发布。

确认回滚版本并接入流水线

回滚门禁必须在变更前明确“上一版是什么、如何恢复、恢复后如何验收”。入口清单应受版本控制,并把上一份已验证的 Git 提交作为主要回滚源;当前线上对象快照适合留作变更证据和差异比对,避免故障时临时寻找旧配置。

bash
kubectl get httproute app-route -n demo -o yaml > <PATH>/app-route-before.yaml

预期结果:

text
命令成功时通常无标准输出,并在 <PATH> 生成当前 HTTPRoute 的 YAML 快照。

<PATH> 由实际流水线替换。kubectl get -o yaml 可能包含 status、resourceVersion 等服务端字段,因此不要把这份快照直接当作干净的回滚清单;回滚应优先恢复版本库中的已验证清单。CI/CD 中可按“服务端 dry-run → 路由状态与冲突检查 → TLS 校验 → 回滚版本确认”的顺序执行;每一步失败都返回非零退出码并保留证据。若生产发布还包含小流量阶段,应把真实 Host/Path 请求验证放在扩大流量之前,这样门禁既检查对象,也检查最终数据面行为。

按自己的节奏,确认真正理解。

目录与阅读设置

记录一个想法

建立入口变更门禁

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通