K8s中PVC挂载目录下单独挂载ConfigMap文件报设备忙问题

报错核心由两个问题共同触发：

• 直接用subPath挂载单个ConfigMap文件到/var/jenkins_home/config.xml时，该路径会成为独立的文件系统挂载点。而Jenkins更新配置用原子写逻辑：先在/var/jenkins_home目录生成临时文件，写完后通过rename系统调用替换正式的config.xml。跨挂载点的rename操作会被操作系统拦截，直接抛出Device or resource busy错误。
• 你提供的YAML存在笔误：ConfigMap配置段的字段写为ites，正确字段名是items，该问题也会导致配置加载异常。

不要直接把ConfigMap文件挂载到目标路径，采用init容器+软链接的方案绕开跨挂载点操作限制，具体实现如下：

• 将ConfigMap存储的config.xml挂载到容器内独立的非Jenkins工作目录，比如/etc/jenkins-config，不要放在/var/jenkins_home路径下
• 新增init容器，在Jenkins主容器启动前，删除PVC工作目录下原有的config.xml文件，创建软链接将/var/jenkins_home/config.xml指向ConfigMap挂载的文件
• 移除主容器中原来直接挂载/var/jenkins_home/config.xml的volumeMount配置段

可直接参考的修正后YAML配置：

spec:
  initContainers:
  - name: link-jenkins-config
    image: busybox:stable
    command: ["sh", "-c", "rm -f /var/jenkins_home/config.xml && ln -s /etc/jenkins-config/config.xml /var/jenkins_home/config.xml"]
    volumeMounts:
    - mountPath: /var/jenkins_home
      name: jenkins-data
      subPath: jenkins
    - mountPath: /etc/jenkins-config
      name: configxml
  containers:
  - name: jenkins
    image: jenkins/jenkins:lts
    # 其余容器配置（端口、资源限制等）保持原有内容不变
    volumeMounts:
    - mountPath: /var/jenkins_home
      name: jenkins-data
      subPath: jenkins
    - mountPath: /etc/jenkins-config
      name: configxml
  volumes:
  - name: jenkins-data
    persistentVolumeClaim:
      claimName: shdr-jenkins-k-test
  - name: configxml
    configMap:
      name: jenkins-k-config
      items:
      - key: jenkins-configfile
        path: config.xml

注意事项：该方案下ConfigMap默认是只读挂载，Jenkins运行过程中修改的配置不会回写到ConfigMap，配置变更需要直接修改ConfigMap后触发Jenkins重载。如果需要配置完全持久化保留Jenkins的所有修改，不要拆分config.xml到ConfigMap，直接全量使用PVC存储即可。

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