# metal3-io v0.12.0

2025-12-19 · [Original release notes](https://github.com/metal3-io/baremetal-operator/releases/tag/v0.12.0) · [Full summary](https://ratatosk.io/en/releases/metal3-io/v0.12.0)

Breaking changes 6 · Deprecations 1 · Important fixes 1 · Enhancements 9 · Dependency updates 18 · Other changes 49

## Breaking changes (6)

### BMO removes `ironic-inspector` support

- Affects: BMO setups using `ironic-inspector` or inspector-formatted Ironic plugin data

Previously, BMO could fall back to the `inspector` interface when `agent` was unavailable and read NIC details from inspector-formatted plugin data. Newly enrolled nodes now use `agent`, and BMO no longer reads that data format.

Evidence: “return "inspector", nil // backward compatibility” https://github.com/metal3-io/baremetal-operator/pull/2755

> - Completely remove support for ironic-inspector (#2755)

### Public baremetal-operator images strip debugging information by default

- Affects: public baremetal-operator images in quay.io

The `-s -w` linker flags strip the symbol table and DWARF debugging information.

Evidence: “DWARF is mostly needed when we are using Delve. DWARF was originally created for C language and the need for it in go and other debugging features is very small in general. As such, switch to using `-ldflags="-s -w"` by default and have an option to opt in for debugging info for those who would really need it.” https://github.com/metal3-io/baremetal-operator/pull/2709

> - Dockerfile: strip out symbol table by default for public images (#2711)

### Debugging information stripped from standard BMO Docker builds

- Affects: standard BMO Docker builds

Previously, standard builds included symbol-table and DWARF debugging information; they now omit it. The opt-in `docker-debug` target still builds with debugging information.

Evidence: “As such, switch to using `-ldflags="-s -w"` by default and have an option to opt in for debugging info for those who would really need it.” https://github.com/metal3-io/baremetal-operator/pull/2709

> - cmd: strip out symbol table & DWARF debugging info (#2709)

### BMO raises the minimum Ironic API microversion

- Affects: Ironic releases before 2024.1 or API microversions below 1.89
- Action required: Ironic 2024.1 or later with API microversion 1.89 or newer

Previously, BMO used microversion 1.81 as its baseline. API versions below the new minimum are rejected with an error.

> - Remove support for Ironic before 2024.1 (#2756)

### Non-Redfish iLO 4 and iLO 5 BMC drivers removed

- Affects: non-Redfish iLO 4 or iLO 5 BMC access
- Action required: For iLO 5, use Redfish; for iLO 4, IPMI is the only option.

BMO previously supported the `ilo4`, `ilo4-virtualmedia`, and `ilo5` access schemes; these schemes are no longer supported.

> - Drop the non-Redfish iLO 4 and iLO 5 drivers (#2750)

### BMO requests `PreprovisioningImage`s for host servicing

- Affects: servicing of provisioned or externally provisioned hosts

Previously, BMO ignored `PreprovisioningImage`s for provisioned hosts, and externally provisioned hosts may have no image left from deployment. During servicing, BMO requests one when deployment image information is absent and a builder is available, so it can be created if needed.

Evidence: “The current code ignores PreprovisioningImages for provisioned nodes. While normally there is a leftover PreprovisioningImage from the deployment, it's not the case for externally provisioned hosts.” https://github.com/metal3-io/baremetal-operator/pull/2690

> - Create a PreprovisioningImage for servicing if needed (#2690)

## Deprecations (1)

### BareMetalHost inspection mode field added; legacy disable annotation deprecated

- Affects: BareMetalHost resources using `spec.inspectionMode` or the legacy `disabled` value of the `inspect.metal3.io` annotation
- Removed in: not stated

The new field supports `disabled` to disable inspection and `agent` for standard agent-based inspection. The legacy `disabled` annotation value remains available for backward compatibility; other annotation values are unaffected.

> - Introduce InspectionMode field (#2670)

## Important fixes (1)

### `BareMetalHost` deletion no longer gets stuck during inspection or cleaning

- Affects: `BareMetalHost` deletion

Previously, deleting a host in `inspecting` or `cleaning` state could get stuck because Ironic rejects power changes while a target provision state is active. BMO now aborts inspection or cleaning before powering off; the abort returns the host to `Dirty` so deletion can retry later.

> - Abort inspection/cleaning before powering off during deletion (#2796)

## Enhancements (9)

- Container images now keylessly signed (To use: The image-build and release workflows enable signing with `sign-image: true`; signing uses GitHub Actions OIDC tokens (`id-token: write`).)
- Optional checksums for BareMetalHost OCI images
- Image build workflows add SBOM attestations to image digests (To use: `id-token` permission and SBOM generation enabled via a flag)
- `bootMACAddress` optional for virtual-media inspection (To use: The `redfish-virtualmedia`, `idrac-virtualmedia`, or `ilo5-virtualmedia` BMC driver with inspection enabled)
- LLDP data captured during hardware inspection
- BMO reads Ironic service details from an existing IrSO object (To use: Configure `IRONIC_NAME` with the name of the existing IrSO Ironic object. `IRONIC_NAMESPACE` can specify its namespace and defaults to `POD_NAMESPACE`.)
- Namespace-scoped watching for BMO (To use: Set `WATCH_NAMESPACE` to a namespace or comma-separated list of namespaces)
- BareMetalHost accepts case-only `bootMACAddress` updates
- BMO release manifests added as release artifacts

## Dependency updates (18)

18 more, none mentioning security

- `- Bump github.com/onsi/gomega from 1.38.2 to 1.38.3 in /test (#2871)`
- `- Bump the kubernetes group to v0.34.3 (#2866)`
- `- Bump github.com/onsi/ginkgo/v2 from 2.27.2 to 2.27.3 in /test (#2870)`
- `- Bump CAPI to v1.12.0 (#2874)`
- `- Bump github.com/onsi/gomega from 1.38.2 to 1.38.3 (#2868)`
- `- Bump github.com/cert-manager/cert-manager from 1.18.2 to 1.18.4 in /test (#2869)`
- `- Bump libvirt.org/go/libvirt from 1.11006.0 to 1.11010.0 in /test (#2831)`
- `- Bump github.com/metal3-io/ironic-standalone-operator/api from 0.6.0 to 0.6.1 (#2829)`
- `- bump golang to 1.24.11 (#2822)`
- `- Bump go.uber.org/zap from 1.27.0 to 1.27.1 (#2800)`
- `- Bump github.com/gophercloud/gophercloud/v2 from 2.8.0 to 2.9.0 (#2801)`
- `- Bump golang.org/x/crypto from 0.43.0 to 0.45.0 in /hack/tools (#2802)`
- `- Bump golang.org/x/crypto from 0.43.0 to 0.45.0 in /test (#2794)`
- `- Bump sigs.k8s.io/kustomize/api from 0.20.1 to 0.21.0 in /test (#2786)`
- `- Bump sigs.k8s.io/kustomize/kustomize/v5 from 5.7.1 to 5.8.0 in /hack/tools (#2784)`
- `- Bump go.etcd.io/etcd/client/pkg/v3 from 3.6.5 to 3.6.6 (#2783)`
- `- Bump golang.org/x/oauth2 from 0.32.0 to 0.33.0 in /hack/tools (#2767)`
- `- Bump k8s.io modules to v0.34.1 and CR to v0.22.4 (#2779)`

## Other changes (49)

- BMO architecture default follows controller CPU architecture
- Hardware details recovered from matching `HardwareData` resources
- BMO end-to-end tests watch `upgrade-bmo` and `upgrade-ironic` namespaces
- `AGENTS.md` file added
- Release-0.11 test triggers added to README
- Alpha release entry added to the release documentation
- Updated information on running end-to-end tests locally
- Release verification instructions added to `releasing.md`
- End-to-end test helper retries `BareMetalHost` patches
- Upgrade tests wait for the BMO controller to process `BareMetalHost` updates before applying the provisioning patch
- Lint configuration now allows long lines in tables and code fences
- End-to-end test image configuration honors `LoadBehavior`
- Controller finalizer removal uses `controllerutil.RemoveFinalizer`
- Modern Go idioms in controller and Ironic provisioner code
- Bare Metal Operator list checks now use `slices.Contains`
- GitHub Actions dependencies updated
- `errorlint` enabled and production error handling updated
- yamllint workflow added
- IrSO test overlays use Ironic version numbers
- Scheduled `osv-scanner` GitHub Actions workflow removed
- E2E helper minimum `kubectl` version raised to v1.34.1
- External-inspection E2E tests use distinct names
- Duplicate inspection-skipping E2E test removed
- E2E setup uses a locally served IPA image
- Pull-request template adds contributor steps and a test checklist
- Multiple VM network interface support in test `vbmctl`
- Upgrade E2E logs and artifacts separated by test case
- E2E tests honor the BMC certificate verification setting
- Upgrade E2E tests now deploy Ironic with IrSO
- E2E IrSO setup updated to v0.5.2
- E2E `vbmctl` switches to the `baremetal-e2e` libvirt storage pool
- Test dependency `github.com/metal3-io/ironic-standalone-operator/api` updated to v0.6.0
- Ironic provisioner startup failures handled by main
- Basic end-to-end tests use an Ironic standalone operator installation
- Periodic end-to-end test job for release-0.8 removed
- Dependabot configuration now specifies a time
- End-to-end upgrade test cleanup ordering and BMH patch retries
- OSV-Scanner setup fixed
- Longer time allowance for optional periodic tests
- Configurable end-to-end workflow timeouts
- End-to-end Ironic overlays use the Nordix cache for IPA downloads
- Periodic test added for `release-0.11`
- End-to-end tests for release 0.11 added
- End-to-end tests accept uppercase `Upgrade` for skip handling
- Version-tagged keepalived image check removed from release verification
- Dependabot support for release-0.11
- `github.com/prometheus/client_golang` updated to 1.23.2
- GitHub Actions runners updated to OCI GitHub ARC runners
- `errname` linter enabled

---

Summaries are produced by AI, so they can be wrong, and they are provided without warranty.
