求助：如何通过Docker Compose将Azure文件共享挂载至VM容器？

一、修正Docker Compose的Azure Volume配置（解决驱动错误） #

你的初始配置存在两个核心问题导致驱动报错：

1. YAML语法错误：jenkins_home 条目后缺少冒号，破坏配置结构
2. 参数混用：部分volume用share，部分用share_name，Azure Volume Driver的标准参数为share_name

以下是修正后的完整docker-compose.yml，明确指定已有的Azure File Share信息，确保驱动能正确识别并挂载：

version: '3.8'

services:
  jenkins:
    image: jenkins/jenkins:lts
    user: root
    privileged: true
    container_name: jenkins
    ports:
      - 8080:8080
    volumes:
      - "jenkins_home:/var/jenkins_home"
      - "/var/run/docker.sock:/var/run/docker.sock"
  sonarqube:
    image: sonarqube:latest
    ports:
      - "9000:9000"
    volumes:
      - sonarqube_data:/opt/sonarqube/data
      - sonarqube_logs:/opt/sonarqube/logs  
      - sonarqube_extensions:/opt/sonarqube/extensions
    environment:
      - SONARQUBE_JDBC_URL=jdbc:postgresql://postgres:5432/sonarqube
      - SONARQUBE_JDBC_USERNAME=username
      - SONARQUBE_JDBC_PASSWORD=password
    depends_on:
      - postgres

  postgres:
    image: postgres:latest
    environment:
      - POSTGRES_PASSWORD=password
      - POSTGRES_DB=username

  nexus:
    image: sonatype/nexus3
    container_name: nexus
    ports:
      - "8082:8081"
    volumes:
      - "nexus_data:/nexus-data"

  prometheus:
    container_name: prometheus
    image: prom/prometheus:latest
    ports:
      - "9090:9090"
    volumes:
      - prometheus_data:/etc/prometheus
    command:
      - "--config.file=/etc/prometheus/prometheus.yml"
      - "--storage.tsdb.path=/prometheus"
      - "--enable-feature=remote-write-receiver"

  grafana:
    container_name: grafana
    image: grafana/grafana:latest
    ports:
      - "3000:3000"
    environment:
      - GF_PATHS_PROVISIONING=/etc/grafana/provisioning
    volumes:
      - grafana_data:/var/lib/grafana
    depends_on:
      - prometheus

volumes:
  jenkins_home:
    driver: azure
    driver_opts:
      share_name: jenkins_home  # 必须与已存在的Azure File Share名称完全一致
      storage_account_name: storage
      storage_account_key: key 
  sonarqube_data:
    driver: azure
    driver_opts:
      share_name: sonarqube_data
      storage_account_name: storage
      storage_account_key: key
  sonarqube_logs:
    driver: azure
    driver_opts:
      share_name: sonarqube_logs
      storage_account_name: storage
      storage_account_key: key
  sonarqube_extensions:
    driver: azure
    driver_opts:
      share_name: sonarqube_extensions
      storage_account_name: storage
      storage_account_key: key
  nexus_data:
    driver: azure
    driver_opts:
      share_name: nexus-data
      storage_account_name: storage
      storage_account_key: key
  prometheus_data:
    driver: azure
    driver_opts:
      share_name: prometheus_data
      storage_account_name: storage
      storage_account_key: key
  grafana_data:
    driver: azure
    driver_opts:
      share_name: grafana-data
      storage_account_name: storage
      storage_account_key: key

二、解决权限错误问题 #

Azure File Share默认权限为root:root（UID=0, GID=0），但多数容器使用非root用户运行，导致目录读写权限不足。以下是三种可行方案：

方案1：容器以root用户运行（快速测试，不推荐生产环境） #

修改服务配置，强制容器用root用户访问挂载目录：

• Jenkins已配置user: root，无需修改
• SonarQube添加user: root：

  sonarqube:
    image: sonarqube:latest
    user: root  # 添加此行
    ports:
      - "9000:9000"
    # 其他配置保持不变
  

• Nexus添加user: root：

  nexus:
    image: sonatype/nexus3
    user: root  # 添加此行
    container_name: nexus
    # 其他配置保持不变
  

方案2：修改Azure File Share权限（推荐生产环境） #

使用Azure CLI调整已存在的File Share权限，匹配容器运行用户的UID/GID：

1. 先确认容器用户的UID/GID：比如SonarQube默认UID=1000，Nexus默认UID=200，Grafana默认UID=472
2. 执行命令修改权限（以SonarQube的share为例）：

   az storage file directory set-permissions \
     --account-name storage \
     --account-key key \
     --share-name sonarqube_data \
     --path / \
     --owner 1000 \
     --group 1000 \
     --permission "u::rwx,g::rwx,o::rx"
   

3. 对每个对应的File Share执行上述命令，替换share-name和UID/GID为对应容器的值。

方案3：Volume配置中指定权限参数（灵活适配） #

Azure Volume Driver支持通过driver_opts直接指定uid、gid、file_mode、dir_mode，挂载时自动适配容器权限：
比如SonarQube的volume配置：

sonarqube_data:
  driver: azure
  driver_opts:
    share_name: sonarqube_data
    storage_account_name: storage
    storage_account_key: key
    uid: 1000  # SonarQube容器用户UID
    gid: 1000  # SonarQube容器用户GID
    file_mode: 0755
    dir_mode: 0755

对每个volume添加对应容器的UID/GID参数即可。

三、验证挂载是否成功 #

1. 启动容器：docker-compose up -d
2. 进入容器查看挂载目录权限：

   # 以Jenkins为例
   docker exec -it jenkins bash
   ls -l /var/jenkins_home
   

3. 检查容器日志是否存在权限报错：docker logs <container-name>

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