composefs backend: support state overlays (writable, image-reconciled subdirectories)
Maintainer thường phản hồi trong vòng 2 ngày
Chưa có ai nhận issue này.
Đánh giá
- Độ khó
- 5/5
- Thời gian dự kiến
- Hơn một tuần
- Mức phù hợp với người mới
- 35/100
- Loại issue
- Tính năng
- Độ rõ ràng
- Khá rõ ràng
- Mức độ hoạt động
- Sôi nổi
- Công nghệ
- linux, rust
- Lĩnh vực
- backend, operating-systems
Hướng nghiên cứu
Start by reading the composefs backend implementation and the existing ostree state overlay behavior; the issue links ostreedev/ostree#3691 and bootc-dev/bootc#1190 for context. Check how the composefs root is assembled and where bootc-composefs.7.md documents known issues. Done means unsealed state overlays have the stated persistence, deployment reconciliation, and rollback behavior, with sealed behavior documented if unsupported.
Do mô hình lập chỉ mục viết ra từ nội dung của issue.
Mô tả
Summary
State overlays work on the ostree backend and not on the composefs backend. It would be good to support them there, at least in the unsealed configuration, and to add them to the known issues list in bootc-composefs.7.md until then.
When the composefs-native backend was planned, bootc-dev/bootc#1190 listed the state overlay docs among ostree-era features the composefs path would need to keep honoring (https://github.com/bootc-dev/bootc/issues/1190#issuecomment-2714380763). The backend is now stable, but state overlays are not on its parity list, have no tracking issue, and are silently skipped (ostreedev/ostree#3691).
The use case
Many third-party host agents, especially security agents, install into /opt/<vendor> and write there at runtime: binaries, version symlinks, enrollment identity, and vendor-delivered content in one tree the vendor will not restructure. Two patterns:
- State and binaries mixed under
/opt. A writable directory whose binaries still come from the image. ostreedev/ostree#3120 named this case: software in/opt"often mixes code and state". ostreedev/ostree#3553 was filed by someone doing this for a vulnerability scanner agent. - In-place self-updaters. The agent's management plane pushes new files into its install directory (bootc-dev/bootc#2468 asked for a variant of this). State overlays do not make those updates permanent (the image wins at the next deployment change), but the agent runs and keeps its state.
Why state overlays and not the alternatives
- The image stays the authority. At every deployment change, upper entries that shadow image content are pruned; only files the image does not ship, such as machine identity, are kept. Rollback gives a coherent pair: binaries roll back, identity stays.
- Relocating the tree to
/varis what people do instead, and it is worse. Image content under/varis applied at install only, so the binaries freeze while the OS moves, and rollback cannot resynchronize them.bootc container lintalready flags it. At least one vendor's published bootc recipe does it (https://github.com/CrowdStrike/falcon-bootc). - It is also simpler for the user. That recipe has to move the tree into
/var/opt, symlink it back, and on RHEL 9 addsemanage fcontextrules so the moved binaries and libraries get the labels they would have had under/opt. A state overlay is onesystemctl enableline: no relocation, no symlinks, no relabeling of the vendor's files, and the vendor's paths stay where it expects them. - Splitting state into
/varshould stay the first recommendation, but only works when the writable paths can be separated from the binaries. - A container is best where the vendor ships one, but most security agents are host installs, and logically bound images are not on this backend either (bootc-dev/bootc#2540).
Without state overlays, the composefs backend leaves these users the /var relocation, the least image-governed option. That matters more over time: upstream plans in-place moves from ostree to this backend, and bootc-dev/bootc#1190 framed it as a step toward phasing out ostree.
Suggested scope
- Unsealed composefs backend: there is no integrity reason to exclude a writable overlay, so the ask is parity with the ostree backend, with the same semantics users rely on today: state written in the directory persists across reboots, content shipped in the image wins when the deployment changes, and rollback behaves the same way. How to build it is up to maintainers, however best fits the composefs root setup.
- Sealed (fs-verity) configuration: a writable overlay over measured content may be out of scope by design, as bootc-dev/bootc#2507 proposes for
usr-overlay. If so, please say so inbootc-composefs.7.mdrather than leaving a silent no-op.
Naming
A composefs-native implementation is a natural point to adopt a backend-neutral unit name: [email protected], or [email protected] if an unprefixed name is a concern. Keep ostree-state-overlay@ as an alias so existing images keep working, and use scoped examples (@opt-myvendor, not @opt) in the docs.
Known rough edges, not blockers
No way to see what the overlay holds or what a prune removed (a notice journal line would help; asked in the ostreedev/ostree#3120 review). The merged directory takes mode 0700 and label var_t from the upper, so non-root services cannot read it, and new files in it are labeled var_t. Docs show only the unscoped @opt.service. No state overlay tests in bootc (ostree has one); see also bootc-dev/bootc#1925.
Related
- ostreedev/ostree#3691: fail visibly instead of skipping on this backend.
- bootc-dev/bootc#1190, bootc-dev/bootc#2540, bootc-dev/bootc#2507, bootc-dev/bootc#2468, bootc-dev/bootc#1925, ostreedev/ostree#3120.
- Ngôn ngữ chính
- Rust
- Star
- 2.3k
- Fork
- 230
- Merge trung bình
- 2 ngày 11 giờ
- Pull request đã merge (30 ngày)
- 42
Chuẩn bị môi trường
Bắt đầu từ đâu
- Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
- Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
- Fork repository và làm thay đổi trên một nhánh.
- Mở pull request có tham chiếu số hiệu của issue.
Issue khác của bootc-dev/bootc
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 76/100
Maintainer thường phản hồi trong vòng 2 ngày
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 68/100
Maintainer thường phản hồi trong vòng 2 ngày
-
install: improve error message when systemd-boot is selected without composefs backendCó thể làm lại được Pull request cho issue này đã bị đóng mà không được merge. Đang mở
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 76/100
Maintainer thường phản hồi trong vòng 2 ngày
-
Độ khó 4/5 3-5 ngày Mức phù hợp với người mới 55/100
Maintainer thường phản hồi trong vòng 2 ngày
-
Độ khó 5/5 Hơn một tuần Mức phù hợp với người mới 30/100
Maintainer thường phản hồi trong vòng 2 ngày
Tất cả issue của bootc-dev/bootc
Issue tương tự
-
[Bug]: layer.move to the place a layer already has fails and stops a script; with several layers it leaves an empty undo stepCó thể đã có người làm @jgregoriorincon đã nhận hôm nay. Đang mở
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 78/100
opengeos/RustGIS#2621 · 1 bình luận ·
Maintainer thường phản hồi trong vòng 1 ngày
-
good first issue web
Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 92/100
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 70/100
-
Wait for the IDS correction dialog to settle in the stale-audit testCó thể đã có người làm @louistrue đã nhận hôm nay. Đang mởready
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 68/100
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 70/100
Maintainer thường phản hồi trong vòng 1 ngày