particle-os/debian-forge-cli
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

doc: document manifest

Browse source 
Signed-off-by: Simon de Vlieger <supakeen@redhat.com>
This commit is contained in:
Simon de Vlieger 2025-04-08 09:45:44 +02:00
parent 1a85fc9248
commit ea1a42773a
1 changed files with 23 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

23
doc/01-usage.md
View file

@ -193,6 +193,29 @@ $ image-builder describe --arch aarch64 minimal-raw
# ... output ...
```
## `image-builder manifest`
The `manifest` command outputs an [osbuild](https://github.com/osbuild/osbuild) manifest for an image. This manifest contains all the steps performed to assemble the eventual image but the image itself is not created.
```console
$ image-builder manifest minimal-raw
# ... json ...
```
By default the `manifest` command uses the same distribution and version as the host system, you can pass another distribution and version with the `--distro` argument:
```console
$ image-builder manifest --distro fedora-43 minimal-raw
# ... json ...
```
When passed `--arch` `image-builder` will show the manifest for that architecture:
```console
$ image-builder manifest --arch aarch64 minimal-raw
# ... output ...
```
# 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.