写 Deployment 模板时，最容易偷懒的是镜像字段：开发环境先填一个 `:develop`，测试环境临时改成 `:test`，上线前再手动替换成正式 tag。短期看省事，后面排查问题会很麻烦。因为你很难只看一份 YAML 就判断：这是基础模板的默认值，还是某个环境的真实发布配置。

更稳的做法是把 base 当成“最小公共结构”，只放所有环境都一致的东西；环境差异放到 overlay。镜像 tag、replicas、环境变量、资源限制、探针参数，都属于容易按环境变化的字段。它们不一定都要第一天写全，但不要混在 base 里靠人工记忆维护。

一个简单的目录可以这样拆：

```text
manifest/deploy/kustomize/
  base/
    deployment.yaml
    service.yaml
  overlays/
    develop/
      kustomization.yaml
      deployment.yaml
    prod/
      kustomization.yaml
      deployment.yaml
```

base 里保留 Deployment 的骨架：

```yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: admin-api
  labels:
    app: admin-api
spec:
  replicas: 1
  selector:
    matchLabels:
      app: admin-api
  template:
    metadata:
      labels:
        app: admin-api
    spec:
      containers:
        - name: main
          image: admin-api
          imagePullPolicy: Always
```

develop overlay 只覆盖它关心的部分：

```yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: admin-api
spec:
  template:
    spec:
      containers:
        - name: main
          image: admin-api:develop
```

这里有两个细节值得检查。

第一，overlay 里的容器 `name` 必须和 base 对得上。Strategic Merge Patch 靠 `containers[].name` 合并数组项。如果 base 里叫 `main`，overlay 里写成 `api`，你以为是在改镜像，实际可能变成追加一个容器。这个错误不一定在编辑时暴露，到了集群里才会变成启动失败、端口冲突或资源异常。

第二，base 里的镜像最好不要带具体环境语义。`admin-api` 可以接受，`admin-api:develop` 放在 base 里就不合适。base 一旦带了 develop，prod overlay 漏写镜像时，最终渲染出来的 YAML 仍然“看起来能跑”，只是跑错版本。

发布前我会加一个很笨但有效的校验步骤。不要只看源文件，直接渲染最终结果：

```bash
kubectl kustomize manifest/deploy/kustomize/overlays/develop \
  | grep -A 6 'containers:'

kubectl kustomize manifest/deploy/kustomize/overlays/prod \
  | grep -A 6 'containers:'
```

如果没有 `kubectl kustomize`，也可以用独立的 kustomize：

```bash
kustomize build manifest/deploy/kustomize/overlays/develop > /tmp/develop.yaml
kustomize build manifest/deploy/kustomize/overlays/prod > /tmp/prod.yaml
```

然后人工看三件事就够了：

| 检查项 | 要看的内容 | 常见问题 |
|---|---|---|
| 镜像 | `image:` 是否是目标环境 tag | prod 漏覆盖，继续使用 develop |
| 容器名 | overlay 的 `containers[].name` 是否匹配 base | 写错 name 后补出第二个容器 |
| 副本数 | `replicas` 是否符合环境预期 | base 默认 1，被误用到正式环境 |

这个检查不需要复杂平台。它的价值在于把“我记得改过”变成“渲染结果就是这样”。尤其是多人维护后台服务时，最终 YAML 比源文件片段更可靠。

还有一个容易忽略的点：Dockerfile 和 K8s 模板要一起看。镜像里实际启动的命令、工作目录、二进制路径，必须和 Deployment 的探针、日志路径、ConfigMap 挂载位置对得上。否则 YAML 看上去没问题，Pod 仍然会在启动阶段反复重启。

比如镜像构建阶段如果把二进制放到 `/app/main`，启动命令是：

```dockerfile
WORKDIR /app
CMD ./main
```

那后续给容器加探针或挂载配置时，就要围绕 `/app` 这个工作目录来确认，而不是凭习惯写 `/opt/app`。我一般会在提交前跑这几条：

```bash
docker build -t admin-api:develop -f manifest/docker/Dockerfile .
docker run --rm admin-api:develop pwd
docker run --rm admin-api:develop ls -lah /app
kubectl kustomize manifest/deploy/kustomize/overlays/develop
```

没有真实压测数据时，不要在这里写“性能提升多少”。这类配置检查解决的是可维护性和发布确定性，不是性能优化。它能减少的是手工改 YAML 带来的错配：镜像错、环境错、patch 没合上、容器启动目录和配置路径不一致。

可以对照这个仓库里的几个文件看：`server/manifest/docker/Dockerfile`、`server/manifest/docker/docker.sh`、`server/manifest/deploy/kustomize/base/deployment.yaml`、`server/manifest/deploy/kustomize/overlays/develop/deployment.yaml`。链接放一个就够了：https://github.com/z312193608/xygo-admin/tree/master/server/manifest

如果你的后台服务还停留在“复制一份 YAML，改几个字段”的阶段，建议先做一件小事：把 base 和 overlay 拆开，再把渲染结果纳入发布前检查。它不华丽，但很管用。

写 Deployment 模板时，最容易偷懒的是镜像字段：开发环境先填一个 :develop，测试环境临时改成 :test，上线前再手动替换成正式 tag。短期看省事，后面排查问题会很麻烦。因为你很难只看一份 YAML 就判断：这是基础模板的默认值，还是某个环境的真实发布配置。

Kubernetes Deployment 的 base 不要急着写死镜像 tag，环境差异放到 overlay 里

写 Kubernetes Deployment 时，不要把 develop、prod 这类环境差异混进 base。本文用 Deployment、Dockerfile 和 kustomize overlay 示例说明发布前该怎样渲染检查。

开发者

运维

开发工具

后端

Kubernetes部署最佳实践：使用Kustomize分离基础配置与环境差异。避免镜像标签混用，通过overlay管理环境变量、副本数等差异配置。关键检查点包括镜像版本、容器名称匹配、副本数设置，确保最终渲染结果正确。推荐将Dockerfile工作目录与K8s探针路径对齐，并通过kustomize build验证配置。

代码解释

容器

Docker

2026上云采购 | AI焕新·智启新局

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

Kubernetes部署最佳实践：使用Kustomize分离基础配置与环境差异。避免镜像标签混用，通过overlay管理环境变量、副本数等差异配置。关键检查点包括镜像版本、容器名称匹配、副本数设置，确保最终渲染结果正确。推荐将Dockerfile工作目录与K8s探针路径对齐，并通过kustomize build验证配置...

Kubernetes Deployment 的 base 不要急着写死镜像 tag，环境差异放到 overlay 里-腾讯云开发者社区-腾讯云

Kubernetes Deployment 的 base 不要急着写死镜像 tag，环境差异放到 overlay 里

Kubernetes Deployment 的 base 不要急着写死镜像 tag，环境差异放到 overlay 里

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐