Skip to content

doc: introduce advanced bootc#462

Merged
supakeen merged 1 commit intoosbuild:mainfrom
supakeen:doc-bootc-advanced
Apr 29, 2026
Merged

doc: introduce advanced bootc#462
supakeen merged 1 commit intoosbuild:mainfrom
supakeen:doc-bootc-advanced

Conversation

@supakeen
Copy link
Copy Markdown
Member

@supakeen supakeen commented Feb 24, 2026

Using the newly introduced advanced section move the Containerfile for installer setup into it. Also document disk.yaml and iso.yaml.

The disk.yaml is our general partitioning format in the YAML definitions so when we start officially exposing/documenting that the section can move and we can refer to it.

@supakeen
Copy link
Copy Markdown
Member Author

Found a small bug while testing out the documentation that we will address: osbuild/images#2228 for now it has a warning that LVM base partition tables don't work with bootc images.

Comment thread doc/20-advanced/20-bootc/05-sources-of-configuration.md Outdated
Comment thread doc/20-advanced/20-bootc/05-sources-of-configuration.md
@bcl
Copy link
Copy Markdown

bcl commented Feb 24, 2026

Related to this (I think) the osbuild.github.io readme-list should pull the README from https://github.com/osbuild/images/blob/main/data/files/pxetree/README and add it as a new section on bootc-pxe-tar

Comment thread doc/20-advanced/20-bootc/10-installers.md Outdated
@supakeen supakeen force-pushed the doc-bootc-advanced branch 11 times, most recently from 7b34aba to 9f6cd0f Compare March 27, 2026 11:49
@github-actions
Copy link
Copy Markdown

This PR is stale because it had no activity for the past 30 days. Remove the "Stale" label or add a comment, otherwise this PR will be closed in 7 days.

@github-actions github-actions Bot added the Stale label Apr 27, 2026
@supakeen
Copy link
Copy Markdown
Member Author

Not stale.

@github-actions github-actions Bot removed the Stale label Apr 28, 2026
@supakeen supakeen force-pushed the doc-bootc-advanced branch from 9f6cd0f to 5a37c21 Compare April 28, 2026 08:31
Using the newly introduced advanced section move the `Containerfile` for
installer setup into it.

Also write down a new section of sources of configuration for
`image-builder` when converting bootable containers.

Signed-off-by: Simon de Vlieger <cmdr@supakeen.com>
@supakeen supakeen force-pushed the doc-bootc-advanced branch from 5a37c21 to c430891 Compare April 28, 2026 08:32
@supakeen
Copy link
Copy Markdown
Member Author

Going to undraft because it's quite far along and already super useful. I want to do more smaller changes instead of a big bang.

The only /real/ thing missing here is the raw partition type and perhaps some bits about the iso.yaml; I'll do that in follow-ups instead.

@supakeen supakeen marked this pull request as ready for review April 28, 2026 08:36
@supakeen supakeen requested a review from bcl April 28, 2026 08:36
Copy link
Copy Markdown
Member

@thozza thozza left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM, thanks!


For a `payload_type: filesystem` the `payload` has the following properties:

- `type`
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Missing a description of type here.



- `label`, an *optional* `string` that contains the filesystem label.
- `fstab_options`
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

More missing descriptions.

mountpoint: "/var"
```

*To use `btrfs` your container must set its configured root filesystem to `btrfs`, or it must be passed when `image-builder` is called.*
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

'must be passed' should say how (using --bootc-default-fs is the only way, right?)

Copy link
Copy Markdown

@brlane-rht brlane-rht left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks pretty good. A few minor missing things, but no reason to block if you want to fix them later.

@supakeen supakeen added this pull request to the merge queue Apr 29, 2026
Merged via the queue into osbuild:main with commit b547ff3 Apr 29, 2026
39 checks passed
@supakeen supakeen deleted the doc-bootc-advanced branch April 29, 2026 18:06
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants