docker compose模式下，volumes中的${HOSTNAME}识别不了

在 Docker Compose 的 volumes 配置中，${HOSTNAME} 的识别问题通常是因为 HOSTNAME 是一个系统变量，但在 docker-compose 文件中，默认并不会直接读取宿主机上的环境变量，或者其值在运行时并未正确传递。因此导致 ${HOSTNAME} 变量无法解析。

下面是一些可能的解决方案：

1. 明确传递 HOSTNAME 变量

你需要显式地将 HOSTNAME 环境变量传递给 docker-compose.yml，通过 .env 文件或者命令行参数。

方法 1: 使用 .env 文件

创建一个 .env 文件，内容如下：

HOSTNAME=myhostname

在 docker-compose.yml 文件中，使用 ${HOSTNAME}：

version: '3.9'

services:
  app:
    image: nginx
    volumes:
      - "/data/${HOSTNAME}:/app/data"

运行 docker-compose 时，HOSTNAME 将从 .env 文件中读取并替换为实际值。

方法 2: 使用命令行传递变量

直接通过命令行传递 HOSTNAME：

HOSTNAME=myhostname docker-compose up

或者使用 --env-file 明确指定环境变量文件：

docker-compose --env-file .env up

2. 为每个服务动态指定 HOSTNAME

如果你希望每个容器拥有独立的 HOSTNAME 值，可以通过 environment 传递自定义的值，并在容器中解析：

version: '3.9'

services:
  app:
    image: nginx
    environment:
      - HOSTNAME=my_app
    volumes:
      - "/data/${HOSTNAME:-default}:/app/data"

这里的 ${HOSTNAME:-default} 提供了默认值 default，在未传递 HOSTNAME 时使用该值。

3. 通过脚本生成 Compose 文件

如果需要动态生成 HOSTNAME 或其他环境变量，可以用脚本动态生成 docker-compose.yml 文件，或者动态注入变量。

示例 Python 脚本

import os
import yaml

# 获取系统的主机名
hostname = os.getenv('HOSTNAME', 'default_hostname')

# 定义 docker-compose 配置
compose_config = {
    'version': '3.9',
    'services': {
        'app': {
            'image': 'nginx',
            'volumes': [f'/data/{hostname}:/app/data']
        }
    }
}

# 保存为 docker-compose 文件
with open('docker-compose.generated.yml', 'w') as file:
    yaml.dump(compose_config, file)

print("Generated docker-compose file with HOSTNAME:", hostname)

运行此脚本将生成一个带有正确 HOSTNAME 的 docker-compose.generated.yml 文件。

4. 直接用 container_name 或服务名替代 HOSTNAME

如果目标是为每个服务/容器定义独立的卷路径，而非严格依赖 HOSTNAME，可以使用 container_name 或服务名来生成唯一的路径。

示例

version: '3.9'

services:
  app1:
    image: nginx
    container_name: app1
    volumes:
      - "/data/app1:/app/data"

  app2:
    image: nginx
    container_name: app2
    volumes:
      - "/data/app2:/app/data"

5. 利用 Docker Compose 的变量文件支持

Docker Compose 支持通过变量文件（如 .env）注入变量，确保 volumes 能正确解析变量。

.env 文件

HOSTNAME=myhost

docker-compose.yml 文件

version: '3.9'

services:
  app:
    image: nginx
    volumes:
      - "/data/${HOSTNAME}:/app/data"

通过 .env 文件管理 HOSTNAME，可以轻松修改。

6. 避免直接使用 HOSTNAME

如果 HOSTNAME 变量依赖于运行环境（例如每个容器生成独立的 HOSTNAME），推荐使用 Swarm 模式下的 task.id 或 service.name 来动态生成路径。

示例（Swarm 模式）

version: '3.9'

services:
  app:
    image: nginx
    volumes:
      - "/data/app_${TASK_ID}:/app/data"
    deploy:
      replicas: 3

TASK_ID 是每个 Swarm 任务唯一的标识符，适合动态路径生成。

总结

如果 ${HOSTNAME} 识别不了，可能是由于：

1. 环境变量未正确传递。
2. docker-compose 的解析机制未从宿主机环境中读取 HOSTNAME。

解决方法：

1. 显式传递 HOSTNAME：通过 .env 或命令行传递变量。
2. 动态生成 Compose 文件：在启动之前动态生成 docker-compose.yml。
3. 使用 Swarm 动态变量：如 task.id 或 service.name。
4. 明确路径：使用服务名或容器名替代。

根据你的实际需求选择合适的方式即可。