microsoft/azure-linux-image-tools v1.2.0

v1.2.0

Repository: microsoft/azure-linux-image-tools

Tag: v1.2.0

Published: 2026-02-28T03:58:57Z

Prerelease: no

Release notes:

Breaking changes

None

Breaking changes for preview features

• The UKI API has changed. .os.uki.kernels was removed and .os.uki.mode was added.
• If you want to leave an existing UKI from the base image, you must now explicitly specify .os.uki.mode=passthrough.
• Kernel command-line args are now placed in a UKI addon instead of the main UKI file.

New preview features

• You can now control the COSI zstd compression level using the .output.image.cosi.compression.level API.
• Expanded hierarchical configs API to include ISO and PXE.
• Added support for btrfs filesystem, including creating subvolumnes and setting quotas.
• Added create subcommand for creating OS images from scratch.
• Added UKI mode of modify for modifying the kernel args through a UKI addon.
• Added initial support for customizing Ubuntu cloud images. Many features are not yet implemented.

New features

• Added support for COSI v1.2.
• Added convert subcommand, for converting OS images without customizing them. This is useful for creating fixed-sized VHDs and creating COSI images.
• Added validate-config subcommand.

Bug fixes

• Fixed boot failures when using the .storage.verity[].hashSignaturePath API.

Doc fixes and improvements

• Fixed a bunch of spelling and grammar issues.
• Fixed example for .output.image API.
• Gave the customize subcommand its own page.
• Cleaned up output image formats docs.
• Call out the need to specify --image-cache-dir when using the OCI APIs.