output type

Specifies the configuration for the output image and artifacts.

image [outputImage]

Specifies the configuration for the output image.

Example:

output:
  image:
    path: ./out/image.vhdx
    format: vhdx

Added in v0.13.

artifacts [outputArtifacts]

This is a preview feature. Its API and behavior is subject to change. You must enable this feature by specifying output-artifacts in the previewFeatures API.

Specifies the configuration for the output directory containing the generated artifacts.

Example:

output:
  artifacts:
    items: 
    - ukis
    - shim
    - systemd-boot
    - verity-hash
    path: ./output
previewFeatures:
- output-artifacts

Added in v0.14.

selinuxPolicyPath [string]

Optional.

This is a preview feature. Its API and behavior is subject to change. You must enable this feature by specifying output-selinux-policy in the previewFeatures API.

Specifies the directory path where Image Customizer will output the SELinux policy files. The policy type is determined by reading the SELINUXTYPE value from /etc/selinux/config in the image (e.g., targeted), and the corresponding directory from /etc/selinux/<type> is extracted.

This field can be overridden by the --output-selinux-policy-path command line option. If both are provided, the command line value is used.

The path can be either:

  • An absolute path (e.g., /tmp/selinux-policy)
  • A relative path to the configuration file’s parent directory (e.g., ./selinux-policy)

If this field is not specified or is an empty string, SELinux policy extraction is disabled.

The output directory will contain a subdirectory named after the SELINUXTYPE value (e.g., targeted/) with the complete SELinux policy structure, including:

  • policy/ – Compiled policy files
  • contexts/ – SELinux context configurations
  • seusers – SELinux user mappings
  • Additional policy-related files and directories

If /etc/selinux/config does not exist in the image, or if the policy directory for the configured SELINUXTYPE does not exist in /etc/selinux/, the customization will fail with an error.

Example:

output:
  selinuxPolicyPath: ./selinux-policy
previewFeatures:
- output-selinux-policy

Added in v1.1.