Docker Swarm集群下如何在容器端口监听后再路由流量至service

Docker Swarm默认仅判断容器进程启动就将服务判定为运行状态，你需要配置自定义健康检查来检测端口是否正常监听，只有健康检查通过的实例才会被加入路由转发池，从根源避免流量打到未就绪的容器。

1. 健康检查逻辑说明 #

你可以直接用端口连通性检测作为健康检查规则，支持两种检测方式，按需选择：

• 针对TCP端口监听检测：用内置的nc（netcat）工具检测指定端口是否处于监听状态，无额外依赖
• 针对HTTP服务检测：如果你的容器是HTTP服务，可以直接请求对应健康接口，更准确判断服务可用性

2. docker run 命令配置示例 #

启动服务时直接添加健康检查参数，比如检测容器内8080端口是否就绪：

docker service create \
  --name your-service-name \
  --health-cmd "nc -z localhost 8080 || exit 1" \
  --health-interval 2s \
  --health-timeout 1s \
  --health-retries 3 \
  --health-start-period 10s \
  your-image:tag

参数说明：

• --health-cmd：健康检查执行的命令，返回0代表检查通过，返回1代表失败
• --health-interval：两次健康检查的间隔时间，示例中设为2秒
• --health-timeout：单次检查的超时时间，超过这个时间直接判定本次检查失败
• --health-retries：连续失败多少次后判定容器不健康
• --health-start-period：容器启动的初始化宽限期，这段时间内的检查失败不会计入重试次数，适合启动慢的服务，可以根据你的容器实际启动时长调整该值

3. Docker Compose 配置示例 #

如果用compose文件部署Swarm服务，添加healthcheck配置段即可：

version: '3.8'
services:
  your-service:
    image: your-image:tag
    ports:
      - "80:8080"
    healthcheck:
      test: ["CMD", "nc", "-z", "localhost", "8080"]
      interval: 2s
      timeout: 1s
      retries: 3
      start_period: 10s
    deploy:
      mode: replicated
      replicas: 2

4. 注意事项 #

• 如果你的基础镜像没有预装nc，可以换成wget或者curl检测，比如HTTP服务的检查命令可以写成curl -f http://localhost:8080/health || exit 1
• 健康检查通过前，Swarm的负载均衡不会将流量转发到该实例，完全符合你要求的"正常监听后再路由流量"的需求
• 你可以通过docker service ps your-service-name命令查看实例的健康状态，STATE列会显示healthy或者starting/unhealthy

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