docs(compose): single-definition image ref via extension field + anchor - #68
Draft
CybotTM wants to merge 1 commit into
Draft
docs(compose): single-definition image ref via extension field + anchor#68CybotTM wants to merge 1 commit into
CybotTM wants to merge 1 commit into
Conversation
Learned on OPS-898 (nine consumer repos): repeating an image default per
service invites drift; a top-level x-* extension field with a YAML anchor
defines image path, version variable and default tag once per compose
file. Records the two traps met in practice: anchors do not cross files
(overlays need their own), and only ${VAR:-def} catches the empty-but-set
variable that otherwise resolves :latest.
Assisted-by: claude-code:claude-fable-5
Agent-Session: https://claude.ai/code/session_01Mu33BP3JtQfKkpZkeTHLqr
Agent-Host: 0493f0
Signed-off-by: Sebastian Mendel <info@sebastianmendel.de>
Contributor
Dependency Review✅ No vulnerabilities or license issues or OpenSSF Scorecard issues found.Scanned FilesNone |
|
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.



Adds one Compose Essentials bullet: define a shared image reference (path + version variable + default tag) once per compose file as a top-level
x-*extension field with a YAML anchor, referenced by the services viaimage: *anchor. Documents the two traps met in practice on OPS-898 across nine consumer repos: anchors are file-local (every overlay needs its own), and only${VAR:-def}also catches the empty-but-set variable — a bare omitted tag silently resolves:latest. Verification recipe viadocker compose configfor both the default and the override path.Assisted by claude-code:claude-fable-5 — Session