日常开发会碰到的清单:命名空间、探针、LimitRange、Kustomize

日常开发会碰到的清单:命名空间、探针、LimitRange、Kustomize

Hello,我是小兔大白糖。 系列收束:日常提 PR 前扫一眼的清单,把 Namespace、探针、LimitRange、Kustomize 钉成习惯。

副标题:把「提交 YAML 前扫一眼」固化成习惯,少在开发环境踩生产同款坑

估计阅读时间:16 分钟


目录


命名空间:逻辑隔离的楼层分区

Namespace 不是物理机隔离,更像酒店里的「商务层 / 游客层」——名字分开、配额分开、权限分开,但仍可能共享同一批 Node。

示例:development 里跑 backend-api,和生产命名空间隔离配置与权限,但节点池是否共用取决于平台。

日常注意:

  • kubectl 别忘 -n development(或改当前上下文);
  • ResourceQuota / LimitRange 往往挂在命名空间上;
  • Service DNS:backend-api.development.svc.cluster.local。
Kubernetes Namespace 逻辑隔离
Kubernetes Namespace 逻辑隔离 · 点击查看 SVG 原图

LimitRange:命名空间里的默认套餐

如果你忘了写 resources,命名空间可能用 LimitRange 给你填默认值,并限制最大值。

脱敏示例(教学):

apiVersion: v1
kind: LimitRange
metadata:
  name: default-limits
  namespace: development
spec:
  limits:
    - type: Container
      defaultRequest:
        cpu: "200m"
        memory: "512Mi"
      default:
        cpu: "800m"
        memory: "1Gi"
      max:
        cpu: "2"
        memory: "3Gi"

人话:

字段含义
defaultRequest没写 request 时,默认订这么多座
default(default limit)没写 limit 时,默认天花板
max再敢写大也不让你过这道门

对后端的提醒:

  • 「我本地 YAML 没写 resources,集群里却有」——多半是 LimitRange;
  • 想压测抬到 4 核,可能被 max: 2 挡下——去找平台改 LimitRange 或换命名空间策略,而不是怀疑 Deployment 没生效。

探针:客房门铃与假死检测

探针类比失败会怎样
Readiness客房收拾好了吗?好了才领客人从 Service Endpoints 摘掉,不杀进程
Liveness房客还活着吗?失败达阈值 → 重启容器
Startup(可选)慢启动服务的宽限期启动阶段保护,避免过早被 liveness 打死
# 教学示意:路径与端口按服务实际改
readinessProbe:
  httpGet:
    path: /health/ready
    port: 8080
  initialDelaySeconds: 5
  periodSeconds: 5
livenessProbe:
  httpGet:
    path: /health/live
    port: 8080
  initialDelaySeconds: 15
  periodSeconds: 10

避坑:

  • readiness 里做重依赖检查可以,但别把「下游抖一下」变成大规模摘流雪崩——按团队规范设计;
  • liveness 不要绑「依赖 DB 必须通」,否则 DB 抖动会引发重启风暴。

Kustomize overlay:同一套底座,多环境差分

某团队常见结构(概念):base + development overlay,而不是复制三份完全不同的 YAML。

backend-api/
  base/
    kustomization.yaml
    deployment.yaml
    service.yaml
  overlays/
    development/
      kustomization.yaml
      set-replicas.yaml      # 例: replicas=1
      set-resources.yaml     # 例: 开发环境较小 request/limit

overlays/development/kustomization.yaml 直觉上就是:

# 示意
resources:
  - ../../base
images:
  - name: xxx.dkr.ecr.region.amazonaws.com/demo-backend-api
    newTag: dev-20260101
replicas:
  - name: backend-api
    count: 1
Kustomize base 与多环境 overlay
Kustomize base 与多环境 overlay · 点击查看 SVG 原图

好处:改端口、改探针只改 base;环境差异留在 overlay。和后端「同一套代码、不同配置文件」同构。


GitOps 概念:让集群跟着仓库走

GitOps(概念层):以 Git 仓库为真相源,控制器(例如 Flux 一类工具)持续把集群状态对齐到仓库声明。

你需要记住的只有:

  1. 改资源 → 提 PR → 合并 → 控制器同步(而不是长期手搓 kubectl apply 当唯一途径);
  2. 漂移(有人手改了集群)会被揪出来或被纠正;
  3. 具体仓库地址、控制器配置属于内部平台细节——本系列不展开、不贴内网 URL。

对后端:把「YAML 当代码」——评审 request/limit、副本、探针,和评审连接池参数一样严肃。


提交前检查清单

每次改 backend-api 部署相关配置,扫一眼:

资源与副本

  • requests / limits 都写了吗?谁大谁小对不对?
  • 内存 request 是否接近常驻 WSS?CPU request 是否接近稳态用量?
  • 抬 limit 时,有没有同步考虑是否该抬 request?
  • replicas 或 HPA maxReplicas × 连接池,会不会打爆下游?
  • 是否需要 svc-multi-replica: "true" 这类团队约定标签?

调度与命名空间

  • 目标 namespace 对不对(如 development)?
  • 是否可能撞 LimitRange 的 max?
  • 大 request 在小节点池会不会 Pending?

健康与发布

  • readiness / liveness 路径是否真实可用?
  • liveness 是否误绑关键依赖?
  • 滚动更新时,新版本 Ready 前会不会被过早摘流/加流?

工程化

  • 改的是 base 还是某环境 overlay?
  • 镜像 tag 是否指向预期版本(占位仓库即可,勿把密钥写进清单)?
  • 有没有把 Secret 明文写进 Git?
┌─────────────────────────────────────────┐
│  PR 前 30 秒                            │
│  1. request/limit/replicas              │
│  2. 探针与命名空间                        │
│  3. overlay 是否改对环境                  │
│  4. 无密钥、无真实账号/节点 ID             │
└─────────────────────────────────────────┘

系列收束

回到第 00 篇的目标,你现在应当能:

  1. 画出 Cluster / Node / Pod / Deployment / Service;
  2. 用人话讲清 request vs limit、Guaranteed vs Burstable;
  3. 回答 limit 可以超物理机,内存 request 不能乱超 allocatable;
  4. 在 16c/16G 心算里留出预留与缓冲;
  5. 压测时按 throttle / OOM / Pending 分支处理,并理解 HPA;
  6. 用清单管住日常 YAML。
Kubernetes 后端学习总结
Kubernetes 后端学习总结 · 点击查看 SVG 原图

小结

  • Namespace 做逻辑隔离;LimitRange 填默认、卡上限。
  • Readiness 管流量;Liveness 管假死重启——别用错。
  • Kustomize base + overlay 管多环境差分;GitOps 让仓库成为真相源(Flux 等仅作概念)。
  • 用检查清单把 request/limit、副本、探针、密钥纪律固化成肌肉记忆。

写在最后

没有「下一篇预告」了——但有「下一件小事」:

打开你负责的服务的 Deployment,把当前的 request/limit/replicas 抄下来,对照第 03~05 篇标一版「压测后目标值」,提一个只改资源数字的小 PR。

比再读一篇长文,更管用。

若你把这系列发到团队博客,建议按 00 → 01 → … → 06 连载;评论区最高频的问题,多半还是那句:

「limit 加起来可以超过物理机吗?」——可以;但 request(尤其是内存)别骗调度器。


系列导航:导读 · 03 必读 · 05 压测 · 06(本文)