dweomer/serf

HashiCorp Serf on Alpine镜像

镜像概述

本镜像基于Alpine Linux构建，提供极简的HashiCorp Serf运行环境。镜像设计无多余副作用（无预设VOLUME或EXPOSE），仅将serf可执行文件作为入口点，适用于作为分布式系统中Serf集群的客户端或服务器基础镜像。

核心功能

Serf是一款轻量级服务发现与集群编排工具，支持以下核心操作：

• agent：运行Serf代理节点
• join：加入现有Serf集群
• members：列出集群成员信息
• event：向集群发送自定义事件
• query：向集群节点发起查询
• leave：优雅退出集群并关闭代理
• keygen：生成集群加密通信密钥

使用场景

• 分布式系统的服务发现与节点状态同步
• 集群节点动态加入/退出管理
• 跨节点自定义事件通知与查询
• 微服务架构中服务注册与发现的基础组件

配置说明

镜像未预设VOLUME或EXPOSE，用户可根据需求灵活配置：

1. 端口映射：Serf默认使用7946端口（TCP/UDP），可通过-p 7946:7946/tcp -p7946:7946/udp映射
2. 挂载卷：若需持久化配置，可挂载本地目录（如-v ./serf-config:/etc/serf）
3. 环境变量：通过-e设置集群名称、加密密钥等参数

部署示例

运行Serf代理

bash
docker run --rm -it dweomer/serf agent -node=my-node -bind=0.0.0.0:7946

加入现有集群

bash
docker run --rm -it dweomer/serf join 192.168.1.100:7946

查看集群成员

bash
docker run --rm -it dweomer/serf members