hermes-bot
6f1a7b6d96
Folds the good parts of #1412 into this PR and addresses both review-bot reviews (#1412 review 1789, #1414 review 1791): - Everything after the OpenBao store is best-effort. Decode, reconnect, listing and revokes run in reap_superseded(); reap_summary() turns any error into "reap skipped" plus a warning, so rotate_ha_token returns Ok. A failed run would start a second pod (backoffLimit: 1) that keeps the token just stored and its successor and reaps the token consumers still hold until ESO syncs, i.e. the #1081 outage. Two unit tests cover it. - Warn when the replaced token is not named "<client_name> [<6 hex>]": no later run reaps it, so it needs a manual revoke (from #1412). - Staged image rollout (from #1412): only the three HA CronJobs carry the flux-system:secret-rotator marker; the other 17 rotators stay on 2026-07-30 until a manual HA run validates the new binary, then a follow-up adds the marker to them. rotation/kustomization.yaml records the exception. - Merged current main (a6f37e2b,1691a0ac): the Reloader annotations for zone-configurator and speech-to-phrase are already there via #1409.
90 lines
3.2 KiB
YAML
90 lines
3.2 KiB
YAML
---
|
|
# Class-A automated rotation of paperless — a self-generated random secret.
|
|
#
|
|
# Runs the secret-rotator binary (random mode): generate N cryptographically-
|
|
# random bytes, standard-base64 encode (byte-compatible with the previous
|
|
# `head -c 50 /dev/urandom | base64`), and merge-patch into OpenBao.
|
|
# assert_fields_exist first refuses to run if the field is absent, so a
|
|
# misconfig fails safe (no rotation) rather than adding a stray field.
|
|
#
|
|
# openbao-ns pattern: the Job runs in the openbao namespace, reaching the
|
|
# OpenBao API intra-namespace — no NetworkPolicy needed. It writes OpenBao
|
|
# only; ESO syncs the paperless-secrets Secret (ns paperless, 10m refresh) and Reloader
|
|
# restarts the consumer.
|
|
#
|
|
# Rotating the Django SECRET_KEY invalidates existing sessions (users re-login); no data loss — paperless does not encrypt documents with it.
|
|
#
|
|
# OpenBao policy/role rotator (rotator-paperless) bootstrapped out-of-band; unchanged by
|
|
# this port — the binary uses the same k8s-auth role the shell job did.
|
|
#
|
|
# ON-DEMAND: kubectl -n openbao create job --from=cronjob/paperless-secret-rotate paperless-secret-rotate-now
|
|
apiVersion: v1
|
|
kind: ServiceAccount
|
|
metadata:
|
|
name: paperless-secret-rotator
|
|
namespace: openbao
|
|
labels:
|
|
app.kubernetes.io/name: paperless
|
|
app.kubernetes.io/component: secret-rotator
|
|
---
|
|
apiVersion: batch/v1
|
|
kind: CronJob
|
|
metadata:
|
|
name: paperless-secret-rotate
|
|
namespace: openbao
|
|
labels:
|
|
app.kubernetes.io/name: paperless
|
|
app.kubernetes.io/component: secret-rotator
|
|
spec:
|
|
schedule: "0 4 1 1,4,7,10 *" # quarterly, Europe/Berlin — off-hours for the brief restart
|
|
timeZone: Europe/Berlin
|
|
concurrencyPolicy: Forbid
|
|
successfulJobsHistoryLimit: 2
|
|
failedJobsHistoryLimit: 5
|
|
startingDeadlineSeconds: 3600
|
|
jobTemplate:
|
|
spec:
|
|
backoffLimit: 2
|
|
activeDeadlineSeconds: 300
|
|
ttlSecondsAfterFinished: 259200 # 3 d
|
|
template:
|
|
metadata:
|
|
labels:
|
|
app.kubernetes.io/name: paperless
|
|
app.kubernetes.io/component: secret-rotator
|
|
spec:
|
|
serviceAccountName: paperless-secret-rotator
|
|
restartPolicy: Never
|
|
securityContext:
|
|
runAsNonRoot: true
|
|
runAsUser: 65534
|
|
runAsGroup: 65534
|
|
seccompProfile:
|
|
type: RuntimeDefault
|
|
containers:
|
|
- name: rotate
|
|
image: gitea.renner.uno/gitea_admin/secret-rotator:2026-07-30
|
|
args: ["random"]
|
|
securityContext:
|
|
allowPrivilegeEscalation: false
|
|
readOnlyRootFilesystem: true
|
|
capabilities:
|
|
drop: ["ALL"]
|
|
env:
|
|
- name: BAO_ADDR
|
|
value: http://openbao.openbao.svc.cluster.local:8200
|
|
- name: BAO_ROLE
|
|
value: rotator-paperless
|
|
- name: BAO_PATH
|
|
value: homelab/apps/paperless
|
|
- name: BAO_FIELDS
|
|
value: "secret-key"
|
|
- name: RANDOM_BYTES
|
|
value: "50"
|
|
resources:
|
|
requests:
|
|
cpu: 25m
|
|
memory: 16Mi
|
|
limits:
|
|
memory: 48Mi
|