Skip to content

Feature: _ignite ​

Description ​

Installs Ignition and integrates it into the initrd for declarative first-boot system configuration.

What it does ​

_ignite installs the ignition package along with dracut-network and curl, and configures dracut to include Ignition in the initrd via 30-ignition.conf. A custom dracut module (30ignition-extra) extends the upstream Ignition support with an environment variable generator (ignition-env-generator.sh), a static environment file (ignition-files.env), a module-setup.sh for module registration, and an after-net-online.conf ordering file that ensures Ignition runs after the network is available.

Ignition processes a JSON configuration fetched from a platform-specific source (such as a cloud metadata service or fw_cfg) to provision users, files, systemd units, and disks on first boot. Features such as _pxe and _bfpxe include _ignite to provide this capability.

Files ​

Files present in this feature and their purpose. See the feature file reference for the semantics of each file type.

FilePurpose
file.include.markers.yaml (ref)Maps files in this feature to test-coverage marker IDs.
info.yaml (ref)Declares type: flag and included/excluded features.
pkg.include (ref)Installs dracut-network, ignition, and curl.
file.include/etc/dracut.conf.d/30-ignition.conf (file.include)Tells dracut to include the Ignition module when building the initrd.
file.include/usr/lib/dracut/modules.d/30ignition-extra/after-net-online.conf (file.include)Ordering configuration that ensures the Ignition-extra module activates after network connectivity is established.
file.include/usr/lib/dracut/modules.d/30ignition-extra/ignition-env-generator.sh (file.include)Systemd environment generator that exports Ignition platform and configuration URL variables in the initrd.
file.include/usr/lib/dracut/modules.d/30ignition-extra/ignition-files.env (file.include)Static environment file with default Ignition settings included in the initrd.
file.include/usr/lib/dracut/modules.d/30ignition-extra/module-setup.sh (file.include)Registers the 30ignition-extra dracut module and declares its dependencies.

This feature has no include or exclude relationships.

Further reading ​