InjectArtifactMetadata type

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.

Defines a single artifact to be injected into a partition during image modification.

This is used in the InjectFilesConfig array when performing injection via the inject-files CLI command.

Added in v0.14.

Example 

partition:
  idType: part-uuid
  id: b9f59ced-d1a6-44a7-91d9-4d623a39b032
destination: /EFI/BOOT/bootx64.efi
source: ./shim/bootx64.efi
type: shim

partition InjectFilePartition

Required.

The target partition where the artifact should be injected.

This field must be an object of type InjectFilePartition, with fields:

  • idType: How the partition should be identified. Options:
    • uuid
    • part-uuid
    • part-label
  • id: The identifier value (such as the GPT partition UUID or label).

Added in v0.14.

destination [string]

Required.

The absolute path (inside the target partition) where the artifact should be copied.

For example: /EFI/BOOT/bootx64.efi

Added in v0.14.

source [string]

Required.

Path to the artifact file to be injected. This path may be relative to the inject-files.yaml config file or an absolute path.

When the config file is generated by the output artifacts API, this will be the path of the unsigned artifact. Users should replace this file with the signed version before running the inject-files command.

Artifacts are organized in subdirectories matching their type (e.g., ukis/, shim/, systemd-boot/, verity-hash/).

Added in v0.14.

type [string]

Optional.

The type of artifact being injected. This field helps users identify which signing process to apply to each artifact.

For supported values, see output.artifacts.items.

Added in v1.1.