Files
helm-charts/voucher-vault/templates
jklein e0541a0352 voucher-vault: add a NOTES.txt worth reading twice (6.1.0+up1.30.1)
The notes print what an operator would otherwise have to dig out of the
templates or out of the image, not a restatement of the values.

The centrepiece is the secret inventory: the three OnePasswordItem CRs
carry item paths only, so the field names each item must contain are
decided in this chart and appear nowhere in 1Password. A missing field
does not fail the install - the operator writes a Secret without that key
and the pod stays in CreateContainerConfigError.

The warnings are the ones this chart earns, all read out of the running
image rather than assumed:

- The first start against an empty database creates the superuser "admin"
  with a random password and prints it to stdout exactly once. With OIDC
  on, the app drops its password-change pages and the login form redirects
  to the provider by itself, so /admin/ is the documented way back in.
- The probes send Host: 127.0.0.1, which is always in ALLOWED_HOSTS. A
  wrong ingress.domain is therefore invisible: probes pass, the rollout
  goes green, and every real request gets 400.
- The entrypoint waits for Postgres in an nc loop with no timeout before
  opening the HTTP port, so a wrong database host produces no error at all
  - just a log that stops, until the startup probe budget runs out.
- Celery worker and beat are started detached from the same entrypoint;
  uwsgi answers whether or not they survived, so a wrong redis-url costs
  the expiry notifications silently.
- Every start runs makemigrations and migrate, and helm rollback does not
  reverse them.
- Expiry notifications need a per-user Apprise URL, and the beat schedule
  is created only while an empty database is initialized.

Conditional blocks cover the ingress and no-ingress access paths, the
scaled-down state, the storage class, and the case where voucherVault.env
has replaced the chart's full env list instead of extending it. The
startup budget and the replica state are read through the chart's own
helpers. No real domain appears anywhere; the one place an example is
needed uses example.com.

Minor bump, purely additive: a NOTES.txt changes no rendered object.

Part of #43
2026-08-29 00:03:06 +02:00
..