nodeintegration/rancher-haproxy

rancher-haproxy镜像

镜像概述

该Docker镜像基于HAProxy构建，通过Rancher元数据服务自动发现服务，实现按主机名路由请求到对应Stack的功能。支持动态配置更新、SSL卸载等扩展特性，适用于CI/CD流程中多版本应用的隔离部署与统一入口管理。

核心功能

• 动态服务发现：通过Rancher元数据服务自动扫描带指定标签的容器，生成路由规则
• SSL支持：提供SSL卸载、HTTP到HTTPS重定向功能，支持证书挂载或元数据配置
• 统计界面：可配置启用HAProxy统计页面，查看负载均衡状态
• 代理协议：支持后端服务的Proxy Protocol配置
• Stack别名：允许为Stack设置额外域名别名（如[***] Stack）
• 无重启更新：通过文件监听实现配置变更时自动重载HAProxy

使用场景

• CI/CD流程中多版本应用的独立部署（如app-r123.$domain）
• 多Stack应用的统一入口路由管理
• 负载均衡与SSL终止处理
• 动态服务发现与配置自动更新

配置说明

环境变量

部署示例

负载均衡Stack的docker-compose.yml

yaml
HTTP-generate-maps:
  environment:
    STACK_DOMAIN: MYDOMAIN.tld
  labels:
    io.rancher.container.pull_image: always
  tty: true
  command: ["generate-maps"]
  image: nodeintegration/rancher-haproxy
  stdin_open: true
  volumes:
    - /usr/local/etc/haproxy
HTTP:
  ports:
    - "80:80/tcp"
    - "443:443/tcp"
  labels:
    io.rancher.sidekicks: HTTP-generate-maps
    io.rancher.container.pull_image: always
  tty: true
  image: nodeintegration/rancher-haproxy
  stdin_open: true
  volumes_from:
    - HTTP-generate-maps

应用Stack的docker-compose.yml（示例：test-webservice-r123）

yaml
nginx:
  labels:
    io.rancher.container.pull_image: always
    map-public-http: "80"  # 对应RANCHER_LABEL的值，指定容器监听端口
  tty: true
  image: nginx:stable-alpine
  stdin_open: true

代理协议配置示例

在应用Stack中添加代理协议标签：

yaml
nginx:
  labels:
    io.rancher.container.pull_image: always
    map-public-http: "80"
    proxy_protocol: send-proxy  # 指定代理协议类型
  tty: true
  image: nginx:stable-alpine
  stdin_open: true

在负载均衡Stack中启用代理协议支持：

yaml
HTTP-generate-maps:
  environment:
    STACK_DOMAIN: MYDOMAIN.tld
    RANCHER_PROXY_LABEL: proxy_protocol  # 指定代理协议标签键
  # 其他配置与上述负载均衡Stack一致

SSL证书配置（通过元数据）

rancher-compose.yml中添加证书：

yaml
HTTP:
  metadata:
    ssl_cert: |
      -----BEGIN CERTIFICATE-----
      # 替换为实际证书内容
      -----END CERTIFICATE-----
    ssl_key: |
      -----BEGIN RSA PRIVATE KEY-----
      # 替换为实际密钥内容
      -----END RSA PRIVATE KEY-----