inject-files subcommand

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

This subcommand takes a base image and a config file (typically auto-generated from the output.artifacts API) and injects files (like signed bootchain artifacts) back into the image at specified locations.

The output image will be written to the same path as the input image, unless --output-image-file and --output-image-format are specified.

See injectFilesConfig for config format.

Added in v0.14.

--config-file=FILE-PATH

Required.

The path to the file injection configuration, typically auto-generated from the output.artifacts section of the image customization config.

See: injectFilesConfig

Added in v0.14.

--image-file=FILE-PATH

Required.

The path to the base image to inject files into.

Supported image formats: vhd, vhdx, qcow2, and raw.

Added in v0.14.

--build-dir=DIRECTORY-PATH

Required.

The temporary workspace directory where the tool will place its working files.

Added in v0.14.

--output-image-file=FILE-PATH

Optional.

The file path to write the modified image to. If not specified, the image is modified at --image-file.

Added in v0.14.

--output-path=FILE-PATH

An alias to --output-image-file

Added in v0.15.

--output-image-format=FORMAT

Optional.

The image format of the final image written to --output-image-file.

Supported image formats: vhd, vhd-fixed, vhdx, qcow2, raw, iso, pxe-dir, pxe-tar, cosi, and baremetal-image.

See output.image.format for detailed descriptions of each format.

If this option is not provided, the format of the input image is preserved.

Added in v0.14.

--cosi-compression-level=LEVEL

Optional. Default: 9

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

The zstd compression level (1-22) for COSI partition images.

Higher compression levels produce smaller files but take significantly longer to compress. Decompression speed is largely unaffected by the compression level.

Added in v1.2.