# coffeegoesincodecomesout/silence-operator architecture

> Architecture diagram of the GitHub repository coffeegoesincodecomesout/silence-operator, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/coffeegoesincodecomesout/silence-operator
- Repository: https://github.com/coffeegoesincodecomesout/silence-operator

## Overview

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: [`internal/controller/silence_controller.go`](https://github.com/coffeegoesincodecomesout/silence-operator/blob/main/internal/controller/silence_controller.go) (v1 Reconciler), [`internal/controller/silence_v2_controller.go`](https://github.com/coffeegoesincodecomesout/silence-operator/blob/main/internal/controller/silence_v2_controller.go) (v2 Reconciler), [`pkg/config/config.go`](https://github.com/coffeegoesincodecomesout/silence-operator/blob/main/pkg/config/config.go) (Operator configuration), [`cmd/main.go`](https://github.com/coffeegoesincodecomesout/silence-operator/blob/main/cmd/main.go) (Operator startup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Operator runtime"]
  node_main["Operator startup<br/>[main.go]"]
  node_v1controller["v1 Reconciler"]
  node_v2controller["v2 Reconciler"]
end

subgraph group_apis["Silence APIs"]
  node_legacy["Legacy Silence API<br/>[silence_types.go]"]
  node_namespaced["Namespaced Silence API<br/>[silence_types.go]"]
end

subgraph group_sync["Alertmanager sync"]
  node_service["Silence service<br/>[silence.go]"]
  node_alertclient["Alertmanager client<br/>[alertmanager.go]"]
end

subgraph group_settings["Filtering and tenancy"]
  node_config["Operator configuration<br/>[config.go]"]
  node_tenancy["Tenant extraction<br/>[tenancy.go]"]
end

node_user(("Kubernetes user"))
node_kube[("Kubernetes API")]
node_alertmanager["Alertmanager"]

node_user -->|"creates or updates"| node_kube
node_kube -->|"dispatches changes"| node_v1controller
node_kube -->|"dispatches changes"| node_v2controller
node_v1controller -->|"reads resource"| node_legacy
node_v2controller -->|"reads resource"| node_namespaced
node_v1controller -->|"updates finalizer"| node_kube
node_v2controller -->|"updates finalizer"| node_kube
node_v1controller -->|"syncs or deletes"| node_service
node_v2controller -->|"syncs or deletes"| node_service
node_v1controller -->|"extracts tenant"| node_tenancy
node_v2controller -->|"extracts tenant"| node_tenancy
node_service -->|"manages silences"| node_alertclient
node_alertclient -->|"HTTP requests"| node_alertmanager
node_tenancy -->|"reads settings"| node_config
node_main -.->|"sets options"| node_config
node_config -.->|"filters resources"| node_v1controller
node_config -.->|"filters namespaces"| node_v2controller
node_main -.->|"registers reconciler"| node_v1controller
node_main -.->|"registers reconciler"| node_v2controller

click node_main "https://github.com/coffeegoesincodecomesout/silence-operator/blob/main/cmd/main.go"
click node_legacy "https://github.com/coffeegoesincodecomesout/silence-operator/blob/main/api/v1alpha1/silence_types.go"
click node_namespaced "https://github.com/coffeegoesincodecomesout/silence-operator/blob/main/api/v1alpha2/silence_types.go"
click node_v1controller "https://github.com/coffeegoesincodecomesout/silence-operator/blob/main/internal/controller/silence_controller.go"
click node_v2controller "https://github.com/coffeegoesincodecomesout/silence-operator/blob/main/internal/controller/silence_v2_controller.go"
click node_service "https://github.com/coffeegoesincodecomesout/silence-operator/blob/main/pkg/service/silence.go"
click node_alertclient "https://github.com/coffeegoesincodecomesout/silence-operator/blob/main/pkg/alertmanager/alertmanager.go"
click node_config "https://github.com/coffeegoesincodecomesout/silence-operator/blob/main/pkg/config/config.go"
click node_tenancy "https://github.com/coffeegoesincodecomesout/silence-operator/blob/main/pkg/tenancy/tenancy.go"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_main,node_v1controller,node_v2controller,node_user toneBlue
class node_legacy,node_namespaced,node_kube toneAmber
class node_service,node_alertclient toneMint
class node_config,node_tenancy toneRose
class node_alertmanager toneIndigo
```

## Components

### Operator runtime

- [Operator startup](https://github.com/coffeegoesincodecomesout/silence-operator/blob/main/cmd/main.go): `cmd/main.go`
- [v1 Reconciler](https://github.com/coffeegoesincodecomesout/silence-operator/blob/main/internal/controller/silence_controller.go): `internal/controller/silence_controller.go`
- [v2 Reconciler](https://github.com/coffeegoesincodecomesout/silence-operator/blob/main/internal/controller/silence_v2_controller.go): `internal/controller/silence_v2_controller.go`

### Silence APIs

- [Legacy Silence API](https://github.com/coffeegoesincodecomesout/silence-operator/blob/main/api/v1alpha1/silence_types.go): `api/v1alpha1/silence_types.go`
- [Namespaced Silence API](https://github.com/coffeegoesincodecomesout/silence-operator/blob/main/api/v1alpha2/silence_types.go): `api/v1alpha2/silence_types.go`

### Alertmanager sync

- [Silence service](https://github.com/coffeegoesincodecomesout/silence-operator/blob/main/pkg/service/silence.go): `pkg/service/silence.go`
- [Alertmanager client](https://github.com/coffeegoesincodecomesout/silence-operator/blob/main/pkg/alertmanager/alertmanager.go): `pkg/alertmanager/alertmanager.go`

### Filtering and tenancy

- [Operator configuration](https://github.com/coffeegoesincodecomesout/silence-operator/blob/main/pkg/config/config.go): `pkg/config/config.go`
- [Tenant extraction](https://github.com/coffeegoesincodecomesout/silence-operator/blob/main/pkg/tenancy/tenancy.go): `pkg/tenancy/tenancy.go`

### Other components

- **Kubernetes user**
- **Kubernetes API**
- **Alertmanager**

## Connections

- Kubernetes user → Kubernetes API: creates or updates (evidence: `README.md`)
- Kubernetes API → v1 Reconciler: dispatches changes (evidence: `README.md`)
- Kubernetes API → v2 Reconciler: dispatches changes (evidence: `README.md`)
- v1 Reconciler → Legacy Silence API: reads resource (evidence: `internal/controller/silence_controller.go`)
- v2 Reconciler → Namespaced Silence API: reads resource (evidence: `internal/controller/silence_v2_controller.go`)
- v1 Reconciler → Kubernetes API: updates finalizer (evidence: `internal/controller/silence_controller.go`)
- v2 Reconciler → Kubernetes API: updates finalizer (evidence: `internal/controller/silence_v2_controller.go`)
- v1 Reconciler → Silence service: syncs or deletes (evidence: `internal/controller/silence_controller.go`)
- v2 Reconciler → Silence service: syncs or deletes (evidence: `internal/controller/silence_v2_controller.go`)
- v1 Reconciler → Tenant extraction: extracts tenant (evidence: `internal/controller/silence_controller.go`)
- v2 Reconciler → Tenant extraction: extracts tenant (evidence: `internal/controller/silence_v2_controller.go`)
- Silence service → Alertmanager client: manages silences (evidence: `pkg/service/silence.go`)
- Alertmanager client → Alertmanager: HTTP requests (evidence: `pkg/alertmanager/alertmanager.go`)
- Tenant extraction → Operator configuration: reads settings (evidence: `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
