niklas 7fb8042265
CI / chart (push) Successful in 1s
CI / security (push) Successful in 56s
CI / test (push) Successful in 2m31s
Merge pull request 'Authenticate with a seeded operator key; fold escalation and switches into TerdutTeam' (#12) from operator-key-and-team-config into main
Reviewed-on: #12
2026-10-09 20:20:13 +00:00
2026-10-09 22:05:15 +02:00
2026-10-09 22:05:15 +02:00

Terdut operator

Exposes terdut-server's configuration as Kubernetes objects, so teams can self-service it over gitops. See DESIGN.md for the design (read its revision section first: it is the current shape of credentials and the CRD catalog), and examples/demo for a working install.

CRDs

TerdutServer

A terdut-server install: Deployment, Service, database wiring (a DSN, or a Zalando postgresClusterRef), and an operator key Secret it hands to the server so the operator can authenticate. allowedTeams consents to TerdutTeams in other namespaces.

TerdutTeam

One team on a server, possibly in another namespace (serverRef, gated by that server's allowedTeams). It carries the team's whole configuration:

  • displayName and OIDC group bindings
  • escalation — the escalation ladder
  • deadmanSwitches — dead man's switches, by name (switches not listed are removed)

TerdutAlertSource

An alert-ingest integration on a team (teamRef). The server shows the webhook key once; it is surfaced only through a generated Secret next to the object, never set explicitly.

Demo

examples/demo wires one of each together — two teams, each with an escalation ladder, a dead man's switch and an alert source — plus a script that fires synthetic Alertmanager webhooks at it, so you can watch incidents open, escalate and resolve without a real Alertmanager.

S
Description
No description provided
Readme 1.5 MiB
Languages
Go 89.4%
Makefile 8.7%
Go Template 1.1%
Dockerfile 0.8%