Skip to content

docs: 0041 amendment, an overlay an upgrade adds to the chain - #54

Merged
marcos-mendez merged 1 commit into
mainfrom
docs/0041-overlay-added-by-upgrade
Oct 8, 2026
Merged

marcos-mendez merged 1 commit into
mainfrom
docs/0041-overlay-added-by-upgrade

Conversation

@marcos-mendez

Copy link
Copy Markdown
Contributor

Proposed amendment to 0041 and rule 25 of docs/manifest-v1.md, for the maintainer's approval.

keel-core 0.1.3 added vip to Core, and after apt full-upgrade every keel command on two Keel Web nodes refused the spec (overlays.vip: not declared). Rule 25 as written makes any overlay added to a chain break every existing spec on upgrade.

The amendment: an overlay the spec does not declare, and did not declare when it was last applied (recorded by apply --system), takes its manifest default for installation.mode with a warning. One the spec declared and drops stays an error, so 0027's explicit spec holds for what the operator wrote. The spec file is never edited by keel or by a maintainer script. The note explains why the postinst option was not taken.

Implemented in Keel-Linux/keel, branch fix/overlay-new-in-chain.

Rule 25 makes every spec invalid when an upgrade adds an overlay to the
chain, as keel-core 0.1.3 did with vip. Proposed: such an overlay takes
its default for the mode with a warning; one the spec declared when it
was last applied and leaves out stays an error.
@marcos-mendez
marcos-mendez merged commit 49794da into main Oct 8, 2026
12 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant