Chapter 1. Red Hat build of MicroShift 4.16 release notes
Red Hat build of MicroShift provides developers and IT organizations with small-form-factor and edge computing delivered as an application that customers can deploy on top of their managed Red Hat Enterprise Linux (RHEL) devices at the edge. Built on OpenShift Container Platform and Kubernetes, MicroShift provides an efficient way to operate single-node clusters in low-resource edge environments.
MicroShift is designed to make control plane restarts economical and be lifecycle-managed as a single unit by the operating system. Updates, roll-backs, and configuration changes consist of simply staging another version in parallel and then - without relying on a network - flipping to and from that version and restarting.
1.1. About this release
Version 4.16 of Red Hat build of MicroShift includes new features and enhancements. MicroShift was introduced as Generally Available with MicroShift 4.14. Update to the latest version of MicroShift to receive all of the latest features, bug fixes, and security updates. MicroShift is derived from OpenShift Container Platform 4.16 and uses the CRI-O container runtime. New features, changes, and known issues that pertain to MicroShift are included in this topic.
You can deploy MicroShift clusters to on-premise, cloud, disconnected, and offline environments.
MicroShift 4.16 is supported on Red Hat Enterprise Linux (RHEL) or Red Hat Enterprise Linux for Edge (RHEL for Edge) 9.4.
For lifecycle information, see the Red Hat build of MicroShift Life Cycle Policy.
1.2. New features and enhancements
This release adds improvements related to the following components and concepts.
1.2.1. Red Hat Enterprise Linux (RHEL)
- MicroShift 4.16 runs on Red Hat Enterprise Linux (RHEL) 9.4.
1.2.2. Updating
Updating two minor versions in a single step is now supported. Updates for both single-version minor releases and patch releases are still supported.
1.2.2.1. Update two minor versions in a single step
See the following list for details:
- You can update from one long-life-cycle version of MicroShift directly to another, without applying the intermediate version. For example, you can update directly to 4.16 from 4.14. Updating 4.14 to 4.15 before updating to 4.16 is no longer required.
- Now, you can focus on developing applications for your devices in remote locations and with limited bandwidth, rather than planning for updates.
- MicroShift offers in-place updates on RHEL for Edge systems with automatic system rollback capabilities and automatic back up and restore functions.
- Updates of the RPMs on a non-OSTree system such as {op-system} are also supported.
- See Update options with Red Hat build of MicroShift and Red Hat Device Edge for details.
1.2.3. Configuring
1.2.3.1. Customizable certificate authorities for the API server are supported
With this release, you can configure a custom server certificate that has been issued by an external certificate authority (CA). The default API server certificate is issued by an internal MicroShift cluster CA. You can now replace this certificate with one that is issued by a CA that clients trust. See Configuring custom certificate authorities.
1.2.3.2. Configurable policies for log file rotation and retention
You can now configure audit logging policies to manage the retention policies for log files, ensuring that edge devices with limited storage capacities are not hampered by accumulated logging data. To configure audit log policies, use settings such as a maximum file size limit and maximum retained files to set a limit on log storage size. You can also choose an audit policy profile to specify the data collected. See Configuring audit logs.
1.2.3.3. Support for cleaning up certificates
With this release, you can clean up custom certificates. For more information, see Cleaning up and recreating the custom certificates.
1.2.4. Networking
1.2.4.1. Multiple networks capability now available
With this release, using multiple networks is supported with the MicroShift Multus plugin. If you have advanced networking requirements, you can attach additional networks to a pod for high-performance network configurations. After installing the MicroShift Multus RPM package, you can use the Bridge, MACVLAN, or IPVLAN plugins to create additional networks. See Additional networks in MicroShift.
1.2.4.2. Custom configurations for the ingress router are supported
You can now configure ingress routes to create access to multiple services inside your MicroShift cluster. You can use a variety of combinations to customize the endpoint configuration for your use case. See About configuring the router.
1.2.4.3. Configuring the route admission policy now available
You can now configure the route admission policy to allow routes to claim different paths of the same hostname across namespaces. See Configuring the route admission policy.
1.2.5. Running applications
1.2.5.1. GitOps with Argo CD now available
With this release, you can use the GitOps with Argo CD agent derived from GitOps 1.12 with MicroShift. Using GitOps means you can update a single Git repository and automate the deployment of new applications or updates to existing ones. You can also use your Git repository as an audit trail of changes so that you can create processes such as review and approval for merging pull requests that implement configuration changes. See Automating application management with the GitOps controller.
1.2.6. Support
1.2.6.1. Getting a cluster ID
With this release, you can get the ID of a MicroShift cluster. When opening a support case, you can provide the cluster ID to Red Hat Support to help in identifying issues with your cluster. See Getting your cluster ID.
1.2.7. Security and compliance
1.2.7.1. SSL Medium Strength Cipher Suites now supported
During an SSL handshake between a client and a server, the cipher to use is negotiated between them. With this release, SSL Medium Strength Cipher Suites are now supported for the kube-controller-manager daemon, kube-scheduler control-plane process, and kubelet "node agent." This enhancement to the internal communication between kubernetes components improves control plane communications security. (OCPBUGS-29037)
1.2.8. Documentation enhancements
1.2.8.1. Route configuration now documented
With this release, specific details for creating and managing supported route configurations are documented, see Configuring routes.
1.3. Bug fixes
Networking
Previously, the MicroShift load balancer controller tried to update the IP addresses of every LoadBalancer service in the cluster. Some of these services, such as those with a defined loadBalancerClass, have their own update procedures for external IPs. This conflicted with the MicroShift controller. Now, services that have a loadBalancerClass are filtered and IP addresses owned by other load balancer services are ignored by MicroShift. (OCPBUGS-30833)
Support
Previously, when microshift-etcd unexpectedly exited, MicroShift tried to restart so that microshift-etcd could restart, but there was a lingering unit fragment. Every attempt to restart microshift-etcd failed, making the system unusable. The --collect flag was added to the systemd-run invocation used to start microshift-etcd. The additional flag results in systemd cleaning up the unit fragment even if the unit failed. The system now recovers and restarts. (OCPBUGS-33588)
1.4. Known issues
1.4.1. Pods crash when writing files that exceed memory limits
Because of an issue with RHEL, when a pod tries to write files that are larger than configured memory limits to a persistent volume claim, the pod might crash with an out-of-memory error. The pod status shows OOMKilled when this occurs. Use the following workarounds to avoid this issue: Pods writing files larger than memory limit to PVCs tend to OOM frequently running on MicroShift(Red Hat Knowledgebase).
1.5. Asynchronous errata updates
Security, bug fix, and enhancement updates for MicroShift 4.16 are released as asynchronous errata through the Red Hat Network. All MicroShift 4.16 errata are available on the Red Hat Customer Portal. For more information about asynchronous errata, read the MicroShift Life Cycle.
Red Hat Customer Portal users can enable errata notifications in the account settings for Red Hat Subscription Management (RHSM). When errata notifications are enabled, you are notified through email whenever new errata relevant to your registered systems are released.
Red Hat Customer Portal user accounts must have systems registered and consuming MicroShift entitlements for MicroShift errata notification emails to generate.
This section is updated over time to provide notes on enhancements and bug fixes for future asynchronous errata releases of MicroShift 4.16. Versioned asynchronous releases, for example with the form MicroShift 4.16.z, are detailed in the following subsections.
1.5.1. RHEA-2024:0043 - MicroShift 4.16.0 bug fix and security update advisory
Issued: 27 June 2024
Red Hat build of MicroShift release 4.16.0 is now available. The list of bug fixes that are included in the update is documented in the RHSA-2024:0043 advisory. The images that are included in the update are provided by the RHSA-2024:0041 advisory.
See the latest images included with MicroShift by listing the contents of the MicroShift RPM release package.
1.5.2. RHBA-2024:4158 - MicroShift 4.16.1 bug fix and enhancement advisory
Issued: 3 July 2024
Red Hat build of MicroShift release 4.16.1 is now available. The list of bug fixes that are included in the update is documented in the RHBA-2024:4158 advisory. The images that are included in the update are provided by the RHSA-2024:4156 advisory.
See the latest images included with MicroShift by listing the contents of the MicroShift RPM release package.
1.5.3. RHBA-2024:4318 - MicroShift 4.16.2 bug fix and enhancement advisory
Issued: 9 July 2024
Red Hat build of MicroShift release 4.16.2 is now available. The list of bug fixes that are included in the update is documented in the RHBA-2024:4318 advisory. The images that are included in the update are provided by the RHSA-2024:4316 advisory.
See the latest images included with MicroShift by listing the contents of the MicroShift RPM release package.
1.5.4. RHBA-2024:4318 - MicroShift 4.16.3 bug fix and enhancement advisory
Issued: 16 July 2024
Red Hat build of MicroShift release 4.16.3 is now available. The list of bug fixes that are included in the update is documented in the RHBA-2024:4471 advisory. The images that are included in the update are provided by the RHSA-2024:4469 advisory.
See the latest images included with MicroShift by listing the contents of the MicroShift RPM release package.
1.5.4.1. Bug fixes
-
An error in validation allowed empty entries in the
listenAddressconfiguration parameter. The empty entries prevented MicroShift from starting and rendered a difficult-to-understand error message. Empty entries in the list are now filtered.
1.5.5. RHBA-2024:4615 - MicroShift 4.16.4 bug fix and enhancement advisory
Issued: 24 July 2024
Red Hat build of MicroShift release 4.16.4 is now available. The list of bug fixes that are included in the update is documented in the RHBA-2024:4615 advisory. The images that are included in the update are provided by the RHSA-2024:4613 advisory.
See the latest images included with MicroShift by listing the contents of the MicroShift RPM release package.
1.5.6. RHBA-2024:4857 - MicroShift 4.16.5 bug fix and enhancement advisory
Issued: 31 July 2024
Red Hat build of MicroShift release 4.16.5 is now available. The list of bug fixes that are included in the update is documented in the RHBA-2024:4857 advisory. The images that are included in the update are provided by the RHBA-2024:4855 advisory.
See the latest images included with MicroShift by listing the contents of the MicroShift RPM release package.
1.5.7. RHBA-2024:4967 - MicroShift 4.16.6 bug fix and enhancement advisory
Issued: 6 August 2024
Red Hat build of MicroShift release 4.16.6 is now available. The list of bug fixes that are included in the update is documented in the RHBA-2024:4967 advisory. The images that are included in the update are provided by the RHSA-2024:4965 advisory.
See the latest images included with MicroShift by listing the contents of the MicroShift RPM release package.
1.5.8. RHBA-2024:5109 - MicroShift 4.16.7 bug fix and enhancement advisory
Issued: 13 August 2024
Red Hat build of MicroShift release 4.16.7 is now available. The list of bug fixes that are included in the update is documented in the RHBA-2024:5109 advisory. The images that are included in the update are provided by the RHSA-2024:5107 advisory.
See the latest images included with MicroShift by listing the contents of the MicroShift RPM release package.
1.5.9. RHBA-2024:5424 - MicroShift 4.16.8 bug fix and enhancement advisory
Issued: 20 August 2024
Red Hat build of MicroShift release 4.16.8 is now available. The list of bug fixes that are included in the update is attached to the RHBA-2024:5424 advisory. The images that are included in the update are provided by the RHSA-2024:5422 advisory.
See the latest images included with MicroShift by listing the contents of the MicroShift RPM release package.
1.5.10. RHBA-2024:5759 - MicroShift 4.16.9 bug fix and enhancement advisory
Issued: 29 August 2024
Red Hat build of MicroShift release 4.16.9 is now available. The list of bug fixes that are included in the update is attached to the RHBA-2024:5759 advisory. The images that are included in the update are provided by the RHBA-2024:5757 advisory.
See the latest images included with MicroShift by listing the contents of the MicroShift RPM release package.
1.5.11. RHBA-2024:6006 - MicroShift 4.16.10 bug fix and enhancement advisory
Issued: 3 September 2024
Red Hat build of MicroShift release 4.16.10 is now available. The list of bug fixes that are included in the update is attached to the RHBA-2024:6006 advisory. The images that are included in the update are provided by the RHSA-2024:6004 advisory.
See the latest images included with MicroShift by listing the contents of the MicroShift RPM release package.
1.5.12. RHBA-2024:6403 - MicroShift 4.16.11 bug fix and enhancement advisory
Issued: 11 September 2024
Red Hat build of MicroShift release 4.16.11 is now available. The list of bug fixes that are included in the update is attached to the RHBA-2024:6403 advisory. The images that are included in the update are provided by the RHBA-2024:6401 advisory.
See the latest images included with MicroShift by listing the contents of the MicroShift RPM release package.
1.5.13. RHBA-2024:6634 - MicroShift 4.16.12 bug fix and enhancement advisory
Issued: 17 September 2024
Red Hat build of MicroShift release 4.16.12 is now available. The list of bug fixes that are included in the update is attached to the RHBA-2024:6634 advisory. The images that are included in the update are provided by the RHSA-2024:6632 advisory.
See the latest images included with MicroShift by listing the contents of the MicroShift RPM release package.
1.5.14. RHBA-2024:6688 - MicroShift 4.16.13 bug fix and enhancement advisory
Issued: 19 September 2024
Red Hat build of MicroShift release 4.16.13 is now available. The list of bug fixes that are included in the update is attached to the RHBA-2024:6688 advisory. The images that are included in the update are provided by the RHSA-2024:6687 advisory.
See the latest images included with MicroShift by listing the contents of the MicroShift RPM release package.
1.5.15. RHBA-2024:6826 - MicroShift 4.16.14 bug fix and enhancement advisory
Issued: 24 September 2024
Red Hat build of MicroShift release 4.16.14 is now available. The list of bug fixes that are included in the update is attached to the RHBA-2024:6826 advisory. The images that are included in the update are provided by the RHSA-2024:6824 advisory.
See the latest images included with MicroShift by listing the contents of the MicroShift RPM release package.
1.5.16. RHBA-2024:7176 - MicroShift 4.16.15 bug fix and enhancement advisory
Issued: 2 October 2024
Red Hat build of MicroShift release 4.16.15 is now available. The list of bug fixes that are included in the update is attached to the RHBA-2024:7176 advisory. The images that are included in the update are provided by the RHSA-2024:7174 advisory.
See the latest images included with MicroShift by listing the contents of the MicroShift RPM release package.
1.5.17. RHBA-2024:7601 - MicroShift 4.16.16 bug fix and enhancement advisory
Issued: 8 October 2024
Red Hat build of MicroShift release 4.16.16 is now available. The list of bug fixes that are included in the update is attached to the RHBA-2024:7601 advisory. The images that are included in the update are provided by the RHSA-2024:7599 advisory.
See the latest images included with MicroShift by listing the contents of the MicroShift RPM release package.
1.5.18. RHBA-2024:7946 - MicroShift 4.16.17 bug fix and enhancement advisory
Issued: 16 October 2024
Red Hat build of MicroShift release 4.16.17 is now available. The list of bug fixes that are included in the update is attached to the RHBA-2024:7946 advisory. The images that are included in the update are provided by the RHSA-2024:7944 advisory.
See the latest images included with MicroShift by listing the contents of the MicroShift RPM release package.
1.5.19. RHBA-2024:8262 - MicroShift 4.16.18 bug fix and enhancement advisory
Issued: 24 October 2024
Red Hat build of MicroShift release 4.16.18 is now available. The list of bug fixes that are included in the update is attached to the RHBA-2024:8262 advisory. The images that are included in the update are provided by the RHSA-2024:8260 advisory.
See the latest images included with MicroShift by listing the contents of the MicroShift RPM release package.
1.5.20. RHBA-2024:8417 - MicroShift 4.16.19 bug fix and enhancement advisory
Issued: 30 October 2024
Red Hat build of MicroShift release 4.16.19 is now available. The list of bug fixes that are included in the update is attached to the RHBA-2024:8417 advisory. The images that are included in the update are provided by the RHSA-2024:8415 advisory.
See the latest images included with MicroShift by listing the contents of the MicroShift RPM release package.
1.5.21. RHBA-2024:8685 - MicroShift 4.16.20 bug fix and enhancement advisory
Issued: 6 November 2024
Red Hat build of MicroShift release 4.16.20 is now available. The list of bug fixes that are included in the update is attached to the RHBA-2024:8685 advisory. The images that are included in the update are provided by the RHSA-2024:8683 advisory.
See the latest images included with MicroShift by listing the contents of the MicroShift RPM release package.
1.5.22. RHBA-2024:8988 - MicroShift 4.16.21 bug fix and enhancement advisory
Issued: 13 November 2024
Red Hat build of MicroShift release 4.16.21 is now available. The list of bug fixes that are included in the update is attached to the RHBA-2024:8988 advisory. The images that are included in the update are provided by the RHBA-2024:8986 advisory.
See the latest images included with MicroShift by listing the contents of the MicroShift RPM release package.
