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

Merged

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

2026-10-08 03:33:41 -03:00

marcos-mendez commented

2026-10-08 03:24:29 -03:00

(Migrated from github.com)

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.

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`.