strausmann/keepalived

strausmann/keepalived

![GitLab Pipeline]([] ![MIT License]([] ![Open in Gitpod]([***]

最新版本：2.2.7 - Keepalived 2.2.7 - 变更日志 | https://hub.docker.com/r/strausmann/keepalived/

用于运行Keepalived的Docker镜像。

keepalived.org

• strausmann/keepalived
  • 快速启动
  • 入门指南
  • 使用自定义Keepalived配置
  • 修复Docker挂载文件问题
  • 调试
• 环境变量
  • 设置自定义环境变量
    • 使用命令行参数
    • 链接环境文件
    • 创建自定义镜像或扩展此镜像
• 高级用户指南
  • 扩展strausmann/keepalived镜像
  • 创建自定义keepalived镜像
  • 测试
  • 底层依赖：osixia/light-baseimage
• 安全
• 帮助链接
• 变更日志
• 许可证

快速启动

此镜像要求主机已加载ip_vs内核模块（modprobe ip_vs），且运行时需添加以下参数：--cap-add=NET_ADMIN --net=host

docker
docker run --cap-add=NET_ADMIN --cap-add=NET_BROADCAST --cap-add=NET_RAW --net=host -d strausmann/keepalived:2.2.7

入门指南

使用自定义Keepalived配置

此镜像默认包含一个可通过环境变量快速定制的keepalived配置文件，但也支持使用自定义keepalived.conf。有两种方式：

• 运行时将配置文件挂载到/container/service/keepalived/assets/keepalived.conf：

  docker
  docker run --volume /data/my-keepalived.conf:/container/service/keepalived/assets/keepalived.conf --detach strausmann/keepalived:2.2.7
  

• 通过扩展或克隆此镜像添加配置文件，详情参见高级用户指南

修复Docker挂载文件问题

在某些系统上，挂载文件可能出现问题。启动脚本会尝试调整文件所有者和权限，这可能导致错误。详见Docker文档。

如需修复，运行容器时添加--copy-service参数：

docker
docker run [你的选项] strausmann/keepalived:2.2.7 --copy-service

调试

容器默认日志级别为info。可用级别：none、error、warning、info、debug和trace。

示例：以debug模式运行容器

docker
docker run --detach strausmann/keepalived:2.2.7 --loglevel debug

查看所有命令行选项：

docker
docker run strausmann/keepalived:2.2.7 --help

环境变量

环境变量默认值在image/environment/default.yaml中设置。

查看如何设置自定义环境变量

• KEEPALIVED_INTERFACE：Keepalived网络接口。默认值：eth0

• KEEPALIVED_PASSWORD：Keepalived密码。默认值：d0cker

• KEEPALIVED_PRIORITY：Keepalived节点优先级。默认值：150

• KEEPALIVED_ROUTER_ID：Keepalived虚拟路由ID。默认值：51

• KEEPALIVED_UNICAST_PEERS：Keepalived单播对等节点。默认值： - 192.168.1.10 - 192.168.1.11

  如需在docker run命令中设置此变量，需添加标签#PYTHON2BASH:并将YAML转换为Python格式：

  docker
  docker run --env KEEPALIVED_UNICAST_PEERS="#PYTHON2BASH:['192.168.1.10', '192.168.1.11']" --detach strausmann/keepalived:2.2.7
  

  在线YAML转Python工具：[***]

• KEEPALIVED_VIRTUAL_IPS：Keepalived虚拟IP。默认值：

  - 192.168.1.231
  - 192.168.1.232
  

  如需在docker run命令中设置此变量，需按上述方法将YAML转换为Python格式。

• KEEPALIVED_NOTIFY：节点状态变化时执行的脚本。默认值：/container/service/keepalived/assets/notify.sh

• KEEPALIVED_COMMAND_LINE_ARGUMENTS：Keepalived命令行参数；默认值：--log-detail --dump-conf

• KEEPALIVED_STATE：Keepalived启动状态；可选值：MASTER或BACKUP。

设置自定义环境变量

使用命令行参数

可通过--env参数在命令行设置环境变量，例如：

docker
docker run --env KEEPALIVED_INTERFACE="eno1" --env KEEPALIVED_PASSWORD="password!" \
--env KEEPALIVED_PRIORITY="100" --detach strausmann/keepalived:2.2.7

链接环境文件

例如，环境文件路径为：/data/environment/my-env.yaml

docker
docker run --volume /data/environment/my-env.yaml:/container/environment/01-custom/env.yaml \
--detach strausmann/keepalived:2.2.7

注意需将环境文件链接到/container/environment/XX-somedir（XX < 99，确保在默认环境文件前处理），不要直接链接到/container/environment，因为该目录包含预定义的基础镜像环境文件（用于修复INITRD、LANG、LANGUAGE和LC_CTYPE等容器环境变量）。

创建自定义镜像或扩展此镜像

如拥有私有仓库，这是最佳方案。详情参见下方高级用户指南。

高级用户指南

扩展strausmann/keepalived:2.2.7镜像

如需添加自定义TLS证书、引导配置或环境文件，最简单的方法是扩展此镜像。

Dockerfile示例：

dockerfile
FROM strausmann/keepalived:2.2.7
MAINTAINER 你的姓名 <your@name.com>

ADD keepalived.conf /container/service/keepalived/assets/keepalived.conf
ADD environment /container/environment/01-custom
ADD scripts.sh /container/service/keepalived/assets/notify.sh

创建自定义keepalived镜像

克隆项目：

bash
git clone https://github.com/osixia/docker-keepalived
cd docker-keepalived

修改Makefile，设置镜像名称和版本，例如：

make
NAME = osixia/keepalived
VERSION = 1.3.5

改为：
NAME = billy-the-king/keepalived
VERSION = 0.1.0

添加自定义脚本、环境文件、配置等。

构建镜像：

bash
make build

运行镜像：

docker
docker run -d billy-the-king/keepalived:0.1.0

测试

使用Bats（Bash自动化测试系统）测试此镜像：

https://github.com/bats-core/bats-core

安装Bats后，在项目目录中运行：

bash
make test

底层依赖：osixia/light-baseimage

此镜像基于osixia/light-baseimage构建。更多信息：https://github.com/osixia/docker-light-baseimage

安全

如发现此Docker镜像中的安全漏洞，请发送邮件至***。对于次要漏洞，也可通过上述***提交issue。

请包含尽可能多的细节。

帮助链接

• https://github.com/osixia/docker-keepalived

变更日志

详见：CHANGELOG.md

许可证

详见：LICENSE