jimmidyson/configmap-reload

Kubernetes ConfigMap Reload

镜像概述和主要用途

configmap-reload 是一个简单的二进制工具，用于在Kubernetes ConfigMap更新时触发重载操作。它通过监视挂载的卷目录，当检测到ConfigMap更新时，向目标进程发送通知。目前仅支持发送HTTP请求，未来计划在Kubernetes支持Pod PID命名空间后增加OS信号（如SIGHUP）支持。该镜像可从Docker Hub获取：https://hub.docker.com/r/jimmidyson/configmap-reload%E3%80%82

核心功能和特性

• 监视ConfigMap挂载卷目录的更新事件
• 支持通过HTTP请求触发目标进程重载
• 可配置HTTP请求方法和成功状态码
• 轻量级设计，易于集成到Kubernetes部署中

使用场景和适用范围

适用于Kubernetes环境中需要在ConfigMap更新后自动触发应用配置重载的场景，例如：

• Web服务配置更新后无需手动重启
• 微服务动态加载最新配置
• 配置驱动型应用的自动配置刷新

使用方法和配置说明

命令行参数

Docker运行示例

bash
docker run -v /path/to/configmap-volume:/etc/config \
  jimmidyson/configmap-reload \
  -volume-dir=/etc/config \
  -webhook-url=http://target-service:8080/reload \
  -webhook-method=POST \
  -webhook-status-code=200

Kubernetes部署示例

在Kubernetes Pod中作为Sidecar容器使用：

yaml
spec:
  containers:
  - name: app
    image: your-app-image
    volumeMounts:
    - name: config-volume
      mountPath: /etc/config
  - name: configmap-reload
    image: jimmidyson/configmap-reload
    args:
    - -volume-dir=/etc/config
    - -webhook-url=http://localhost:8080/reload
    volumeMounts:
    - name: config-volume
      mountPath: /etc/config
  volumes:
  - name: config-volume
    configMap:
      name: your-configmap-name

许可证

本项目采用 Apache许可。