docs: rewrite documentation to ASD-STE100 #12

Closed

sean wants to merge 3 commits from docs/asd-ste100-rewrite into trunk

pull from: docs/asd-ste100-rewrite

merge into: sean:trunk

sean:trunk

sean:main

Conversation 0 Commits 3 Files changed 14 +196 -146

sean commented 2026-08-07 16:31:03 +00:00

Owner

Copy link

Rewrite README.md prose and substantial explanatory comment blocks in 13 YAML manifests to ASD-STE100 Simplified Technical English. All touched YAML re-validated with a parser. No manifest structure, keys, values, namespaces, or resource names changed.

Rewrite README.md prose and substantial explanatory comment blocks in 13 YAML manifests to ASD-STE100 Simplified Technical English. All touched YAML re-validated with a parser. No manifest structure, keys, values, namespaces, or resource names changed.

sean added 3 commits 2026-08-07 16:31:03 +00:00

fix(grafana): point the OIDC registrar at ns ory, not the deleted ory-alice ... 7cf6f6483b

The 07-24 ory-alice->ory SSO cutover deleted ns ory-alice but missed this
registrar Job. HYDRA_PUBLIC_INTERNAL is what it writes into the grafana-oidc
Secret as TOKEN_URL/API_URL, so Grafana's server-side code exchange dialed
hydra-public.ory-alice.svc (NXDOMAIN) while the browser leg via the public
auth.sean.farm host kept working — surfacing as 'Login failed / Failed to get
token from provider'.

fix(grafana): make the OIDC registrar a self-completing sync hook ... 786fd39b6c

A Job spec is immutable, so editing the registrar in place never applied and
the grafana-oidc Secret silently kept its stale endpoints — the mechanism that
let the ory-alice URLs survive the SSO cutover. Run it as an ArgoCD Sync hook
(deleted before each hook creation, excluded from drift comparison so it can't
flap under selfHeal), and have it restart Grafana after rewriting the Secret,
since envFrom is read only at process start. An endpoint or credential change
now converges with no manual rollout, on a running cluster and on rebuild.

docs: rewrite documentation to ASD-STE100 ... ed9bdec034

Rewrite README.md prose and substantial explanatory # comment blocks in 13 YAML manifests to ASD-STE100. All YAML re-validated with a YAML parser after editing. No manifest structure, keys, values, namespaces, or resource names changed.

sean closed this pull request 2026-08-07 16:51:48 +00:00

sean referenced this pull request 2026-08-07 16:51:48 +00:00

docs: rewrite documentation to ASD-STE100 #13

Some checks are pending

Hide checks

pipeline/ci CI green @ ed9bdec034e5

Details

binjovi/ci

Required

Pull request closed

This pull request cannot be reopened because the branch was deleted.

Sign in to join this conversation.

Reviewers

No reviewers

Labels

Clear labels

No items

No labels

Milestone

Clear milestone

No items

No milestone

Projects

Clear projects

No items

No project

Assignees

Clear assignees

No assignees

1 participant

Notifications

Subscribe

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference

sean/olly!12

No description provided.