Kubernetes部署CouchDB挂载ConfigMap配置文件报错求助

问题根源 #

挂载时报「目标路径不是目录」，通常是以下两种情况：

• 试图将ConfigMap挂载到容器内已存在的文件路径（比如CouchDB默认的/opt/couchdb/etc/local.ini），直接挂载目录会和现有文件冲突
• 挂载路径拼写错误，指向了容器内不存在的路径，或路径本身是文件而非目录

正确挂载方案 #

方案1：挂载额外配置到CouchDB扩展配置目录 #

CouchDB会自动加载local.d/目录下的所有.ini配置文件，无需替换默认配置，推荐用这种方式避免冲突：

1.1 配置ConfigMap

apiVersion: v1
kind: ConfigMap
metadata:
  name: couchdb-config
data:
  custom-settings.ini: |
    [httpd]
    bind_address = 0.0.0.0
    port = 5984
    [couchdb]
    max_document_size = 5000000
    [admins]
    admin = your-encrypted-password

1.2 配置Deployment挂载

apiVersion: apps/v1
kind: Deployment
metadata:
  name: couchdb
spec:
  replicas: 1
  selector:
    matchLabels:
      app: couchdb
  template:
    metadata:
      labels:
        app: couchdb
    spec:
      containers:
      - name: couchdb
        image: couchdb:latest
        ports:
        - containerPort: 5984
        volumeMounts:
        - name: couchdb-config-vol
          mountPath: /opt/couchdb/etc/local.d/  # 容器内默认存在的目录
          readOnly: true
      volumes:
      - name: couchdb-config-vol
        configMap:
          name: couchdb-config

方案2：替换默认的local.ini配置文件 #

如果必须替换默认配置，需用subPath指定单个文件挂载到目标文件路径：

2.1 配置ConfigMap

apiVersion: v1
kind: ConfigMap
metadata:
  name: couchdb-config
data:
  local.ini: |
    [httpd]
    bind_address = 0.0.0.0
    port = 5984
    [couchdb]
    database_dir = /opt/couchdb/data
    view_index_dir = /opt/couchdb/data
    [admins]
    admin = your-encrypted-password

2.2 配置Deployment挂载

apiVersion: apps/v1
kind: Deployment
metadata:
  name: couchdb
spec:
  replicas: 1
  selector:
    matchLabels:
      app: couchdb
  template:
    metadata:
      labels:
        app: couchdb
    spec:
      containers:
      - name: couchdb
        image: couchdb:latest
        ports:
        - containerPort: 5984
        volumeMounts:
        - name: couchdb-config-vol
          mountPath: /opt/couchdb/etc/local.ini  # 目标为容器内的文件路径
          subPath: local.ini  # 对应ConfigMap中存储配置的键名
          readOnly: true
      volumes:
      - name: couchdb-config-vol
        configMap:
          name: couchdb-config

排查要点 #

• 先确认容器内路径正确性：执行kubectl exec -it <couchdb-pod-name> -- ls /opt/couchdb/etc/查看目录结构
• 若之前subPath失败，检查subPath值是否和ConfigMap中的键名完全一致，mountPath是否指向正确的文件路径

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