Skip to content

Automotive Image Builder manifests

The Automotive SIG maintains two collections of automotive-image-builder manifests that you can use to better understand the requisite YAML syntax, and for you to build and modify yourself:

  • The sig-docs/demos which includes all the manifests present in this documentation site. These images are built and tested nightly, and when changes are merged to Automotive image builder itself.
  • The sample-images repos which includes a collection of manifests. These images are not regularly tested and while most of them are included in sig-docs/demos there may still be interesting manifests examples.

mpp.yml vs aib.yml

As you browse through the example manifests you might notice two types of manifests, some ending with .mpp.yml and some ending with .aib.yml. They reflect an evolution to the manifest format. The .mpp.yml manifests are written using the first generation format and structure heavily based on OSBuild‘s manifests. That format is complex, error-prone and cumbersome when manually edited.

This, first, complex format has been replaced by a “simplified” format which has a limited and clearly defined set of capabilities documented at: https://centos.gitlab.io/automotive/src/automotive-image-builder/simple_manifest.html. This format requires the .aib.yml file extension. It is the format that is used in this documentation and the format that we strongly encourage you to use.

Tuning options in the manifest

An Automotive Image Builder manifest specifies the build configuration of your image. To create an immutable AutoSD OS image, you must define configurable options exclusively in your manifest file.

The simple manifest is a resource that lists the configuration details of tunable options in an Automotive Image Builder manifest. The simple manifest describes the component type, the purpose of the component, its syntax, required values, options, and other information.

If an option does not appear in the simple manifest, then its value is constant and it cannot be changed in an Automotive Image Builder manifest.

© Red Hat