如何在Jenkinsfile中把关联服务容器的暴露端口绑定到Jenkins slave容器本地主机

嘿，这个需求我在CI环境里经常碰到，给你几个实用的方案，看哪种适合你的场景：

如果只是想快速让slave的localhost能访问服务端口，这个方法最简单——让Jenkins slave容器直接复用服务容器的网络栈，相当于两个容器共用同一个网卡和端口空间。

• 假设你的服务容器已经在运行，名称是my-service
• 启动Jenkins slave时加上--network container:my-service参数：

  docker run -d --name jenkins-slave --network container:my-service jenkins/slave:latest
  

  这样操作后，你在slave容器里访问localhost:xxx（xxx是你的服务端口），就直接能连接到你的服务了。

如果不想让两个容器完全共享网络（比如怕端口冲突），可以用自定义桥接网络把两者连起来，再在slave里做端口转发，把服务的端口映射到slave的localhost。

1. 先创建一个专属的自定义网络：

   docker network create jenkins-services-net
   

2. 启动服务容器时加入这个网络：

   docker run -d --name my-service --network jenkins-services-net your-service-image
   

3. 启动Jenkins slave时同样加入该网络，并用socat工具把服务端口转发到slave的localhost：

   docker run -d --name jenkins-slave --network jenkins-services-net jenkins/slave:latest \
     sh -c "socat TCP-LISTEN:8080,fork TCP:my-service:8080 & /usr/local/bin/jenkins-agent"
   

   这里my-service是服务容器的名称，在自定义网络里可以直接通过名称解析到容器IP。执行后，slave里的localhost:8080就会转发到服务容器的8080端口。

如果你的环境是用Compose管理的，把服务和slave写到同一个配置文件里，配置会更清晰，也方便团队协作：

version: '3.8'
services:
  my-service:
    image: your-service-image
    # 服务的其他配置，比如环境变量、挂载卷等

  jenkins-slave:
    image: jenkins/slave:latest
    network_mode: "service:my-service" # 直接复用my-service的网络栈
    depends_on:
      - my-service
    # slave的其他配置，比如挂载Jenkins agent密钥、设置环境变量等

启动时执行docker-compose up -d，slave容器就会自动和服务容器共享网络，localhost直接访问服务端口。

注意事项 #

• 用共享网络的方式时，两个容器不能占用相同的端口，否则会启动失败
• 自定义网络默认支持容器名称解析，不用手动记容器IP，比默认的bridge网络更方便
• 如果你的Jenkins slave是动态创建的（比如用Kubernetes插件），那可以考虑在slave Pod里配置服务的访问地址，或者用Sidecar容器做端口转发

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