morecontainers/reloader

Pod Reloader

镜像概述

Pod Reloader是一个Kubernetes环境下的配置自动重载工具，用于解决应用配置动态更新的问题。当指定的ConfigMap发生变更时，该工具会自动将配置文件同步到应用的指定路径，并通过HTTP端点或文件触发应用重新加载配置，无需重启Pod。

核心功能

• 监控Kubernetes ConfigMap变化，实时检测配置更新
• 将ConfigMap中的配置文件同步至应用指定路径
• 支持通过HTTP端点触发应用配置重载
• 支持通过创建/更新文件（RELOADER_TOUCHFILE）触发配置重载
• 提供初始化容器（initContainers）用于首次配置同步

使用场景

适用于Kubernetes集群中需要动态更新配置的应用，特别是那些不具备内置配置热重载功能的应用，例如：

• Prometheus监控配置更新
• NGINX反向代理配置变更
• HAProxy负载均衡器配置调整
• Docker Registry配置更新

使用方法

部署示例

Kubernetes Deployment配置

yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: prometheus
spec:
  selector:
    matchLabels:
      app: prometheus
  template:
    metadata:
      labels:
        app: prometheus
    spec:
      initContainers:
      - name: reloader-init
        image: docker.io/morecontainers/reloader:latest
        env:
        - {name: RELOADER_INIT,      value: "1"}  # 启用初始化模式
        - {name: RELOADER_CONFIGMAP, value: prometheus}  # 要监控的ConfigMap名称
        - {name: RELOADER_PATH,      value: /config}  # 配置文件同步路径
      containers:
      - name: prometheus
        image: victoriametrics/victoria-metrics:v1.56.0
        args: ["-promscrape.config","/config/prometheus.yml"]  # 从同步路径加载配置
        ports:
        - containerPort: 8428
        volumeMounts:
        - name: config-volume
          mountPath: /config  # 挂载配置卷
      - name: reloader
        image: docker.io/morecontainers/reloader:latest
        env:
        - {name: RELOADER_CONFIGMAP, value: prometheus}  # 要监控的ConfigMap名称
        - {name: RELOADER_PATH,      value: /config}  # 配置文件同步路径
        - {name: RELOADER_ENDPOINT,  value: "http://localhost:8428/-/reload"}  # 重载触发HTTP端点
        volumeMounts:
        - name: config-volume
          mountPath: /config  # 挂载配置卷
      volumes:
      - name: config-volume
        emptyDir: {}  # 用于在容器间共享配置的临时存储

ConfigMap配置

yaml
apiVersion: v1
kind: ConfigMap
metadata:
  name: prometheus  # 需与Deployment中RELOADER_CONFIGMAP值一致
data:
  prometheus.yml: |  # 配置文件名，需与应用加载的文件名一致
    global:
      scrape_interval: 5s
    scrape_configs:
     - job_name: haproxy
       static_configs:
       - targets: ['haproxy:8428']

环境变量说明

RBAC配置

为使Pod Reloader能够监控ConfigMap变化，需为服务账户授予查看ConfigMap的权限：

sh
kubectl create rolebinding serviceaccounts-view \
  --clusterrole=view \
  --group=system:serviceaccounts:default \
  --namespace=default

支持的应用

• Prometheus：通过/-/reload HTTP端点触发配置重载
• NGINX：可通过发送信号（如SIGHUP）或HTTP端点触发重载
• HAProxy：支持通过命令行或信号触发配置重载
• Docker Registry：通过RELOADER_TOUCHFILE创建文件触发重载

预构建容器

预构建镜像可在Docker Hub获取：
https://hub.docker.com/repository/docker/morecontainers/reloader

作者

• Henrik Holst (***)