Docker Swarm部署服务名称下划线问题及替换方案咨询

问题背景 #

使用docker stack deploy将Trino+Hive Metastore的Compose配置部署到Swarm集群后，服务名称自动生成为docker-trino_hive-metastore这类格式（项目名+下划线+服务名），但Trino配置的Hive Metastore URI采用连字符分隔（docker-trino-hive-metastore），导致服务间无法正常通信。

解决方案 #

方法1：显式指定Swarm服务名称 #

在Compose文件中给每个服务添加name字段，直接定义部署后的服务名称，避免自动生成下划线格式：

services:
  hive-metastore:
    name: docker-trino-hive-metastore  # 用连字符定义服务名
    # 原有配置（build、networks、environment等）保持不变
  trino-master:
    name: docker-trino-trino-master
    # 原有配置保持不变
  trino-worker:
    name: docker-trino-trino-worker
    # 原有配置保持不变

部署后执行docker service ls，会显示你指定的带连字符的服务名，与URI中的格式完全匹配。

方法2：在容器启动时自动替换URI中的下划线 #

如果不想修改服务名称，可以调整Trino服务的启动命令，在生成配置文件时自动将URI中的下划线替换为连字符。以trino-master为例，修改command部分的配置替换逻辑：

command: sh -c 'sed -i "/coordinator=/d" /etc/trino/config.properties && 
                echo coordinator=true >> /etc/trino/config.properties && 
                sed -i "/discovery.uri/d" /etc/trino/config.properties && 
                # 替换discovery.uri中的下划线为连字符
                echo discovery.uri=$(echo ${DISCOVERY_URI} | tr "_" "-") >> /etc/trino/config.properties && 
                sed -i "/hive.metastore.uri/d" /etc/trino/catalog/hive.properties && 
                # 替换hive.metastore.uri中的下划线为连字符
                echo hive.metastore.uri=$(echo ${HIVE_METASTORE_URI} | tr "_" "-") >> /etc/trino/catalog/hive.properties && 
                sed -i "/node-scheduler.include-coordinator/d" /etc/trino/config.properties && 
                echo node-scheduler.include-coordinator=${INCLUDE_COORDINATOR} >> /etc/trino/config.properties && 
                sed -i "/discovery-server.enabled/d" /etc/trino/config.properties && 
                echo discovery-server.enabled=true >> /etc/trino/config.properties && 
                /usr/lib/trino/bin/run-trino'

对trino-worker的command做同样修改即可，容器启动时会自动修正URI格式，匹配Swarm的服务DNS名称。

方法3：跳过项目名前缀（不推荐） #

Docker Swarm默认用下划线拼接项目名和服务名，若部署时省略项目名参数，服务名将直接使用Compose文件中定义的名称：

docker stack deploy --compose-file swarm-compose.yml

但这种方法会丢失项目名前缀，可能导致集群内服务命名冲突，仅适合小型单项目场景。

验证部署 #

修改配置后重新部署：

docker stack deploy --compose-file swarm-compose.yml docker-trino

执行docker service ls确认服务名称为带连字符的格式，再进入Trino容器测试连接：

docker exec -it <trino-master-container-id> trino
trino> SHOW CATALOGS;  # 确认hive catalog正常加载

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