goabout/hetzner-vip

hetzner-vip 镜像文档

镜像概述

hetzner-vip是为Hetzner Cloud环境适配的keepalived-vip实现，基于https://github.com/kubernetes-retired/contrib/tree/master/keepalived-vip%E9%A1%B9%E7%9B%AE%E4%BF%AE%E6%94%B9%E3%80%82%E8%AF%A5%E9%95%9C%E5%83%8F%E7%94%A8%E4%BA%8E%E5%9C%A8Kubernetes%E9%9B%86%E7%BE%A4%E4%B8%AD%E7%AE%A1%E7%90%86%E6%B5%AE%E5%8A%A8IP%EF%BC%88VIP%EF%BC%89%EF%BC%8C%E9%80%9A%E8%BF%87%E4%B8%8EHetzner Cloud API交互，实现VIP的自动分配、故障检测和转移，确保服务高可用性。

核心功能和特性

• Hetzner Cloud集成：与Hetzner Cloud API深度集成，支持浮动IP的动态管理
• 浮动IP管理：自动处理VIP的分配、绑定和解绑操作
• 高可用支持：实现节点故障时的VIP自动转移，确保服务不中断
• Kubernetes原生集成：通过ConfigMap和Secret管理配置，支持DaemonSet部署模式
• 单播模式：支持使用单播（unicast）进行节点间通信，适应Hetzner Cloud网络环境
• 命名空间监控：可配置监控单个或所有命名空间的服务

使用场景

• 在Hetzner Cloud上运行的Kubernetes集群中需要VIP的场景
• 需要实现服务高可用的应用，如负载均衡入口、数据库主从切换、API网关等
• 要求自动故障转移能力的关键业务系统

使用方法和配置说明

前提条件

• 已在Hetzner Cloud创建Kubernetes集群
• 拥有Hetzner Cloud API令牌（需具备浮动IP管理权限）
• 已准备好要使用的浮动IP地址

配置步骤

1. 创建ConfigMap

配置需要管理的浮动IP地址：

yaml
apiVersion: v1
kind: ConfigMap
metadata:
  name: kube-keepalived-vip-services-configmap
data:
  <IP_ADDRESS>: ""  # 与DaemonSet中的FLOATING_IP保持一致

2. 创建Secret

存储Hetzner Cloud API令牌（需Base64编码）：

yaml
apiVersion: v1
kind: Secret
data:
  HCLOUD_TOKEN: <BASE64_ENCODED_TOKEN>  # Hetzner Cloud API令牌的Base64编码值
metadata:
  name: kube-keepalived-vip-secrets

3. 创建DaemonSet

部署keepalived-vip组件：

yaml
apiVersion: apps/v1
kind: DaemonSet
metadata:
  name: keepalived-vip
spec:
  template:
    metadata:
      name: keepalived-vip
    spec:
      hostNetwork: true  # 使用主机网络
      containers:
        - name: keepalived-vip
          image: goabout/hetzner-vip
          imagePullPolicy: Always
          securityContext:
            privileged: true  # 需要特权模式以修改网络配置
          args:
            - --services-configmap=$(POD_NAMESPACE)/keepalived-vip-services
            - --watch-all-namespaces=true  # 监控所有命名空间
            - --use-unicast=true  # 使用单播模式
            - --logtostderr=true  # 日志输出到stderr
          envFrom:
            - secretRef:
                name: keepalived-vip-secrets  # 引用之前创建的Secret
          env:
            - name: POD_NAME
              valueFrom:
                fieldRef:
                  fieldPath: metadata.name  # 获取Pod名称
            - name: POD_NAMESPACE
              valueFrom:
                fieldRef:
                  fieldPath: metadata.namespace  # 获取Pod所在命名空间
            - name: NODE_NAME
              valueFrom:
                fieldRef:
                  fieldPath: spec.nodeName  # 获取节点名称
            - name: FLOATING_IP
              value: <IP_ADDRESS>  # 与ConfigMap中的IP保持一致
          volumeMounts:
            - name: modules
              mountPath: /lib/modules  # 挂载主机内核模块
              readOnly: true
            - name: dev
              mountPath: /dev  # 挂载设备目录
      volumes:
        - name: modules
          hostPath:
            path: /lib/modules  # 主机内核模块路径
        - name: dev
          hostPath:
            path: /dev  # 主机设备目录路径

参数说明

容器参数（args）

环境变量

注意事项

• 确保ConfigMap和DaemonSet中的<IP_ADDRESS>值完全一致
• HCLOUD_TOKEN必须进行Base64编码后存储在Secret中
• 由于需要修改网络配置，容器必须以特权模式运行（privileged: true）
• 主机网络（hostNetwork: true）是必要的，以确保网络配置对主机生效
• 卷挂载/lib/modules和/dev是运行keepalived服务的必要条件