Skip to content

Commit 985899f

Browse files
committed
docs: Move composefs tracking from issue #1190 to docs
The composefs backend implementation has largely landed. Consolidate tracking of known issues into the docs, categorized by severity: - Deployment blockers: GC, SELinux enforcing=0, OCI registry install - Important: Sealed image build UX, kargs.d support - Long-term: Unified storage, UKI/systemd-boot improvements This allows closing the original tracking issue #1190. Assisted-by: OpenCode (Claude Sonnet 4)
1 parent b901498 commit 985899f

File tree

1 file changed

+15
-14
lines changed

1 file changed

+15
-14
lines changed

docs/src/experimental-composefs.md

Lines changed: 15 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,6 @@
33
Experimental features are subject to change or removal. Please
44
do provide feedback on them.
55

6-
Tracking issue: <https://github.com/bootc-dev/bootc/issues/1190>
7-
86
## Overview
97

108
The composefs backend is an experimental alternative storage backend that uses [composefs-rs](https://github.com/containers/composefs-rs) instead of ostree for storing and managing bootc system deployments.
@@ -140,21 +138,24 @@ To use sealed images, the container image must have a UKI and systemd-boot insta
140138

141139
There is a `--composefs-backend` option for `bootc install` to explicitly select a composefs backend apart from sealed images; this is not as heavily tested yet.
142140

143-
## Current Limitations
141+
## Known Issues
142+
143+
The composefs backend is experimental; on-disk formats are subject to change.
144+
145+
### Deployment blockers
146+
147+
- [Garbage collection](https://github.com/containers/composefs-rs/pull/200): Old deployments are not cleaned up
148+
- [SELinux enforcement](https://github.com/bootc-dev/bootc/issues/1826): Currently requires `enforcing=0`
149+
- [OCI registry install](https://github.com/bootc-dev/bootc/issues/1703): Installing from registry can fail due to config mismatch
150+
151+
### Important
144152

145-
- **Experimental**: The on-disk formats are subject to change
146-
- **UX refinement**: The user experience for building and managing sealed images is still being improved
147-
- **SELinux**: Currently uses `enforcing=0` in the kernel command line (see [#1826](https://github.com/bootc-dev/bootc/issues/1826))
148-
- **kargs.d**: Custom kernel arguments from `/usr/lib/bootc/kargs.d` are not yet automatically included in sealed UKIs
153+
- [Sealed image build UX](https://github.com/bootc-dev/bootc/issues/1498): Streamlined tooling for building sealed images
154+
- **kargs.d**: Custom kernel arguments from `/usr/lib/bootc/kargs.d` not yet included in sealed UKIs
149155

150-
## Related Issues
156+
### Long-term
151157

152-
- [#1190](https://github.com/bootc-dev/bootc/issues/1190) - composefs-native backend (main tracker)
153-
- [#1498](https://github.com/bootc-dev/bootc/issues/1498) - Sealed image build UX + implementation
154-
- [#1703](https://github.com/bootc-dev/bootc/issues/1703) - OCI config mismatch issues
155-
- [#1826](https://github.com/bootc-dev/bootc/issues/1826) - SELinux enforcement with composefs
156-
- [#20](https://github.com/bootc-dev/bootc/issues/20) - Unified storage (long-term goal)
157-
- [#806](https://github.com/bootc-dev/bootc/issues/806) - UKI/systemd-boot tracker
158+
- [Unified storage](https://github.com/bootc-dev/bootc/issues/20)
158159

159160
## Additional Resources
160161

0 commit comments

Comments
 (0)