1
0
mirror of https://github.com/containers/bootc.git synced 2026-02-05 15:45:53 +01:00
Commit Graph

219 Commits

Author SHA1 Message Date
github-actions[bot]
84157fd69c chore: Update generated files
Signed-off-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
2025-07-12 03:48:49 +00:00
Colin Walters
86b45a592e secrets: Expand on authfile
- Note the existence of `/run` here
- Describe how to use `podman login --authfile` to write it
- Also describe the pattern of symlinking to keep things in sync
  where desired

Signed-off-by: Colin Walters <walters@verbum.org>
2025-06-30 17:50:56 -04:00
John Eckersberg
1b3f1411c3 docs: Update generated
Signed-off-by: John Eckersberg <jeckersb@redhat.com>
2025-06-27 17:35:36 -04:00
FT
e3262f440f Update guidance.md 2025-06-15 14:12:19 +02:00
FT
a8830d0785 Update users-and-groups.md 2025-06-15 14:11:52 +02:00
fuder.eth
10435b9b8a Update filesystem-sysroot.md 2025-06-13 20:01:44 +02:00
fuder.eth
4590b650d3 Update relationship-particles.md 2025-06-13 20:01:16 +02:00
kilavvy
91b64485ee Update relationship-particles.md 2025-06-12 15:49:03 +02:00
Colin Walters
e0b176999c kargs: Clarify a bit more
- Changes via `rpm-ostree kargs` will persist, this came up
  as a question
- Explicitly mention the `unshare -m` trick
- Emphasize a bit more bootc+rpm-ostree do interoperate;
  except for removing things added by `/usr/lib/bootc/kargs.d`,
  don't do that
2025-06-11 08:22:28 +02:00
Colin Walters
726041f5ba Merge pull request #1354 from cgwalters/doc-bootloader
docs: Add bootloaders.md
2025-06-06 12:01:36 -04:00
Colin Walters
88a830a5af docs: Add bootloaders.md
This one is important.

Signed-off-by: Colin Walters <walters@verbum.org>
2025-06-05 13:06:21 -04:00
ckyrouac
10637b5a3f reinstall: Docs for cleanup script and mount points
Signed-off-by: ckyrouac <ckyrouac@redhat.com>
2025-06-03 10:22:37 -04:00
John Eckersberg
ca7b38f699 Rewrite containers org links to bootc-dev org
Literally just find and replace github.com/containers/bootc with
github.com/bootc-dev/bootc

We have the redirect in place so none of this is really important, but
I figure removing as many instances of the old repo and replacing them
with the current can't hurt for things like search engine
optimization.  Plus some non-zero number of people might assume one is
a fork of the other or something.

Signed-off-by: John Eckersberg <jeckersb@redhat.com>
2025-05-22 09:07:36 -04:00
Colin Walters
59232f0635 docs: Fix typos and clarify content
Especially fix the intro and note that bootc's APIs are stable.

Co-Authored-By: Claude <noreply@anthropic.com>
Signed-off-by: Colin Walters <walters@verbum.org>
2025-05-16 20:47:29 -04:00
Colin Walters
c1d67aa07c Merge pull request #1315 from cgwalters/doc-initramfs-transient
filesystem: Note initramfs reneneration is required for prepare-root
2025-05-13 10:17:57 -04:00
Colin Walters
c33202e7a6 filesystem: Note initramfs reneneration is required for prepare-root
Ref https://gitlab.com/fedora/bootc/examples/-/merge_requests/59#note_2500726902
2025-05-13 11:33:02 +00:00
omahs
4e19c8e1ba docs: fix typos 2025-05-10 09:12:10 +02:00
Colin Walters
63ccfd12af Merge pull request #1272 from cgwalters/doc-verity-more
docs/filesystem: Explain a little bit more about fsverity
2025-04-14 10:03:11 -04:00
Colin Walters
833dda4136 docs/filesystem: Explain a little bit more about fsverity
- Doesn't apply to LBIs, and actually c/storage has no knob for
  this
- Elaborate a bit on /etc and /var

Signed-off-by: Colin Walters <walters@verbum.org>
2025-04-14 08:50:08 -04:00
Colin Walters
750515053a Merge pull request #1256 from ckyrouac/run-fetch-check
install: Deprecate skip-fetch-check, replace with run-fetch-check
2025-04-10 20:23:58 -04:00
Colin Walters
5add8885d6 docs/users-and-groups: expand on static users and systemd-sysusers
Co-authored-by: Colin Walters <walters@verbum.org>

Signed-off-by: Colin Walters <walters@verbum.org>
Signed-off-by: Joseph Marrero Corchado <jmarrero@redhat.com>
2025-04-10 15:22:42 -04:00
ckyrouac
44ce2cf2c2 install: Deprecate skip-fetch-check, replace with run-fetch-check
This deprecates skip-fetch-check in favor of the inverse,
run-fetch-check. Updates docs and tests to reflect the change.

Signed-off-by: ckyrouac <ckyrouac@redhat.com>
2025-04-08 14:51:58 -04:00
Colin Walters
f16492c0eb docs/filesystem: Reword /var a bit
- Move the recommendation for `tmpfiles.d` above the philosophy
  so it's a bit more obvious
- Reword and clarify the "only applied once" semantic
- Drop the link to the ostree change as it's no longer "new"

Motivated by seeing another question on this.

Signed-off-by: Colin Walters <walters@verbum.org>
2025-03-28 07:54:07 -04:00
Colin Walters
35c1d5cfe4 Merge pull request #1232 from cgwalters/doc-verity
docs/filesystem: Mention composefs.enabled = verity
2025-03-26 20:08:50 -04:00
Colin Walters
e91de0a0dc docs/filesystem: Mention composefs.enabled = verity
The support for this landed in a previous PR,
let's talk about it.
2025-03-25 23:15:36 +00:00
Ken Dreyer
e1f79fc156 docs: install to-disk --via-loopback requires root
Update the --via-loopback example to clarify that this must be run as
root.

We already state this at the very top of this document, but this makes
it clearer for users who skip directly down to this example command.
2025-03-25 17:20:04 -04:00
ckyrouac
2b7ed39596 docs: Fix broken link in reinstall docs
Signed-off-by: ckyrouac <ckyrouac@redhat.com>
2025-03-18 12:14:11 -04:00
Colin Walters
1958fe8b1b Merge pull request #1202 from rsturla/rollback-apply
feat(rollback): add `--apply` flag
2025-03-18 09:16:23 -04:00
Colin Walters
f818b37a57 Merge pull request #1207 from ckyrouac/reinstall-docs
reinstall: Add docs for system-reinstall-bootc
2025-03-17 16:10:42 -04:00
ckyrouac
a2134e2f2c reinstall: Add docs for system-reinstall-bootc
Signed-off-by: ckyrouac <ckyrouac@redhat.com>
2025-03-17 12:02:36 -04:00
Robert Sturla
b241b44eb7 feat(rollback): add --apply flag
Adds an --apply flag to the `bootc rollback` command to implement
automated restarts.

Have confirmed this works by building the bootc binary and running
`bootc rollback --apply` on my host.  This restarted the machine
into the new (rollback) image.

Closes #1029

Signed-off-by: Robert Sturla <robertsturla@outlook.com>
2025-03-14 01:27:42 +00:00
Jonathan Lebon
57983e8f06 docs/filesystem: Rework state overlay and /opt messaging a bit
Tweak the changes in #1191 to more clearly lay out the tradeoffs of
state overlays. Contrast it with transient root (since that was one of
the primary motivations for it), and generalize the "alternatives" to be
about both approaches.
2025-03-13 16:14:55 -04:00
Colin Walters
57adb67bf0 Merge pull request #1191 from cgwalters/stateoverlay-discouragement
docs/filesystem: Weaken stateoverlay wording and direct to alternatives
2025-03-13 13:17:05 -04:00
Colin Walters
154a808b34 Merge pull request #1178 from cgwalters/add-fsck
internals: Add new (experimental) `bootc internals fsck`
2025-03-13 09:13:29 -04:00
Colin Walters
877c339bba docs/filesystem: Weaken stateoverlay wording and direct to alternatives
We wrote the code and it is useful. We are probably just going
to need to support it into the forseeable future. However, my
core problem with it is what I wrote in the docs here: it has
no equivalent in the docker/podman ecosystem, which I think
cuts against a core principle that we're trying to make
the booted host align with containers.

Of course, stateoverlay isn't a lot of code, and in theory
it's a bit independent of ostree, so perhaps we could try to
split it out at some point and then it could be used by e.g.
`podman run --mount=type=stateoverlay` or so.

Before anyone starts just blindly enabling stateoverlays
I'd like them to have considered alternatives such as the
symlink approach.

Signed-off-by: Colin Walters <walters@verbum.org>
2025-03-11 10:03:04 -04:00
Joseph Marrero Corchado
5229fbb1fe docs: add footer with CNCF trademark notice
Signed-off-by: Joseph Marrero Corchado <jmarrero@redhat.com>
2025-03-10 20:59:28 -04:00
Colin Walters
7145132ea2 internals: Add new bootc internals fsck
Split this out of the fsverity PR.

We obviously want a `fsck` command. This starts by doing
just two checks:

- A verification of `etc/resolv.conf`; this tests
  98995f662b
- Just run `ostree fsck`

But obvious things we should be adding here are:

- Verifying kargs
- Verifying LBIs

etc.

Signed-off-by: Colin Walters <walters@verbum.org>
2025-03-10 13:46:18 -04:00
John Eckersberg
8ac427dade Update links to new docs site
Signed-off-by: John Eckersberg <jeckersb@redhat.com>
2025-03-10 09:40:26 -04:00
John Eckersberg
e246a56411 docs: Update generated
Signed-off-by: John Eckersberg <jeckersb@redhat.com>
2025-03-06 17:24:24 -05:00
Colin Walters
112e36d759 install: Add a generic install finalize
Basically I want to get Anaconda to run this, then we
can perform arbitrary fixups on whatever it did
between the install and reboot without changing Anaconda's
code.

This also applies to user `%post` scripts for example;
maybe those break the bootloader entries in /boot;
we have the opportunity to catch such things here.

Or we may choose to start forcibly relabeling the target
`/etc`.

Signed-off-by: Colin Walters <walters@verbum.org>
2025-03-01 13:13:29 -05:00
Colin Walters
8f60e20195 storage: Drop duplicate SELinux section
The info in this one was outdated and wrong (we now support labeling
dynamically).

Signed-off-by: Colin Walters <walters@verbum.org>
2025-02-26 09:58:25 -05:00
Colin Walters
752de7fb43 docs/filesystem: Flesh out etc a bit more
- Mention `ostree admin config-diff`
- Note that metadata also counts as a modification

Signed-off-by: Colin Walters <walters@verbum.org>
2025-02-04 16:07:00 +00:00
Joseph Marrero Corchado
455e16852c Merge pull request #1067 from cgwalters/lint-list
lints: Add description and `--list`
2025-01-31 16:44:21 -05:00
Colin Walters
1433aa4ef8 man: Update generated manpages
Signed-off-by: Colin Walters <walters@verbum.org>
2025-01-31 14:14:11 -05:00
Colin Walters
3117c37ee4 docs/lbi: Mention not to configure globally
This came up in a discussion.

Signed-off-by: Colin Walters <walters@verbum.org>
2025-01-31 13:16:05 -05:00
Colin Walters
c00adeec31 container/lint: Add --rootfs
Intended to pair with things like https://github.com/coreos/rpm-ostree/pull/5211
where we operate on a non-booted root.

Signed-off-by: Colin Walters <walters@verbum.org>
2025-01-14 13:56:21 -05:00
Colin Walters
7ee23e354a docs: Update generated
Signed-off-by: Colin Walters <walters@verbum.org>
2025-01-13 10:38:01 -05:00
John Eckersberg
3875368fc2 Typo fixup for #961
Signed-off-by: John Eckersberg <jeckersb@redhat.com>
2025-01-09 14:46:29 -05:00
Colin Walters
63d1199e44 progress: Emit a Start message with API version, drop from fields
And use a semantic version for the API version as this allows
a clearer evolution.

Signed-off-by: Colin Walters <walters@verbum.org>
2025-01-08 15:23:04 -05:00
Antheas Kapenekakis
c2a7d606e2 docs: Describe --progress-fd, add rendered JSON schema
Signed-off-by: Antheas Kapenekakis <git@antheas.dev>
Signed-off-by: Colin Walters <walters@verbum.org>
2025-01-08 13:24:49 -05:00