Rancher部署Docker镜像配置PersistentVolume的mountPath报operation not permitted错误

报错根因定位 #

该问题由持久卷目录权限不匹配导致：

• Sonarqube镜像默认使用UID为999的普通用户运行业务进程，未使用root权限
• Kubernetes默认挂载的持久卷目录属主为root，仅root用户拥有写入权限，Sonarqube进程无法向挂载的/opt/sonarqube/data/目录写入数据
• 不挂载持久卷时，容器使用内部可写存储层，目录属主为预设的999用户，因此可以正常启动

解决方案 #

方案1：添加初始化容器修改目录权限（兼容性最优，无需调整PVC/PV配置） #

在Deployment的spec.template.spec下新增initContainer配置，启动业务容器前先修改持久卷目录的属主，修改后的完整配置片段如下：

apiVersion: apps/v1
kind: Deployment
metadata:
  labels:
    app: sonarqube-server-lte
  name: sonarqube-server-lte
spec:
  selector:
    matchLabels:
      app: sonarqube-server-lte
  replicas: 1
  template:
    metadata:
      labels:
        app: sonarqube-server-lte
    spec:
      # 新增初始化容器配置
      initContainers:
      - name: fix-permission
        image: busybox:1.36
        command: ["sh", "-c", "chown -R 999:999 /opt/sonarqube/data"]
        volumeMounts:
        - mountPath: "/opt/sonarqube/data"
          name: app-pvc
        securityContext:
          runAsUser: 0
      # 原有业务容器配置保持不变
      containers:
        - name: sonarqube-server-lte
          image: xictorlr/sonarqubemodificado2
          resources:
            requests:
              cpu: 500m
              memory: 1024Mi
            limits:
              cpu: 2000m
              memory: 2048Mi
          volumeMounts:
          - mountPath: "/opt/sonarqube/data"
            name: app-pvc
          ports:
          - containerPort: 9000
            protocol: TCP
      volumes:
      - name: app-pvc
        persistentVolumeClaim:
          claimName: sonar-pvc-lte

方案2：配置Pod安全上下文 #

在spec.template.spec下添加安全上下文配置，直接指定Pod内所有进程以999用户运行，同时自动调整持久卷目录权限：

spec:
  template:
    spec:
      securityContext:
        runAsUser: 999
        fsGroup: 999
      # 原有业务容器配置保持不变

方案3：静态PV调整挂载参数（仅使用自行创建的静态PV时可选） #

如果你的PV是手动创建的静态资源，可以在PV的spec中添加挂载参数，直接指定目录属主：

spec:
  mountOptions:
    - uid=999
    - gid=999
  # 原有PV其他配置保持不变

前置校验项 #

操作前先确认以下配置正常：

• PVC sonar-pvc-lte 状态为Bound，无绑定异常
• PV容量不小于10Gi，满足Sonarqube最低存储要求

内容的提问来源于stack exchange，提问作者Víctor López Rapado