Shell脚本如何动态生成容器配置

wen 实用脚本 2026-07-16 2

Shell脚本动态生成Docker与K8s配置的终极指南

📖 目录导读

为什么需要动态生成容器配置？
Shell脚本基础：环境变量与模板引擎
实战：用Shell生成Docker Compose文件
进阶：动态生成Kubernetes YAML清单
常见错误避坑指南
问答专区：高频问题深度解析

为什么需要动态生成容器配置？

在微服务架构与CI/CD流水线普及的今天，容器配置往往面临三大痛点：

Shell脚本如何动态生成容器配置

环境差异：开发、测试、生产环境的端口、数据库地址不同
版本爆炸：每次发布需要手动修改配置，极易引发“配置漂移”
灵活扩展：容器实例数需根据负载动态调整，固定配置无法满足

Shell脚本的核心价值在于：通过变量注入、条件判断和循环结构，将静态配置文件转化为“活的”模板，当你在CI/CD中执行一次./generate-config.sh，即可输出适配当前环境、资源限制、网络拓扑的精准配置。

Shell脚本基础：环境变量与模板引擎

1 变量传递的黄金法则

# 从外部注入（推荐）
export APP_PORT=8080
export DB_HOST=postgres-prod.example.com
# 从文件读取（适合敏感信息）
source ./env/development.env
# 从命令行参数获取
while getopts "p:d:h" opt; do
  case $opt in
    p) APP_PORT=$OPTARG ;;
    d) DB_HOST=$OPTARG ;;
  esac
done

2 低配版模板引擎（sed+envsubst）

方案A: 环境变量替换

cat > docker-compose.yml << EOF
version: '3'
services:
  app:
    image: myapp:${VERSION:-latest}
    ports:
      - "${APP_PORT}:8080"
EOF

方案B: 利用envsubst（更安全）

export VERSION="1.0.3"
envsubst < docker-compose.template.yml > docker-compose.yml

模板文件中需显式标注$VERSION，避免意外替换$PATH等系统变量

实战：用Shell生成Docker Compose文件

1 动态服务拓扑

假设我们需要根据传入的SERVICE_COUNT参数生成N个微服务实例：

#!/bin/bash
SERVICE_COUNT=${1:-3}
BASE_PORT=8000
cat > docker-compose.yml << EOF
version: '3.8'
services:
EOF
for i in $(seq 1 $SERVICE_COUNT); do
  PORT=$((BASE_PORT + i - 1))
  cat >> docker-compose.yml << EOF
  service-$i:
    image: myapp:latest
    environment:
      - NODE_ID=$i
      - PORT=$PORT
    ports:
      - "$PORT:8080"
EOF
done

2 结合环境矩阵生成多环境配置

#!/bin/bash
ENV=${1:-dev}
case $ENV in
  dev)  DB="postgres-dev"; MEM="256m";;
  prod) DB="postgres-prod"; MEM="2g"; REPLICAS=3;;
esac
cat << EOF > docker-compose.$ENV.yml
services:
  app:
    deploy:
      replicas: ${REPLICAS:-1}
      resources:
        limits:
          memory: $MEM
    environment:
      - DB_HOST=$DB
      - ENV=$ENV
EOF

这样docker compose -f docker-compose.prod.yml up即可自动使用生产配置

进阶：动态生成Kubernetes YAML清单

1 多副本Deployment生成器

K8s配置比Docker Compose更复杂，需处理资源配额、探针、挂载卷等：

#!/bin/bash
cat << EOF | kubectl apply -f -
apiVersion: apps/v1
kind: Deployment
metadata:
  name: app-${NAMESPACE:-default}
spec:
  replicas: ${REPLICAS:-2}
  template:
    spec:
      containers:
      - name: main
        image: ${IMAGE_NAME}:${IMAGE_TAG}
        ports:
        - containerPort: ${CONTAINER_PORT:-8080}
        resources:
          limits:
            memory: "${MEMORY_LIMIT:-512Mi}"
        env:
        - name: DB_URL
          value: "postgresql://$(cat /secrets/db_user):$(cat /secrets/db_pass)@${DB_HOST}:5432"
EOF

2 配置热更新：结合ConfigMap与Secrets

#!/bin/sh
# 动态生成ConfigMap YAML
kubectl create configmap app-config \
  --from-literal=log.level=${LOG_LEVEL:-info} \
  --from-literal=cache.ttl=${CACHE_TTL:-60} \
  --dry-run=client -o yaml > configmap.yaml
# 注入环境变量到Deployment
sed "s/\${LOG_LEVEL}/$LOG_LEVEL/g" deployment-template.yaml | kubectl apply -f -

常见错误避坑指南

错误类型	典型表现	解决方案
YAML缩进错误	`mapping values are not allowed here`	使用`cat <<-`（制表符转为空格）+ 工具`yamllint`
变量未定义	`$ENV_HOST`为空	强制默认值`${ENV_HOST:-fallback}`
特殊字符转义	密码含或被替换	使用单引号包裹变量引用
多行值丢失	换行符丢失导致JSON失效	使用`printf '%s\n'`而非`echo`

问答专区：高频问题深度解析

Q1: Shell脚本动态生成配置是否比Ansible/Terraform更优？
A: 各有优劣，Shell适合快速原型、CI/CD单次触发；Terraform适合基础设施状态管理，建议组合使用：Shell生成敏感配置（通过Vault动态获取密码），Terraform管理集群基础设施。

Q2: 如何确保生成的配置不被Git跟踪导致隐私泄露？
A: 三步法：

在.gitignore写入*/generated/*.yml
使用envsubst时通过临时文件mktemp生成
对密码采用$(cat /run/secrets/db_pass)运行时注入

Q3: 容器配置动态更新后，如何避免服务重启？
A: K8s可通过kubectl set env deployment myapp –env=NEW_VAR=value实现滚动更新；Docker Compose则需docker compose up -d触发重建，高级做法：使用环境变量挂载ConfigMap，配置修改后自动重载（需应用支持）

Q4: 模板语法冲突（例如Shell变量与YAML中的符号）如何解决？
A: 方法一：用\${VAR}在模板中转义；方法二：使用envsubst时指定保留变量（envsubst '${VAR1}${VAR2}'），推荐方法三：改用Go模板渲染（如gomplate）或Python脚本，彻底规避歧义。

Q5: 大量服务配置（100+）生成性能问题？
A: 优化路线：