Repository navigation
docs(full-platform): record the verified platform status - #55
Merged
Merged
Conversation
Adds full-platform/status.md, the status document gitops spec 009 T158 names. It records what is true now rather than what the specifications intend. Its first table is the fact a reader needs before any other: every managed cluster registration activates zero applications, zero infrastructure roots and zero environments, so nothing is deployed anywhere. The economical runtime is quiesced deliberately before a Terraform teardown, and the retired list is preserved so the retirement is reversible by a reviewed commit. The three full clusters have never been activated. The rest states the trade-offs exactly, including that the full profile runs one replica of each component and is not highly available; the data-continuity limits, including that Redis is ephemeral and a lost message is neither recoverable nor detected; the traffic status, which is traffic-disabled-ready; the rollback path and its single audited exception; and the read-only commands an operator runs, with the note that a BLOCKED verdict is the correct result today and a PASS that should have been BLOCKED is the defect. Every artifact the document names was located before it was named. T158 is not ticked here: it also names three documents in the GitOps repository, and the register is updated there once those land.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What changes
Adds
full-platform/status.md, the status document gitops spec 009 T158 names.It records what is true now rather than what the specifications intend.
Its first table is the fact a reader needs before any other: every managed
cluster registration activates zero applications, zero infrastructure roots and
zero environments. Nothing is deployed anywhere. The rest covers the exact
trade-offs, the data-continuity limits, the traffic status, the rollback path,
and the read-only commands an operator runs.
Why
T158 requires a verified statement of current state, and there was none. The
rollout index describes the intended stage order, and the specifications
describe the target, but nothing said what is actually running. A reader who
saw the size of the desired state could reasonably assume most of it was live;
none of it is.
The document is written so that assumption cannot survive its first table.
Tasks
gitops specs/009-full-platform-rollout T158 (advanced, not ticked)
No task is ticked here, and the register is not updated here. T158 also names
three documents in
microservice-app-gitops(docs/profiles.md,clusters/README.md,docs/bootstrap-boundary.md). It is ticked in thatrepository once those land, which is also where its register lives.
How it is verified
Every claim about desired state was read from a file, not recalled. The
activation table comes from the registrations themselves:
The reason for the economical zero is quoted from the file's own header, in
clusters/eks-dev/activation-infrastructure.yaml: dependency cleanup iscomplete, so no infrastructure child Application remains active before a
Terraform teardown. The previous list is preserved in
activation-infrastructure-retired.yaml.Every artifact the document names was located before it was named:
One claim was wrong and was corrected before publishing. A first draft
placed the log shipper at
infrastructure/alloy. That root does not exist:Alloy is
alloy.yamlandalloy-config.yamlinsideinfrastructure/loki. Thetable now says so.
Nothing live is asserted. This authoring environment holds no cluster
credentials, and the document says that in its header rather than implying
otherwise. It states that the collectors report
BLOCKEDtoday and that aBLOCKEDverdict is the correct result, not a failure to investigate.This pull request adds one Markdown file to a documentation-only repository and
changes no infrastructure, no provider argument and no version. Its source was
the repositories themselves, read at
main.Risk and rollback
A new document in a repository with no executable code. It changes no behavior.
The risk worth naming is the document going stale: it is a point-in-time
statement, dated in its header, and its closing table lists the five events that
would change it. Rollback is
git revertof the merge.What this PR does not do
GitOps pull request, which is also where T158 is ticked.
rollout-index.md, which governs stage order and remains theauthority on it.
Merge method: squash. There is no SDD pair here; this is a document.
Approval required: one approval from
EstebanGZamorJuanmadiaz45. No AIagent approves it.
🤖 Generated with Claude Code