How coffeegoesincodecomesout/silence-operator works
Silence Operator turns declarative Kubernetes Silence resources into matching Alertmanager silences. Users create or update either the legacy cluster-scoped v1alpha1 resource or the recommended namespace-scoped v1alpha2 resource; the corresponding reconciler reads it, handles lifecycle/finalizers, derives matchers, timing and tenant, then delegates synchronization or deletion through the silence service to Alertmanager. Both APIs and their selector behavior are represented. Startup wiring and some configuration-to-controller links are unsampled, so those links are marked unverified rather than asserted.
Main entry points: silence_controller.go v1 Reconciler · silence_v2_controller.go v2 Reconciler · config.go Operator configuration · main.go Operator startup
Components 12
Operator runtime
- Operator startup
cmd/main.go - v1 Reconciler
internal/controller/silence_controller.go - v2 Reconciler
internal/controller/silence_v2_controller.go
Silence APIs
- Legacy Silence API
api/v1alpha1/silence_types.go - Namespaced Silence API
api/v1alpha2/silence_types.go
Alertmanager sync
- Silence service
pkg/service/silence.go - Alertmanager client
pkg/alertmanager/alertmanager.go
Filtering and tenancy
- Operator configuration
pkg/config/config.go - Tenant extraction
pkg/tenancy/tenancy.go
Other components
- Kubernetes user
- Kubernetes API
- Alertmanager
Connections 19
- Kubernetes user → Kubernetes API: creates or updates
README.md - Kubernetes API → v1 Reconciler: dispatches changes
README.md - Kubernetes API → v2 Reconciler: dispatches changes
README.md - v1 Reconciler → Legacy Silence API: reads resource
internal/controller/silence_controller.go - v2 Reconciler → Namespaced Silence API: reads resource
internal/controller/silence_v2_controller.go - v1 Reconciler → Kubernetes API: updates finalizer
internal/controller/silence_controller.go - v2 Reconciler → Kubernetes API: updates finalizer
internal/controller/silence_v2_controller.go - v1 Reconciler → Silence service: syncs or deletes
internal/controller/silence_controller.go - v2 Reconciler → Silence service: syncs or deletes
internal/controller/silence_v2_controller.go - v1 Reconciler → Tenant extraction: extracts tenant
internal/controller/silence_controller.go - v2 Reconciler → Tenant extraction: extracts tenant
internal/controller/silence_v2_controller.go - Silence service → Alertmanager client: manages silences
pkg/service/silence.go - Alertmanager client → Alertmanager: HTTP requests
pkg/alertmanager/alertmanager.go - Tenant extraction → Operator configuration: reads settings
pkg/tenancy/tenancy.go - Operator startup → Operator configuration: sets options
- Operator configuration → v1 Reconciler: filters resources
- Operator configuration → v2 Reconciler: filters namespaces
- Operator startup → v1 Reconciler: registers reconciler
- Operator startup → v2 Reconciler: registers reconciler