v0.13.0-mirantis.0

Release v0.13.0-mirantis.0

Release Date: November 4, 2025

Base Version: v0.13.0 (upstream)

Container Image: ghcr.io/mirantis/cluster-api-provider-openstack:v0.13.0-mirantis.0

🎯 Overview

This release syncs Mirantis CAPO with upstream v0.13.0, bringing support for Cluster API v1.11.x and the v1beta2 API contract. All Mirantis features from v0.12.5-mirantis.0 have been contributed to and accepted by upstream, so this is a clean sync with no additional patches.

✨ Key Changes

Cluster API v1.11.x Support

• v1beta2 API Contract - Updated to support Cluster API v1.11.2 with the new v1beta2 contract
• Backward Compatible - Existing v1beta1 resources continue to work seamlessly

📋 Technical Details

API Changes

• API Contract: v1beta2 (CAPI v1.11.x)
• Backward Compatible: v1beta1 resources fully supported

Compatibility

• Base: Kubernetes Cluster API v1.11.2
• OpenStack: Pike+ (minimum Nova microversion 2.60)
• Kubernetes: v1.28+
• Go: 1.24.0

🚀 Container Images

Multi-architecture support:

docker pull ghcr.io/mirantis/cluster-api-provider-openstack:v0.13.0-mirantis.0

Supported platforms:

• linux/amd64
• linux/arm
• linux/arm64
• linux/ppc64le
• linux/s390x

🔄 Upgrade Notes

Upgrading from v0.12.5-mirantis.0

This is a straightforward version bump with full backward compatibility:

1. Update to this release for the new features mentioned above
2. All existing v1beta1 resources continue to work
3. The v1beta2 contract is now supported for new resources

No action required for existing clusters - they will continue to function normally.

🤝 Contributing

All Mirantis features from v0.12.5-mirantis.0 (OpenStackClusterIdentity, network handling improvements, hosted control plane documentation) have been successfully contributed back to and merged into upstream kubernetes-sigs/cluster-api-provider-openstack. This release maintains full compatibility with upstream.

v0.12.5-mirantis.1

Release v0.12.5-mirantis.1

Release Date: September 3, 2025
Base Version: v0.12.4 (upstream stable)
Container Image: ghcr.io/mirantis/cluster-api-provider-openstack:v0.12.5-mirantis.1

🎯 Overview

This is a Mirantis internal release that adds trunk sub-port support to the stable v0.12.4 upstream base. This release focuses on while delivering essential OpenStack trunk sub-port creation capability.

✨ New Features

Trunk Sub-Port Creation

• Sub-ports can be added to trunk ports for OpenStack Machines

📋 Technical Details

API Changes

• Added SubportOpts and ResolvedSubportSpec types to API
• Since sub-ports and ports are essentially the same entities
  CommonPortOpts and CommonResolvedPortSpec types were introduced as a
  basis for regular ports and trunk subports
• Added SubPortStatus to keep track of ports which are associated with
  trunk

Compatibility

• Base: Kubernetes Cluster API v1.8+
• OpenStack: Pike+ (same as upstream)
• Kubernetes: v1.28+ (tested with v1.33)

🚀 Container Images

Multi-architecture support:
docker pull ghcr.io/mirantis/cluster-api-provider-openstack:v0.12.5-mirantis.1

Supported platforms:

• linux/amd64
• linux/arm
• linux/arm64
• linux/ppc64le
• linux/s390x

🔄 Upgrade Notes

This release is based on the stable v0.12.4 upstream version and can be used as a drop-in replacement. The new properties for ports in OpenStackMachine and OpenStackMachineDeployment just set to nil value on migration and do not affect existing entitites

🤝 Contributing

This release represents Mirantis's enterprise hardening of the upstream project while maintaining full compatibility. Features developed here are also contributed back to the upstream project.

Full Changelog: v0.12.4...v0.12.5-mirantis.1

v0.12.5-mirantis.0

Release v0.12.5-mirantis.0

Release Date: September 3, 2025
Base Version: v0.12.4 (upstream stable)
Container Image: ghcr.io/mirantis/cluster-api-provider-openstack:v0.12.5-mirantis.0

🎯 Overview

This is a Mirantis internal release that adds critical features and fixes to the stable v0.12.4 upstream base. This release focuses on production stability while delivering essential OpenStack Credential Management capabilities.

✨ New Features

OpenStackClusterIdentity (v1alpha1)

• Centralized credential management for OpenStack clusters
• Namespace-scoped access control with selector-based permissions
• Type-based identity references (Secret vs ClusterIdentity)
• Enhanced security by centralizing OpenStack authentication
• Comprehensive test coverage (unit, integration, e2e)

🔧 Bug Fixes & Improvements

Hosted Control Plane (HCP) Stability

• Fixed panic conditions in HCP deployments
• Improved nil network handling for edge cases
• Enhanced security group precedence logic
• Added comprehensive unit tests for edge cases

Documentation & Guides

• New hosted control plane deployment guide
• OpenStackClusterIdentity usage documentation
• Enhanced API documentation with examples

📋 Technical Details

API Changes

• New CRD: OpenStackClusterIdentity (v1alpha1)
• Enhanced: OpenStackIdentityReference with type field
• Backward compatible: Existing Secret-based auth unchanged

Compatibility

• Base: Kubernetes Cluster API v1.8+
• OpenStack: Pike+ (same as upstream)
• Kubernetes: v1.28+ (tested with v1.33)

🚀 Container Images

Multi-architecture support:

docker pull ghcr.io/mirantis/cluster-api-provider-openstack:v0.12.5-mirantis.0

Supported platforms:

• linux/amd64
• linux/arm
• linux/arm64
• linux/ppc64le
• linux/s390x

📝 Commit Summary

• 949b78fa Add Mirantis release workflows and registry configuration
• ec726c31 Merge branch 'hotfix/openstackclusteridentity'
• d452405e tests: e2e tests implemented
• 3b9bd1e8 envtest: added integration tests
• 4f49f7f0 tests: unit tests for provider.go
• a5c8293b add openstackclusteridentity crd and supporting code
• 3bbb587a added guide to deploy a openstack cluster - hosted cp
• 42b871b1 unit tests: add cases for nil network and SG override
• 96f2da1a handle nil cluster network & SG precedence, add TerminalError

🔄 Upgrade Notes

This release is based on the stable v0.12.4 upstream version and can be used as a drop-in replacement. The new OpenStackClusterIdentity feature is opt-in and doesn't affect existing deployments.

🤝 Contributing

This release represents Mirantis's enterprise hardening of the upstream project while maintaining full compatibility. Features developed here are also contributed back to the upstream project at https://github.com/kubernetes-sigs/cluster-api-provider-openstack.

---

Full Changelog: v0.12.4...v0.12.5-mirantis.0