使用Spring Cloud Deployer无法将本地Docker容器接入已有网络

你遇到的不是bug，是配置方式的问题，以下是具体排查和解决步骤：

1. 确保部署属性的层级正确 #

针对Docker部署场景，容器网络配置需要放在deployer.*的属性层级下，分全局配置和单应用配置两种方式：

• 全局配置：让流中所有应用都加入自定义网络，部署时传递属性：

  dataflow stream deploy --name <你的流名称> --properties "deployer.*.docker.network=<你的自定义网络名>"
  

• 单应用配置：仅指定某个应用加入自定义网络：

  dataflow stream deploy --name <你的流名称> --properties "deployer.<应用名称>.docker.network=<你的自定义网络名>"
  

注意：必须确保这些属性被正确传递给Skipper Server，而不是仅在Data Flow层面设置。

2. 让Skipper Server本身加入自定义网络 #

Skipper Server需要能访问自定义网络内的Docker资源，所以启动Skipper容器时必须将其加入你的自定义网络。比如在docker-compose.yml中添加：

services:
  skipper-server:
    image: springcloud/spring-cloud-skipper-server:2.9.0-SNAPSHOT
    networks:
      - <你的自定义网络名>

如果Skipper本身在默认bridge网络，会无法正确操作自定义网络的容器，导致配置被忽略。

3. 验证属性传递与Skipper日志 #

部署流后，查看Skipper Server的日志，确认deployer.*.docker.network属性是否被正确接收。如果日志显示属性未被识别，可能是SNAPSHOT版本的属性名有变更，可尝试使用完整前缀：spring.cloud.deployer.docker.network。

4. 检查Docker网络的有效性 #

• 用docker network ls确认你的自定义网络存在，名称拼写完全一致
• 确认自定义网络为bridge类型，且网络内的Kafka、MongoDB等服务可以通过名称正常解析

内容的提问来源于stack exchange，提问作者Sergio Sánchez