basefly/keepalived

basefly/keepalived 镜像文档

镜像概述

basefly/keepalived是一个基于Alpine Linux构建的轻量级高可用解决方案镜像，集成了keepalived和curl工具。该镜像支持arm64和amd64两种架构，可用于实现服务器或服务的故障转移和VIP（虚拟IP）管理，确保服务持续可用。

核心功能与特性

• 轻量级基础：基于Alpine Linux，镜像体积小，资源占用低
• 多架构支持：同时支持arm64和amd64架构，适配不同硬件环境
• 高可用保障：集成keepalived实现VIP自动漂移和故障转移
• 健康检查：内置curl工具支持服务健康检查脚本
• 灵活配置：支持通过挂载配置文件自定义keepalived行为

使用场景

• Kubernetes集群控制平面高可用（如API Server VIP管理）
• 负载均衡器（LB）的主备切换
• 关键服务的故障自动转移
• 需要VIP漂移功能的高可用架构

使用方法

基本运行命令

使用docker运行（需提前准备keepalived.conf配置文件）：

bash
docker run -d \
  --name keepalived \
  --restart always \
  -v /etc/keepalived/keepalived.conf:/etc/keepalived/keepalived.conf \
  --network=host \
  --privileged \
  basefly/keepalived

使用containerd/nerdctl运行：

bash
nerdctl run -d \
  --name keepalived \
  --restart always \
  -v /etc/keepalived/keepalived.conf:/etc/keepalived/keepalived.conf \
  --network=host \
  --privileged \
  basefly/keepalived

配置文件说明

Master节点配置示例

json
global_defs {
    router_id lb-master  # 路由标识，建议唯一
}

vrrp_script check {
    script "curl -k https://127.0.0.1:6443/readyz"  # 健康检查脚本（示例为K8s API健康检查）
    interval 3  # 检查间隔（秒）
    timeout 9   # 超时时间（秒）
    fall 2      # 连续失败次数达到此值触发切换
    rise 2      # 连续成功次数达到此值恢复
}

vrrp_instance VI-kube-master {
    state MASTER          # 节点角色（MASTER/BACKUP）
    priority 120          # 优先级（MASTER应高于BACKUP）
    unicast_src_ip {{.Master0}}  # 本地IP地址
    unicast_peer {
      {{.Master1}}        # 对等节点IP地址
    }
    dont_track_primary    # 不跟踪主接口状态
    interface {{.Interface}}  # 绑定的网络接口（如eth0）
    virtual_router_id 111 # 虚拟路由ID（主备节点需一致）
    advert_int 3          # 通告间隔（秒）
    track_script {
        check             # 引用健康检查脚本
    }
    virtual_ipaddress {
        {{.Vip}}          # 虚拟IP地址（VIP）
    }
}

Backup节点配置示例

json
global_defs {
    router_id lb-backup-{{.Master1}}  # 路由标识，与MASTER区分
}

vrrp_script check {
    script "curl -k https://127.0.0.1:6443/readyz"  # 与MASTER相同的健康检查脚本
    interval 3
    timeout 9
    fall 2
    rise 2
}

vrrp_instance VI-kube-master {
    state BACKUP          # 节点角色为BACKUP
    priority 105          # 优先级低于MASTER（如105 < 120）
    unicast_src_ip {{.Master1}}  # 本地IP地址
    unicast_peer {
        {{.Master0}}      # 对等节点（MASTER）IP地址
    }
    dont_track_primary
    interface {{.Interface}}  # 与MASTER相同的网络接口
    virtual_router_id 111 # 与MASTER相同的虚拟路由ID
    advert_int 3
    track_script {
        check
    }
    virtual_ipaddress {
        {{.Vip}}          # 与MASTER相同的VIP
    }
}

配置参数说明：

• router_id：节点唯一标识
• state：节点角色（MASTER/BACKUP）
• priority：优先级，值越高越优先成为主节点
• unicast_src_ip：本地IP地址
• unicast_peer：对等节点IP列表
• interface：绑定的网络接口
• virtual_router_id：虚拟路由ID（0-255，主备节点需一致）
• virtual_ipaddress：需要漂移的VIP地址
• vrrp_script：健康检查脚本配置，用于检测服务状态

镜像构建

如需自定义构建镜像，可使用以下命令（支持多平台构建）：

bash
docker buildx build \
  -t basefly/keepalived:v2.2.4 \
  --platform=linux/arm64,linux/amd64 \
  . \
  --push

Dockerfile解析：

bash
FROM alpine  # 基于Alpine基础镜像
RUN apk --no-cache add keepalived curl  # 安装keepalived和curl工具

# 启动命令：清理运行文件并启动keepalived（前台运行模式）
CMD rm -rf /var/run/keepalived/* && \
    /usr/sbin/keepalived --dont-fork --log-console -f /etc/keepalived/keepalived.conf

注意事项

1. 必须使用--privileged特权模式运行，以确保keepalived能正常管理网络接口
2. 建议使用--network=host网络模式，确保VIP配置生效
3. 配置文件需正确挂载到/etc/keepalived/keepalived.conf路径
4. 主备节点的virtual_router_id必须一致，priority需区分（MASTER > BACKUP）
5. 健康检查脚本需根据实际服务情况调整，确保能准确检测服务状态