From 8020dc6a98e9dae0cb25f5cac3bc3ea15e3c4249 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Fabrice=20Flore-Th=C3=A9bault?= Date: Mon, 10 Nov 2025 10:49:34 +0100 Subject: [PATCH 1/8] Release notes for 1.8 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Fabrice Flore-Thébault --- .../ref-release-notes-breaking-changes.adoc | 45 ++- ...ease-notes-deprecated-functionalities.adoc | 18 +- .../ref-release-notes-developer-preview.adoc | 23 +- .../ref-release-notes-fixed-issues.adoc | 132 +++----- .../ref-release-notes-known-issues.adoc | 48 ++- .../ref-release-notes-new-features.adoc | 314 ++++++++++++------ ...gle-source-release-notes.jira2asciidoc.yml | 38 +-- 7 files changed, 376 insertions(+), 242 deletions(-) diff --git a/modules/release-notes/ref-release-notes-breaking-changes.adoc b/modules/release-notes/ref-release-notes-breaking-changes.adoc index 5257c7af19..29e9a133d7 100644 --- a/modules/release-notes/ref-release-notes-breaking-changes.adoc +++ b/modules/release-notes/ref-release-notes-breaking-changes.adoc @@ -5,6 +5,49 @@ This section lists breaking changes in {product} {product-version}. +[id="removed-functionality-rhidp-5309"] +== Argo CD, Tekton, and Topology plugins require the Kubernetes Frontend and Kubernetes Backend plugins + +With this update, the Argo CD, Tekton, and Topology plugins requires the Kubernetes Frontend and Kubernetes Backend plugins. Before this update, these plugins depended only on the Kubernetes Backend plugin, and the feature provided by the Kubernetes Frontend plugin where provided by the removed `@janus-idp/shared-react` package. + +.Procedure +. Enable the Kubernetes Frontend and Kubernetes Backend plugins. ++ +[source,yaml] +---- +global: + dynamic: + plugins: + - package: ./dynamic-plugins/dist/backstage-plugin-kubernetes + disabled: false + - package: ./dynamic-plugins/dist/backstage-plugin-kubernetes-backend-dynamic + disabled: false +---- + +. The Kubernetes Frontend plugin shows automatically a *Kubernetes* tab for Software Catalog entities with the annotation `backstage.io/kubernetes-id` or `backstage.io/kubernetes-namespace`. ++ +Optionally, to hide the *Kubernetes* tab in the Software Catalog, disable the feature with this dynamic plugin configuration: ++ +[source,yaml] +---- +global: + dynamic: + plugins: + - package: ./dynamic-plugins/dist/backstage-plugin-kubernetes + disabled: false + pluginConfig: + dynamicPlugins: + frontend: + backstage.plugin-kubernetes: + mountPoints: [] + - package: ./dynamic-plugins/dist/backstage-plugin-kubernetes-backend-dynamic + disabled: false +---- + + + +.Additional resources +* link:https://issues.redhat.com/browse/RHIDP-5309[RHIDP-5309] + -None. diff --git a/modules/release-notes/ref-release-notes-deprecated-functionalities.adoc b/modules/release-notes/ref-release-notes-deprecated-functionalities.adoc index 49d14dd061..b6157177ef 100644 --- a/modules/release-notes/ref-release-notes-deprecated-functionalities.adoc +++ b/modules/release-notes/ref-release-notes-deprecated-functionalities.adoc @@ -5,23 +5,15 @@ This section lists deprecated functionalities in {product} {product-version}. -[id="deprecated-functionality-rhidp-6917"] -== Backstage CR versions `v1alpha1` and `v1alpha2` +[id="deprecated-functionality-rhidp-9180"] +== OCM Plugins are deprecated -Backstage CR versions `v1alpha1` and `v1alpha2` are deprecated in 1.7 and will be removed in 1.9 +The Open Cluster Management (OCM) plugins integrates your {product} instance with the MultiClusterHub and MultiCluster engines of OCM. +The OCM plugins are deprecated as of RHDH 1.8, and will be removed in a future release. .Additional resources -* link:https://issues.redhat.com/browse/RHIDP-6917[RHIDP-6917] +* link:https://issues.redhat.com/browse/RHIDP-9180[RHIDP-9180] -[id="deprecated-functionality-rhidp-8525"] -== Deprecation of Bundled Plugin Wrappers -To enhance performance, decrease image size, and reduce maintenance, the method of including "wrapped" dynamic plugins within the main {product} container image is being deprecated as of release 1.7.0. We are transitioning to a model where all dynamic plugins will be distributed as independent OCI artifacts. -For the 1.7.0 release, this is a deprecation notice only; there are no breaking changes, and all previously bundled plugins will continue to be bundled. However, we encourage customers to prepare for the removal of wrappers in a future release by beginning to use the new OCI artifacts in 1.8.0. Documentation will be updated to guide this migration. - -For more information, see {installing-and-viewing-plugins-book-link}#proc-load-plugin-oci-image_assembly-install-third-party-plugins-rhdh[Loading a plugin packaged as an OCI image]. - -.Additional resources -* link:https://issues.redhat.com/browse/RHIDP-8525[RHIDP-8525] diff --git a/modules/release-notes/ref-release-notes-developer-preview.adoc b/modules/release-notes/ref-release-notes-developer-preview.adoc index 3215d33e52..43c4692175 100644 --- a/modules/release-notes/ref-release-notes-developer-preview.adoc +++ b/modules/release-notes/ref-release-notes-developer-preview.adoc @@ -1,8 +1,6 @@ :_content-type: REFERENCE [id="developer-preview"] -:ls-brand-name: Red Hat Developer Lightspeed for {product} - = Developer Preview This section lists Developer Preview features in {product} {product-version}. @@ -14,7 +12,22 @@ Developer Preview features are not supported by Red Hat in any way and are not f For more information about the support scope of Red Hat Developer Preview features, see link:https://access.redhat.com/support/offerings/devpreview/[Developer Preview Support Scope]. ==== -== {ls-brand-name} +[id="developer-preview-rhidp-8709"] +== Configurable Key Performance Indicators (KPIs) by using the Scorecard plugin + +With this release, {product} integrates the Scorecard plugin, enabling users to visualize software quality and health metrics directly in {product-short}. + +Developers can visualize scorecards with the metrics available to the their role in a tab on component detail pages, allowing them to quickly check the quality of their code and ensure it meets team standards. + +Platform engineers can configure Key Performance Indicators (KPIs) from various data sources, with initial support for GitHub open pull requests and Jira open issues. Custom metric providers will allow for the addition of more data sources. + +This simplifies the monitoring of applications by offering a single, clear report on health, security, and compliance. + +// RN already in https://issues.redhat.com/browse/RHIDP-8709 + + +.Additional resources +* link:https://issues.redhat.com/browse/RHIDP-8709[RHIDP-8709] + + -{ls-brand-name} is available as a Developer Preview feature in {product}, as a virtual assistant powered by generative Artificial Intelligence (AI) designed for {product-very-short}. The assistant offers in-depth insights into {product-very-short}, including its wide range of capabilities. You can interact with this assistant to explore and learn more about {product-very-short} in greater detail. -For more information, see {product-docs-link}/html-single/interacting_with_red_hat_developer_lightspeed_for_red_hat_developer_hub/index[{ls-brand-name}]. diff --git a/modules/release-notes/ref-release-notes-fixed-issues.adoc b/modules/release-notes/ref-release-notes-fixed-issues.adoc index 545552d51a..fdc18bce83 100644 --- a/modules/release-notes/ref-release-notes-fixed-issues.adoc +++ b/modules/release-notes/ref-release-notes-fixed-issues.adoc @@ -1,153 +1,97 @@ :_content-type: REFERENCE + [id="fixed-issues"] = Fixed issues This section lists issues fixed in {product} {product-version}. -== Fixed issues in 1.7.0 +== Fixed issues in 1.8.0 -[id="bug-fix-rhidp-6536"] -=== Improved keyboard accessibility +[id="bug-fix-rhdhbugs-1000"] +=== Improved startup speed with updated init container image pull policy for {product-short} Helm Chart -In this release, various fixes and improvements have been made to improve the keyboard accessibility in {product}. +With this update, the pull policy for the init container image of the {product-short} Helm Chart was changed from `Always` to `IfNotPresent`. This change reduces the repeated download time during startup of the container image, which is approximately 2.5 GB, thereby significantly improving startup speed for users. .Additional resources -* link:https://issues.redhat.com/browse/RHIDP-6536[RHIDP-6536] +* link:https://issues.redhat.com/browse/RHDHBUGS-1000[RHDHBUGS-1000] -[id="bug-fix-rhdhbugs-249"] -=== Fixed `techdocs-module-addons-contrib` plugin not displayed as preinstalled plugin +[id="bug-fix-rhdhbugs-1028"] +=== Improved Authentication for Self-Hosted Enterprise SCM Providers -Previously, the `techdocs-module-addons-contrib` plugin was not displayed as preinstalled in Extensions. With this update, the plugin is displayed as preinstalled. - - -.Additional resources -* link:https://issues.redhat.com/browse/RHDHBUGS-249[RHDHBUGS-249] - - -[id="bug-fix-rhdhbugs-322"] -=== Excessive queries to the `relations` database table from the `rbac-backend` plugin +Previously, actions requiring access to a self-hosted enterprise SCM provider failed, returning an error that no authentication provider was available for the specified host. -Before this update, excessive queries from the `rbac-backend` plugin to the `relations` database table caused performance issues. As a consequence, users experienced slow performance. With this release, the RBAC backend plugin has been optimized to improve performance by preventing excessive queries to the 'relations' database table. +With this update, the SCM integration correctly identifies and uses the configured authentication provider for the corresponding enterprise host. .Additional resources -* link:https://issues.redhat.com/browse/RHDHBUGS-322[RHDHBUGS-322] +* link:https://issues.redhat.com/browse/RHDHBUGS-1028[RHDHBUGS-1028] -[id="bug-fix-rhdhbugs-503"] -=== The Operator reverts the number of replicas set automatically by a Horizontal Pod Autoscaler (HPA) - -Previously the {product-very-short} Operator enforced `replicas: 1` from its default deployment config, which overrode scaling decisions. +[id="bug-fix-rhdhbugs-2003"] +=== Customizable image names for job and data index services in {product-short} Helm Chart -With this update, `replicas: 1` is removed from the default deployment profile and the DB-statefulset manifest. - -This update allows HPA to control scaling as expected, so that {product-very-short} instances can now scale dynamically with HPA without being reset by the operator. +Previously, when deploying the {product-short} Helm Chart with the Orchestrator enabled, it was not possible to customize the image names of the job and data index services, for example in disconnected environments. Setting the `orchestrator.sonataflowPlatform.jobServiceImage` and `orchestrator.sonataflowPlatform.dataIndexImage` would return a schema validation error from Helm. This update fixes this issue. .Additional resources -* link:https://issues.redhat.com/browse/RHDHBUGS-503[RHDHBUGS-503] +* link:https://issues.redhat.com/browse/RHDHBUGS-2003[RHDHBUGS-2003] -[id="bug-fix-rhdhbugs-512"] -=== Improved error messaging for bulk imports +[id="bug-fix-rhdhbugs-2020"] +=== Network policy installation fix for {product-short} RHDH Helm Chart with Orchestrator flavor -Before this update, when users selected 100 or more repositories simultaneously, the create pull request action could fail with a generic error message. In this release, we provide a more informative error message when creating pull requests for multiple repositories. This bug fix helps users to understand the issue by providing more information about what caused the error. +Before this update, the {product-short} RHDH Helm Chart would not install Network Policies when the Orchestrator flavor was deployed with `serverlessLogicOperator` disabled, preventing the {product-short} Pods from being completely available. This update fixes this situation by installing network policies unconditionally when the orchestrator is enabled. .Additional resources -* link:https://issues.redhat.com/browse/RHDHBUGS-512[RHDHBUGS-512] +* link:https://issues.redhat.com/browse/RHDHBUGS-2020[RHDHBUGS-2020] -[id="bug-fix-rhdhbugs-622"] -=== Excessive authorize requests generated by the RBAC backend API +[id="bug-fix-rhdhbugs-2036"] +=== Resolved SonataFlow Pod Crash Issue -Before this update, excessive authorize requests in the REST API for creating/editing roles, permissions, and conditions in rbac-backend led to performance issues. With this release, the excessive authorization requests in the REST API have been fixed by reducing permissions to only 'user' credentials. +In the new release, a timing problem during the RHDH 1.7 installation with Orchestrator plugins, affecting SonataFlow database provisioning, has been addressed. This issue caused SonataFlow pods to repeatedly enter the `CrashLoopBackOff` state, leading to delays and potential confusion for users. With this update, SonataFlow pods no longer encounter the `CrashLoopBackOff` state due to the database provisioning delay. This improvement enhances the user experience, as SonataFlow pods now start promptly, eliminating unnecessary wait times. .Additional resources -* link:https://issues.redhat.com/browse/RHDHBUGS-622[RHDHBUGS-622] +* link:https://issues.redhat.com/browse/RHDHBUGS-2036[RHDHBUGS-2036] +== Fixed issues in 1.7.2 -[id="bug-fix-rhdhbugs-632"] -=== Custom title not persisting on refresh of visited cards - -Previously, the custom title set via `app.title` in the _Top Visited_ and _Recently Visited_ cards did not persist after a page refresh, instead it defaulted back to _{product}_. +[id="bug-fix-rhdhbugs-2117"] +=== Fixed SCM integration failures for self-hosted enterprise SCM providers -With this update, after each refresh, the cards correctly display the custom title defined in the `app.title` configuration. - - -.Additional resources -* link:https://issues.redhat.com/browse/RHDHBUGS-632[RHDHBUGS-632] - - -[id="bug-fix-rhdhbugs-834"] -=== Fixed role name updates via API to correctly propagate to permissions, metadata, and conditions +Before this update, the SCM integration failed due to lack of identification of the configured authentication provider for self-hosted enterprise SCM hosts. As a consequence, users experienced failed actions with self-hosted enterprise SCM providers due to missing authentication. -Previously, when a role name was updated using the RBAC API, existing permissions, conditions, and metadata were not updated and remained mapped to the old role name. -With this update, role name changes are now correctly updated. +With this release, the SCM integration now correctly uses the configured authentication provider for corresponding enterprise host. As a result, end users can now successfully perform actions requiring enterprise SCM access. .Additional resources -* link:https://issues.redhat.com/browse/RHDHBUGS-834[RHDHBUGS-834] +* link:https://issues.redhat.com/browse/RHDHBUGS-2117[RHDHBUGS-2117] +== Fixed issues in 1.7.1 -[id="bug-fix-rhdhbugs-903"] -=== Fixed role actions tooltip delay issue +[id="bug-fix-rhdhbugs-1878"] +=== Fixed incorrect version detection for local plugin updates -Previously, tooltips on action icons in the Role list table of the Role-Based Access Control (RBAC) page were slow to appear on hover. - -This issue has been fixed, ensuring that tooltips now appear immediately when hovering over action icons in the RBAC page. +Before this update, local plugins within the image were incorrectly detected for updates due to version misidentification. This led to users being unable to update local plugins from wrappers, resulting in outdated functionality. With this release, local plugin updates are now automatically detected, eliminating the need for manual adjustments and ensuring seamless plugin version updates for end users. .Additional resources -* link:https://issues.redhat.com/browse/RHDHBUGS-903[RHDHBUGS-903] +* link:https://issues.redhat.com/browse/RHDHBUGS-1878[RHDHBUGS-1878] -[id="bug-fix-rhdhbugs-1110"] -=== The Extensions catalog does not show an error when the backend plugin is not installed - -Previously, if the backend Extensions was not installed, {product-very-short} showed the skeleton "forever" instead of an error message. +[id="bug-fix-rhdhbugs-2041"] +=== Orchestrator plugin updated to 1.7.1 -With this update, the UI shows an empty state with a message to enable the backend plugin. +Before this update, the latest Orchestrator feature set was unavailable because the release included the outdated Orchestrator plugin version `1.6`. This issue is resolved in {product-very-short} `1.7.1`. The Orchestrator plugin is now updated to version `1.7.1`, ensuring that users have access to the latest features and functionality. -.Additional resources -* link:https://issues.redhat.com/browse/RHDHBUGS-1110[RHDHBUGS-1110] - - -[id="bug-fix-rhdhbugs-1139"] -=== Fixed Profile dropdown showing Guest instead of user's name with OIDC authentication - -Previously, the *Profile dropdown* in the Global Header showed `Guest` instead of the logged-in user’s display name when logging in using the OIDC authentication. - -With this update, the *Profile dropdown* now correctly displays the user's name by first checking `spec.profile.displayName`, then `metadata.title`, and finally falls back to the name shown on the *Profile card* in the *Settings* page if neither is available. - - - -.Additional resources -* link:https://issues.redhat.com/browse/RHDHBUGS-1139[RHDHBUGS-1139] - - -[id="bug-fix-rhdhbugs-1162"] -=== Excessive filter arguments generated by the RBAC backend `enforcerDelegate.getFilteredPolicy` - -Before this update, {product-very-short} performance was affected by the duplication of filter arguments in `enforcerDelegate.getFilteredPolicy`. With this release, the duplication of filter arguments in `enforcerDelegate.ts` is avoided. - - -.Additional resources -* link:https://issues.redhat.com/browse/RHDHBUGS-1162[RHDHBUGS-1162] - - -[id="bug-fix-rhdhbugs-1213"] -=== Fixed Jenkins permissions not being displayed in RBAC UI - -Previously, Jenkins permissions were not exposed by Jenkins at `/api/jenkins/.well-known/backstage/permissions/metadata` with the change to `JenkinsBuilder`. As a result, RBAC UI did not display the permissions. In this release, users can configure Jenkins permissions by using the RBAC UI. - .Additional resources -* link:https://issues.redhat.com/browse/RHDHBUGS-1213[RHDHBUGS-1213] +* link:https://issues.redhat.com/browse/RHDHBUGS-2041[RHDHBUGS-2041] diff --git a/modules/release-notes/ref-release-notes-known-issues.adoc b/modules/release-notes/ref-release-notes-known-issues.adoc index 62fd170b13..ea624f28a8 100644 --- a/modules/release-notes/ref-release-notes-known-issues.adoc +++ b/modules/release-notes/ref-release-notes-known-issues.adoc @@ -5,21 +5,61 @@ This section lists known issues in {product} {product-version}. -[id="known-issue-rhdhbugs-1979"] -== Latest Orchestrator feature set is unavailable +[id="known-issue-rhdhbugs-986"] +== MUI v5 components might render with broken styles in non-bundled plugins -This release includes the Orchestrator plugin version from `1.6`. As a result, the latest feature set is not yet available. The Orchestrator plugin will be updated to the latest feature set in a future release. +Plugins that are not bundled with {product}, meaning not part of the {product} wrappers, might experience styling issues or broken visuals when using Material UI v5 components. +. Workaround +* Add the following code to the plugin’s entry file, such as `workspaces/<pluginId>/plugins/<pluginId>/src/index.ts`: ++ +[source,javascript] +---- +import { unstable_ClassNameGenerator as ClassNameGenerator } from '@mui/material/className'; +ClassNameGenerator.configure(componentName => { + return componentName.startsWith('v5-') + ? componentName + : `v5-${componentName}`; +}); +---- +// Source: https://docs.google.com/document/d/1cF-pRNY7duwD5JP8ACQVP24oJJw8ffphCzIgmyICcAM/edit?usp=sharing +.Additional resources +* link:https://issues.redhat.com/browse/RHDHBUGS-986[RHDHBUGS-986] + +[id="known-issue-rhdhbugs-664"] +== Out-Of-Memory errors in the {product} Operator + +To resolve Out-Of-Memory errors in the {product} Operator, adjust memory settings manually: + +. Edit the deployment: ++ +---- +kubectl edit deployment rhdh-operator -n <namespace> +---- +. In the editor, set the memory request to 1 GiB and the limit to 2 GiB: ++ +[source,yaml] +---- +spec: + containers: + - name: rhdh-operator + resources: + requests: + memory: "1G" + limits: + memory: "2G" +---- +. Reapply this change whenever the Operator is actively reconciled. The pod should become healthy, using about 1.07 GiB of memory. .Additional resources -* link:https://issues.redhat.com/browse/RHDHBUGS-1979[RHDHBUGS-1979] +* link:https://issues.redhat.com/browse/RHDHBUGS-664[RHDHBUGS-664] diff --git a/modules/release-notes/ref-release-notes-new-features.adoc b/modules/release-notes/ref-release-notes-new-features.adoc index 0070e778a9..d82f21e3b7 100644 --- a/modules/release-notes/ref-release-notes-new-features.adoc +++ b/modules/release-notes/ref-release-notes-new-features.adoc @@ -1,106 +1,208 @@ -:_content-type: REFERENCE - -[id="new-features"] -= New features - -This section highlights new features in {product} {product-version}. - -[id="enhancement-rhdhbugs-1885"] -== Improved plugin configuration merging for include files - -Previously, include plugin configuration files would overwrite existing files. With this update, {product} will merge configurations from existing include files, only overwriting specific keys while preserving keys defined in existing include files, mirroring the behavior for the `plugins` key. - - -[id="feature-rhidp-6628"] -== Dynamic plugin dependency management -{product} 1.7 adds dynamic plugin dependency management, so that the Operator can manage Kubernetes resources required by plugins. - -For more information, see link:https://github.com/redhat-developer/rhdh-operator/blob/main/docs/dynamic-plugins.md#dynamic-plugins-dependency-management[Dynamic plugin dependency management] - -[id="feature-rhidp-6633"] -== Added Orchestrator plugins with dependencies to {product-very-short} profile. - -With this update, Orchestrator plugins with dependencies are added to the {product-very-short} profile. The Orchestrator plugin is disabled by default. When you enable the Orchestrator plugin, it will deploy dependencies and work out of the box on {product-very-short}. - -[id="enhancement-rhidp-6657"] -== Updated {product-very-short} theme - -With this update, the `@redhat-developer/red-hat-developer-hub-theme` package is replaced with the plugin version from the `rhdh-plugins` repository to improve theme integration and visual consistency. Minor UI enhancements include updated border radius on cards. - -[id="enhancement-rhidp-6723"] -== Improved Role-based access control (RBAC) usability and consistency -This release includes several enhancements to improve the usability and consistency of the RBAC experience: - -* Aligned the table height behavior in the "Users and Groups" step with the "Permissions" step. -* Standardized icon colors for edit and delete actions in tables. -* Simplified Overview page titles for users, groups, and permissions. -* Improved layout and labeling in the Conditional Access sidebar. -* Preserved typed input in search fields when selecting users, groups, or plugins. - -These changes aim to create a more intuitive and seamless role management workflow. - -[id="feature-rhidp-6758"] -== Introducing plugin management by using Extensions - -In this release, {product-short} administrators can configure dynamic plugins directly within the Extensions UI. Administrators can now enable, disable, install, or edit the configuration of dynamic plugins on the Extensions Details Page. - -This is an opt-in feature that must be enabled by configuration, and it is intended for testing and development environments only; it is not recommended for production use. - -This release requires a single replica deployment and uses a persistent volume claim (PVC) for the dynamic plugin configuration file. The {product-short} backend does not automatically restart when you save configuration changes. You must restart the {product-short} application for any dynamic plugin configuration updates to take effect. - -[id="feature-rhidp-6963"] -== Dynamic plugins now fully supported and a new command-line tool released. - -Backend dynamic plugins have reached General Availability (GA). A new command-line tool, `@red-hat-developer-hub/cli` (rhdh-cli), has been released for building and packaging these plugins. As a result, the `@janus-idp/cli` is now officially deprecated. All users should migrate their build processes to `@red-hat-developer-hub/cli` to maintain support and receive future updates. - -[id="feature-rhidp-7018"] -== Quick start for platform engineers - -{product-very-short} 1.7 introduces the new Administrator Quick Start guide, a feature designed to streamline the initial setup and configuration process for platform engineers. This guided, interactive experience appears automatically on an administrator's first login, providing clear, step-by-step instructions for essential platform tasks. The goal is to significantly reduce onboarding time and help you configure your {product-very-short} instance with confidence. - -Quick start tracks your progress, offers context-aware help that follows you across configuration pages, and can be dismissed and reopened from the header at any time. This guide ensures a confident, efficient, and structured onboarding experience. Note that when permissions are enabled, this feature is currently available for administrators only, with support for other roles planned for future versions. - -[id="feature-rhidp-7106"] -== Improved global header UX - -With this release, you can display a user avatar in the profile dropdown in the global header. - -[id="feature-rhidp-7262"] -== Improved look and feel of {product-short} - -With this update, the look and feel of {product-short} has been updated to better match the visual style of PatternFly 6 and improve alignment with the {company} product portfolio. - -[id="feature-rhidp-7306"] -== Versioning for software templates - -{product-very-short} has been enhanced to provide crucial traceability, allowing users to easily identify the template version used to create a specific component. This enhancement helps determine if an older entity needs updating or if a bug is linked to a particular template version. - -Scaffolder templates can now be versioned using the backstage.io/template-version annotation and the `catalog:template:version` action. When used with the `catalog:template:version` action, the annotation of the template is applied to the generated catalog entity. - -[id="feature-rhidp-7561"] -== Support for high availability in {eks-brand-name} - -{product} now supports high availability setups in {eks-brand-name} ({eks-short}). This enhancement allows the deployment to scale beyond a single replica, ensuring the application remains operational and accessible even in the event of failures or disruptions. - -For more information, see {configuring-book-link}#HighAvailability[_Configuring high availability in {product}_]. - -[id="feature-rhidp-7610"] -== Adoption Insights in {product} - -In this release, the Adoption Insights plugin is fully supported and enabled by default. The Adoption Insights plugin provides key metrics and trends to help you understand {product-short} usage. - -If you have an existing Adoption Insights plugin custom configuration with GitHub Container registry images already set up, you can upgrade to the latest version to omit configurations using GitHub Container registry images. -For more information, see {adoption-insights-link}#proc-configure-adoption-insights_title-adoption-insights[Configuring the {adoption-insights-title}]. - -[id="feature-rhidp-7663"] -== {product-short} community plugins updated to Backstage 1.39 - -The {product-short} community plugins have been updated to Backstage version 1.39. - -[id="enhancement-rhidp-8103"] -== Improved robustness of dynamic plugin installation - -Previously, the {product} would fail to start if a specified include file in dynamic plugins configuration did not exist. This update addresses the issue by logging a warning and skipping the file if it is not found. - - - +:_content-type: REFERENCE + +[id="new-features"] += New features + +This section highlights new features in {product} {product-version}. + +[id="feature-rhidp-5778"] +== built-in monitoring for {product} operator + +This update introduces built-in monitoring for the {product} Operator. By enabling `spec.monitoring.enabled: true` in your Backstage custom resource, the {product} Operator will automatically manage service monitor resources for Prometheus metrics collection on the `/metrics` endpoint. This simplifies the monitoring process, eliminating the need for manual service monitor setup, and enhances the user experience on OpenShift and Kubernetes clusters with Prometheus Operator installed. + +[id="feature-rhidp-5779"] +==Automatic ServiceMonitor Creation for Built-in Monitoring + +The Red Hat Developer Hub Operator provides built-in monitoring capabilities by automatically creating and managing the necessary `ServiceMonitor` resource. +For more information, see {monitoring-and-logging-book-link}#proc-admin-enabling-metrics-ocp-operator_assembly-rhdh-observability[2.1. Enabling metrics monitoring in a Red Hat Developer Hub Operator installation on an OpenShift Container Platform cluster]. + +[id="feature-rhidp-7059"] +== Bulk import GitLab projects + +With this update, users can bulk import entities from GitLab into {product}, enhancing onboarding efficiency. + +[id="feature-rhidp-8249"] +== Enhanced package management in the *Extensions* page + +You can manage installed packages more easily under the reorganized *Extensions* navigation. The former *Installed Plugins* tab is renamed to *Installed Packages* and includes new row actions that allow you to edit, enable, and disable packages directly from the list. + +[id="feature-rhidp-8259"] +== Introducing localization support in core plugins, and French localization + +This update introduces localization support and French localization to these core plugins: + +- Adoption insights +- AI Integrations +- Bulk Import +- Extensions (Marketplace) +- Lightspeed +- Orchestrator +- QuickStart +- RBAC +- ScoreCard +- Topology +- Global header +- Homepage +- Tekton +- ArgoCD + +This enhancement allows {product} to display content in French, improving accessibility for users who speak French. AI/Cursor automation ensures a seamless translation process, enhancing the user experience by providing content in their preferred language, preparing {product} for use in multilingual environments and fostering a more inclusive developer community. + +[id="feature-rhidp-8260"] +== Localization support for strings defined in {product} configuration files + +With this update, localization support is introduced for strings defined in {product} configuration files such as `app-config.yaml` and `dynamic-plugins.default.yaml`. +This enables users to customize the interface in their preferred language, providing a consistent multilingual interface across these components: + +* Entity Tabs Configuration +* Global Header +* QuickStart +* Sidebar Menu Items +* Floating Action Button (FAB) labels and tooltips + +This localization support ensures a more inclusive and user-friendly experience for a diverse user base, improving user experience and supporting global users. + +[id="feature-rhidp-8261"] +== Plugins localization support + +With this update, {product} integrates the Backstage localization framework, enabling users to load translations provided by their plugins. The selected language will persist according to the user settings persistence configuration. Additionally, users can load translations from an external JSON file, allowing them to override existing translations or add translations for existing translation keys. + +[id="feature-rhidp-8274"] +== Enhanced Bulk Import with Scaffolder Templates + +With this update, users can enhance the Bulk Import plugin by importing repositories using scaffolder templates. This automates and optimizes the process by integrating with existing Backstage templates and Orchestrator workflows. Users can select their preferred pre-ingestion workflow and incorporate various scaffolder actions into their bulk import process, resulting in a more efficient and flexible Bulk Import experience. + +[id="feature-rhidp-8288"] +== Enabling Software Template version update notifications + +With this update, you can enable notification alerts whenever a Software Template is updated with a new version. For more information, see {customizing-book-link}#proc-enabling-software-template-version-update-notifications_configuring-templates[Enabling Software Template version update notifications in {product}]. + +[id="enhancement-rhidp-8290"] +== Built-in TechDocs for RHDH-Local + +With this update, RHDH Local includes comprehensive technical TechDocs covering everything you need to know about it. +Once running, access the built-in documentation directly in the application for detailed guides. + +[id="feature-rhidp-8295"] +== Software Template provenance and dependency tracking + +With this update, {product} supports Software Template provenance and a dedicated dependency view to improve component traceability and lifecycle management across your organization. + +For more information, see {customizing-book-link}#tracking-component-origin-and-software-template-version[Tracking component origin and Software Template version]. + +[id="feature-rhidp-8296"] +== Tech Radar and Quay plugins in RHDH Local + +With this update, RHDH Local integrates the Tech Radar and Quay plugins, for a better out of the box experience for users. The Tech Radar plugin provides a visually engaging element on the homepage or via navigation, and showcases the dynamic plugins loading mechanism for simple {product-short} extension. The Quay plugin demonstrates integration with external services and provides a practical example of extending the {product-short} software catalog. + +[id="feature-rhidp-8297"] +== RHDH Local default homepage enhancements + +With this update, RHDH Local default homepage integrates a floating action button with quick links for easy access to documentation and information. + +[id="feature-rhidp-8298"] +== Enhanced customozation and collaboration with pre-loaded templates in RHDH Local + +With this update, RHDH Local integrates pre-loaded essential templates, enabling users to create their own custom plugins and add TechDocs or software components to existing projects within {product}. This enhancement demonstrates {product-short} extensibility, empowers users to extend the platform, and enhances the overall user experience by promoting collaboration and customization. + +[id="feature-rhidp-8329"] +== Users can customize their homepage + +With this update, {product} users can customize their homepage, empowering personalization and productivity. Users can now move, resize, remove, and add existing cards, fostering a more flexible and adaptable user experience. The customization options are based on the existing settings, and users can reset their configuration to the default. The feature aims to improve the resize and reorder mechanism, and update existing cards to work better on different card sizes. + +[id="feature-rhidp-8342"] +== French language support + +With this update, {product} provides full French language support, enhancing accessibility and user experience for French-speaking users, particularly in Quebec. This implementation includes translating all visible text into French, ensuring accurate and consistent translations, and providing a user-friendly interface. This feature was implemented to comply with legal requirements in Quebec and unlock adoption in French-speaking markets, supporting the long-term internationalization plan. + +[id="feature-rhidp-8409"] +== {product-short} community plugins updated to Backstage 1.42 + +The {product-short} community plugins have been updated to Backstage version 1.42. + +[id="feature-rhidp-8445"] +== Quick Start experience for developers logging into {product} for the first time + +With this update, {product} includes a guided Quick Start experience tailored for the developer persona. This new feature appears automatically upon a developer's first login to help them get started quickly and accelerate adoption of the platform. + +The developer Quick Start provides guided next steps for key features, including: + +- Bulk import +- Software Catalog +- Self-service templates +- Learning paths + +This feature is integrated with RBAC, allowing platform engineers to configure the Quick Start content and conditionally display it to specific developer groups for personalized onboarding. + +[id="feature-rhidp-8460"] +== Transparent plugin support indicators + +With this update, the plugin support model is now transparently aligned with Red Hat's standard release classifications. +The *Verified* badge is removed, a clearer tiered support system is implemented, and plugin metadata are enhanced, providing a more informative and user-friendly experience in the *Extensions Catalog*. This change improves visibility into plugin maturity, enhances customer trust, and ensures internal consistency across the catalog. + +Release Status:: +Indicates the support status: +* Generally Available (GA) +* Technology Preview (TP) +* Developer Preview (DP). + +Supported By:: +Indicates the support provider: +* Red Hat +* Partner Name +* Customer Name +* Backstage Community + +Backstage Version Supported:: +Replaces the previous *Version* field. + +Author:: +Indicates the plugin author. + +Tags:: +Indicates the plugin tags. + +Category:: +Indicates the plugin category. + +Badges:: +GA (Green)::: For plugins that have the `Generally Available` *Release Status*, and a non empty *Supported By* value. +Certified (Purple)::: For Red Hat partner plugins (unchanged). +Custom (Yellow)::: For customer-developed plugins (unchanged). ++ +[NOTE] +---- +The *Verified* badge is removed. +---- + + + + +[id="enhancement-rhidp-8643"] +== Enhanced package management in the Extensions page + +With this update, {product} includes a reorganized Extensions navigation, enabling the user to manage installed packages more easily. The former *Installed Plugins* tab is renamed to *Installed Packages* and includes new row actions that allow you to edit, enable, and disable packages directly from the list. + +[id="feature-rhidp-8645"] +== Support for high availability in {gke-brand-name} + +{product} now supports high availability setups in {gke-brand-name} ({gke-short}). This enhancement allows the deployment to scale beyond a single replica, ensuring the application remains operational and accessible even in the event of failures or disruptions. + +For more information, see link:{configuring-book-url}#HighAvailability[_Configuring high availability in Red Hat Developer Hub_]. + +[id="feature-rhidp-8715"] +== Customizable container deployment in {product} pods + +Previously, injecting necessary files (`extraFiles`) and environment variables (`extraEnvs`) was restricted to the default `backstage-backend` container. + +With this update, you can configure resource injection for any container in the {product} pod, including sidecars and system containers. This allows you to complete the job of deploying custom components, such as security agents, log collectors, or configuration managers, that require specific volumes or runtime variables to operate successfully. + +See {configuring-book-link}#proc-injecting-custom-files-and-environment-variables-into-backstage-containers[Injecting extra files and environment variables into {backstage} containers]. + +[id="feature-rhidp-8816"] +== French localization + +This release is introducing localization, with one language supported: French. + + + diff --git a/modules/release-notes/single-source-release-notes.jira2asciidoc.yml b/modules/release-notes/single-source-release-notes.jira2asciidoc.yml index e92116f107..dfe2b32b7e 100644 --- a/modules/release-notes/single-source-release-notes.jira2asciidoc.yml +++ b/modules/release-notes/single-source-release-notes.jira2asciidoc.yml @@ -66,27 +66,27 @@ sections: AND fixVersion <= "{version_patch}" ORDER BY key template: with-jira-link - # - id: developer-preview - # title: Developer Preview - # description: | - # This section lists Developer Preview features in {product} {product-version}. + - id: developer-preview + title: Developer Preview + description: | + This section lists Developer Preview features in {product} {product-version}. - # [IMPORTANT] - # ==== - # Developer Preview features are not supported by Red Hat in any way and are not functionally complete or production-ready. Do not use Developer Preview features for production or business-critical workloads. Developer Preview features provide early access to functionality in advance of possible inclusion in a Red Hat product offering. Customers can use these features to test functionality and provide feedback during the development process. Developer Preview features might not have any documentation, are subject to change or removal at any time, and have received limited testing. Red Hat might provide ways to submit feedback on Developer Preview features without an associated SLA. + [IMPORTANT] + ==== + Developer Preview features are not supported by Red Hat in any way and are not functionally complete or production-ready. Do not use Developer Preview features for production or business-critical workloads. Developer Preview features provide early access to functionality in advance of possible inclusion in a Red Hat product offering. Customers can use these features to test functionality and provide feedback during the development process. Developer Preview features might not have any documentation, are subject to change or removal at any time, and have received limited testing. Red Hat might provide ways to submit feedback on Developer Preview features without an associated SLA. - # For more information about the support scope of Red Hat Developer Preview features, see link:https://access.redhat.com/support/offerings/devpreview/[Developer Preview Support Scope]. - # ==== - # query: > - # project in ("Red Hat Internal Developer Platform") - # AND "Release Note Status" = "Done" - # AND level is EMPTY - # AND status in (Closed, "Release Pending") - # AND "Release Note Type" in ("Developer Preview") - # AND fixVersion >= "{version_minor}" - # AND fixVersion <= "{version_patch}" - # ORDER BY key - # template: with-jira-link + For more information about the support scope of Red Hat Developer Preview features, see link:https://access.redhat.com/support/offerings/devpreview/[Developer Preview Support Scope]. + ==== + query: > + project in ("Red Hat Internal Developer Platform") + AND "Release Note Status" = "Done" + AND level is EMPTY + AND status in (Closed, "Release Pending") + AND "Release Note Type" in ("Developer Preview") + AND fixVersion >= "{version_minor}" + AND fixVersion <= "{version_patch}" + ORDER BY key + template: with-jira-link - id: fixed-issues title: Fixed issues description: | From c7be91af63b8ca4800d1d0992ae0ba822f1de42a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Fabrice=20Flore-Th=C3=A9bault?= Date: Mon, 10 Nov 2025 12:38:46 +0100 Subject: [PATCH 2/8] Update modules/release-notes/ref-release-notes-fixed-issues.adoc --- .../ref-release-notes-fixed-issues.adoc | 151 +++++++++--------- 1 file changed, 75 insertions(+), 76 deletions(-) diff --git a/modules/release-notes/ref-release-notes-fixed-issues.adoc b/modules/release-notes/ref-release-notes-fixed-issues.adoc index fdc18bce83..425bc15466 100644 --- a/modules/release-notes/ref-release-notes-fixed-issues.adoc +++ b/modules/release-notes/ref-release-notes-fixed-issues.adoc @@ -1,97 +1,96 @@ -:_content-type: REFERENCE - -[id="fixed-issues"] -= Fixed issues - -This section lists issues fixed in {product} {product-version}. - -== Fixed issues in 1.8.0 - -[id="bug-fix-rhdhbugs-1000"] +:_content-type: REFERENCE + +[id="fixed-issues"] += Fixed issues + +This section lists issues fixed in {product} {product-version}. + +== Fixed issues in 1.8.0 + +[id="bug-fix-rhdhbugs-1000"] === Improved startup speed with updated init container image pull policy for {product-short} Helm Chart -With this update, the pull policy for the init container image of the {product-short} Helm Chart was changed from `Always` to `IfNotPresent`. This change reduces the repeated download time during startup of the container image, which is approximately 2.5 GB, thereby significantly improving startup speed for users. - - -.Additional resources -* link:https://issues.redhat.com/browse/RHDHBUGS-1000[RHDHBUGS-1000] - - -[id="bug-fix-rhdhbugs-1028"] +With this update, the pull policy for the init container image of the {product-short} Helm Chart was changed from `Always` to `IfNotPresent`. This change reduces the repeated download time during startup of the container image, which is approximately 2.5 GB, thereby significantly improving startup speed for users. + + +.Additional resources +* link:https://issues.redhat.com/browse/RHDHBUGS-1000[RHDHBUGS-1000] + + +[id="bug-fix-rhdhbugs-1028"] === Improved Authentication for Self-Hosted Enterprise SCM Providers Previously, actions requiring access to a self-hosted enterprise SCM provider failed, returning an error that no authentication provider was available for the specified host. -With this update, the SCM integration correctly identifies and uses the configured authentication provider for the corresponding enterprise host. - - -.Additional resources -* link:https://issues.redhat.com/browse/RHDHBUGS-1028[RHDHBUGS-1028] - - -[id="bug-fix-rhdhbugs-2003"] +With this update, the SCM integration correctly identifies and uses the configured authentication provider for the corresponding enterprise host. + + +.Additional resources +* link:https://issues.redhat.com/browse/RHDHBUGS-1028[RHDHBUGS-1028] + + +[id="bug-fix-rhdhbugs-2003"] === Customizable image names for job and data index services in {product-short} Helm Chart -Previously, when deploying the {product-short} Helm Chart with the Orchestrator enabled, it was not possible to customize the image names of the job and data index services, for example in disconnected environments. Setting the `orchestrator.sonataflowPlatform.jobServiceImage` and `orchestrator.sonataflowPlatform.dataIndexImage` would return a schema validation error from Helm. This update fixes this issue. - - -.Additional resources -* link:https://issues.redhat.com/browse/RHDHBUGS-2003[RHDHBUGS-2003] - - -[id="bug-fix-rhdhbugs-2020"] +Previously, when deploying the {product-short} Helm Chart with the Orchestrator enabled, it was not possible to customize the image names of the job and data index services, for example in disconnected environments. Setting the `orchestrator.sonataflowPlatform.jobServiceImage` and `orchestrator.sonataflowPlatform.dataIndexImage` would return a schema validation error from Helm. This update fixes this issue. + + +.Additional resources +* link:https://issues.redhat.com/browse/RHDHBUGS-2003[RHDHBUGS-2003] + + +[id="bug-fix-rhdhbugs-2020"] === Network policy installation fix for {product-short} RHDH Helm Chart with Orchestrator flavor -Before this update, the {product-short} RHDH Helm Chart would not install Network Policies when the Orchestrator flavor was deployed with `serverlessLogicOperator` disabled, preventing the {product-short} Pods from being completely available. This update fixes this situation by installing network policies unconditionally when the orchestrator is enabled. - - -.Additional resources -* link:https://issues.redhat.com/browse/RHDHBUGS-2020[RHDHBUGS-2020] - - -[id="bug-fix-rhdhbugs-2036"] +Before this update, the {product-short} RHDH Helm Chart would not install Network Policies when the Orchestrator flavor was deployed with `serverlessLogicOperator` disabled, preventing the {product-short} Pods from being completely available. This update fixes this situation by installing network policies unconditionally when the orchestrator is enabled. + + +.Additional resources +* link:https://issues.redhat.com/browse/RHDHBUGS-2020[RHDHBUGS-2020] + + +[id="bug-fix-rhdhbugs-2036"] === Resolved SonataFlow Pod Crash Issue -In the new release, a timing problem during the RHDH 1.7 installation with Orchestrator plugins, affecting SonataFlow database provisioning, has been addressed. This issue caused SonataFlow pods to repeatedly enter the `CrashLoopBackOff` state, leading to delays and potential confusion for users. With this update, SonataFlow pods no longer encounter the `CrashLoopBackOff` state due to the database provisioning delay. This improvement enhances the user experience, as SonataFlow pods now start promptly, eliminating unnecessary wait times. - - -.Additional resources -* link:https://issues.redhat.com/browse/RHDHBUGS-2036[RHDHBUGS-2036] - -== Fixed issues in 1.7.2 - -[id="bug-fix-rhdhbugs-2117"] +In the new release, a timing problem during the RHDH 1.7 installation with Orchestrator plugins, affecting SonataFlow database provisioning, has been addressed. This issue caused SonataFlow pods to repeatedly enter the `CrashLoopBackOff` state, leading to delays and potential confusion for users. With this update, SonataFlow pods no longer encounter the `CrashLoopBackOff` state due to the database provisioning delay. This improvement enhances the user experience, as SonataFlow pods now start promptly, eliminating unnecessary wait times. + + +.Additional resources +* link:https://issues.redhat.com/browse/RHDHBUGS-2036[RHDHBUGS-2036] + + +[id="bug-fix-rhdhbugs-2117"] === Fixed SCM integration failures for self-hosted enterprise SCM providers Before this update, the SCM integration failed due to lack of identification of the configured authentication provider for self-hosted enterprise SCM hosts. As a consequence, users experienced failed actions with self-hosted enterprise SCM providers due to missing authentication. -With this release, the SCM integration now correctly uses the configured authentication provider for corresponding enterprise host. As a result, end users can now successfully perform actions requiring enterprise SCM access. - - -.Additional resources -* link:https://issues.redhat.com/browse/RHDHBUGS-2117[RHDHBUGS-2117] - -== Fixed issues in 1.7.1 - -[id="bug-fix-rhdhbugs-1878"] +With this release, the SCM integration now correctly uses the configured authentication provider for corresponding enterprise host. As a result, end users can now successfully perform actions requiring enterprise SCM access. + + +.Additional resources +* link:https://issues.redhat.com/browse/RHDHBUGS-2117[RHDHBUGS-2117] + +== Fixed issues in 1.7.1 + +[id="bug-fix-rhdhbugs-1878"] === Fixed incorrect version detection for local plugin updates -Before this update, local plugins within the image were incorrectly detected for updates due to version misidentification. This led to users being unable to update local plugins from wrappers, resulting in outdated functionality. With this release, local plugin updates are now automatically detected, eliminating the need for manual adjustments and ensuring seamless plugin version updates for end users. - - -.Additional resources -* link:https://issues.redhat.com/browse/RHDHBUGS-1878[RHDHBUGS-1878] - - -[id="bug-fix-rhdhbugs-2041"] +Before this update, local plugins within the image were incorrectly detected for updates due to version misidentification. This led to users being unable to update local plugins from wrappers, resulting in outdated functionality. With this release, local plugin updates are now automatically detected, eliminating the need for manual adjustments and ensuring seamless plugin version updates for end users. + + +.Additional resources +* link:https://issues.redhat.com/browse/RHDHBUGS-1878[RHDHBUGS-1878] + + +[id="bug-fix-rhdhbugs-2041"] === Orchestrator plugin updated to 1.7.1 Before this update, the latest Orchestrator feature set was unavailable because the release included the outdated Orchestrator plugin version `1.6`. This issue is resolved in {product-very-short} `1.7.1`. The Orchestrator plugin is now updated to version `1.7.1`, ensuring that users have access to the latest features and functionality. - - - -.Additional resources -* link:https://issues.redhat.com/browse/RHDHBUGS-2041[RHDHBUGS-2041] - - - + + + +.Additional resources +* link:https://issues.redhat.com/browse/RHDHBUGS-2041[RHDHBUGS-2041] + + + From e8361fc4661d0714746447b3cba014020d3cfe6f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Fabrice=20Flore-Th=C3=A9bault?= Date: Mon, 10 Nov 2025 12:39:19 +0100 Subject: [PATCH 3/8] Update modules/release-notes/ref-release-notes-fixed-issues.adoc --- modules/release-notes/ref-release-notes-fixed-issues.adoc | 1 - 1 file changed, 1 deletion(-) diff --git a/modules/release-notes/ref-release-notes-fixed-issues.adoc b/modules/release-notes/ref-release-notes-fixed-issues.adoc index 425bc15466..744667b85c 100644 --- a/modules/release-notes/ref-release-notes-fixed-issues.adoc +++ b/modules/release-notes/ref-release-notes-fixed-issues.adoc @@ -70,7 +70,6 @@ With this release, the SCM integration now correctly uses the configured authent .Additional resources * link:https://issues.redhat.com/browse/RHDHBUGS-2117[RHDHBUGS-2117] -== Fixed issues in 1.7.1 [id="bug-fix-rhdhbugs-1878"] === Fixed incorrect version detection for local plugin updates From e46aa007edd6079cd698d4f75ec3eb875d7f87bd Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Fabrice=20Flore-Th=C3=A9bault?= Date: Mon, 10 Nov 2025 12:40:45 +0100 Subject: [PATCH 4/8] Update modules/release-notes/ref-release-notes-new-features.adoc Co-authored-by: Gerry-Forde <63045020+Gerry-Forde@users.noreply.github.com> --- .../ref-release-notes-new-features.adoc | 206 +++++++++--------- 1 file changed, 103 insertions(+), 103 deletions(-) diff --git a/modules/release-notes/ref-release-notes-new-features.adoc b/modules/release-notes/ref-release-notes-new-features.adoc index d82f21e3b7..a3e292229e 100644 --- a/modules/release-notes/ref-release-notes-new-features.adoc +++ b/modules/release-notes/ref-release-notes-new-features.adoc @@ -1,54 +1,54 @@ -:_content-type: REFERENCE - -[id="new-features"] -= New features - -This section highlights new features in {product} {product-version}. - -[id="feature-rhidp-5778"] -== built-in monitoring for {product} operator - -This update introduces built-in monitoring for the {product} Operator. By enabling `spec.monitoring.enabled: true` in your Backstage custom resource, the {product} Operator will automatically manage service monitor resources for Prometheus metrics collection on the `/metrics` endpoint. This simplifies the monitoring process, eliminating the need for manual service monitor setup, and enhances the user experience on OpenShift and Kubernetes clusters with Prometheus Operator installed. - -[id="feature-rhidp-5779"] +:_content-type: REFERENCE + +[id="new-features"] += New features + +This section highlights new features in {product} {product-version}. + +[id="feature-rhidp-5778"] +== Built-in monitoring for {product} operator + +This update introduces built-in monitoring for the {product} Operator. By enabling `spec.monitoring.enabled: true` in your Backstage custom resource, the {product} Operator will automatically manage service monitor resources for Prometheus metrics collection on the `/metrics` endpoint. This simplifies the monitoring process, eliminating the need for manual service monitor setup, and enhances the user experience on OpenShift and Kubernetes clusters with Prometheus Operator installed. + +[id="feature-rhidp-5779"] ==Automatic ServiceMonitor Creation for Built-in Monitoring The Red Hat Developer Hub Operator provides built-in monitoring capabilities by automatically creating and managing the necessary `ServiceMonitor` resource. -For more information, see {monitoring-and-logging-book-link}#proc-admin-enabling-metrics-ocp-operator_assembly-rhdh-observability[2.1. Enabling metrics monitoring in a Red Hat Developer Hub Operator installation on an OpenShift Container Platform cluster]. - -[id="feature-rhidp-7059"] +For more information, see {monitoring-and-logging-book-link}#proc-admin-enabling-metrics-ocp-operator_assembly-rhdh-observability[2.1. Enabling metrics monitoring in a Red Hat Developer Hub Operator installation on an OpenShift Container Platform cluster]. + +[id="feature-rhidp-7059"] == Bulk import GitLab projects -With this update, users can bulk import entities from GitLab into {product}, enhancing onboarding efficiency. - -[id="feature-rhidp-8249"] +With this update, users can bulk import entities from GitLab into {product}, enhancing onboarding efficiency. + +[id="feature-rhidp-8249"] == Enhanced package management in the *Extensions* page -You can manage installed packages more easily under the reorganized *Extensions* navigation. The former *Installed Plugins* tab is renamed to *Installed Packages* and includes new row actions that allow you to edit, enable, and disable packages directly from the list. - -[id="feature-rhidp-8259"] -== Introducing localization support in core plugins, and French localization - -This update introduces localization support and French localization to these core plugins: - -- Adoption insights -- AI Integrations -- Bulk Import -- Extensions (Marketplace) -- Lightspeed -- Orchestrator -- QuickStart -- RBAC -- ScoreCard -- Topology -- Global header -- Homepage -- Tekton -- ArgoCD - -This enhancement allows {product} to display content in French, improving accessibility for users who speak French. AI/Cursor automation ensures a seamless translation process, enhancing the user experience by providing content in their preferred language, preparing {product} for use in multilingual environments and fostering a more inclusive developer community. - -[id="feature-rhidp-8260"] +You can manage installed packages more easily under the reorganized *Extensions* navigation. The former *Installed Plugins* tab is renamed to *Installed Packages* and includes new row actions that allow you to edit, enable, and disable packages directly from the list. + +[id="feature-rhidp-8259"] +== Introducing localization support in core plugins, and French localization + +This update introduces localization support and French localization to these core plugins: + +- Adoption insights +- AI Integrations +- Bulk Import +- Extensions (Marketplace) +- Lightspeed +- Orchestrator +- QuickStart +- RBAC +- ScoreCard +- Topology +- Global header +- Homepage +- Tekton +- ArgoCD + +This enhancement allows {product} to display content in French, improving accessibility for users who speak French. AI/Cursor automation ensures a seamless translation process, enhancing the user experience by providing content in their preferred language, preparing {product} for use in multilingual environments and fostering a more inclusive developer community. + +[id="feature-rhidp-8260"] == Localization support for strings defined in {product} configuration files With this update, localization support is introduced for strings defined in {product} configuration files such as `app-config.yaml` and `dynamic-plugins.default.yaml`. @@ -60,67 +60,67 @@ This enables users to customize the interface in their preferred language, provi * Sidebar Menu Items * Floating Action Button (FAB) labels and tooltips -This localization support ensures a more inclusive and user-friendly experience for a diverse user base, improving user experience and supporting global users. - -[id="feature-rhidp-8261"] +This localization support ensures a more inclusive and user-friendly experience for a diverse user base, improving user experience and supporting global users. + +[id="feature-rhidp-8261"] == Plugins localization support -With this update, {product} integrates the Backstage localization framework, enabling users to load translations provided by their plugins. The selected language will persist according to the user settings persistence configuration. Additionally, users can load translations from an external JSON file, allowing them to override existing translations or add translations for existing translation keys. - -[id="feature-rhidp-8274"] +With this update, {product} integrates the Backstage localization framework, enabling users to load translations provided by their plugins. The selected language will persist according to the user settings persistence configuration. Additionally, users can load translations from an external JSON file, allowing them to override existing translations or add translations for existing translation keys. + +[id="feature-rhidp-8274"] == Enhanced Bulk Import with Scaffolder Templates -With this update, users can enhance the Bulk Import plugin by importing repositories using scaffolder templates. This automates and optimizes the process by integrating with existing Backstage templates and Orchestrator workflows. Users can select their preferred pre-ingestion workflow and incorporate various scaffolder actions into their bulk import process, resulting in a more efficient and flexible Bulk Import experience. - -[id="feature-rhidp-8288"] +With this update, users can enhance the Bulk Import plugin by importing repositories using scaffolder templates. This automates and optimizes the process by integrating with existing Backstage templates and Orchestrator workflows. Users can select their preferred pre-ingestion workflow and incorporate various scaffolder actions into their bulk import process, resulting in a more efficient and flexible Bulk Import experience. + +[id="feature-rhidp-8288"] == Enabling Software Template version update notifications -With this update, you can enable notification alerts whenever a Software Template is updated with a new version. For more information, see {customizing-book-link}#proc-enabling-software-template-version-update-notifications_configuring-templates[Enabling Software Template version update notifications in {product}]. - -[id="enhancement-rhidp-8290"] +With this update, you can enable notification alerts whenever a Software Template is updated with a new version. For more information, see {customizing-book-link}#proc-enabling-software-template-version-update-notifications_configuring-templates[Enabling Software Template version update notifications in {product}]. + +[id="enhancement-rhidp-8290"] == Built-in TechDocs for RHDH-Local With this update, RHDH Local includes comprehensive technical TechDocs covering everything you need to know about it. -Once running, access the built-in documentation directly in the application for detailed guides. - -[id="feature-rhidp-8295"] +Once running, access the built-in documentation directly in the application for detailed guides. + +[id="feature-rhidp-8295"] == Software Template provenance and dependency tracking With this update, {product} supports Software Template provenance and a dedicated dependency view to improve component traceability and lifecycle management across your organization. -For more information, see {customizing-book-link}#tracking-component-origin-and-software-template-version[Tracking component origin and Software Template version]. - -[id="feature-rhidp-8296"] +For more information, see {customizing-book-link}#tracking-component-origin-and-software-template-version[Tracking component origin and Software Template version]. + +[id="feature-rhidp-8296"] == Tech Radar and Quay plugins in RHDH Local -With this update, RHDH Local integrates the Tech Radar and Quay plugins, for a better out of the box experience for users. The Tech Radar plugin provides a visually engaging element on the homepage or via navigation, and showcases the dynamic plugins loading mechanism for simple {product-short} extension. The Quay plugin demonstrates integration with external services and provides a practical example of extending the {product-short} software catalog. - -[id="feature-rhidp-8297"] +With this update, RHDH Local integrates the Tech Radar and Quay plugins, for a better out of the box experience for users. The Tech Radar plugin provides a visually engaging element on the homepage or via navigation, and showcases the dynamic plugins loading mechanism for simple {product-short} extension. The Quay plugin demonstrates integration with external services and provides a practical example of extending the {product-short} software catalog. + +[id="feature-rhidp-8297"] == RHDH Local default homepage enhancements -With this update, RHDH Local default homepage integrates a floating action button with quick links for easy access to documentation and information. - -[id="feature-rhidp-8298"] +With this update, RHDH Local default homepage integrates a floating action button with quick links for easy access to documentation and information. + +[id="feature-rhidp-8298"] == Enhanced customozation and collaboration with pre-loaded templates in RHDH Local -With this update, RHDH Local integrates pre-loaded essential templates, enabling users to create their own custom plugins and add TechDocs or software components to existing projects within {product}. This enhancement demonstrates {product-short} extensibility, empowers users to extend the platform, and enhances the overall user experience by promoting collaboration and customization. - -[id="feature-rhidp-8329"] -== Users can customize their homepage - -With this update, {product} users can customize their homepage, empowering personalization and productivity. Users can now move, resize, remove, and add existing cards, fostering a more flexible and adaptable user experience. The customization options are based on the existing settings, and users can reset their configuration to the default. The feature aims to improve the resize and reorder mechanism, and update existing cards to work better on different card sizes. - -[id="feature-rhidp-8342"] -== French language support - -With this update, {product} provides full French language support, enhancing accessibility and user experience for French-speaking users, particularly in Quebec. This implementation includes translating all visible text into French, ensuring accurate and consistent translations, and providing a user-friendly interface. This feature was implemented to comply with legal requirements in Quebec and unlock adoption in French-speaking markets, supporting the long-term internationalization plan. - -[id="feature-rhidp-8409"] +With this update, RHDH Local integrates pre-loaded essential templates, enabling users to create their own custom plugins and add TechDocs or software components to existing projects within {product}. This enhancement demonstrates {product-short} extensibility, empowers users to extend the platform, and enhances the overall user experience by promoting collaboration and customization. + +[id="feature-rhidp-8329"] +== Users can customize their homepage + +With this update, {product} users can customize their homepage, empowering personalization and productivity. Users can now move, resize, remove, and add existing cards, fostering a more flexible and adaptable user experience. The customization options are based on the existing settings, and users can reset their configuration to the default. The feature aims to improve the resize and reorder mechanism, and update existing cards to work better on different card sizes. + +[id="feature-rhidp-8342"] +== French language support + +With this update, {product} provides full French language support, enhancing accessibility and user experience for French-speaking users, particularly in Quebec. This implementation includes translating all visible text into French, ensuring accurate and consistent translations, and providing a user-friendly interface. This feature was implemented to comply with legal requirements in Quebec and unlock adoption in French-speaking markets, supporting the long-term internationalization plan. + +[id="feature-rhidp-8409"] == {product-short} community plugins updated to Backstage 1.42 -The {product-short} community plugins have been updated to Backstage version 1.42. - -[id="feature-rhidp-8445"] +The {product-short} community plugins have been updated to Backstage version 1.42. + +[id="feature-rhidp-8445"] == Quick Start experience for developers logging into {product} for the first time With this update, {product} includes a guided Quick Start experience tailored for the developer persona. This new feature appears automatically upon a developer's first login to help them get started quickly and accelerate adoption of the platform. @@ -132,9 +132,9 @@ The developer Quick Start provides guided next steps for key features, including - Self-service templates - Learning paths -This feature is integrated with RBAC, allowing platform engineers to configure the Quick Start content and conditionally display it to specific developer groups for personalized onboarding. - -[id="feature-rhidp-8460"] +This feature is integrated with RBAC, allowing platform engineers to configure the Quick Start content and conditionally display it to specific developer groups for personalized onboarding. + +[id="feature-rhidp-8460"] == Transparent plugin support indicators With this update, the plugin support model is now transparently aligned with Red Hat's standard release classifications. @@ -176,33 +176,33 @@ The *Verified* badge is removed. ---- - - -[id="enhancement-rhidp-8643"] + + +[id="enhancement-rhidp-8643"] == Enhanced package management in the Extensions page -With this update, {product} includes a reorganized Extensions navigation, enabling the user to manage installed packages more easily. The former *Installed Plugins* tab is renamed to *Installed Packages* and includes new row actions that allow you to edit, enable, and disable packages directly from the list. - -[id="feature-rhidp-8645"] +With this update, {product} includes a reorganized Extensions navigation, enabling the user to manage installed packages more easily. The former *Installed Plugins* tab is renamed to *Installed Packages* and includes new row actions that allow you to edit, enable, and disable packages directly from the list. + +[id="feature-rhidp-8645"] == Support for high availability in {gke-brand-name} {product} now supports high availability setups in {gke-brand-name} ({gke-short}). This enhancement allows the deployment to scale beyond a single replica, ensuring the application remains operational and accessible even in the event of failures or disruptions. -For more information, see link:{configuring-book-url}#HighAvailability[_Configuring high availability in Red Hat Developer Hub_]. - -[id="feature-rhidp-8715"] +For more information, see link:{configuring-book-url}#HighAvailability[_Configuring high availability in Red Hat Developer Hub_]. + +[id="feature-rhidp-8715"] == Customizable container deployment in {product} pods Previously, injecting necessary files (`extraFiles`) and environment variables (`extraEnvs`) was restricted to the default `backstage-backend` container. With this update, you can configure resource injection for any container in the {product} pod, including sidecars and system containers. This allows you to complete the job of deploying custom components, such as security agents, log collectors, or configuration managers, that require specific volumes or runtime variables to operate successfully. -See {configuring-book-link}#proc-injecting-custom-files-and-environment-variables-into-backstage-containers[Injecting extra files and environment variables into {backstage} containers]. - -[id="feature-rhidp-8816"] +See {configuring-book-link}#proc-injecting-custom-files-and-environment-variables-into-backstage-containers[Injecting extra files and environment variables into {backstage} containers]. + +[id="feature-rhidp-8816"] == French localization -This release is introducing localization, with one language supported: French. - - - +This release is introducing localization, with one language supported: French. + + + From fc5bc465459406fff03ddde309d2a58a7e6f4eaf Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Fabrice=20Flore-Th=C3=A9bault?= Date: Mon, 10 Nov 2025 12:41:17 +0100 Subject: [PATCH 5/8] Update modules/release-notes/ref-release-notes-new-features.adoc Co-authored-by: Gerry-Forde <63045020+Gerry-Forde@users.noreply.github.com> --- modules/release-notes/ref-release-notes-new-features.adoc | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/modules/release-notes/ref-release-notes-new-features.adoc b/modules/release-notes/ref-release-notes-new-features.adoc index a3e292229e..f0eea9160e 100644 --- a/modules/release-notes/ref-release-notes-new-features.adoc +++ b/modules/release-notes/ref-release-notes-new-features.adoc @@ -11,7 +11,8 @@ This section highlights new features in {product} {product-version}. This update introduces built-in monitoring for the {product} Operator. By enabling `spec.monitoring.enabled: true` in your Backstage custom resource, the {product} Operator will automatically manage service monitor resources for Prometheus metrics collection on the `/metrics` endpoint. This simplifies the monitoring process, eliminating the need for manual service monitor setup, and enhances the user experience on OpenShift and Kubernetes clusters with Prometheus Operator installed. [id="feature-rhidp-5779"] -==Automatic ServiceMonitor Creation for Built-in Monitoring +== Automatic ServiceMonitor Creation for Built-in Monitoring + The Red Hat Developer Hub Operator provides built-in monitoring capabilities by automatically creating and managing the necessary `ServiceMonitor` resource. For more information, see {monitoring-and-logging-book-link}#proc-admin-enabling-metrics-ocp-operator_assembly-rhdh-observability[2.1. Enabling metrics monitoring in a Red Hat Developer Hub Operator installation on an OpenShift Container Platform cluster]. From e809e49f3f47d0e1a130b37e75741a3f65cdccfb Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Fabrice=20Flore-Th=C3=A9bault?= Date: Mon, 10 Nov 2025 13:04:00 +0100 Subject: [PATCH 6/8] Update modules/release-notes/ref-release-notes-new-features.adoc --- modules/release-notes/ref-release-notes-new-features.adoc | 4 ---- 1 file changed, 4 deletions(-) diff --git a/modules/release-notes/ref-release-notes-new-features.adoc b/modules/release-notes/ref-release-notes-new-features.adoc index f0eea9160e..4dd4f20ab4 100644 --- a/modules/release-notes/ref-release-notes-new-features.adoc +++ b/modules/release-notes/ref-release-notes-new-features.adoc @@ -200,10 +200,6 @@ With this update, you can configure resource injection for any container in the See {configuring-book-link}#proc-injecting-custom-files-and-environment-variables-into-backstage-containers[Injecting extra files and environment variables into {backstage} containers]. -[id="feature-rhidp-8816"] -== French localization - -This release is introducing localization, with one language supported: French. From 153375515a46168179de9e8b7542eed5b72d44a9 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Fabrice=20Flore-Th=C3=A9bault?= Date: Mon, 10 Nov 2025 13:13:04 +0100 Subject: [PATCH 7/8] Applied suggestions from code review MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Fabrice Flore-Thébault --- .../ref-release-notes-fixed-issues.adoc | 190 ++++++++--------- .../ref-release-notes-new-features.adoc | 193 +++++++++--------- 2 files changed, 188 insertions(+), 195 deletions(-) diff --git a/modules/release-notes/ref-release-notes-fixed-issues.adoc b/modules/release-notes/ref-release-notes-fixed-issues.adoc index 744667b85c..f84d5518f4 100644 --- a/modules/release-notes/ref-release-notes-fixed-issues.adoc +++ b/modules/release-notes/ref-release-notes-fixed-issues.adoc @@ -1,95 +1,95 @@ -:_content-type: REFERENCE - -[id="fixed-issues"] -= Fixed issues - -This section lists issues fixed in {product} {product-version}. - -== Fixed issues in 1.8.0 - -[id="bug-fix-rhdhbugs-1000"] -=== Improved startup speed with updated init container image pull policy for {product-short} Helm Chart - -With this update, the pull policy for the init container image of the {product-short} Helm Chart was changed from `Always` to `IfNotPresent`. This change reduces the repeated download time during startup of the container image, which is approximately 2.5 GB, thereby significantly improving startup speed for users. - - -.Additional resources -* link:https://issues.redhat.com/browse/RHDHBUGS-1000[RHDHBUGS-1000] - - -[id="bug-fix-rhdhbugs-1028"] -=== Improved Authentication for Self-Hosted Enterprise SCM Providers - -Previously, actions requiring access to a self-hosted enterprise SCM provider failed, returning an error that no authentication provider was available for the specified host. - -With this update, the SCM integration correctly identifies and uses the configured authentication provider for the corresponding enterprise host. - - -.Additional resources -* link:https://issues.redhat.com/browse/RHDHBUGS-1028[RHDHBUGS-1028] - - -[id="bug-fix-rhdhbugs-2003"] -=== Customizable image names for job and data index services in {product-short} Helm Chart - -Previously, when deploying the {product-short} Helm Chart with the Orchestrator enabled, it was not possible to customize the image names of the job and data index services, for example in disconnected environments. Setting the `orchestrator.sonataflowPlatform.jobServiceImage` and `orchestrator.sonataflowPlatform.dataIndexImage` would return a schema validation error from Helm. This update fixes this issue. - - -.Additional resources -* link:https://issues.redhat.com/browse/RHDHBUGS-2003[RHDHBUGS-2003] - - -[id="bug-fix-rhdhbugs-2020"] -=== Network policy installation fix for {product-short} RHDH Helm Chart with Orchestrator flavor - -Before this update, the {product-short} RHDH Helm Chart would not install Network Policies when the Orchestrator flavor was deployed with `serverlessLogicOperator` disabled, preventing the {product-short} Pods from being completely available. This update fixes this situation by installing network policies unconditionally when the orchestrator is enabled. - - -.Additional resources -* link:https://issues.redhat.com/browse/RHDHBUGS-2020[RHDHBUGS-2020] - - -[id="bug-fix-rhdhbugs-2036"] -=== Resolved SonataFlow Pod Crash Issue - -In the new release, a timing problem during the RHDH 1.7 installation with Orchestrator plugins, affecting SonataFlow database provisioning, has been addressed. This issue caused SonataFlow pods to repeatedly enter the `CrashLoopBackOff` state, leading to delays and potential confusion for users. With this update, SonataFlow pods no longer encounter the `CrashLoopBackOff` state due to the database provisioning delay. This improvement enhances the user experience, as SonataFlow pods now start promptly, eliminating unnecessary wait times. - - -.Additional resources -* link:https://issues.redhat.com/browse/RHDHBUGS-2036[RHDHBUGS-2036] - - -[id="bug-fix-rhdhbugs-2117"] -=== Fixed SCM integration failures for self-hosted enterprise SCM providers - -Before this update, the SCM integration failed due to lack of identification of the configured authentication provider for self-hosted enterprise SCM hosts. As a consequence, users experienced failed actions with self-hosted enterprise SCM providers due to missing authentication. - -With this release, the SCM integration now correctly uses the configured authentication provider for corresponding enterprise host. As a result, end users can now successfully perform actions requiring enterprise SCM access. - - -.Additional resources -* link:https://issues.redhat.com/browse/RHDHBUGS-2117[RHDHBUGS-2117] - - -[id="bug-fix-rhdhbugs-1878"] -=== Fixed incorrect version detection for local plugin updates - -Before this update, local plugins within the image were incorrectly detected for updates due to version misidentification. This led to users being unable to update local plugins from wrappers, resulting in outdated functionality. With this release, local plugin updates are now automatically detected, eliminating the need for manual adjustments and ensuring seamless plugin version updates for end users. - - -.Additional resources -* link:https://issues.redhat.com/browse/RHDHBUGS-1878[RHDHBUGS-1878] - - -[id="bug-fix-rhdhbugs-2041"] -=== Orchestrator plugin updated to 1.7.1 - -Before this update, the latest Orchestrator feature set was unavailable because the release included the outdated Orchestrator plugin version `1.6`. This issue is resolved in {product-very-short} `1.7.1`. The Orchestrator plugin is now updated to version `1.7.1`, ensuring that users have access to the latest features and functionality. - - - -.Additional resources -* link:https://issues.redhat.com/browse/RHDHBUGS-2041[RHDHBUGS-2041] - - - +:_content-type: REFERENCE + +[id="fixed-issues"] += Fixed issues + +This section lists issues fixed in {product} {product-version}. + +== Fixed issues in 1.8.0 + +[id="bug-fix-rhdhbugs-1000"] +=== Improved startup speed with updated init container image pull policy for {product-short} Helm Chart + +With this update, the pull policy for the init container image of the {product-short} Helm Chart was changed from `Always` to `IfNotPresent`. This change reduces the repeated download time during startup of the container image, which is approximately 2.5 GB, thereby significantly improving startup speed for users. + + +.Additional resources +* link:https://issues.redhat.com/browse/RHDHBUGS-1000[RHDHBUGS-1000] + + +[id="bug-fix-rhdhbugs-1028"] +=== Improved Authentication for Self-Hosted Enterprise SCM Providers + +Previously, actions requiring access to a self-hosted enterprise SCM provider failed, returning an error that no authentication provider was available for the specified host. + +With this update, the SCM integration correctly identifies and uses the configured authentication provider for the corresponding enterprise host. + + +.Additional resources +* link:https://issues.redhat.com/browse/RHDHBUGS-1028[RHDHBUGS-1028] + + +[id="bug-fix-rhdhbugs-2003"] +=== Customizable image names for job and data index services in {product-short} Helm Chart + +Previously, when deploying the {product-short} Helm Chart with the Orchestrator enabled, it was not possible to customize the image names of the job and data index services, for example in disconnected environments. Setting the `orchestrator.sonataflowPlatform.jobServiceImage` and `orchestrator.sonataflowPlatform.dataIndexImage` would return a schema validation error from Helm. This update fixes this issue. + + +.Additional resources +* link:https://issues.redhat.com/browse/RHDHBUGS-2003[RHDHBUGS-2003] + + +[id="bug-fix-rhdhbugs-2020"] +=== Network policy installation fix for {product-short} RHDH Helm Chart with Orchestrator flavor + +Before this update, the {product-short} RHDH Helm Chart would not install Network Policies when the Orchestrator flavor was deployed with `serverlessLogicOperator` disabled, preventing the {product-short} Pods from being completely available. This update fixes this situation by installing network policies unconditionally when the orchestrator is enabled. + + +.Additional resources +* link:https://issues.redhat.com/browse/RHDHBUGS-2020[RHDHBUGS-2020] + + +[id="bug-fix-rhdhbugs-2036"] +=== Resolved SonataFlow Pod Crash Issue + +In the new release, a timing problem during the RHDH 1.7 installation with Orchestrator plugins, affecting SonataFlow database provisioning, has been addressed. This issue caused SonataFlow pods to repeatedly enter the `CrashLoopBackOff` state, leading to delays and potential confusion for users. With this update, SonataFlow pods no longer encounter the `CrashLoopBackOff` state due to the database provisioning delay. This improvement enhances the user experience, as SonataFlow pods now start promptly, eliminating unnecessary wait times. + + +.Additional resources +* link:https://issues.redhat.com/browse/RHDHBUGS-2036[RHDHBUGS-2036] + + +[id="bug-fix-rhdhbugs-2117"] +=== Fixed SCM integration failures for self-hosted enterprise SCM providers + +Before this update, the SCM integration failed due to lack of identification of the configured authentication provider for self-hosted enterprise SCM hosts. As a consequence, users experienced failed actions with self-hosted enterprise SCM providers due to missing authentication. + +With this release, the SCM integration now correctly uses the configured authentication provider for corresponding enterprise host. As a result, end users can now successfully perform actions requiring enterprise SCM access. + + +.Additional resources +* link:https://issues.redhat.com/browse/RHDHBUGS-2117[RHDHBUGS-2117] + + +[id="bug-fix-rhdhbugs-1878"] +=== Fixed incorrect version detection for local plugin updates + +Before this update, local plugins within the image were incorrectly detected for updates due to version misidentification. This led to users being unable to update local plugins from wrappers, resulting in outdated functionality. With this release, local plugin updates are now automatically detected, eliminating the need for manual adjustments and ensuring seamless plugin version updates for end users. + + +.Additional resources +* link:https://issues.redhat.com/browse/RHDHBUGS-1878[RHDHBUGS-1878] + + +[id="bug-fix-rhdhbugs-2041"] +=== Orchestrator plugin updated to 1.7.1 + +Before this update, the latest Orchestrator feature set was unavailable because the release included the outdated Orchestrator plugin version `1.6`. This issue is resolved in {product-very-short} `1.7.1`. The Orchestrator plugin is now updated to version `1.7.1`, ensuring that users have access to the latest features and functionality. + + + +.Additional resources +* link:https://issues.redhat.com/browse/RHDHBUGS-2041[RHDHBUGS-2041] + + + diff --git a/modules/release-notes/ref-release-notes-new-features.adoc b/modules/release-notes/ref-release-notes-new-features.adoc index 4dd4f20ab4..4d03d79350 100644 --- a/modules/release-notes/ref-release-notes-new-features.adoc +++ b/modules/release-notes/ref-release-notes-new-features.adoc @@ -1,55 +1,54 @@ -:_content-type: REFERENCE - -[id="new-features"] -= New features - -This section highlights new features in {product} {product-version}. - -[id="feature-rhidp-5778"] +:_content-type: REFERENCE + +[id="new-features"] += New features + +This section highlights new features in {product} {product-version}. + +[id="feature-rhidp-5778"] == Built-in monitoring for {product} operator -This update introduces built-in monitoring for the {product} Operator. By enabling `spec.monitoring.enabled: true` in your Backstage custom resource, the {product} Operator will automatically manage service monitor resources for Prometheus metrics collection on the `/metrics` endpoint. This simplifies the monitoring process, eliminating the need for manual service monitor setup, and enhances the user experience on OpenShift and Kubernetes clusters with Prometheus Operator installed. - -[id="feature-rhidp-5779"] +This update introduces built-in monitoring for the {product} Operator. By enabling `spec.monitoring.enabled: true` in your Backstage custom resource, the {product} Operator will automatically manage service monitor resources for Prometheus metrics collection on the `/metrics` endpoint. This simplifies the monitoring process, eliminating the need for manual service monitor setup, and enhances the user experience on OpenShift and Kubernetes clusters with Prometheus Operator installed. + +[id="feature-rhidp-5779"] == Automatic ServiceMonitor Creation for Built-in Monitoring - The Red Hat Developer Hub Operator provides built-in monitoring capabilities by automatically creating and managing the necessary `ServiceMonitor` resource. -For more information, see {monitoring-and-logging-book-link}#proc-admin-enabling-metrics-ocp-operator_assembly-rhdh-observability[2.1. Enabling metrics monitoring in a Red Hat Developer Hub Operator installation on an OpenShift Container Platform cluster]. - -[id="feature-rhidp-7059"] +For more information, see {monitoring-and-logging-book-link}#proc-admin-enabling-metrics-ocp-operator_assembly-rhdh-observability[2.1. Enabling metrics monitoring in a Red Hat Developer Hub Operator installation on an OpenShift Container Platform cluster]. + +[id="feature-rhidp-7059"] == Bulk import GitLab projects -With this update, users can bulk import entities from GitLab into {product}, enhancing onboarding efficiency. - -[id="feature-rhidp-8249"] +With this update, users can bulk import entities from GitLab into {product}, enhancing onboarding efficiency. + +[id="feature-rhidp-8249"] == Enhanced package management in the *Extensions* page -You can manage installed packages more easily under the reorganized *Extensions* navigation. The former *Installed Plugins* tab is renamed to *Installed Packages* and includes new row actions that allow you to edit, enable, and disable packages directly from the list. - -[id="feature-rhidp-8259"] -== Introducing localization support in core plugins, and French localization - -This update introduces localization support and French localization to these core plugins: - -- Adoption insights -- AI Integrations -- Bulk Import -- Extensions (Marketplace) -- Lightspeed -- Orchestrator -- QuickStart -- RBAC -- ScoreCard -- Topology -- Global header -- Homepage -- Tekton -- ArgoCD - -This enhancement allows {product} to display content in French, improving accessibility for users who speak French. AI/Cursor automation ensures a seamless translation process, enhancing the user experience by providing content in their preferred language, preparing {product} for use in multilingual environments and fostering a more inclusive developer community. - -[id="feature-rhidp-8260"] +You can manage installed packages more easily under the reorganized *Extensions* navigation. The former *Installed Plugins* tab is renamed to *Installed Packages* and includes new row actions that allow you to edit, enable, and disable packages directly from the list. + +[id="feature-rhidp-8259"] +== Introducing localization support in core plugins, and French localization + +This update introduces localization support and French localization to these core plugins: + +- Adoption insights +- AI Integrations +- Bulk Import +- Extensions (Marketplace) +- Lightspeed +- Orchestrator +- QuickStart +- RBAC +- ScoreCard +- Topology +- Global header +- Homepage +- Tekton +- ArgoCD + +This enhancement allows {product} to display content in French, improving accessibility for users who speak French. AI/Cursor automation ensures a seamless translation process, enhancing the user experience by providing content in their preferred language, preparing {product} for use in multilingual environments and fostering a more inclusive developer community. + +[id="feature-rhidp-8260"] == Localization support for strings defined in {product} configuration files With this update, localization support is introduced for strings defined in {product} configuration files such as `app-config.yaml` and `dynamic-plugins.default.yaml`. @@ -61,67 +60,62 @@ This enables users to customize the interface in their preferred language, provi * Sidebar Menu Items * Floating Action Button (FAB) labels and tooltips -This localization support ensures a more inclusive and user-friendly experience for a diverse user base, improving user experience and supporting global users. - -[id="feature-rhidp-8261"] +This localization support ensures a more inclusive and user-friendly experience for a diverse user base, improving user experience and supporting global users. + +[id="feature-rhidp-8261"] == Plugins localization support -With this update, {product} integrates the Backstage localization framework, enabling users to load translations provided by their plugins. The selected language will persist according to the user settings persistence configuration. Additionally, users can load translations from an external JSON file, allowing them to override existing translations or add translations for existing translation keys. - -[id="feature-rhidp-8274"] +With this update, {product} integrates the Backstage localization framework, enabling users to load translations provided by their plugins. The selected language will persist according to the user settings persistence configuration. Additionally, users can load translations from an external JSON file, allowing them to override existing translations or add translations for existing translation keys. + +[id="feature-rhidp-8274"] == Enhanced Bulk Import with Scaffolder Templates -With this update, users can enhance the Bulk Import plugin by importing repositories using scaffolder templates. This automates and optimizes the process by integrating with existing Backstage templates and Orchestrator workflows. Users can select their preferred pre-ingestion workflow and incorporate various scaffolder actions into their bulk import process, resulting in a more efficient and flexible Bulk Import experience. - -[id="feature-rhidp-8288"] +With this update, users can enhance the Bulk Import plugin by importing repositories using scaffolder templates. This automates and optimizes the process by integrating with existing Backstage templates and Orchestrator workflows. Users can select their preferred pre-ingestion workflow and incorporate various scaffolder actions into their bulk import process, resulting in a more efficient and flexible Bulk Import experience. + +[id="feature-rhidp-8288"] == Enabling Software Template version update notifications -With this update, you can enable notification alerts whenever a Software Template is updated with a new version. For more information, see {customizing-book-link}#proc-enabling-software-template-version-update-notifications_configuring-templates[Enabling Software Template version update notifications in {product}]. - -[id="enhancement-rhidp-8290"] +With this update, you can enable notification alerts whenever a Software Template is updated with a new version. For more information, see {customizing-book-link}#proc-enabling-software-template-version-update-notifications_configuring-templates[Enabling Software Template version update notifications in {product}]. + +[id="enhancement-rhidp-8290"] == Built-in TechDocs for RHDH-Local With this update, RHDH Local includes comprehensive technical TechDocs covering everything you need to know about it. -Once running, access the built-in documentation directly in the application for detailed guides. - -[id="feature-rhidp-8295"] +Once running, access the built-in documentation directly in the application for detailed guides. + +[id="feature-rhidp-8295"] == Software Template provenance and dependency tracking With this update, {product} supports Software Template provenance and a dedicated dependency view to improve component traceability and lifecycle management across your organization. -For more information, see {customizing-book-link}#tracking-component-origin-and-software-template-version[Tracking component origin and Software Template version]. - -[id="feature-rhidp-8296"] +For more information, see {customizing-book-link}#tracking-component-origin-and-software-template-version[Tracking component origin and Software Template version]. + +[id="feature-rhidp-8296"] == Tech Radar and Quay plugins in RHDH Local -With this update, RHDH Local integrates the Tech Radar and Quay plugins, for a better out of the box experience for users. The Tech Radar plugin provides a visually engaging element on the homepage or via navigation, and showcases the dynamic plugins loading mechanism for simple {product-short} extension. The Quay plugin demonstrates integration with external services and provides a practical example of extending the {product-short} software catalog. - -[id="feature-rhidp-8297"] +With this update, RHDH Local integrates the Tech Radar and Quay plugins, for a better out of the box experience for users. The Tech Radar plugin provides a visually engaging element on the homepage or via navigation, and showcases the dynamic plugins loading mechanism for simple {product-short} extension. The Quay plugin demonstrates integration with external services and provides a practical example of extending the {product-short} software catalog. + +[id="feature-rhidp-8297"] == RHDH Local default homepage enhancements -With this update, RHDH Local default homepage integrates a floating action button with quick links for easy access to documentation and information. - -[id="feature-rhidp-8298"] +With this update, RHDH Local default homepage integrates a floating action button with quick links for easy access to documentation and information. + +[id="feature-rhidp-8298"] == Enhanced customozation and collaboration with pre-loaded templates in RHDH Local -With this update, RHDH Local integrates pre-loaded essential templates, enabling users to create their own custom plugins and add TechDocs or software components to existing projects within {product}. This enhancement demonstrates {product-short} extensibility, empowers users to extend the platform, and enhances the overall user experience by promoting collaboration and customization. - -[id="feature-rhidp-8329"] -== Users can customize their homepage - -With this update, {product} users can customize their homepage, empowering personalization and productivity. Users can now move, resize, remove, and add existing cards, fostering a more flexible and adaptable user experience. The customization options are based on the existing settings, and users can reset their configuration to the default. The feature aims to improve the resize and reorder mechanism, and update existing cards to work better on different card sizes. - -[id="feature-rhidp-8342"] -== French language support - -With this update, {product} provides full French language support, enhancing accessibility and user experience for French-speaking users, particularly in Quebec. This implementation includes translating all visible text into French, ensuring accurate and consistent translations, and providing a user-friendly interface. This feature was implemented to comply with legal requirements in Quebec and unlock adoption in French-speaking markets, supporting the long-term internationalization plan. - -[id="feature-rhidp-8409"] +With this update, RHDH Local integrates pre-loaded essential templates, enabling users to create their own custom plugins and add TechDocs or software components to existing projects within {product}. This enhancement demonstrates {product-short} extensibility, empowers users to extend the platform, and enhances the overall user experience by promoting collaboration and customization. + +[id="feature-rhidp-8329"] +== Users can customize their homepage + +With this update, {product} users can customize their homepage, empowering personalization and productivity. Users can now move, resize, remove, and add existing cards, fostering a more flexible and adaptable user experience. The customization options are based on the existing settings, and users can reset their configuration to the default. The feature aims to improve the resize and reorder mechanism, and update existing cards to work better on different card sizes. + +[id="feature-rhidp-8409"] == {product-short} community plugins updated to Backstage 1.42 -The {product-short} community plugins have been updated to Backstage version 1.42. - -[id="feature-rhidp-8445"] +The {product-short} community plugins have been updated to Backstage version 1.42. + +[id="feature-rhidp-8445"] == Quick Start experience for developers logging into {product} for the first time With this update, {product} includes a guided Quick Start experience tailored for the developer persona. This new feature appears automatically upon a developer's first login to help them get started quickly and accelerate adoption of the platform. @@ -133,9 +127,9 @@ The developer Quick Start provides guided next steps for key features, including - Self-service templates - Learning paths -This feature is integrated with RBAC, allowing platform engineers to configure the Quick Start content and conditionally display it to specific developer groups for personalized onboarding. - -[id="feature-rhidp-8460"] +This feature is integrated with RBAC, allowing platform engineers to configure the Quick Start content and conditionally display it to specific developer groups for personalized onboarding. + +[id="feature-rhidp-8460"] == Transparent plugin support indicators With this update, the plugin support model is now transparently aligned with Red Hat's standard release classifications. @@ -177,29 +171,28 @@ The *Verified* badge is removed. ---- - - -[id="enhancement-rhidp-8643"] + + +[id="enhancement-rhidp-8643"] == Enhanced package management in the Extensions page -With this update, {product} includes a reorganized Extensions navigation, enabling the user to manage installed packages more easily. The former *Installed Plugins* tab is renamed to *Installed Packages* and includes new row actions that allow you to edit, enable, and disable packages directly from the list. - -[id="feature-rhidp-8645"] +With this update, {product} includes a reorganized Extensions navigation, enabling the user to manage installed packages more easily. The former *Installed Plugins* tab is renamed to *Installed Packages* and includes new row actions that allow you to edit, enable, and disable packages directly from the list. + +[id="feature-rhidp-8645"] == Support for high availability in {gke-brand-name} {product} now supports high availability setups in {gke-brand-name} ({gke-short}). This enhancement allows the deployment to scale beyond a single replica, ensuring the application remains operational and accessible even in the event of failures or disruptions. -For more information, see link:{configuring-book-url}#HighAvailability[_Configuring high availability in Red Hat Developer Hub_]. - -[id="feature-rhidp-8715"] +For more information, see link:{configuring-book-url}#HighAvailability[_Configuring high availability in Red Hat Developer Hub_]. + +[id="feature-rhidp-8715"] == Customizable container deployment in {product} pods Previously, injecting necessary files (`extraFiles`) and environment variables (`extraEnvs`) was restricted to the default `backstage-backend` container. With this update, you can configure resource injection for any container in the {product} pod, including sidecars and system containers. This allows you to complete the job of deploying custom components, such as security agents, log collectors, or configuration managers, that require specific volumes or runtime variables to operate successfully. -See {configuring-book-link}#proc-injecting-custom-files-and-environment-variables-into-backstage-containers[Injecting extra files and environment variables into {backstage} containers]. - - - - +See {configuring-book-link}#proc-injecting-custom-files-and-environment-variables-into-backstage-containers[Injecting extra files and environment variables into {backstage} containers]. + + + From 43d212f7300f176cabc587edce748b13c2bbd500 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Fabrice=20Flore-Th=C3=A9bault?= Date: Mon, 10 Nov 2025 13:33:39 +0100 Subject: [PATCH 8/8] Applied suggestions from code review MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Fabrice Flore-Thébault --- ...-release-notes-deprecated-functionalities.adoc | 15 ++++++++++++++- 1 file changed, 14 insertions(+), 1 deletion(-) diff --git a/modules/release-notes/ref-release-notes-deprecated-functionalities.adoc b/modules/release-notes/ref-release-notes-deprecated-functionalities.adoc index b6157177ef..1a8a17b8b8 100644 --- a/modules/release-notes/ref-release-notes-deprecated-functionalities.adoc +++ b/modules/release-notes/ref-release-notes-deprecated-functionalities.adoc @@ -5,8 +5,21 @@ This section lists deprecated functionalities in {product} {product-version}. +[id="deprecated-functionality-rhidp-8525"] +== Deprecation of Bundled Plugin Wrappers + +To enhance performance, decrease image size, and reduce maintenance, the method of including "wrapped" dynamic plugins within the main {product} container image is being deprecated as of release 1.7.0. We are transitioning to a model where all dynamic plugins will be distributed as independent OCI artifacts. + +For the 1.7.0 release, this is a deprecation notice only; there are no breaking changes, and all previously bundled plugins will continue to be bundled. However, we encourage customers to prepare for the removal of wrappers in a future release by beginning to use the new OCI artifacts in 1.9.0. Documentation will be updated to guide this migration. + +For more information, see {installing-and-viewing-plugins-book-link}#proc-load-plugin-oci-image_assembly-install-third-party-plugins-rhdh[Loading a plugin packaged as an OCI image]. + + +.Additional resources +* link:https://issues.redhat.com/browse/RHIDP-8525[RHIDP-8525] + [id="deprecated-functionality-rhidp-9180"] -== OCM Plugins are deprecated +== Deprecation of OCM Plugins The Open Cluster Management (OCM) plugins integrates your {product} instance with the MultiClusterHub and MultiCluster engines of OCM. The OCM plugins are deprecated as of RHDH 1.8, and will be removed in a future release.