agoat/routing-mesh-controller

路由网格控制器镜像文档

镜像概述和主要用途

该镜像为入口路由网格网络的控制器，用于将Web流量转发到后端服务容器。它是Docker Swarm环境中建立路由网格所需的两个必要容器之一。与Traefik不同，此设置的特点是让管理器直接访问Docker实例，并与仅获取管理器写入配置的路由容器相隔离。

核心功能和特性

• 流量转发：将Web流量（HTTP/HTTPS）转发到后端服务容器
• 隔离架构：管理器直接访问Docker实例，与路由容器分离，增强安全性
• Docker Swarm支持：专为Docker Swarm集群设计，支持全局部署模式
• Nginx配置集成：通过挂载配置卷使用Nginx作为反向代理
• HTTPS支持：包含443端口映射，支持SSL证书管理
• Let's Encrypt集成：提供挑战文件和证书存储卷，支持自动证书管理

使用场景和适用范围

适用于Docker Swarm集群环境，需要建立统一入口路由、集中管理Web流量转发的场景。特别适合需要将前端请求分发到多个后端服务容器，并需要自动配置HTTPS的微服务架构。

使用方法和配置说明

Docker Stack部署示例

通过docker stack deploy部署，以下是完整的stack配置：

yaml
version: "3.8"

services:
  controller:
    image: agoat/routing-mesh-controller:latest
    deploy:
      mode: global  # 在每个节点上部署一个实例
    labels:
      routing.mesh.controller: "true"  # 控制器标识标签
    networks:
      controller:
    ports:
      - target: 80    # HTTP端口
        published: 80
        mode: host    # 使用主机网络模式
      - target: 443   # HTTPS端口
        published: 443
        mode: host
    volumes:
      - "config:/etc/nginx/conf.d:ro"        # Nginx配置卷（只读）
      - "challenges:/var/www/letsencrypt:ro" # Let's Encrypt挑战文件卷（只读）
      - "certs:/etc/letsencrypt:ro"          # SSL证书卷（只读）

  manager:
    image: agoat/routing-mesh-manager:latest
    deploy:
      mode: global  # 在每个节点上部署一个实例
    environment:
      ROUTING_NETWORK: "routingmesh"        # 路由网络名称
      LETSENCRYPT_EMAIL: "your@email.xyz"   # Let's Encrypt注册邮箱
      NODE_ID: '{{.Node.ID}}'               # Docker节点ID（Swarm模板变量）
    networks:
      manager:
    volumes:
      - "/var/run/docker.sock:/var/run/docker.sock"  # 挂载Docker socket以访问Docker API
      - "config:/etc/nginx/conf.d"                   # Nginx配置卷（可写，由管理器生成配置）
      - "challenges:/var/www/letsencrypt"            # Let's Encrypt挑战文件卷（可写）
      - "certs:/etc/letsencrypt"                     # SSL证书卷（可写）

volumes:
  config:        # 存储Nginx配置文件
  challenges:    # 存储Let's Encrypt挑战文件
  certs:         # 存储SSL证书

networks:
  controller:
    attachable: true
    name: "routingmesh"  # 控制器网络名称
  manager:
    name: "routingmesh_manager"  # 管理器网络名称

部署命令：

bash
docker stack deploy -c stack.yml routing-mesh

配置参数说明

环境变量（manager服务）

• ROUTING_NETWORK: 路由网络名称，需与networks.controller.name一致
• LETSENCRYPT_EMAIL: Let's Encrypt证书注册***，用于证书更新通知
• NODE_ID: Docker节点ID，使用Swarm模板变量{{.Node.ID}}自动获取

卷说明

• config: 共享卷，由manager生成Nginx配置，controller以只读方式挂载
• challenges: Let's Encrypt ACME挑战文件存储卷
• certs: SSL证书存储卷，包含Let's Encrypt生成的证书

网络说明

• controller: 控制器网络，名称为routingmesh，用于控制器与后端服务通信
• manager: 管理器网络，名称为routingmesh_manager，用于管理器内部通信

端口映射

• 80/tcp: HTTP流量端口，使用主机模式映射
• 443/tcp: HTTPS流量端口，使用主机模式映射