使用Ansible的community.docker.docker_compose模块时，Dockerfile中的变量无法展开

我太懂这种“本地跑好好的，一用Ansible就出问题”的糟心感了！明明直接docker-compose up -d时，Dockerfile里的$HOSTNAME变量能正常展开成容器的主机名，证书路径也没问题，但换成Ansible的community.docker.docker_compose模块启动，变量直接就空了，证书路径变成了/data/cert/.key和/data/cert/.crt，完全没法用。

咱们来一步步排查解决：

问题根源 #

核心问题出在Ansible调用docker_compose模块时，容器的主机名（HOSTNAME）没有被正确设置或传递。直接用docker-compose启动时，容器会自动获取一个默认主机名（通常是容器ID的短格式），或者如果你的docker-compose.yml里配置了hostname，它也能正常读取；但Ansible的模块在处理时，可能没有正确继承这个配置，导致容器内的$HOSTNAME变量为空，自然没法展开。

解决办法 #

这里给你几个实用的解决方案，选一个适合你的就行：

1. 确保docker-compose.yml里的主机名配置被正确读取 #

先检查你的docker-compose.yml，如果里面已经配置了hostname字段，那要确保Ansible的docker_compose模块没有覆盖这个设置。比如你的docker-compose.yml可能长这样：

services:
  your-web-service:
    build: .
    hostname: web-server-01 # 或者用自定义的变量值

在Ansible playbook里调用模块时，只需要指定project_src指向docker-compose.yml所在目录，不要额外设置会覆盖hostname的参数：

- name: 启动容器
  community.docker.docker_compose:
    project_src: ./your-compose-dir
    state: present

2. 换用显式环境变量替代$HOSTNAME #

如果依赖容器默认的HOSTNAME不稳定，不如直接在docker-compose.yml里定义一个显式的环境变量，比如APP_HOSTNAME，这样不管是docker-compose还是Ansible调用，都能稳定传递：

• 先修改Dockerfile的CMD命令：

CMD ["sh", "-c", "gunicorn -w=4 --bind=0.0.0.0:7004 --certfile=/data/cert/${APP_HOSTNAME}.crt --keyfile=/data/cert/${APP_HOSTNAME}.key main:app"]

• 然后在docker-compose.yml里添加环境变量配置：

services:
  your-web-service:
    build: .
    environment:
      - APP_HOSTNAME=web-server-01 # 或者用Ansible变量比如{{ inventory_hostname }}

这样变量展开就完全不受容器主机名设置的影响，稳定性拉满。

3. 在Ansible playbook里显式设置容器主机名 #

如果你的docker-compose.yml里没有配置hostname，也可以直接在Ansible playbook里通过docker_compose模块的参数显式设置：

- name: 启动容器并设置主机名
  community.docker.docker_compose:
    project_src: ./your-compose-dir
    services: your-web-service
    hostname: "{{ inventory_hostname }}" # 用目标主机的主机名，或者自定义值

这样容器启动后，$HOSTNAME就会被设置成你指定的值，自然能正常展开了。

验证方法 #

你可以在容器启动后，用Ansible或者docker exec进入容器，执行echo $HOSTNAME看看变量值是否正确，或者直接查看gunicorn的日志，确认证书路径是否已经正确展开。

备注：内容来源于stack exchange，提问作者Phipsen