butane፦ ሁሉም ስሪቶች እና የቆዩ ስሪቶች

Starting with this release, ignition-validate binaries are signed with the
Fedora 44 key.
Breaking changes
- The build script now requires a subcommand (ignition, ignition-validate, or ignition-validate-cross). Sourcing the build script is no longer supported.
- Build and install are separate steps with explicit targets (ignition, ignition-validate, ignition-validate-cross, install, install-ignition-validate-cross, install-grub-for-bootupd).
Features
- Accept Butane YAML configs in addition to Ignition JSON, with automatic transpilation at boot (#2235)
- Support reading configs from /run/ignition and /etc/ignition/ in addition to /usr/lib/ignition/, searched in descending priority order (#2221)
- Add support for virtiofs
- Support loading Ignition config from a labeled device via ignition.config.device and ignition.config.path kernel command-line arguments
- Allow deleting a disk partition while creating another partition with number 0. (#2234)
Changes
- Merge Butane config transpiler into the Ignition repository; the butane CLI is now built from the Ignition source tree (#2235)
- Replace GCS client library with direct HTTP calls to the GCS JSON API, significantly reducing binary size (#2045)
- Refactored the Makefile and build script to match the Fedora RPM spec: separate build targets per binary, with VERSION and linker flags passed in at build time
- build_blackbox_tests builds a blackbox-specific ignition binary with make
- CI and GitHub Actions updated to build via make ignition and make ignition-validate
- Fix test script compatibility with Go 1.26 which removed the -go flag from go tool fix
- Improved documentation for the flow of Ignition across clouds.
Bug fixes
- Fix giving disk partition number 0 to get the next available slot. This caused the disks stage to fail since version 2.20.0. (#2234)
- Fix disk partitioning race condition where the kernel is already aware of the changes before running partx, causing a fatal error. (#2234)
- Add x-initrd.attach to crypttab entries to fix soft-reboot with LUKS (#2219)

Breaking changes
Roll back OpenShift spec 4.22.0 to Ignition spec 3.5.0. Butane 0.28.0 stabilized 4.22.0 targeting Ignition 3.6.0 (#704), but OCP 4.22's Machine Config Operator does not support Ignition 3.6.0 (OCPBUGS-90256). Configs must be re-transpiled with an updated Butane.

Misc. changes
Add support for pretty error reporting, can be controlled through the use of --raw-errors (disable) and --color/--colour

Starting with this release, Butane binaries are signed with the Fedora 44
key.
Features
- Stabilize OpenShift spec 4.22.0, targeting Ignition spec 3.6.0
- Add OpenShift spec 4.23.0-experimental, targeting Ignition spec 3.7.0-experimental
- Add systemd.quadlets section for embedding Podman Quadlet files (fcos 1.8.0-exp, fiot 1.1.0-exp, flatcar 1.2.0-exp, openshift 4.23.0-exp, r4e 1.2.0-exp)

Misc. changes
- Warn on root partition size is too small (fcos 1.3.0+)
- Warn on root partition constrained by another partition (fcos 1.3.0+)

Butane 0.27.0 (2026-02-27)
Features
- Stabilize Fcos spec 1.7.0, targeting Ignition spec 3.6.0
- Add Fcos spec 1.8.0-experimental, targeting Ignition spec 3.7.0-experimental
- Update Flatcar spec 1.2.0-experimental to target Ignition spec 3.7.0-experimental
- Update Fiot spec 1.1.0-experimental to target Ignition spec 3.7.0-experimental
- Update R4E spec 1.2.0-experimental to target Ignition spec 3.7.0-experimental
- Update OpenShift spec 4.22.0-experimental to target Ignition spec 3.7.0-experimental
Docs changes
- Re-vendor latest ignition release; 3.6.0-experimental becomes 3.6.0
NOTE: the release will be published initially without the artifacts while they are in the signing process. Once signed they will be added. Thank you for your understanding.

Starting with this release, Butane binaries are signed with the Fedora 43
key.
Breaking changes
- Require boot_device.layout when using boot_device.mirror (fcos 1.7.0-exp)
Features
- Stabilize OpenShift spec 4.21.0, targeting Ignition spec 3.5.0
- Add OpenShift spec 4.22.0-experimental, targeting Ignition spec
3.6.0-experimental
- Add support for mode and ownership settings for trees.
Bug fixes
- Warn for boot_device.layout to be specified when using boot_device.mirror (fcos 1.3.0-1.6.0)
Docs changes
- Update boot_device.mirror examples to specify boot_device.layout

Docs changes
- Update docs around the use of setuid/gid from Ignition bug
Misc. changes
- Update vendor'd Ignition dependency to point to latest v2.23.0

Features
- Stabilize OpenShift spec 4.20.0, targeting Ignition spec 3.5.0
- Add OpenShift spec 4.21.0-experimental, targeting Ignition spec 3.6.0-experimental
Bug fixes
- Stop overriding default LUKS cipher algorithm in FIPS mode (openshift 4.20.0)
Docs changes
- Add missing examples in upgrading-openshift (openshift 4.14)

Features
- Validate merged/replaced Ignition configs if they are local/inline (all base specifications)
- Stabilize OpenShift spec 4.19.0, targeting Ignition spec 3.5.0
- Add OpenShift spec 4.20.0-experimental, targeting Ignition spec
3.6.0-experimental
Bug fixes
- Fail if LUKS method is not specified while boot_device.luks.device is set (fcos 1.7.0-exp)
- Validate kernel arguments when CEX support is enabled on s390x (4.19.0 and 4.20.0-experimental)
Misc. changes
- Roll back to Ignition spec 3.5.0 (openshift 4.19.0)

Butane 0.23.0 (2024-12-03)
Starting with this release, Butane binaries are signed with the Fedora 41
key.Features
- Add OpenShift spec 4.19.0-experimental, targeting Ignition spec
3.6.0-experimental
- Stabilize OpenShift spec 4.18.0, targeting Ignition spec 3.4.0
- Stabilize Fcos spec 1.6.0, targeting Ignition spec 3.5.0
- Add Fcos spec 1.7.0-experimental, targeting Ignition spec
3.6.0-experimental
- Update Fiot spec 1.1.0-experimental to target Ignition spec
3.6.0-experimental
- Update Flatcar spec 1.2.0-experimental to target Ignition spec
3.6.0-experimental
- Update OpenShift spec 4.18.0-experimental, targeting Ignition spec
3.6.0-experimental
- Update R4e spec 1.2.0-experimental to target Ignition spec
3.6.0-experimental
- Support LUKS encryption using IBM CEX secure keys on s390x (fcos 1.6) (openshift 4.18.0-exp)
Docs changes
- Re-vendor latest ignition release; 3.5.0-experimental becomes 3.5.0

Butane 0.22.0 (2024-09-20)
Features
- Stabilize OpenShift spec 4.17.0, targeting Ignition spec 3.4.0
- Add OpenShift spec 4.18.0-experimental, targeting Ignition spec
3.5.0-experimental
- Support and documentation for grub section moved to OpenShift
4.18.0-experimental spec.
Misc. changes
- Roll back to Ignition spec 3.4.0 (openshift 4.17.0)

Butane 0.21.0 (2024-06-06)
Starting with this release, Butane binaries are signed with the Fedora 40
key.Breaking changes
Features
- Support storage.luks.clevis (flatcar 1.2.0-exp)
- Stabilize OpenShift spec 4.16.0, targeting Ignition spec 3.4.0
- Add OpenShift spec 4.17.0-experimental, targeting Ignition spec
3.5.0-experimental

Starting with this release, Butane binaries are signed with the Fedora 39
key.Features
- Support s390x layouts in boot_device section (fcos 1.6.0-exp, openshift 4.15.0-exp)
- Stabilize OpenShift spec 4.15.0, targeting Ignition spec 3.4.0
- Add OpenShift spec 4.16.0-experimental, targeting Ignition spec
3.5.0-experimental
Misc. changes
- Require Go 1.20+

Breaking changes
- Spec implementations require a FieldFilters() method (Go API)
- Reports from Unvalidated functions can now include json paths (Go API)
Features
- Add -c/--check option to check config without producing output
- Warn if config attempts to reuse partition by label _(fcos 1.6.0-exp,
- Require storage.filesystems.path to start with /etc or /var if
- Stabilize OpenShift spec 4.14.0, targeting Ignition spec 3.4.0
- Add OpenShift spec 4.15.0-experimental, targeting Ignition spec
Bug fixes
- Fix line/column reporting for http_headers errors
- Fix line/column reporting for unsupported field errors _(r4e)_
Misc. changes
- Add error structs for YAML unmarshal errors, unknown config versions (Go API)
- Roll back to Ignition spec 3.4.0 _(openshift 4.14.0)_
Docs changes
- Document consequence of setting systemd.units.mask to false
- Document grub section _(openshift 4.15.0-exp)_
- Document /dev/disk/by-id/coreos-boot-disk _(fcos, openshift 4.11.0+)_
- Don't claim to support generating swap units _(openshift 4.8.0 - 4.13.0)_
- Document key_file compression field _(openshift 4.8.0 - 4.9.0)_
- Document support for special mode bits and arn URLs _(r4e 1.1.0+)_
- Improve rendering of spec docs on docs site