AKS PVC/PV权限修改：部署Jenkins时chmod命令不生效如何解决？

根因说明 #

你遇到的chmod不生效问题，本质是AKS默认存储类的特性导致：

若你使用的是默认azurefile存储类，其底层为SMB协议的Azure Files共享存储，本身不支持持久化保存UNIX权限位，容器内执行的chmod仅临时生效，重新挂载后会恢复存储类默认的dir_mode=0777、file_mode=0777参数值。

可行解决方案 #

方案1：切换为Azure Disk存储类（最推荐） #

Azure Disk是块存储，可格式化为EXT4/XFS等原生Linux文件系统，完全支持UNIX权限持久化修改，适配Jenkins这类对权限有要求的负载：

• 直接创建azure-disk-csi类型的PVC挂载到Jenkins的/var/jenkins_home路径
• 配置Pod的securityContext指定与Jenkins镜像匹配的UID/GID即可：

securityContext:
  runAsUser: 1000
  runAsGroup: 1000
  fsGroup: 1000

• 挂载完成后可直接执行chmod修改任意文件/文件夹权限，修改结果永久生效

方案2：必须使用Azure Files时的适配方案 #

如果业务要求必须用Azure Files存储，可通过自定义挂载参数+初始化容器解决：

1. 在PVC的annotations中指定自定义挂载权限，覆盖默认777配置：

annotations:
  volume.beta.kubernetes.io/mount-options: "dir_mode=0755,file_mode=0644,uid=1000,gid=1000"

2. 新增initContainer在Jenkins主容器启动前修改特定文件权限，需要开启特权模式：

initContainers:
- name: fix-permission
  image: busybox:1.35
  command: ["/bin/sh", "-c"]
  args:
  - chmod 0600 /var/jenkins_home/secrets/* /var/jenkins_home/identity.key
  volumeMounts:
  - name: jenkins-storage
    mountPath: /var/jenkins_home
  securityContext:
    privileged: true

方案3：通过存储类参数全局配置 #

如果需要批量调整该存储类下所有卷的默认权限，可新建自定义StorageClass，在参数中指定默认挂载权限：

apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
  name: custom-azurefile
provisioner: file.csi.azure.com
parameters:
  skuName: Standard_LRS
mountOptions:
  - dir_mode=0755
  - file_mode=0644
  - uid=1000
  - gid=1000

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