1
0
mirror of https://github.com/openshift/openshift-docs.git synced 2026-02-05 12:46:18 +01:00

OSDOCS-13383: adds release note file to 4.19 MicroShift

This commit is contained in:
“Shauna Diaz”
2025-02-26 12:36:20 -05:00
parent 38241b5297
commit ca4a1a9fe9
3 changed files with 57 additions and 55 deletions

View File

@@ -33,8 +33,8 @@ Name: Red Hat build of MicroShift release notes
Dir: microshift_release_notes
Distros: microshift
Topics:
- Name: Red Hat build of MicroShift 4.18 release notes
File: microshift-4-18-release-notes
- Name: Red Hat build of MicroShift 4.19 release notes
File: microshift-4-19-release-notes
---
Name: Getting ready to install MicroShift
Dir: microshift_install_get_ready

View File

@@ -1,5 +1,5 @@
:_mod-docs-content-type: ASSEMBLY
[id="microshift-4-18-release-notes"]
[id="microshift-4-19-release-notes"]
= {product-title} {product-version} release notes
include::_attributes/attributes-microshift.adoc[]
:context: release-notes
@@ -10,17 +10,18 @@ toc::[]
{microshift-short} 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.
[id="microshift-4-18-about-this-release_{context}"]
[id="microshift-4-19-about-this-release_{context}"]
== About this release
Version {product-version} of {microshift-short} includes new features and enhancements. Update to the latest version of {microshift-short} to receive all of the latest features, bug fixes, and security updates. {microshift-short} is derived from {OCP} {ocp-version} and uses the CRI-O container runtime. New features, changes, and known issues that pertain to {microshift-short} are included in this topic.
You can deploy {microshift-short} clusters to on-premise, cloud, disconnected, and offline environments.
{microshift-short} {product-version} is supported on {op-system-base-full} 9.4.
//TODO confirm RHEL version compatibility
//{microshift-short} {product-version} is supported on {op-system-base-full} 9.6.
For lifecycle information, see the link:https://access.redhat.com/product-life-cycles?product=Red%20Hat%20build%20of%20Microshift,Red%20Hat%20Device%20Edge[{product-title} Life Cycle Policy].
[id="microshift-4-18-new-features-and-enhancements_{context}"]
[id="microshift-4-19-new-features-and-enhancements_{context}"]
== New features and enhancements
This release adds improvements related to the following components and concepts.
@@ -30,75 +31,74 @@ This release adds improvements related to the following components and concepts.
//=== {op-system-base-full}
//Image mode for RHEL here if GA; otherwise leave in TP
[id="microshift-4-18-updating_{context}"]
//4.19 is not an EUS release
[id="microshift-4-19-updating_{context}"]
=== Updating
Updating two minor EUS versions in a single step is supported in 4.18. Updates for both single-version minor releases and patch releases are also supported. See xref:../microshift_updating/microshift-update-options.adoc#microshift-update-options[Update options with {product-title} and {op-system-bundle}] for details.
Updates for both single-version minor releases and patch releases are supported. See xref:../microshift_updating/microshift-update-options.adoc#microshift-update-options[Update options with {product-title} and {op-system-bundle}] for details.
//TODO add new features and enhancements as needed, follow doc TOC titles as L3s, then add L4 headings for each feature
[id="microshift-4-18-configuring_{context}"]
//[id="microshift-4-19-example-ra-feature_{context}"]
//==== Example RA feature here
[id="microshift-4-19-configuring_{context}"]
=== Configuring
[id="microshift-4-18-drop-in-config_{context}"]
==== Drop-in configuration snippets now available
With this release, make configuring your {microshift-short} instances easier by using drop-in configuration snippets. See xref:../microshift_configuring/microshift-using-config-yaml.adoc#microshift-config-snippets_microshift-configuring[Using configuration snippets] for details.
//[id="microshift-4-19-ingress-controller-two-config_{context}"]
//==== Control ingress for your use case with additional parameters
//add phase 2 ingress control parameters announcement here
[id="microshift-4-18-ingress-controller-config_{context}"]
==== Control ingress for your use case with additional parameters
With this update, you have greater control over ingress to your {microshift-short} cluster by configuring more parameters. You can use these parameters to define secure connections and the number of connections per pod, plus more. See xref:../microshift_configuring/microshift-ingress-controller.adoc#microshift-ingress-controller_microshift-configuring[Using ingress control for a {microshift-short} cluster] for details.
[id="microshift-4-18-running-apps_{context}"]
[id="microshift-4-19-running-apps_{context}"]
=== Running applications
[id="microshift-4-18-deleting-resource-manifest_{context}"]
==== Deleting or updating Kustomize manifest resources now documented
With this release, you can delete or upgrade the Kustomize manifest resources. For more information, see xref:../microshift_running_apps/microshift-deleting-resource-manifests.adoc#microshift-deleting-resource-manifests[Deleting or updating Kustomize manifest resources].
//[id="microshift-4-19-example-ra-feature_{context}"]
//==== Example RA feature here
[id="microshift-4-18-greenboot-workload-scripts-by-os_{context}"]
==== Greenboot example outputs for image mode for RHEL available
With this release, you can see detailed explanations and example outputs to check whether greenboot workload scripts are running properly. For more information, see xref:../microshift_running_apps/microshift-greenboot-workload-scripts.adoc#microshift-greenboot-test-workload-health-check-script_microshift-greenboot-workload-scripts[Testing a workload health check script].
[id="microshift-4-19-support_{context}"]
=== Support
[id="microshift-4-18-backup_and_restore_{context}"]
=== Backup and restore
//[id="microshift-4-19-example-support-feature_{context}"]
//==== Example Support feature here
[id="microshift-4-18-autorecovery-from-manual-backup_{context}"]
==== Automated recovery from manual backups
With this release, you can automatically restore data from manual backups when {microshift-short} fails to start by using the `auto-recovery` feature. For more information, see xref:../microshift_backup_and_restore/microshift-auto-recover-manual-backup.adoc#microshift-auto-recover-manual-backup[Automated recovery from manual backups].
//[id="microshift-4-19-doc-enhancements_{context}"]
//=== Documentation enhancements
[id="microshift-4-18-doc-enhancements_{context}"]
=== Documentation enhancements
//[id="microshift-4-19-storage-docs-update_{context}"]
//==== Updated content in the storage section
[id="microshift-4-18-install-with-rhel-image-mode_{context}"]
==== Updated content in the {op-system-base} image mode section
With this release, the contents of the "Installing with {op-system-base} image mode" section, which were previously developer-focused, are now updated to be {microshift-short} administrator-focused. For more information, see xref:../microshift_install_bootc/microshift-install-rhel-image-mode.adoc#microshift-install-rhel-image-mode[Using image mode for RHEL with {microshift-short}].
[id="microshift-4-18-tech-preview_{context}"]
[id="microshift-4-19-tech-preview_{context}"]
== Technology Preview features
Some features in this release are currently in Technology Preview. These experimental features are not intended for production use. Note the following scope of support on the Red{nbsp}Hat Customer Portal for these features:
link:https://access.redhat.com/support/offerings/techpreview[Technology Preview Features Support Scope]
[id="microshift-4-18-rhel-image-mode_{context}"]
=== {op-system-base-full} image mode Technology Preview feature
* You can install {microshift-short} using a `bootc` container image. Image mode for {op-system-base} is a Technology Preview deployment method that uses a container-native approach to build, deploy and manage the operating system as a bootc container image.
//[id="microshift-4-19-rhoai_{context}"]
//=== Example Red Hat AI feature
//TODO Gateway API might TP with this 4.19; there is no current epic. Discuss with PM as the release approaches.
//TODO verify the status of image mode; might GA with this release
//[id="microshift-4-19-rhel-image-mode_{context}"]
//=== {op-system-base-full} image mode Technology Preview feature
//* You can install {microshift-short} using a `bootc` container image. Image mode for {op-system-base} is a Technology Preview deployment method that uses a container-native approach to build, deploy and manage the operating system as a bootc container image.
See xref:../microshift_install_bootc/microshift-install-rhel-image-mode.adoc#microshift-install-rhel-image-mode[Using image mode for RHEL with {microshift-short}] for more information.
[id="microshift-4-18-deprecated-and-removed-features_{context}"]
[id="microshift-4-19-deprecated-and-removed-features_{context}"]
== Deprecated and removed features
With this release, the CSI snapshot webhook feature available in previous releases is removed. The webhook is replaced by CEL validation rules for snapshot objects.
//NOTE: Do NOT repeat bug fixes already noted in previous version z-streams
[id="microshift-4-18-bug-fixes_{context}"]
[id="microshift-4-19-bug-fixes_{context}"]
== Bug fixes
[discrete]
[id="microshift-4-18-installation-bug-fixes"]
=== Installation
Previously, the greenboot health check marked some healthy Image mode for {op-system-base} systems as unhealthy due to a 300-second timeout, which was insufficient for systems with slow networks. Beginning in {product-title} 4.18, the default greenboot wait timeout has been extended to 600 seconds to provide more time to download images and ensure accurate system checks. (https://issues.redhat.com/browse/OCPBUGS-47463[OCPBUGS-47463])
//[discrete]
//[id="microshift-4-19-installation-bug-fixes"]
//=== Installation
[id="microshift-4-18-additional-release-notes_{context}"]
[id="microshift-4-19-additional-release-notes_{context}"]
== Additional release notes
Release notes for related components and products are available in the following documentation:
@@ -107,19 +107,21 @@ Release notes for related components and products are available in the following
The following release notes are for downstream Red{nbsp}Hat products only; upstream or community release notes for related products are not included.
====
[id="microshift-4-18-additional-release-notes-gitops_{context}"]
//TODO check the latest gitops release version
[id="microshift-4-19-additional-release-notes-gitops_{context}"]
=== GitOps release notes
See link:https://docs.redhat.com/en/documentation/red_hat_openshift_gitops/1.15/html/release_notes/index[Red{nbsp}Hat OpenShift GitOps 1.15: Highlights of what is new and what has changed with this OpenShift GitOps release] for more information. You can also go to the Red{nbsp}Hat package download page and search for "gitops" if you just need the latest package, link:https://access.redhat.com/downloads/content/package-browser[Red{nbsp}Hat packages].
[id="microshift-4-18-additional-release-notes-ocp_{context}"]
[id="microshift-4-19-additional-release-notes-ocp_{context}"]
=== {OCP} release notes
See the https://docs.openshift.com/container-platform/4.18/release_notes/ocp-4-18-release-notes.html[{OCP} Release Notes] for information about the Operator Lifecycle Manager and other components. Not all of the changes to {OCP} apply to {microshift-short}. See the specific {microshift-short} implementation of an Operator or function for more information.
See the https://docs.openshift.com/container-platform/4.19/release_notes/ocp-4-19-release-notes.html[{OCP} Release Notes] for information about the Operator Lifecycle Manager and other components. Not all of the changes to {OCP} apply to {microshift-short}. See the specific {microshift-short} implementation of an Operator or function for more information.
[id="microshift-4-18-additional-release-notes-rhel_{context}"]
[id="microshift-4-19-additional-release-notes-rhel_{context}"]
=== {op-system-base-full} release notes
See the link:https://docs.redhat.com/en/documentation/red_hat_enterprise_linux/9/html/9.4_release_notes/index[Release Notes for Red{nbsp}Hat Enterprise Linux 9.4] for more information about {op-system-base}.
See the link:https://docs.redhat.com/en/documentation/red_hat_enterprise_linux/9/html/9.6_release_notes/index[Release Notes for Red{nbsp}Hat Enterprise Linux 9.6] for more information about {op-system-base}.
//Use the latest compatible RHEL, expected to be 9.6
[id="microshift-4-18-asynchronous-errata-updates_{context}"]
[id="microshift-4-19-asynchronous-errata-updates_{context}"]
== Asynchronous errata updates
Security, bug fix, and enhancement updates for {microshift-short} {product-version} are released as asynchronous errata through the Red{nbsp}Hat Network. All {microshift-short} {product-version} errata are https://access.redhat.com/downloads/content/290/[available on the Red{nbsp}Hat Customer Portal]. For more information about asynchronous errata, read the https://access.redhat.com/product-life-cycles?product=Red%20Hat%20build%20of%20Microshift,Red%20Hat%20Device%20Edge[{microshift-short} Life Cycle].
@@ -133,11 +135,11 @@ Red{nbsp}Hat Customer Portal user accounts must have systems registered and cons
This section is updated over time to provide notes on enhancements and bug fixes for future asynchronous errata releases of {microshift-short} {product-version}. Versioned asynchronous releases, for example with the form {microshift-short} {product-version}.z, are detailed in the following subsections.
[id="microshift-4-18-1-dp_{context}"]
=== RHEA-2024:6124 - {microshift-short} 4.18.1 bug fix and security update advisory
[id="microshift-4-19-0-dp_{context}"]
=== RHEA-2025:1234 - {microshift-short} 4.19. bug fix and security update advisory
Issued: 25 February 2025
Issued: XX Month 2025
{product-title} release 4.18.1 is now available. Bug fixes and enhancements are listed in the link:https://access.redhat.com/errata/RHEA-2024:6124[RHEA-2024:6124] advisory. Release notes for bug fixes and enhancements are provided in this documentation. The images that are included in the update are provided by the {OCP} link:https://access.redhat.com/errata/RHSA-2024:6122[RHSA-2024:6122] advisory.
{product-title} release 4.19.0 is now available. Bug fixes and enhancements are listed in the link:https://access.redhat.com/errata/RHEA-2025:1234[RHEA-2025:1234] advisory. Release notes for bug fixes and enhancements are provided in this documentation. The images that are included in the update are provided by the {OCP} link:https://access.redhat.com/errata/RHSA-2025:1234[RHSA-2025:1234] advisory.
See the latest images included with {microshift-short} by xref:../microshift_updating/microshift-list-update-contents.adoc#microshift-get-rpm-release-info_microshift-list-update-contents[listing the contents of the {microshift-short} RPM release package].

View File

@@ -21,7 +21,7 @@ To browse the {microshift-short} {product-version} documentation, use one of the
To get started with {microshift-short}, use the following links:
//text is in main assembly for the sake of cross references
* xref:../microshift_release_notes/microshift-4-18-release-notes.adoc#microshift-4-18-release-notes[{product-title} release notes]
* xref:../microshift_release_notes/microshift-4-19-release-notes.adoc#microshift-4-19-release-notes[{product-title} release notes]
* xref:../microshift_install_rpm/microshift-install-rpm.adoc#microshift-install-rpm[Installing {product-title}]
For related information, use the following links: