如何使用kubectl patch更新ConfigMap中log.cfg的[log_file]配置？

问题背景 #

现有ConfigMap内容：

apiVersion: v1
data:
  allow_cookie: "false"
  log.cfg: |-
    [log]
    level: info
    [log_file]

需要在[log_file]行下添加配置src: $LOG_FILE_LOCATION（$LOG_FILE_LOCATION为本地环境变量），目标ConfigMap如下：

apiVersion: v1
data:
  allow_cookie: "false"
  log.cfg: |-
    [log]
    level: info
    [log_file]
    src: $LOG_FILE_LOCATION

尝试以下kubectl patch命令时报错The request is invalid：

kubectl patch cm demo-app-config --type json --patch '[{ "op": "add", "path": "/data/log.cfg/[log_file]", "value": "src: $LOG_FILE_LOCATION" }]'

错误原因 #

log.cfg是ConfigMap中的单个多行字符串值，并非嵌套的JSON/YAML结构，无法通过JSON Patch的路径/data/log.cfg/[log_file]定位到其中的某一行，这是导致请求无效的核心原因。

可行解决方案 #

方案1：使用JSON Patch替换整个log.cfg内容 #

直接替换log.cfg的完整字符串，同时展开环境变量：

kubectl patch cm demo-app-config --type json --patch '[{
  "op": "replace",
  "path": "/data/log.cfg",
  "value": "[log]\nlevel: info\n[log_file]\nsrc: '"$LOG_FILE_LOCATION"'"
}]'

说明：

• 用replace操作覆盖整个log.cfg的值，而非尝试添加到子路径
• 通过'"$LOG_FILE_LOCATION"'的写法让Shell正确展开环境变量，避免变量被当作字符串字面量

方案2：用envsubst结合kubectl apply（适合Kubernetes Job场景） #

这种方法更适合在Job中自动化执行，步骤如下：

1. 准备ConfigMap模板文件cm-patch-template.yaml：

apiVersion: v1
kind: ConfigMap
metadata:
  name: demo-app-config
data:
  allow_cookie: "false"
  log.cfg: |-
    [log]
    level: info
    [log_file]
    src: ${LOG_FILE_LOCATION}

2. 在Job容器中执行以下命令（需确保容器内安装了envsubst工具，通常在busybox或alpine镜像中可通过apk add gettext安装）：

envsubst < cm-patch-template.yaml | kubectl apply -f -

说明：

• envsubst会将模板中的${LOG_FILE_LOCATION}替换为容器环境中的对应变量值
• 生成的完整YAML通过管道传给kubectl apply，实现ConfigMap的更新

方案3：用sed结合kubectl get/apply修改现有内容 #

通过sed在指定行后插入新配置，再重新应用：

kubectl get cm demo-app-config -o yaml | sed '/\[log_file\]/a\    src: '"$LOG_FILE_LOCATION"'' | kubectl apply -f -

说明：

• kubectl get导出当前ConfigMap的YAML
• sed '/\[log_file\]/a\ src: ...'在[log_file]行后插入新配置行
• 管道输出给kubectl apply完成更新

内容的提问来源于stack exchange，提问作者P7asad