Distribution Support
The following tables show which APIs are supported for each distribution.
APIs marked as Preview require the distribution’s
previewFeatures value to be set
(e.g. ubuntu-22.04, ubuntu-24.04, azure-container-linux-3).
Command line
| Subcommand + Flag | Azure Linux 3.0 | Azure Linux 4.0 | Ubuntu 22.04, 24.04 | Azure Container Linux 3.0 |
|---|---|---|---|---|
| create | Yes | Yes | No | No |
| convert | Yes | Yes | Yes | No |
| customize | Yes | Yes | Preview | Preview |
| --build-dir | Yes | Yes | Preview | Preview |
| --image-file | Yes | Yes | Preview | Preview |
| --image | Yes | Yes | No | No |
azureLinux:* |
Yes | Yes | N/A | N/A |
oci:* |
Yes | Yes | Preview | No |
| --output-image-file | Yes | Yes | Preview | Preview |
| --output-path | Yes | Yes | Preview | Preview |
| --output-image-format | Yes | Yes | Preview | Preview |
baremetal-image |
Yes | No | Preview | No |
cosi |
Yes | No | Preview | No |
iso |
Yes | No | No | No |
pxe-dir |
Yes | No | No | No |
pxe-tar |
Yes | No | No | No |
qcow2 |
Yes | Yes | Preview | Preview |
raw |
Yes | Yes | Preview | Preview |
vhd-fixed |
Yes | Yes | Preview | Preview |
vhd |
Yes | Yes | Preview | Preview |
vhdx |
Yes | Yes | Preview | Preview |
| --cosi-compression-level | Yes | No | No | No |
| --output-selinux-policy-path | Yes | No | No | No |
| --config-file | Yes | Yes | Preview | Preview |
| --rpm-source | Yes | Yes | No | No |
| --disable-base-image-rpm-repos | Yes | Yes | No | No |
| --package-snapshot-time | Yes | No | No | No |
| --image-cache-dir | Yes | Yes | No | No |
| inject-files | Yes | Yes | No | No |
Configuration
| API | Azure Linux 3.0 | Azure Linux 4.0 | Ubuntu 22.04, 24.04 | Azure Container Linux 3.0 |
|---|---|---|---|---|
| input.image.path | Yes | Yes | Preview | Preview |
| input.image.oci | Yes | Yes | No | No |
| input.image.azureLinux | Yes | Yes | N/A | N/A |
| storage | Yes | No | No | No |
| iso | Yes | No | No | No |
| pxe | Yes | No | No | No |
| os.hostname | Yes | Yes | Preview | Preview |
| os.kernelCommandLine | Yes | No | No | Preview |
| os.packages | Yes | Yes | Preview | No |
| .updateExistingPackages | Yes | Yes | Preview | No |
| .installLists | Yes | Yes | Preview | No |
| .install | Yes | Yes | Preview | No |
| .removeLists | Yes | Yes | Preview | No |
| .remove | Yes | Yes | Preview | No |
| .updateLists | Yes | Yes | Preview | No |
| .update | Yes | Yes | Preview | No |
| .snapshotTime | Yes | No | No | No |
| os.additionalFiles | Yes | Yes | Preview | Preview |
| os.additionalDirs | Yes | Yes | Preview | Preview |
| os.groups | Yes | Yes | Preview | Preview |
| os.users | Yes | Yes | Preview | Preview |
| os.modules | Yes | Yes | Preview | Preview |
| os.services | Yes | Yes | Preview | Preview |
| os.overlays | Yes | Yes | No | No |
| os.bootloader | Yes | No | No | No |
| os.uki | Yes | No | No | Preview |
| os.selinux | Yes | No | No | Preview |
| os.imageHistory | Yes | Yes | Preview | Preview |
| scripts | Yes | Yes | Preview | Preview |
| output.image | Yes | Yes | Preview | Preview |
| output.artifacts | Yes | No | No | Preview |
| output.selinuxPolicyPath | Yes | No | No | No |
| previewFeatures | Yes | Yes | Yes | Yes |