doc: build command

Introduce the `build` command.

Signed-off-by: Simon de Vlieger <supakeen@redhat.com>
This commit is contained in:
Simon de Vlieger 2025-02-13 10:48:01 +00:00
parent ca7ea33765
commit 0cc171e1f9
2 changed files with 22 additions and 0 deletions

View file

@ -96,6 +96,22 @@ $ image-builder list-images --filter type:qcow2 --filter distro:fedora-41
# ... list ...
```
## `image-builder build`
The `build` command builds images of a given [image type](./10-faq.md#image-types), for example:
```console
$ sudo image-builder build minimal-raw
# ... progress ...
```
By default the `build` command uses the same distribution and version as the host system, you can pass another distribution and version with the `--distro` argument:
```console
$ sudo image-builder build --distro fedora-43 minimal-raw
# ... progress ...
```
# Blueprints
Images can be customized with [blueprints](https://osbuild.org/docs/user-guide/blueprint-reference). For example we could build the `qcow2` we built above with some customizations applied.