如何正确合并Docker Compose片段以保留完整deploy配置？

问题核心是直接用deploy: *deploy_test01会完全覆盖默认的deploy字段，而非合并其中的配置项。要实现deploy下多配置的合并，需要调整YAML锚点的使用方式，在deploy内部进行配置合并，而非替换整个deploy字段。

具体实现步骤 #

1. 拆分锚点定义
   将服务级默认配置、deploy默认配置、单独的placement约束分别定义为独立锚点，避免层级冲突：

   # 服务级别的默认配置（如镜像、端口等）
   x-seaweed-master-defaults: &seaweed-master-defaults
     image: chrislusf/seaweedfs:latest
     ports:
       - "9333:9333"
   
   # Deploy模块的默认配置（如重启策略、端点模式）
   x-seaweed-master-deploy-defaults: &seaweed-master-deploy-defaults
     restart_policy:
       condition: on-failure
       delay: 5s
     endpoint_mode: vip
   
   # 单独的placement约束配置
   x-deploy-test01-placement: &deploy-test01-placement
     placement:
       constraints:
         - node.labels.test01 == true
   

2. 在服务中合并配置
   在目标服务的deploy字段内，通过<<:语法同时引入deploy默认配置和placement约束，实现配置项的合并：

   services:
     seaweed_master_test01:
       <<: *seaweed-master-defaults  # 合并服务级默认配置
       deploy:
         <<: *seaweed-master-deploy-defaults  # 先加载deploy默认配置
         <<: *deploy-test01-placement  # 再合并placement约束（新增/覆盖对应字段）
   

验证效果 #

执行以下命令查看最终生成的配置，确认deploy字段同时包含默认的restart_policy、endpoint_mode和指定的placement：

docker stack config --compose-file compose.yaml

原理说明 #

YAML的<<:语法用于合并映射（map）结构，当在同一个deploy映射内多次使用时，后续的锚点会将自身的键值对合并到前面的配置中——如果有重复键会覆盖，新增键则直接添加。这样就不会替换整个deploy字段，而是实现内部配置项的合并。

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