install: Defer the /var copy and initialize separately mounted /var filesystems from the image
维护者通常 2 天内回复
还没有人认领这个 Issue。
评估
- 难度
- 5/5
- 预计耗时
- 一周以上
- 新手友好度
- 25/100
- Issue 类型
- 功能
- 描述清晰度
- 描述清楚
- 活跃度
- 活跃
- 技术栈
- linux, rust
调研方向
The issue proposes two install features, a day-two state command, and a composefs boot change, but does not name implementation files or tests. Start by reading the existing --initialize-var-mounts work in #2521 and the install paths for ostree and composefs. Done means the deferred seeding, initialization of mounted /var filesystems, and fstab-aware composefs behavior are implemented and covered on both backends.
由索引模型根据 Issue 内容生成。
描述
Problem
bootc install to-filesystem seeds the image's /var into a state directory. On ostree, libostree's prepare_deployment_var() fills an empty ostree/deploy/<stateroot>/var. On composefs, bootc copies into state/os/default/var. Since #1727, filesystems the caller mounts at the target's /var or below are accepted, but they stay empty, and at boot they hide the seeded content. On composefs a separate /var filesystem isn't even used: the initramfs bind-mounts the state directory's var over /var, so systemd treats the fstab /var entry as already mounted.
This mostly comes up with hardening profiles such as DISA STIG and CIS, which ask for separate filesystems for /var, /var/log, /var/log/audit, /var/tmp and /home (/var/home on bootc systems). These are usually LVM volumes, often nested, sometimes with no /var volume at all (#1728), on one or more VGs. A single --var mount spec can't describe this layout, and neither can a DPS Variable Data Partition: DPS needs GPT partitions and has no partition types for /var/log or /var/log/audit. Installers already create this layout (Anaconda, and image-builder through customizations.disk), so the caller mounts it and bootc fills it: bootc knows the image's /var content and how to label it.
#2521 adds an opt-in --initialize-var-mounts that copies the seeded /var into the mounted filesystems after install. It works, but every file under a mount is then stored twice: once on the volume, and once on the root filesystem in the state directory, hidden under the mount.
Proposal
Two PRs.
1. install to-filesystem --defer-var
Install without seeding /var. bootc writes a bootc-owned marker that records the deferred /var, the same on the ostree and composefs backends. On composefs, bootc skips its copy. On ostree, libostree seeds any empty stateroot var when it deploys, so bootc also has to keep it from doing that on this and later deploys. We wouldn't rely on libostree's .ostree-selabeled stamp for that, since libostree considers it slated for removal (ostreedev/ostree#872). The stateroot var root is still labeled as /var.
On its own, this is for callers that fill /var themselves, before the first boot. On composefs an empty /var is already visible in the initramfs, before the SELinux policy is loaded, so directories created there then come up unlabeled (on CentOS Stream 10, /var/lib for /var/lib/nfs/rpc_pipefs), and a volume mounted below one, such as /var/lib/appdb, can fail to mount. With PR 2, it gives a single-copy install.
2. --initialize-var-mounts, from the image, and a day-two command
This is the next revision of #2521, reworked, and would be force-pushed there. It copies from the image's /var (the deployment checkout on ostree, the mounted image on composefs) instead of from the seeded copy. It makes one copy per empty filesystem mounted at or below the target's /var, each in a private mount namespace where the mountpoints of the filesystems nested in it are hidden, so each file lands on the filesystem that holds it at boot. With --defer-var, the stateroot var gets only what isn't on a mounted filesystem. Without it, the stateroot var is still seeded in full, as with #2521 today.
From #2521: symlinked mountpoints are refused, and everything is SELinux-labeled by its logical path and synced. Two things change from #2521, both found while testing it:
- An empty parent of a non-empty volume is now filled. In #2521, data in one nested volume skipped the whole tree, including an empty
/varvolume above it. - Hardlinks are kept within a filesystem on composefs. On ostree they become separate files, as with libostree's seeding, because a commit doesn't record them.
The two flags can be combined: bootc install to-filesystem --defer-var --initialize-var-mounts ....
bootc state initialize-var [PATH] runs the same code on a booted system, for anyone who needs it outside install, for example after adding a volume for /var/log/app. The source is the booted deployment's image. It only considers block-device filesystems mounted from their root, so tmpfs, NFS, bind mounts (such as kubelet's), btrfs subvolumes and ZFS datasets are left alone.
Each PR would list what it adds as a feature in bootc --version, as suggested in the #2521 review (main has no such list yet), so osbuild and image-builder can check for them (osbuild/image-builder#2733).
composefs: leave a provided /var to fstab
setup-root would skip its /var bind mount when the fstab that /etc will show has a /var entry. ostree's generator already does this for var.mount, and setup-root already skips the bind mount for systemd.volatile=state. This also matches bootc-filesystem(7): "If it is not a distinct partition, then it is automatically made a bind". The fstab has to be read through the effective /etc, including an overlay /etc. An entry counts when it has a source, a mountpoint and a type and isn't swap; noauto entries count.
PR 1 needs this, so it's in PR 1, as its own commit. It's gated: setup-root only skips the bind mount when the stateroot var has a bootc marker. --defer-var writes one, and PR 2's --initialize-var-mounts writes another when a filesystem is mounted on /var itself. Ungated, it would change boot for existing composefs systems with a /var fstab entry. They have been running on the state directory's var, and after an update they would boot on the fstab filesystem, where the /var data they wrote since install appears to vanish (it is still in state/os/default/var), and if that filesystem is still empty and unlabeled, the boot may fail. With the gate, they keep the bind mount. An initramfs that predates the change ignores the markers, so switching or rolling back to an older image bind-mounts the state directory's var over the volume again.
Behavior
- The installer runs the initialize step at install time, and there's no first-boot unit for now. By the time a deferred install has booted, systemd-tmpfiles has written to
/var, so it isn't empty andbootc state initialize-varcan't fill it. A first-boot unit could come later (see below). - Only empty filesystems are filled. Nothing is merged. A re-run doesn't re-add files an admin deleted, and it doesn't apply
/varcontent from newer images. That matches theVOLUME /varsemantics in bootc-filesystem(7). A volume that is still empty, for example because the image has nothing for it, is initialized again on a re-run, which resets the owner, mode and SELinux label of its root. - A failed or interrupted copy isn't repaired automatically, but it is reported. A failed copy fails the command with an error naming the filesystem, after the filesystems already filled are labeled and synced. After a failure or an interruption, later runs say they skip that filesystem because it isn't empty. Both are printed, and also logged to the journal when bootc runs on a system booted with systemd, as
bootc state initialize-vardoes; an install run in a container only has its own output. To retry, empty the filesystem and run the command again.
Open questions
- Should
bootc statestay hidden? On main, the group is hidden and only haswipe-ostree.bootc state initialize-varis meant for admins, for example after adding a/varvolume, so it would be easier to find ifbootc statewere visible. - Gating the composefs fstab change. The proposal gates it on bootc's markers, so existing systems are unchanged. Or should composefs follow fstab for every system, as ostree does, with a release note?
Future work
--varand DPS. A--varmount option, and using a DPS Variable Data Partition by default (#336, and the #2521 review), are wanted but don't block this. A DPS/varwould be filled by the same routine.- First boot. A unit that runs the routine before systemd-tmpfiles, when
/varis empty (ostreedev/ostree#3222), for setups that create filesystems at first boot rather than at build time. - Factory reset (#404, the experimental
bootc install reset, ostree only today). A reset creates a new stateroot, and libostree seeds itsvaron the root filesystem. The new deployment's fstab carries over only the/bootentry, so separately mounted/varfilesystems aren't mounted after the reset, and they keep the old content. A reset that wants a fresh/varon them would carry their mounts over, wipe them and run the same routine, which the "only empty filesystems" rule already allows. That needs the routine to target a deployment other than the booted one, for example one mounted withbootc install mount(#2483).
Prototype
A prototype of both parts and the composefs change was tested in VMs on ostree and composefs with synthetic LVM layouts, covering install, boot, the day-two command, switch and rollback, with the same flag and command names. It has since been reworked into the two PRs described above, which were also tested on composefs booted with UEFI, with SELinux enforcing, and with both flags on a /var volume with volumes nested in it. They'll be linked here once opened.
Related
- PR 2 would close #997 and #1615. It is the next revision of #2521.
- #336 stays open for
--var. - #1727 (for #1728) made mountpoints under
/varaccepted at install. - osbuild/image-builder#2733 is the image-builder side.
- ostreedev/ostree#3166 is where the
/varseeding was introduced. Its discussion covers separate/varmounts and splitting stateroot init from deploy. - ostreedev/ostree#3222 covers seeding at first boot.
Generated-by: https://github.com/jmarrero-bot#llms
- 主要语言
- Rust
- 星标
- 2.3k
- 派生
- 230
- 平均合并
- 2 天 11 小时
- 30 天内合并 PR
- 42
环境准备
从这里开始
- 先读完整个 Issue,再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库,在一个分支上完成修改。
- 提交 Pull Request,并在描述里引用这个 Issue 编号。
bootc-dev/bootc 的其他 Issue
-
难度 2/5 1-3 小时 新手友好度 76/100
维护者通常 2 天内回复
-
难度 2/5 1-3 小时 新手友好度 68/100
维护者通常 2 天内回复
-
install: improve error message when systemd-boot is selected without composefs backend可能重新可做 关联的 PR 已关闭且未合并。 未关闭
难度 2/5 1-3 小时 新手友好度 76/100
维护者通常 2 天内回复
-
难度 4/5 3-5 天 新手友好度 55/100
维护者通常 2 天内回复
-
难度 5/5 一周以上 新手友好度 30/100
维护者通常 2 天内回复
相似的 Issue
-
llm translation
难度 2/5 1-3 小时 新手友好度 82/100
维护者通常 1 天内回复
-
难度 1/5 1 小时以内 新手友好度 85/100
维护者通常 1 天内回复
-
documentation good first issue trivial
难度 1/5 1-3 小时 新手友好度 84/100
维护者通常 1 天内回复
-
[Bug]: layer.move to the place a layer already has fails and stops a script; with several layers it leaves an empty undo step可能已有人在做 @jgregoriorincon 今天认领。 未关闭
难度 2/5 1-3 小时 新手友好度 78/100
opengeos/RustGIS#2621 · 1 条评论 ·
维护者通常 1 天内回复
-
good first issue web
难度 1/5 1 小时以内 新手友好度 92/100
维护者通常 1 天内回复