Kubernetes部署etcd挂载Persistent Volume时出现权限拒绝问题

问题原因 #

Bitnami官方的etcd镜像默认以**非root用户（UID 1001）**运行，而Persistent Volume挂载到容器内/bitnami/etcd目录时，该目录的所有者通常是root，导致容器用户没有读写权限，触发权限拒绝错误。

具体解决方法 #

方法1：配置Pod安全上下文自动调整权限

在Deployment的spec.template.spec下添加安全上下文，指定运行用户并设置fsGroup，让Kubernetes自动调整挂载卷的权限：

spec:
  template:
    spec:
      securityContext:
        runAsUser: 1001
        runAsGroup: 1001
        fsGroup: 1001
      containers:
        # 原容器配置不变

fsGroup会让挂载的卷自动将所属组设置为1001，确保容器用户拥有读写权限。

方法2：手动调整PV后端存储的权限

如果是手动创建的PV（比如hostPath、NFS），直接在存储源修改目录权限：

• hostPath场景：在Kubernetes节点上执行命令：

  chown -R 1001:1001 /宿主机上的PV目录路径
  

• NFS场景：在NFS服务器上修改共享目录的权限，将所有者UID/GID设为1001，或者添加读写权限给该用户。

方法3：用Init容器提前修正权限

添加一个以root运行的Init容器，在主容器启动前修改挂载目录的权限：

spec:
  template:
    spec:
      initContainers:
        - name: fix-etcd-permissions
          image: busybox:latest
          command: ["sh", "-c", "chown -R 1001:1001 /bitnami/etcd"]
          volumeMounts:
            - name: task-pv-storage
              mountPath: /bitnami/etcd
          securityContext:
            runAsUser: 0 # 以root用户运行
      containers:
        # 原容器配置不变

额外提示 #

你的Deployment设置了replicas: 2，但etcd集群需要**奇数个节点（3、5等）**才能正常达成共识，2节点集群无法提供高可用服务，建议调整副本数为奇数。

内容的提问来源于stack exchange，提问作者Đoàn Đức Bảo