bitnami/configmap-reload

Bitnami ConfigMap Reload 镜像文档

1. 镜像概述与主要用途

ConfigMap Reload 是一款云原生工具，用于监控 Kubernetes ConfigMap 的变更，并在检测到更新时触发目标应用的重载操作，实现配置的动态生效。Bitnami 提供的该镜像基于安全加固标准构建，集成了 Bitnami Secure Images 倡议的核心特性，适用于开发与生产环境中对配置更新敏感的 Kubernetes 应用场景。

2. 核心功能与特性

2.1 ConfigMap Reload 工具功能

• 实时监控：持续监听指定路径下的 ConfigMap 挂载文件，检测内容变更
• 自动触发重载：支持通过 HTTP 回调（Webhook）或命令执行方式触发应用重载
• 轻量设计：无状态架构，资源占用低，适合在 Kubernetes 集群中作为 Sidecar 容器部署

2.2 Bitnami 镜像特性

• 安全加固：基于 Photon Linux 最小操作系统，减少***面，符合 SLSA-3 供应链安全标准
• 非 Root 运行：默认使用非特权用户执行，降低容器逃逸风险，满足生产环境安全要求
• 合规支持：提供 SBOM（软件物料清单）、VEX/KEV 漏洞透明度报告及病毒扫描结果
• 动态更新：上游安全补丁发布后数小时内完成镜像更新，保障依赖组件安全性

3. 使用场景与适用范围

3.1 典型应用场景

• 动态配置更新：需实时加载 ConfigMap 变更的应用（如 Nginx、Prometheus、Envoy 等）
• Sidecar 部署模式：作为辅助容器与业务容器协同运行，监控配置文件并触发主应用重载
• CI/CD 集成：配合 Kubernetes 配置管理工具（如 Helm、Kustomize），实现配置更新自动化流程

3.2 适用范围

• Kubernetes 集群环境（1.16+ 版本）
• 依赖 ConfigMap 进行配置管理的无状态应用
• 需避免因配置更新导致服务中断的高可用场景

4. 使用方法

4.1 获取镜像

4.1.1 拉取预构建镜像

推荐从 Docker Hub 拉取最新版安全加固镜像：

bash
docker pull bitnami/configmap-reload:latest

如需指定版本，可通过标签获取（注意：2025年8月28日后，历史版本将迁移至 bitnamilegacy 仓库）：

bash
docker pull bitnami/configmap-reload:[TAG]  # 例如：bitnami/configmap-reload:0.16.0

4.1.2 手动构建镜像

通过源码构建（需替换 APP=configmap-reload、VERSION 及操作系统参数）：

bash
git clone https://github.com/bitnami/containers.git
cd bitnami/configmap-reload/[VERSION]/[OPERATING-SYSTEM]
docker build -t bitnami/configmap-reload:latest .

4.2 部署示例

4.2.1 Docker 本地运行（开发环境）

bash
docker run --rm \
  -v /path/to/configmaps:/etc/config \  # 挂载 ConfigMap 目录
  bitnami/configmap-reload:latest \
  --volume-dir=/etc/config \           # 监控目录
  --webhook-url=http://localhost:8080/reload  # 触发重载的 Webhook URL

4.2.2 Kubernetes Sidecar 部署（生产环境）

yaml
# deployment.yaml 片段
spec:
  containers:
  - name: app
    image: my-app:latest
    volumeMounts:
    - name: config-volume
      mountPath: /etc/config
  - name: configmap-reload
    image: bitnami/configmap-reload:latest
    args:
    - --volume-dir=/etc/config
    - --webhook-url=http://localhost:8080/reload  # 应用内的重载接口
    volumeMounts:
    - name: config-volume
      mountPath: /etc/config
      readOnly: true
  volumes:
  - name: config-volume
    configMap:
      name: my-app-config  # 目标 ConfigMap 名称

5. 配置说明

5.1 命令行参数

ConfigMap Reload 支持通过命令行参数配置核心行为，常用参数如下：

5.2 环境变量（Bitnami 镜像特有）

针对 Bitnami Secure Images 的安全配置，支持以下环境变量：

6. 注意事项

6.1 镜像仓库迁移通知（2025年8月28日起）

• 仓库变更：原 docker.io/bitnami 下的所有镜像（含历史版本标签，如 2.50.0、10.6）将迁移至 docker.io/bitnamilegacy，且不再接收更新
• 标签策略：社区版用户仅可访问 latest 标签的安全加固镜像（用于开发），生产环境需使用 Bitnami Secure Images 商业版
• 兼容性影响：迁移周期为两周，建议在此之前将依赖镜像路径更新为新仓库或商业版镜像

6.2 生产环境建议

• 避免使用 latest 标签，生产环境应指定具体版本标签（迁移前）或采用商业版安全镜像
• 通过 Kubernetes 资源限制（Resource Limits）控制容器资源占用，避免影响主应用
• 监控镜像拉取状态，确保迁移后镜像源配置正确（如使用 imagePullSecrets 配置商业版仓库认证）

7. 贡献与支持

7.1 贡献方式

通过 https://github.com/bitnami/containers GitHub 仓库提交 Issue 或 Pull Request，参与镜像优化与功能改进。

7.2 问题反馈

如遇容器运行问题，可通过 GitHub Issue 模板提交报告，包含以下信息以加速排查：

• 镜像版本与部署环境（Kubernetes 版本、Docker 版本）
• 容器日志与事件信息（kubectl logs/docker logs）
• 复现步骤与预期行为

8. 许可证

本镜像基于 Apache License 2.0 许可证分发。详细条款可参见 Apache 官方文档。

版权所有 © 2025 Broadcom。"Broadcom" 指 Broadcom Inc. 及其子公司。