kube-configmap-watcher

A lightweight Go-based tool that monitors Kubernetes ConfigMap and Pod events in real-time using the client-go informer framework.

Features

• 🔍 Watches ConfigMap and Pod add, update, and delete events
• 🔗 Indexes Pods based on referenced ConfigMaps
• 📌 Maps ConfigMap updates to affected Pods
• 🛑 Graceful shutdown with signal handling
• ⚡ Built using Kubernetes Shared Informer framework

Prerequisites

• Go 1.24.5+ (for local development)
• Access to a Kubernetes cluster
• kubectl configured with appropriate cluster access

Usage

Local Development

go mod tidy
go build -o configmap-watcher
./configmap-watcher -kubeconfig=/path/to/kubeconfig

Deploy to Kubernetes

The included manifest creates all necessary RBAC resources and deploys the watcher:

kubectl apply -f configmap-watcher.yaml

To view logs:

kubectl logs -f deployment/configmap-watcher -n configmap-watcher

Note: When running inside a Kubernetes cluster, the -kubeconfig flag is optional as it uses in-cluster configuration.