Niklas Ye
e1103f2b7d
Credentials: the TerdutServer controller generates <name>-operator-key in the server's own namespace (owned by it) and hands it to the pods as TERDUT_OPERATOR_KEY; the server creates its instance-scoped account from it at every start. A replaced Secret rolls the pods. The bootstrap handshake, the checkpoint Secret, per-team service accounts and credentials Secrets, BootstrapStateLost and credentials.deletionPolicy are gone. CRDs: TerdutServer, TerdutTeam and TerdutAlertSource. TerdutEscalationRule and TerdutDeadmanSwitch become spec.escalation and spec.deadmanSwitches[] on the team (matched by name, extras removed); team invites are removed. A team is created under the identity <namespace>/<name> (external_id), so a retry, a lost status or a deleted team heal by repeating the same call, and a display name owned by another team is TeamNameTaken instead of an adoption. The server resolves escalation usernames (UnknownUser condition). OIDC claim names and trustEmail are spec fields. Fixes: query values are URL-escaped; every delete treats 404 as success; deleting a team no longer depends on allowedTeams consent; a switch or integration deleted on the server is recreated; unnamed switches take the CR's name. Cleanup: scaffold e2e test, AGENTS.md, devcontainer, unused config/ pieces and Client.Version() removed; DESIGN.md, README, ROADMAP and the demo (run-demo.sh, manifests) rewritten for the new design. Secret RBAC stays cluster-wide, now stated in DESIGN.md section 9. Claude-Session: https://claude.ai/code/session_016mBLURvJoMuUEr9cB2RpUN
194 lines
8.5 KiB
YAML
194 lines
8.5 KiB
YAML
---
|
|
apiVersion: apiextensions.k8s.io/v1
|
|
kind: CustomResourceDefinition
|
|
metadata:
|
|
annotations:
|
|
controller-gen.kubebuilder.io/version: v0.22.0
|
|
name: terdutalertsources.terdut.ryuvia.com
|
|
spec:
|
|
group: terdut.ryuvia.com
|
|
names:
|
|
kind: TerdutAlertSource
|
|
listKind: TerdutAlertSourceList
|
|
plural: terdutalertsources
|
|
singular: terdutalertsource
|
|
scope: Namespaced
|
|
versions:
|
|
- additionalPrinterColumns:
|
|
- jsonPath: .spec.teamRef.name
|
|
name: Team
|
|
type: string
|
|
- jsonPath: .status.integrationID
|
|
name: IntegrationID
|
|
type: integer
|
|
- jsonPath: .status.conditions[?(@.type=="Ready")].status
|
|
name: Ready
|
|
type: string
|
|
- jsonPath: .status.conditions[?(@.type=="Ready")].reason
|
|
name: Reason
|
|
type: string
|
|
name: v1alpha1
|
|
schema:
|
|
openAPIV3Schema:
|
|
description: TerdutAlertSource is the Schema for the terdutalertsources API
|
|
properties:
|
|
apiVersion:
|
|
description: |-
|
|
APIVersion defines the versioned schema of this representation of an object.
|
|
Servers should convert recognized schemas to the latest internal value, and
|
|
may reject unrecognized values.
|
|
More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
|
|
type: string
|
|
kind:
|
|
description: |-
|
|
Kind is a string value representing the REST resource this object represents.
|
|
Servers may infer this from the endpoint the client submits requests to.
|
|
Cannot be updated.
|
|
In CamelCase.
|
|
More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
|
|
type: string
|
|
metadata:
|
|
type: object
|
|
spec:
|
|
description: spec defines the desired state of TerdutAlertSource
|
|
properties:
|
|
kind:
|
|
default: alertmanager
|
|
description: |-
|
|
kind is the alert source type. Only "alertmanager" is supported
|
|
today, mirroring terdut-server's own CHECK constraint on
|
|
integrations.kind (internal/db/migrations/003_teams.sql) --
|
|
confirmed against source, not assumed. Changing it after the
|
|
integration already exists rotates the webhook key (DESIGN.md §5's
|
|
reconciliation table): the old one is deleted and a fresh one
|
|
created, which breaks whatever sends to the old URL until the new
|
|
Secret is picked up.
|
|
enum:
|
|
- alertmanager
|
|
type: string
|
|
name:
|
|
description: |-
|
|
name is this source's own display name server-side -- distinct from
|
|
this object's own metadata.name. POST
|
|
/api/teams/{teamID}/integrations {"name": ...} at creation, and what
|
|
PATCH renames thereafter; renaming never rotates the webhook key.
|
|
minLength: 1
|
|
type: string
|
|
teamRef:
|
|
description: |-
|
|
TerdutTeamRef names the TerdutTeam a TerdutAlertSource belongs to. Always
|
|
same-namespace as the CR itself.
|
|
properties:
|
|
name:
|
|
minLength: 1
|
|
type: string
|
|
required:
|
|
- name
|
|
type: object
|
|
required:
|
|
- name
|
|
- teamRef
|
|
type: object
|
|
status:
|
|
description: status defines the observed state of TerdutAlertSource
|
|
properties:
|
|
conditions:
|
|
items:
|
|
description: Condition contains details for one aspect of the current
|
|
state of this API Resource.
|
|
properties:
|
|
lastTransitionTime:
|
|
description: |-
|
|
lastTransitionTime is the last time the condition transitioned from one status to another.
|
|
This should be when the underlying condition changed. If that is not known, then using the time when the API field changed is acceptable.
|
|
format: date-time
|
|
type: string
|
|
message:
|
|
description: |-
|
|
message is a human readable message indicating details about the transition.
|
|
This may be an empty string.
|
|
maxLength: 32768
|
|
type: string
|
|
observedGeneration:
|
|
description: |-
|
|
observedGeneration represents the .metadata.generation that the condition was set based upon.
|
|
For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date
|
|
with respect to the current state of the instance.
|
|
format: int64
|
|
minimum: 0
|
|
type: integer
|
|
reason:
|
|
description: |-
|
|
reason contains a programmatic identifier indicating the reason for the condition's last transition.
|
|
Producers of specific condition types may define expected values and meanings for this field,
|
|
and whether the values are considered a guaranteed API.
|
|
The value should be a CamelCase string.
|
|
This field may not be empty.
|
|
maxLength: 1024
|
|
minLength: 1
|
|
pattern: ^[A-Za-z]([A-Za-z0-9_,:]*[A-Za-z0-9_])?$
|
|
type: string
|
|
status:
|
|
description: status of the condition, one of True, False, Unknown.
|
|
enum:
|
|
- "True"
|
|
- "False"
|
|
- Unknown
|
|
type: string
|
|
type:
|
|
description: type of condition in CamelCase or in foo.example.com/CamelCase.
|
|
maxLength: 316
|
|
pattern: ^([a-z0-9]([-a-z0-9]*[a-z0-9])?(\.[a-z0-9]([-a-z0-9]*[a-z0-9])?)*/)?(([A-Za-z0-9][-A-Za-z0-9_.]*)?[A-Za-z0-9])$
|
|
type: string
|
|
required:
|
|
- lastTransitionTime
|
|
- message
|
|
- reason
|
|
- status
|
|
- type
|
|
type: object
|
|
type: array
|
|
x-kubernetes-list-map-keys:
|
|
- type
|
|
x-kubernetes-list-type: map
|
|
integrationID:
|
|
description: integrationID is the server-side id.
|
|
format: int64
|
|
type: integer
|
|
lastAppliedKind:
|
|
description: |-
|
|
lastAppliedKind is the kind the currently-live integration was
|
|
actually created with -- compared against spec.kind on every
|
|
reconcile to detect the one spec change that requires
|
|
delete-and-recreate (DESIGN.md §5), since terdut-server's own API has
|
|
no way to read a live integration's kind back for comparison.
|
|
type: string
|
|
observedGeneration:
|
|
format: int64
|
|
type: integer
|
|
webhookURLSecretRef:
|
|
description: |-
|
|
webhookURLSecretRef names the generated Secret holding "url" and
|
|
"key" -- the integration's webhook address and credential, shown by
|
|
terdut-server's API exactly once, at creation (DESIGN.md §4.5), and
|
|
never re-readable afterward, including from this status. Lives in
|
|
this CR's own namespace with a plain OwnerReference (§7) -- unlike
|
|
TerdutServer/TerdutTeam's credential Secrets, this one never crosses
|
|
namespaces, so no finalizer cleanup is needed for it specifically.
|
|
properties:
|
|
name:
|
|
description: name is the Secret's name.
|
|
minLength: 1
|
|
type: string
|
|
required:
|
|
- name
|
|
type: object
|
|
type: object
|
|
required:
|
|
- spec
|
|
type: object
|
|
served: true
|
|
storage: true
|
|
subresources:
|
|
status: {}
|