CI/CD / 系统课时

管理环境配置差异

管理环境配置差异

多环境发布最容易失控的原因,是把测试、预发、生产差异直接写进应用代码或复制出多套清单。本节用 Kustomize 的 base 与 overlay 把公共部署定义和环境参数分离,让同一份应用制品通过少量、可审查的配置进入不同环境。

学习目标

  • 能区分应用制品、公共部署定义与环境专属配置的职责。
  • 能用 Kustomize base 与 overlay 管理副本数和运行参数差异。
  • 能在发布前渲染并核对环境配置,避免把错误参数带入生产。

先拆分不变项与环境差异

应用代码、容器启动方式、端口和基础探针通常属于公共定义;副本数、日志级别、外部服务地址、资源配额和特性开关更适合成为环境参数。敏感值不要与普通配置一起明文提交,应由 Secret 管理方案或外部密钥系统注入。

Kubernetes 多环境配置分层结构

用 base 保存公共部署定义

下面的 base/deployment.yaml 只保留所有环境都一致的工作负载结构,并通过 app-config 读取普通运行参数。镜像地址应替换为团队真实仓库,并在正式流水线中优先使用不可变版本或 digest。

yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: checkout-api
spec:
  replicas: 1
  selector:
    matchLabels:
      app: checkout-api
  template:
    metadata:
      labels:
        app: checkout-api
    spec:
      containers:
        - name: app
          image: registry.example.com/checkout-api:1.8.3
          envFrom:
            - configMapRef:
                name: app-config

base/kustomization.yaml 定义公共资源和默认配置,默认值只作为可覆盖的基线。

yaml
apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization
resources:
  - deployment.yaml
configMapGenerator:
  - name: app-config
    literals:
      - APP_ENV=default
      - LOG_LEVEL=info

这两个文件本身不区分测试或生产环境;环境差异全部留给 overlay,避免复制整份 Deployment 后长期漂移。

用 overlay 只覆盖差异

overlays/staging/kustomization.yaml 可以把预发环境的副本数和日志级别调整为测试需要。

yaml
apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization
resources:
  - ../../base
replicas:
  - name: checkout-api
    count: 2
configMapGenerator:
  - name: app-config
    behavior: merge
    literals:
      - APP_ENV=staging
      - LOG_LEVEL=debug

overlays/production/kustomization.yaml 只声明生产环境真正不同的值。

yaml
apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization
resources:
  - ../../base
replicas:
  - name: checkout-api
    count: 4
configMapGenerator:
  - name: app-config
    behavior: merge
    literals:
      - APP_ENV=production
      - LOG_LEVEL=info

behavior: merge 会覆盖 base 中同名生成器的键,而不是再创建一套手工复制的 ConfigMap 定义。Kustomize 还会为生成的 ConfigMap 添加内容哈希,并自动更新 Deployment 中的引用。

发布前先渲染再比较

不要直接相信 overlay 文件“看起来没问题”。先让 kubectl 渲染两个环境,确认关键差异只出现在允许变化的位置。

bash
kubectl kustomize overlays/staging | grep -E 'replicas:|APP_ENV:|LOG_LEVEL:'
kubectl kustomize overlays/production | grep -E 'replicas:|APP_ENV:|LOG_LEVEL:'

预期输出

text
  APP_ENV: staging
  LOG_LEVEL: debug
  replicas: 2
  APP_ENV: production
  LOG_LEVEL: info
  replicas: 4

字段顺序可能随 kubectl 版本变化,但值应与 overlay 一致。真正部署前还可使用 kubectl diff -k overlays/production -n production 查看集群差异,把意外删除、镜像变化或参数漂移挡在发布动作之前。

避免三类常见配置漂移

不要为每个环境复制一整套应用代码或完整 YAML;公共逻辑修复后很容易漏改某个环境。不要把数据库密码、令牌等密钥写进普通 ConfigMap 或明文 overlay。也不要让流水线临时用字符串替换修改 YAML,因为这种变更难审查、难复现。

环境配置应该具备三个特征:差异最小、来源可追踪、渲染结果可验证。做到这三点,同一份制品才能在测试、预发和生产之间稳定晋级,而不是靠维护多套近似代码来维持环境一致性。

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

目录与阅读设置

阅读设置

17

记录一个想法

管理环境配置差异

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

登录哪都通