Docker Compose挂载Azure存储文件失败：无法绑定nginx.conf

问题根源 #

Azure File Storage卷在Azure容器实例（ACI）的Docker Compose配置中，不支持卷名称/子路径:容器路径这种挂载单个文件的格式。这种写法仅适用于本地文件系统卷或特定卷驱动，Azure File驱动不允许通过卷名称附加子路径来直接挂载共享内的单个文件。

可行解决方案 #

方案一：挂载整个共享并通过启动命令指定配置文件

将整个Azure文件共享挂载到容器内的临时目录，然后通过nginx启动命令指定加载该目录下的配置文件，既保留容器默认配置结构，又能使用Azure存储中的自定义配置。

修改后的docker-compose.yml：

version: '3.9'

services:
  client:
    image: nginx
    ports:
      - '8080:80'
    volumes:
      - nginxconf:/mnt/nginx-conf
    # 通过启动命令指定加载Azure存储中的配置文件
    command: ["nginx", "-g", "daemon off;", "-c", "/mnt/nginx-conf/conf/nginx.conf"]

volumes:
  nginxconf:
    driver: azure_file
    driver_opts:
      share_name: nginxfiles
      storage_account_name: nginxcontainerstorage
      storage_account_key: "xxxxxxxxxxxxxxx"

操作步骤：

1. 将自定义的nginx.conf上传到Azure文件共享nginxfiles的conf目录下（若conf目录不存在需先创建）。
2. 部署修改后的Compose配置，容器启动时会加载指定路径的配置文件。

方案二：直接挂载单个文件（Bind挂载方式）

若仅需挂载单个配置文件，可使用ACI支持的Bind挂载类型，直接指定Azure存储中的文件路径。注意此方式要求目标文件已存在于Azure存储账户中。

修改后的docker-compose.yml：

version: '3.9'

services:
  client:
    image: nginx
    ports:
      - '8080:80'
    volumes:
      - type: bind
        source: azure://nginxcontainerstorage/nginxfiles/conf/nginx.conf
        target: /etc/nginx/nginx.conf
        volume:
          driver_opts:
            storage_account_key: "xxxxxxxxxxxxxxx"

注意事项 #

• 确保Azure存储账户与容器实例处于同一Azure区域，跨区域无法挂载Azure File卷。
• 验证存储账户密钥的正确性，错误密钥会导致权限验证失败。
• 使用方案二时，需提前在Azure文件共享的conf目录下创建并上传nginx.conf文件，否则挂载会失败。

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