docs: sediment trap #4 image tag alias + V(1) default-off case docs#228
Merged
Conversation
d031e47 to
0601fb4
Compare
Contributor
Author
|
Docs gate HOLD for now. The topics are useful, but this PR needs a public-packaging and rebase pass before merge. Blocking items:
Once those are fixed, I can re-run the gate. The V(1) log-level guide looks like the stronger independent piece; the image-tag-alias part needs deduplication against the guide already merged in PR #225. |
Two methodology guides + two MariaDB case appendices, written under
"one doc per topic", with artifact sha anchors so future readers can
verify without re-narrating recent lanes.
1. troubleshoot/addon-instanceset-image-tag-alias-readiness-trap-guide.md
- InstanceSet isImageMatched strict tag equality fails when a node
ctr has the same digest aliased to multiple tags; pod spec.image
and status.image diverge in text but agree on imageID; cluster
stuck in Updating.
- Defers to agent-collab/addon-patch-image-build-handoff-roles-guide.md
for the underlying mechanism + the two generic fix exits (delete
base alias / chart digest pin). This guide only keeps the
InstanceSet-specific symptom + multi-node coverage requirement.
- Diagnosis (jsonpath spec vs status), narrow fix applied on every
hit node (not just current pod's host), recurrence-prevention
checklist.
- Linked from troubleshoot/README.md.
2. test/addon-kb-controller-v1-log-level-verification-guide.md
- logger.V(1).Info(...) is silently filtered at the default
--zap-log-level=info. A diagnostic PR that adds V(1) lines will
produce zero matches under default deployment.
- Canonical enable: --zap-log-level=1 (numeric form). Version-skew
note calibrated: V(N) filtering default is engine-neutral, but the
actual enabling flag / controller-runtime mapping / log output
format need live verification per controller version.
- Workflow: read PR diff for V(N) vs Info(), check controller args,
enable, restart, re-record imageID/startTime/restartCount so the
rollout itself is in evidence, then re-grep.
- Linked from test/README.md.
3. Two case appendices live under cases/mariadb/, documenting the
actual T6 lane recurrences from 2026-05-18 / 19 with artifact
tar shas backing each timeline row.
SKILL-INDEX cases/mariadb count bumped 13 -> 15.
0601fb4 to
c35ac0f
Compare
6 tasks
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.
Summary
logger.V(N)log-level verification guide for diagnostic patch images.docs/test/README.md,docs/troubleshoot/README.md, and the MariaDB case count indocs/SKILL-INDEX.md.Scope boundary
The image tag alias guide now defers the root mechanism and generic exits to the existing patch-image handoff guide. This PR only keeps the InstanceSet readiness symptom, diagnosis, and multi-node cleanup requirement.
The V(N) guide uses calibrated version-skew wording: the default filtering pattern is stable, but the live flag name, controller-runtime mapping, and log output format must be verified on the target controller version.
Test plan
git diff --check origin/main...HEAD