garutilorenzo/docker-swarm-ingress

Docker Swarm 入口服务

镜像概述和主要用途

该镜像为Docker Swarm集群提供轻量级入口服务，通过Nginx反向代理和Python脚本实现基于主机名的请求路由。它能够自动发现Swarm服务并更新Nginx配置，使外部请求可根据公共主机名路由到集群内的相应服务，简化Swarm集群的流量入口管理。

核心功能和特性

• 基于主机名路由：通过服务标签指定主机名，实现外部请求的精准路由
• 自动配置更新：Python脚本定期与Docker守护进程通信，动态更新Nginx配置
• 灵活的服务映射：支持自定义服务端口和路径前缀
• 高可用性：可跨节点扩展，避免单点故障
• SSL支持：提供SSL Passthrough和HTTP到HTTPS重定向功能

使用场景和适用范围

适用于Docker Swarm集群环境，需要集中管理外部流量入口的场景，尤其适合多服务共享集群入口、需要基于域名区分服务的应用部署。

使用方法和配置说明

部署入口服务

入口服务作为集群反向代理，暴露80端口并路由请求到相应服务。需确保与其他服务共享网络，并挂载Docker套接字以获取服务配置。

bash
# 创建共享网络（若不存在）
docker network create --driver overlay ingress-routing

# 部署入口服务
docker service create --name ingress \
  --network ingress-routing \
  -p 80:80 \
  --mount type=bind,source=/var/run/docker.sock,destination=/var/run/docker.sock \
  --constraint node.role==manager \
  foxylion/swarm-ingress

注意：

• 必须挂载/var/run/docker.sock，否则无法获取服务配置
• 建议使用--replicas X参数扩展副本数，提高可用性

注册服务到入口

通过添加标签配置服务路由，服务需加入与入口服务相同的网络（如ingress-routing）。

配置标签说明

部署带入口路由的服务

创建服务时配置：

bash
docker service create --name my-service \
  --network ingress-routing \
  --label ingress.host=my-service.company.tld \
  --label ingress.port=8080 \  # 可选，默认为80
  --label ingress.path=/app \   # 可选，默认为/
  nginx

更新现有服务：

bash
docker service update \
  --label-add ingress.host=my-service.company.tld \
  --label-add ingress.port=8080 \
  --label-add ingress.path=/app \
  my-service

SSL配置示例

启用SSL Passthrough和HTTP重定向：

bash
docker service update \
  --label-add ingress.host=secure-service.company.tld \
  --label-add ingress.ssl=enable \
  --label-add ingress.ssl_redirect=enable \
  secure-service

此配置将实现：

• HTTP请求自动重定向到HTTPS
• 入口服务将SSL流量透传到后端服务处理