Repository navigation
docs: Describe systemd-sysext and confext as distribution-dependent - #2649
Conversation
| adds no overlay of its own either, but with transient root `/etc` is then | ||
| inside the root overlay. Both are documented with the composefs |
There was a problem hiding this comment.
I think the wording of but with transient root /etc is then inside the root overlay is a bit confusing, but it's explained better in the linked man page so I think it's okay
There was a problem hiding this comment.
I agree, I messed up that wording.
@jmarrero-bot can you rephrase this so is clearer?
Maybe
adds no overlay of its own either. Transient root `/etc` is inside the root overlay which allows for confext usage.
or so?
Double check with the linked docs.
There was a problem hiding this comment.
Reworded in 3549180 (your signed-off commit, sign-off kept): "[etc] mount = "none" (which has no ostree equivalent yet) adds no overlay of its own either, so it also leaves room, except with transient root: /etc is then inside the root overlay, which already uses up the stacking depth."
This is the reverse of the suggestion: the transient root overlay sits on the composefs overlay (depth 2), so confext's overlay on /etc would exceed FILESYSTEM_MAX_STACK_DEPTH (the man page's "writable surface over /etc" is about writability, not confext). The push dismissed Johan's approval.
Generated-by: https://github.com/jmarrero-bot#llms
The section added in bootc-dev#2436 says sysext and confext are not supported and not recommended on bootc hosts. That overstates it: the bootc project wants to work together with sysext, and whether it works well today is mostly down to the distribution (its systemd version, SELinux labeling and the like), not bootc itself. Say that instead, and point at #7, where a more integrated approach is being discussed. The transient overlay and OS-specific sections stay, as things to be aware of. The /etc note now names the real setup-root-conf.toml option and says when /etc actually leaves room for confext: the old wording suggested etc = none avoids the limit, but under transient root /etc is still inside that overlay. Generated-by: AI Signed-off-by: Joseph Marrero Corchado <jmarrero@redhat.com>
6036e6a to
3549180
Compare
mohan-shash
left a comment
mohan-shash
left a comment
There was a problem hiding this comment.
Agree with the change in the approach.
#2436 documented systemd-sysext and confext as not supported and not recommended on bootc hosts. This replaces that with: bootc aims to work together with sysext, support today depends mostly on the distribution (systemd version, SELinux and the like), and #7 is where a more integrated approach is being discussed. The transient overlay and OS-specific integration sections stay, as things to be aware of.
Tracker: jmarrero-forge/tracker#88
Testing, on a 16-core RHEL 10 devspace at 37ccf9f:
just build-mdbook-topasses, includingxtask check-docs("Validated 81 canonical pages");mdbook-linkcheck --standalonereports nothing for this page (its only errors are the existinginternals/rustdoc links, which are copied in after the build);make manpages-no-syncrenders the section cleanly in bootc-filesystem(7).The
Signed-off-by: Joseph Marrero Corchado <jmarrero@redhat.com>on these commits was added on jmarrero's approval of the review draft: jmarrero-forge#21 (comment)Generated-by: https://github.com/jmarrero-bot#llms