ghcr.io/parmincloud/haproxy-redis-sentinel:0.0.2

HAProxy Redis Sentinel

基于Python发布/订阅的Sentinel主节点变更通知器，通过HAProxy的Runtime API更新HAProxy配置

只需创建一个简单的HAProxy配置，它就会为您处理所有事情

global
stats socket /var/run/haproxy/haproxy.sock user haproxy group haproxy mode 660 level admin
stats timeout 2m

frontend redis_master
bind *:6379
default_backend redis_master

backend redis_master
balance source
hash-type consistent

这样就足够了

要运行此项目，请安装poetry（并运行poetry install），或使用direnv，它会自动处理依赖项和项目本身的安装

poetry``poetry install``direnv

使用方法

poetry run haproxy-redis-sentinel是我们的命令入口点

poetry run haproxy-redis-sentinel

Sentinel 信息

• --sentinel-host -h TEXT Sentinel 主机名 [环境变量：SENTINEL_HOST] [默认值：127.0.0.1] --sentinel-host -h TEXT Sentinel 主机名 [环境变量：SENTINEL_HOST] [默认值：127.0.0.1]

--sentinel-host``-h``TEXT``SENTINEL_HOST``127.0.0.1

• --sentinel-port -p INTEGER Sentinel 端口 [环境变量：SENTINEL_PORT] [默认值：26379] --sentinel-port -p INTEGER Sentinel 端口 [环境变量：SENTINEL_PORT] [默认值：26379]

--sentinel-port``-p``INTEGER``SENTINEL_PORT``26379

• --sentinel-password -P TEXT Sentinel 密码 [环境变量：SENTINEL_PASSWORD] [默认值：None] --sentinel-password -P TEXT Sentinel 密码 [环境变量：SENTINEL_PASSWORD] [默认值：None]

--sentinel-password``-P``TEXT``SENTINEL_PASSWORD``None

• --master-name -m TEXT Sentinel 主节点名称 [环境变量：MASTER_NAME] [默认值：mymaster] --master-name -m TEXT Sentinel 主节点名称 [环境变量：MASTER_NAME] [默认值：mymaster]

--master-name``-m``TEXT``MASTER_NAME``mymaster

HAProxy 信息

• --haproxy-socket TEXT HAProxy 管理 socket 地址 [环境变量：HAPROXY_SOCKET] [默认值：/var/run/haproxy/haproxy.sock] --haproxy-socket TEXT HAProxy 管理 socket 地址 [环境变量：HAPROXY_SOCKET] [默认值：/var/run/haproxy/haproxy.sock]

--haproxy-socket``TEXT``HAPROXY_SOCKET``/var/run/haproxy/haproxy.sock

• --haproxy-backend TEXT 要控制的 HAProxy 后端名称（设置为空后端）[环境变量：HAPROXY_BACKEND] [默认值：redis_master] --haproxy-backend TEXT 要控制的 HAProxy 后端名称（设置为空后端）[环境变量：HAPROXY_BACKEND] [默认值：redis_master]

--haproxy-backend``TEXT``HAPROXY_BACKEND``redis_master

• --haproxy-server-name TEXT 要控制的 HAProxy 服务器名称，将通过指定的后端添加和控制 [环境变量：HAPROXY_SERVER_NAME] [默认值：current_master] --haproxy-server-name TEXT 要控制的 HAProxy 服务器名称，将通过指定的后端添加和控制 [环境变量：HAPROXY_SERVER_NAME] [默认值：current_master]

--haproxy-server-name``TEXT``HAPROXY_SERVER_NAME``current_master

在容器中运行

项目根目录下存在compose.yaml文件

设置/修改环境变量并运行，或将此项目作为服务添加到您现有的设置中

[!IMPORTANT] 您需要在独立的容器/服务器中运行HAProxy

您需要在独立的容器/服务器中运行HAProxy

K8s

helm repo add haproxy-redis-sentinel https://parmincloud.github.io/haproxy-redis-sentinel/
helm repo update

创建一个名为values.yaml的文件，并根据默认值自定义配置

values.yaml

helm install haproxy-redis-sentinel haproxy-redis-sentinel/haproxy-redis-sentinel --values ./values.yaml

为什么选择本项目？

HAProxy是一款高性能的优秀TCP代理和负载均衡器

但它无法动态处理主节点变更，通过Runtime API我们可以以编程方式进行配置

与那些从零开始编写TCP代理的类似项目不同，我们不想重复造轮子，而是利用HAProxy的强大功能 :)

借助Redis发布/订阅功能，我们能够实时感知主节点变更，并通过断开所有连接并相应更改服务器地址，将变更传播到HAProxy

待办事项

• 为HAProxy命令添加错误处理
• 为K8s Chart添加探针和资源配置