docker-compose与docker compose部署Azure ACI ES集群的.env加载问题
两类Docker Compose命令的核心差异
docker-compose(带连字符):是早期独立分发的Python版本Compose CLI,作为单独的可执行文件存在,不属于Docker CLI原生子命令,需要单独安装。它仅支持对接本地Docker守护进程,无法识别云厂商自定义的Docker context(比如Azure ACI的远程上下文)。docker compose(无连字符):是Docker官方从20.10版本开始内置的Go语言编写的Compose插件,作为Docker CLI的原生子命令存在,无需单独安装。它原生支持扩展的Docker context(包括Azure ACI的远程上下文),也是ACI部署文档指定的唯一受支持的命令。
带连字符的命令报“平台不支持,需要连接Docker Engine”的根本原因就是,它完全不识别ACI的远程context,只会尝试寻找本地运行的Docker服务,没有任何配置能让它适配ACI环境。
报错与.env加载失效的根因
你遇到的invalid spec: certs:: empty section between colons报错,本质是对接ACI context的docker compose没有自动读取执行目录下的.env文件做配置插值,导致compose文件里写的$CERTS_DIR变量值为空,卷映射certs:$CERTS_DIR最终被解析成certs::两个冒号中间无内容的非法格式。
之前尝试使用env_file配置不生效的原因是:env_file的作用是给容器运行时注入内部环境变量,完全不参与Compose自身解析配置文件时的变量插值环节。而变量替换发生在解析compose文件的最前期,远早于处理服务级env_file配置的阶段,自然无法作用于$CERTS_DIR这类占位符。
适配ACI的部署调整方案
按照以下步骤调整即可顺利部署:
显式注入配置插值需要的环境变量
不依赖自动读取.env的逻辑,在执行部署命令时,直接把compose文件里需要用来做占位符替换的变量设置为Compose进程可读取的全局环境变量:- Windows PowerShell 环境执行:
$env:CERTS_DIR="/usr/share/elasticsearch/config/certificates" $env:ELASTIC_PASSWORD="你的实际密码" docker compose -f .\docker-compose.yml -f .\docker-compose.production.yml up- Linux/WSL/Cloud Shell 环境执行:
export CERTS_DIR=/usr/share/elasticsearch/config/certificates export ELASTIC_PASSWORD=你的实际密码 docker compose -f ./docker-compose.yml -f ./docker-compose.production.yml up这种方式传入的变量会被Compose正常用于替换配置文件里的占位符,不会再出现空值导致的路径解析错误。
移除ACI不兼容的compose配置
ACI的Compose实现对部分本地Docker Compose特性不支持,需要手动清理:- 删除所有服务下的
ulimits配置:ACI不支持修改容器的memlock系统限制,这类配置会被直接忽略,不影响ES正常运行 - 删除
networks节点下的driver: bridge配置:ACI的容器网络为托管模式,不支持自定义网络驱动,同组内的服务会自动接入托管网络,直接通过服务名实现互访 - 调整端口绑定规则:ACI不支持将端口绑定到
127.0.0.1本地回环地址,需要把原配置127.0.0.1:9200:9200修改为9200:9200,ACI会自动为服务分配可公网访问的FQDN - 删除
wait_until_ready临时服务:ACI的Compose实现不支持depends_on的健康检查条件判断,该服务无法按预期逻辑运行
- 删除所有服务下的
部署前先验证配置解析结果
正式发起部署前,先运行配置输出命令,确认所有占位符都被正确替换,没有空值问题:$env:CERTS_DIR="/usr/share/elasticsearch/config/certificates" $env:ELASTIC_PASSWORD="你的实际密码" docker compose -f .\docker-compose.yml -f .\docker-compose.production.yml config如果输出内容里的卷映射能正常显示为
certs:/usr/share/elasticsearch/config/certificates,就说明变量加载正常,可以正式执行部署。
内容的提问来源于stack exchange,提问作者user10998602

