Skip to content

Update README and add agent files #40

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
thozza merged 1 commit into from
Apr 23, 2026
+32 −37
Merged

Update README and add agent files #40

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions .cursorrules
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
README.md
Copy link
Copy Markdown
Member

@thozza thozza Apr 20, 2026

Choose a reason for hiding this comment

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

missing newline

Copy link
Copy Markdown
Collaborator Author

@lzap lzap Apr 21, 2026

Choose a reason for hiding this comment

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

Not sure what github means by that :-D

$ ls -la | grep README.md
lrwxrwxrwx    1 lzap lzap     9 Apr 21 19:40 AGENTS.md -> README.md
lrwxrwxrwx    1 lzap lzap     9 Apr 21 19:40 CLAUDE.md -> README.md
lrwxrwxrwx    1 lzap lzap     9 Apr 21 19:40 .cursorrules -> README.md
-rw-r--r--    1 lzap lzap  1948 Apr 21 19:40 README.md

1 change: 1 addition & 0 deletions AGENTS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
README.md
1 change: 1 addition & 0 deletions CLAUDE.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
README.md
66 changes: 29 additions & 37 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,61 +1,53 @@
# Derived bootc images for image builder

This repository contains `Containerfile` for each derived image types that
are used by image builder.
This repository contains a `Containerfile` for each derived image type used by
image builder. The goal is to customize base bootc images of Fedora, CentOS
Stream, or RHEL for the target environment (clouds, virtualization) by
installing the tools needed for a successful installation or to align with Red
Hat or cloud vendor recommendations.

It mirrors what is defined for package-based OS images in distro definitions:
https://github.com/osbuild/images/tree/main/data/distrodefs, but there is no
parity. The core image content comes from the base container, we just add
additional software and configuration to make the image integrate nicely with
the target environment.

## Supported image formats

* AWC EC2
_This is a work in progress, not all image formats are available._

* AWS EC2
* Azure
* GCE
* qcow2
* Anaconda installer
Comment thread
lzap marked this conversation as resolved.

## Supported bootable container base images

* `quay.io/fedora/fedora-bootc` versions N and N-1 (`x86_64`, `aarch64`)
* `quay.io/centos-bootc/centos-bootc` versions Stream 9 and 10 (`x86_64`, `aarch64`)
* `registry.redhat.io/rhelXX/rhel-bootc` (9 and 10) (`x86_64`)

## Published container images

Images are available as multi-arch image manifests with the following URIs:

[Fedora](https://quay.io/repository/osbuild/fedora-bootc) (`x86_64`, `aarch64`)

* `quay.io/osbuild/fedora-bootc:43-ec2`
* `quay.io/osbuild/fedora-bootc:43-azure`
* `quay.io/osbuild/fedora-bootc:43-gce`
* `quay.io/osbuild/fedora-bootc:43-qcow2`

[CentOS 9 Stream](https://quay.io/repository/osbuild/centos-bootc) (`x86_64`, `aarch64`)

* `quay.io/osbuild/centos-bootc:stream9-ec2`
* `quay.io/osbuild/centos-bootc:stream9-azure`
* `quay.io/osbuild/centos-bootc:stream9-gce`
* `quay.io/osbuild/centos-bootc:stream9-qcow2`

[CentOS 10 Stream](https://quay.io/repository/osbuild/centos-bootc) (`x86_64`, `aarch64`)
## Organization

* `quay.io/osbuild/centos-bootc:stream10-ec2`
* `quay.io/osbuild/centos-bootc:stream10-azure`
* `quay.io/osbuild/centos-bootc:stream10-gce`
* `quay.io/osbuild/centos-bootc:stream10-qcow2`
Each `Containerfile` is prefixed with `f` for Fedora, `stream` for CentOS
Stream, and `rhel` for RHEL containers, and suffixed with one of: `qcow2`,
`ec2`, `azure`, `gce`, or `installer`.

RHEL 10 (`x86_64`, `aarch64`)
Heredocs are not allowed in `Containerfile`s; files must be copied with `COPY`
either from a common directory for the image type (for example `qcow2`) or from
an OS version or architecture-specific tree (`qcow2-amd64`). Architecture
names follow podman/docker conventions.

These repositories are not publicly available:
Comments explaining *why* are welcome.

* `quay.io/redhat-services-prod/insights-management-tenant/image-builder-bootc-foundry/rhel-10.1-qcow2`
## Build pipeline

## Using derived images
Images are built in Konflux and published on `quay.io`. Repositories with RHEL
containers are private. Currently available images:

```
image-builder-cli manifest --bootc-ref quay.io/osbuild/fedora-bootc:43-ec2 --bootc-default-fs ext4 ami
image-builder-cli manifest --bootc-ref quay.io/osbuild/fedora-bootc:43-azure --bootc-default-fs ext4 vhd
image-builder-cli manifest --bootc-ref quay.io/osbuild/fedora-bootc:43-gce --bootc-default-fs ext4 gce
image-builder-cli manifest --bootc-ref quay.io/osbuild/fedora-bootc:43-qcow2 --bootc-default-fs ext4 qcow2
```
* `quay.io/redhat-services-prod/insights-management-tenant/image-builder-bootc-foundry/rhel-10.1-qcow2:latest`

## LICENSE
## License

Apache License 2.0
Loading