Azure云部署ChirpStack Docker Compose遇ACI卷驱动错误咨询

操作流程与报错信息 #

在Azure云环境下使用Docker ACI上下文部署ChirpStack容器组，依次执行命令：

docker login azure
docker context create aci myacicontext
docker context use myacicontext
docker compose --file .\docker-compose.yml up

执行后控制台返回错误：

cannot use ACI volume, required driver is "azure_file", found ""

问题根源 #

对照提供的docker-compose.yml配置，报错来自两处不符合ACI运行规则的配置：

• 全局定义的持久化卷没有声明指定驱动：配置末尾的postgresqldata、redisdata两个命名卷为空配置，ACI没有匹配到要求的azure_file卷驱动，无法完成卷初始化
• 配置中大量使用本地路径绑定挂载：所有./configuration/xxx形式的路径映射，依赖部署机的本地文件系统，ACI作为Serverless容器实例不支持这类本地路径访问，本身也不在ACI的能力兼容范围内

修复步骤 #

• 为持久化卷补充驱动配置
  修改compose文件的全局volumes段，为每个需要持久化的卷显式指定azure_file驱动，关联提前在Azure创建好的文件共享资源，参考修改片段：

  volumes:
    postgresqldata:
      driver: azure_file
      driver_opts:
        share_name: <预先创建的Azure文件共享名称>
        storage_account_name: <关联的存储账号名称>
    redisdata:
      driver: azure_file
      driver_opts:
        share_name: <预先创建的Azure文件共享名称>
        storage_account_name: <关联的存储账号名称>
  

• 替换本地绑定挂载配置
  把配置中所有./configuration/xxx形式的本地路径映射，替换为ACI兼容的存储方案：要么将静态配置文件上传到Azure文件共享后通过挂载卷映射到容器路径，要么将配置文件内置到自定义镜像中，避免ACI无法读取本地路径导致服务启动失败
• 前置校验资源权限
  部署前确认当前登录的Azure账号对配置中关联的存储账号、文件共享拥有读写权限，避免权限不足导致的卷挂载失败

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