config type

The top-level type of the configuration.

storage [storage]

Contains the options for provisioning disks, partitions, and file systems.

You should specify the disks, partitions and filesystems for creating a image these cannot be empty.

For supported fields in the storage level of the configuration refer to schema

os [os]

Contains the configuration options for the OS.

For supported fields in the os level of the configuration refer to schema

Example:

os:
  hostname: example-image

scripts [scripts]

Specifies custom scripts to run during the image creation process.

previewFeatures [string[]]

Enables preview features.

Preview features are features that have not yet been stabilized. Their APIs and behavior are subject to change.

Supported options:

  • package-snapshot-time: Enables snapshot-based package filtering during image customization. See the detailed definition in the section below.

    Example:

    os:
    previewFeatures:
    - package-snapshot-time
    
  • package-snapshot-time: Enables snapshot-based package filtering during image customization. This allows specifying a cutoff timestamp using the --package-snapshot-time CLI option or os.packages.snapshotTime API field. If both are provided, the CLI value takes precedence.

output [output]

Specifies the configuration for the output image.