jimmidyson/configmap-reload

Health v2 · maintenance only

Adoption not part of the score

1083 stars · 207 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

A small Go binary that watches Kubernetes ConfigMap and Secret volumes mounted into pods and triggers a reload when they change, currently by sending an HTTP webhook to the target process. It is typically deployed as a sidecar container and exposes Prometheus-style telemetry metrics on an HTTP endpoint.

Use cases

• reload my app automatically when a kubernetes configmap changes
• watch a mounted configmap volume and call a webhook on update
• hot reload configuration in a kubernetes pod
• sidecar to reload nginx or prometheus config when configmap updates
• trigger service reload when kubernetes secret is updated
• monitor configmap changes in a pod and notify the process

When to choose

• Your app in Kubernetes reads configuration from mounted ConfigMap or Secret volumes and cannot watch files itself
• You want a lightweight, single-purpose sidecar that POSTs to a reload endpoint whenever mounted config changes
• You need reload counts exposed as Prometheus metrics alongside the watching behavior

When to avoid

• Your application already supports native config hot-reload or in-process file watching
• You need OS signal-based reloads such as SIGHUP, which is not yet supported
• You are not running workloads on Kubernetes with volume-mounted ConfigMaps or Secrets
• You need reload notifications via mechanisms other than an HTTP request

Facets

cli-tool · maturity active

configuration-management webhook monitoring cloud-computing monitoring go cloud kubernetes-sidecar configmap config-reload hot-reload prometheus-metrics webhook-trigger kubernetes-secrets volume-watcher containers devops kubernetes docker linux

Member repositories

For agents

markdown · JSON · MCP: product_card(name="jimmidyson/configmap-reload")