Skip to content

Document bootc customizations (RHEL-238209) - #213

Merged
schuellerf merged 7 commits into
osbuild:mainfrom
schuellerf:document-bootc-customizations-rhel-238209
Aug 17, 2026
Merged

Document bootc customizations (RHEL-238209)#213
schuellerf merged 7 commits into
osbuild:mainfrom
schuellerf:document-bootc-customizations-rhel-238209

Conversation

@schuellerf

@schuellerf schuellerf commented Aug 13, 2026

Copy link
Copy Markdown
Contributor
  • Generates a Bootc family under image descriptions from bootc-generic/imagetypes.yaml (disk vs ISO allowlists; container = input).
  • Wire into make pull-image-descriptions / make generate (and thus the daily pull workflow); document container / YAML freshness in the README.

Related to HMS-10586


To see the results locally, you can checkout the PR and run make serve

achilleas-k
achilleas-k previously approved these changes Aug 14, 2026

@achilleas-k achilleas-k left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Nice work, thank you! Couple of notes below but nothing to block on.

LGTM!

Comment thread README.md Outdated

| Path | Source |
|------|--------|
| Classic distros | [`ghcr.io/osbuild/image-builder-cli:latest`](https://github.com/osbuild/image-builder/pkgs/container/image-builder-cli) via `list-images` + `describe` (`CONTAINER_IMAGE` in `scripts/pull_image_descriptions.py`). Pull the image before regenerating or docs lag. |

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

"Classic" distros isn't a term we've used before to refer to the package/distro-based images. I don't mind it. I think we've used "traditional" before, but some people take issue with that. I don't like "package mode" or "package-based" either. Adding this note in case anyone has a better idea, but I'm fine with keeping "classic".

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

We shouldn't pass anything that can be seen as value judgement e.g. we don't want to say that package based distros are the 'old way'. I'd go with package mode and image mode just to be sure even if we don't particularly like the terms.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

I changed to image mode and package mode. Being consistent and without judgement makes sense. Please check

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Can we add a special case to mention that the "raw" and "ami" image types are identical?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

thanks for this hint! please check

@achilleas-k
achilleas-k force-pushed the document-bootc-customizations-rhel-238209 branch from 4753b1e to d63f570 Compare August 14, 2026 17:31
Teach pull_image_descriptions to generate a bootc 09 family from
bootc-generic/imagetypes.yaml (--bootc-only / full pull), invert
support lists into a JSON matrix helper, and document that freshness
depends on image-builder-cli / osbuild/image-builder.

make generate already runs pull-image-descriptions; that target now
includes bootc + blueprint-option-support.json. CI pull.yml calls the
same target, so daily updates pick up bootc implicitly.
Add the 00-bootc family under 09-image-descriptions (per-type
supported_options, container-input note) and link Bootc from the
main image-descriptions index.
Point the bootc index and per-type allowlist prose at the browsable
github.com/.../blob/main/.../imagetypes.yaml page instead of raw.githubusercontent.com.
@schuellerf
schuellerf force-pushed the document-bootc-customizations-rhel-238209 branch from e9c0238 to ec973b3 Compare August 17, 2026 08:25
@schuellerf
schuellerf enabled auto-merge (rebase) August 17, 2026 08:26
@schuellerf
schuellerf merged commit 5cae701 into osbuild:main Aug 17, 2026
3 checks passed
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.

3 participants