MicroShift is Developer Preview software only.
For more information about the support scope of Red Hat Developer Preview software, see Developer Preview Support Scope.Chapter 1. Red Hat build of MicroShift 4.12 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 Red Hat Enterprise Linux (RHEL) for Edge and Kubernetes, Red Hat build of MicroShift provides an efficient way to operate single-node clusters in low-resource edge environments.
Red Hat build of 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
Red Hat build of MicroShift is now available as a Developer Preview software. Features and known issues that pertain to Red Hat build of MicroShift 4.12 are included in this topic. For more information about the support scope of Red Hat Developer Preview software, see Developer Preview Support Scope.
Red Hat does not provide or support an update or upgrade path from Developer Preview and Technology Preview versions to later versions of Red Hat build of MicroShift. A new installation is necessary.
1.2. Known issues
There is an issue exporting services with the Route API when the host and
routerCanonicalHostname
do not include the sub domain name. To work around this problem, use the subdomain setting when creating a Route.Example
apiVersion: route.openshift.io/v1 kind: Route metadata: name: route-1 spec: subdomain: svc-subdomain ⇐ specify the subdomain port: targetPort: 8080 to: kind: Service name: svc-1
- There is an issue resuming pods when a service is idled. The Red Hat build of MicroShift software does not support automatically reactivating services, and manual re-scaling the replicas is required.
-
It is possible to over-provision the storage system by creating persistent volumes (PVs) that do not actually fit on the disk when using the
spare-gb
configuration value inlvmd.conf
. To protect capacity from being used by thetopoLVM
driver, use a new separate volume group (VG) that is not exposed totopoLVM
. There is a known issue involving the
runc
CLI tool andsystemd
.runc
is overly verbose aboutmount ops
. These messages are innocuous and do not indicate a problem with the system’s operation. This bug affects any Linux platform running a container runtime built onrunc
.You can suppress all
runc
mount logs throughsystemd
. Create the file/etc/systemd/system/run-containerd-.mount.d/10-silence.conf
, or whatever prefix you need to silence, with:[Mount] LogLevelMax=notice
And reload the daemon.
- There is an issue with the way Red Hat build of MicroShift’s CNI driver manages the firewall rules. If the firewall settings are modified after Red Hat build of MicroShift is started then Red Hat build of MicroShift must be restarted. The recommended workaround is to configure firewall rules before starting Red Hat build of MicroShift.
-
After a new installation of Red Hat build of MicroShift, the
NodePort
service traffic might be stopped. To work around this issue, manually restart theovnkube-master
pod in theopenshift-ovn-kubernetes
namespace.
1.3. Asynchronous errata updates
Security, bug fix, and enhancement updates for Red Hat build of MicroShift 4.12 are released as asynchronous errata through the Red Hat Network. All Red Hat build of MicroShift 4.12 errata are available on the Red Hat Customer Portal. See the Red Hat build of MicroShift Life Cycle for more information about asynchronous errata.
Red Hat Customer Portal users can enable errata notifications in the account settings for Red Hat Subscription Management (RHSM). When errata notifications are enabled, users are notified through email whenever new errata relevant to their registered systems are released.
Red Hat Customer Portal user accounts must have systems registered and consuming Red Hat build of MicroShift entitlements for Red Hat build of MicroShift errata notification emails to generate.
This section will continue to be updated over time to provide notes on enhancements and bug fixes for future asynchronous errata releases of Red Hat build of MicroShift 4.12. Versioned asynchronous releases, for example with the form Red Hat build of MicroShift 4.12.z, will be detailed in subsections. In addition, releases in which the errata text cannot fit in the space provided by the advisory will be detailed in subsections that follow.
1.3.1. RHBA-2023:0452 - Red Hat build of MicroShift 4.12.1 bug fix update
Issued: 2023-01-30
Red Hat build of MicroShift release 4.12.1 is now available. The list of bug fixes that are included in the update is documented in the RHBA-2023:0452 advisory. The images that are included in the update are provided by the RHSA-2023:0449 advisory.
For the TopoLVM
image, see lvms4/topolvm-rhel8.
1.3.2. RHBA-2023:0572 - Red Hat build of MicroShift 4.12.2 bug fix update
Issued: 2023-02-07
Red Hat build of MicroShift release 4.12.2 is now available. The list of bug fixes that are included in the update is documented in the RHBA-2023:0572 advisory. The images that are included in the update are provided by the RHSA-2023:0569 advisory.
For the TopoLVM
image, see lvms4/topolvm-rhel8.
1.3.3. RHBA-2023:0731 - Red Hat build of MicroShift 4.12.3 bug fix update
Issued: 2023-02-16
Red Hat build of MicroShift release 4.12.3 is now available. The list of bug fixes that are included in the update is documented in the RHBA-2023:0731 advisory. The images that are included in the update are provided by the RHSA-2023:0728 advisory.
For the TopoLVM
image, see lvms4/topolvm-rhel8.
1.3.4. RHSA-2023:0769 - Red Hat build of MicroShift 4.12.4 bug fix and security update
Issued: 2023-02-20
Red Hat build of MicroShift release 4.12.4, which includes security updates, is now available. The list of bug fixes that are included in the update is documented in the RHSA-2023:0769 advisory. The images that are included in the update are provided by the RHBA-2023:0768 advisory.
For the TopoLVM
image, see lvms4/topolvm-rhel8.
1.3.5. RHBA-2023:0893 - Red Hat build of MicroShift 4.12.5 bug fix update
Issued: 2023-02-28
Red Hat build of MicroShift release 4.12.5 is now available. The list of bug fixes that are included in the update is documented in the RHBA-2023:0893 advisory. The images that are included in the update are provided by the RHSA-2023:0890 advisory.
For the TopoLVM
image, see lvms4/topolvm-rhel8.
1.3.6. RHBA-2023:1037 - Red Hat build of MicroShift 4.12.6 bug fix update
Issued: 2023-03-07
Red Hat build of MicroShift release 4.12.6 is now available. The list of bug fixes that are included in the update is documented in the RHBA-2023:1037 advisory. The images that are included in the update are provided by the RHBA-2023:1034 advisory.
For the TopoLVM
image, see lvms4/topolvm-rhel8.
1.3.7. RHBA-2023:1166 - Red Hat build of MicroShift 4.12.7 bug fix update
Issued: 2023-03-13
Red Hat build of MicroShift release 4.12.7 is now available. The list of bug fixes that are included in the update is documented in the RHBA-2023:1166 advisory. The images that are included in the update are provided by the RHBA-2023:1163 advisory.
For the TopoLVM
image, see lvms4/topolvm-rhel8.
1.3.8. RHBA-2023:1272 - Red Hat build of MicroShift 4.12.8 bug fix update
Issued: 2023-03-21
Red Hat build of MicroShift release 4.12.8 is now available. The list of bug fixes that are included in the update is documented in the RHBA-2023:1272 advisory. The images that are included in the update are provided by the RHBA-2023:1269 advisory.
For the TopoLVM
image, see lvms4/topolvm-rhel8.
1.3.9. RHBA-2023:1412 - Red Hat build of MicroShift 4.12.9 bug fix and security update
Issued: 2023-03-27
Red Hat build of MicroShift release 4.12.9, which includes security updates, is now available. The list of bug fixes that are included in the update is documented in the RHBA-2023:1412 advisory. The images that are included in the update are provided by the RHSA-2023:1409 advisory.
1.3.9.1. Bug Fixes
- Previously, installing and starting Red Hat build of MicroShift using an 4.12.7 RPM failed with an error. With this update, Red Hat build of MicroShift starts successfully. (OCPBUGS-10347)
For the TopoLVM
image, see lvms4/topolvm-rhel8.
1.3.10. RHBA-2023:1511 - Red Hat build of MicroShift 4.12.10 bug fix update
Issued: 2023-04-03
Red Hat build of MicroShift release 4.12.10 is now available. The list of bug fixes that are included in the update is documented in the RHBA-2023:1511 advisory. The images that are included in the update are provided by the RHBA-2023:1508 advisory.
For the TopoLVM
image, see lvms4/topolvm-rhel8.
1.3.11. RHBA-2023:1648 - Red Hat build of MicroShift 4.12.11 bug fix update
Issued: 2023-04-10
Red Hat build of MicroShift release 4.12.11 is now available. The list of bug fixes that are included in the update is documented in the RHBA-2023:1648 advisory. The images that are included in the update are provided by the RHBA-2023:1645 advisory.
For the TopoLVM
image, see lvms4/topolvm-rhel8.
1.3.12. RHBA-2023:1753 - Red Hat build of MicroShift 4.12.13 bug fix update
Issued: 2023-04-18
Red Hat build of MicroShift release 4.12.13 is now available. The list of bug fixes that are included in the update is documented in the RHBA-2023:1753 advisory. The images that are included in the update are provided by the RHBA-2023:1750 advisory.
For the TopoLVM
image, see lvms4/topolvm-rhel8.
1.3.13. RHBA-2023:1861 - Red Hat build of MicroShift 4.12.14 bug fix update
Issued: 2023-04-24
Red Hat build of MicroShift release 4.12.14 is now available. The list of bug fixes that are included in the update is documented in the RHBA-2023:1861 advisory. The images that are included in the update are provided by the RHBA-2023:1858 advisory.
For the TopoLVM
image, see lvms4/topolvm-rhel8.
1.3.14. RHBA-2023:2040 - Red Hat build of MicroShift 4.12.15 bug fix update
Issued: 2023-05-03
Red Hat build of MicroShift release 4.12.15 is now available. The list of bug fixes that are included in the update is documented in the RHBA-2023:2040 advisory. The images that are included in the update are provided by the RHBA-2023:2037 advisory.
For the TopoLVM
image, see lvms4/topolvm-rhel8.
1.3.15. RHBA-2023:2113 - Red Hat build of MicroShift 4.12.16 bug fix and security update
Issued: 2023-05-10
Red Hat build of MicroShift release 4.12.16, which includes security updates, is now available. The list of bug fixes that are included in the update is documented in the RHBA-2023:2113 advisory. The images that are included in the update are provided by the RHSA-2023:2110 advisory.
For the TopoLVM
image, see lvms4/topolvm-rhel8.
1.3.16. RHBA-2023:3211 - Red Hat build of MicroShift 4.12.18 bug fix update
Issued: 2023-05-23
Red Hat build of MicroShift release 4.12.18 is now available. The list of bug fixes that are included in the update is documented in the RHBA-2023:3211 advisory. The images that are included in the update are provided by the RHBA-2023:3208 advisory.
For the TopoLVM
image, see lvms4/topolvm-rhel8.
1.3.17. RHBA-2023:3290 - Red Hat build of MicroShift 4.12.19 bug fix and security update
Issued: 2023-05-31
Red Hat build of MicroShift release 4.12.19, which includes security updates, is now available. The list of bug fixes that are included in the update is documented in the RHBA-2023:3290 advisory. The images that are included in the update are provided by the RHSA-2023:3287 advisory.
For the TopoLVM
image, see lvms4/topolvm-rhel8.
1.3.18. RHBA-2023:3549 - Red Hat build of MicroShift 4.12.21 bug fix update
Issued: 2023-06-14
Red Hat build of MicroShift release 4.12.21 is now available. The list of bug fixes that are included in the update is documented in the RHBA-2023:3549 advisory. The images that are included in the update are provided by the RHBA-2023:3546 advisory.
For the TopoLVM
image, see lvms4/topolvm-rhel8.
1.3.19. RHBA-2023:3621 - Red Hat build of MicroShift 4.12.22 bug fix and security update
Issued: 2023-06-26
Red Hat build of MicroShift release 4.12.22, which includes security updates, is now available. The list of bug fixes that are included in the update is documented in the RHBA-2023:3621 advisory. The images that are included in the update are provided by the RHSA-2023:3615 advisory.
For the TopoLVM
image, see lvms4/topolvm-rhel8.
1.3.20. RHBA-2023:3928 - Red Hat build of MicroShift 4.12.23 bug fix and security update
Issued: 2023-07-06
Red Hat build of MicroShift release 4.12.23, which includes security updates, is now available. The list of bug fixes that are included in the update is documented in the RHBA-2023:3928 advisory. The images that are included in the update are provided by the RHSA-2023:3925 advisory.
For the TopoLVM
image, see lvms4/topolvm-rhel8.
1.3.21. RHBA-2023:3677 - Red Hat build of MicroShift 4.12.24 bug fix and security update
Issued: 2023-07-12
Red Hat build of MicroShift release 4.12.24, which includes security updates, is now available. The list of bug fixes that are included in the update is documented in the RHBA-2023:3980 advisory. The images that are included in the update are provided by the RHSA-2023:3977 advisory.
For the TopoLVM
image, see lvms4/topolvm-rhel8.
1.3.22. RHBA-2023:4047 - Red Hat build of MicroShift 4.12.25 bug fix update
Issued: 2023-07-19
Red Hat build of MicroShift release 4.12.25 is now available. The list of bug fixes that are included in the update is documented in the RHBA-2023:4047 advisory. The images that are included in the update are provided by the RHBA-2023:4048 advisory.
For the TopoLVM
image, see lvms4/topolvm-rhel8.
1.3.23. RHBA-2023:4223 - Red Hat build of MicroShift 4.12.26 bug fix update
Issued: 2023-07-26
Red Hat build of MicroShift release 4.12.26 is now available. The list of bug fixes that are included in the update is documented in the RHBA-2023:4223 advisory. The images that are included in the update are provided by the RHBA-2023:4221 advisory.
For the TopoLVM
image, see lvms4/topolvm-rhel8.
1.3.24. RHBA-2023:4321 - Red Hat build of MicroShift 4.12.27 bug fix update
Issued: 2023-08-02
Red Hat build of MicroShift release 4.12.27 is now available. The list of bug fixes that are included in the update is documented in the RHBA-2023:4321 advisory. The images that are included in the update are provided by the RHBA-2023:4319 advisory.
For the TopoLVM
image, see lvms4/topolvm-rhel8.
1.3.25. RHBA-2023:4442 - Red Hat build of MicroShift 4.12.28 bug fix update
Issued: 2023-08-09
Red Hat build of MicroShift release 4.12.28 is now available. The list of bug fixes that are included in the update is documented in the RHBA-2023:4442 advisory. The images that are included in the update are provided by the RHBA-2023:4440 advisory.
For the TopoLVM
image, see lvms4/topolvm-rhel8.
1.3.26. RHBA-2023:4610 - Red Hat build of MicroShift 4.12.29 bug fix update
Issued: 2023-08-16
Red Hat build of MicroShift release 4.12.29 is now available. The list of bug fixes that are included in the update is documented in the RHBA-2023:4610 advisory. The images that are included in the update are provided by the RHBA-2023:4608 advisory.
For the TopoLVM
image, see lvms4/topolvm-rhel8.
1.3.27. RHBA-2023:4673 - Red Hat build of MicroShift 4.12.30 bug fix update
Issued: 2023-08-23
Red Hat build of MicroShift release 4.12.30 is now available. The list of bug fixes that are included in the update is documented in the RHBA-2023:4673 advisory. The images that are included in the update are provided by the RHBA-2023:4671 advisory.
For the TopoLVM
image, see lvms4/topolvm-rhel8.
1.3.28. RHBA-2023:4758 - Red Hat build of MicroShift 4.12.31 bug fix update
Issued: 2023-08-31
Red Hat build of MicroShift release 4.12.31 is now available. The list of bug fixes that are included in the update is documented in the RHBA-2023:4758 advisory. The images that are included in the update are provided by the RHBA-2023:4756 advisory.
For the TopoLVM
image, see lvms4/topolvm-rhel8.
1.3.29. RHBA-2023:4902 - Red Hat build of MicroShift 4.12.32 bug fix update
Issued: 2023-09-06
Red Hat build of MicroShift release 4.12.32 is now available. The list of bug fixes that are included in the update is documented in the RHBA-2023:4902 advisory. The images that are included in the update are provided by the RHBA-2023:4900 advisory.
For the TopoLVM
image, see lvms4/topolvm-rhel8.