Skip to content

Commit 93802a7

Browse files
committed
Release notes for 1.8
Signed-off-by: Fabrice Flore-Thébault <[email protected]>
1 parent 85b25ea commit 93802a7

File tree

4 files changed

+289
-234
lines changed

4 files changed

+289
-234
lines changed

modules/release-notes/ref-release-notes-deprecated-functionalities.adoc

Lines changed: 47 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -5,23 +5,59 @@
55

66
This section lists deprecated functionalities in {product} {product-version}.
77

8-
[id="deprecated-functionality-rhidp-6917"]
9-
== Backstage CR versions `v1alpha1` and `v1alpha2`
8+
[id="deprecated-functionality-rhidp-5309"]
9+
== Argo CD, Tekton, and Topology plugins require the Kubernetes Frontend and Kubernetes Backend plugins
10+
11+
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.
12+
13+
.Procedure
14+
. Enable the Kubernetes Frontend and Kubernetes Backend plugins.
15+
+
16+
[source,yaml]
17+
----
18+
global:
19+
dynamic:
20+
plugins:
21+
- package: ./dynamic-plugins/dist/backstage-plugin-kubernetes
22+
disabled: false
23+
- package: ./dynamic-plugins/dist/backstage-plugin-kubernetes-backend-dynamic
24+
disabled: false
25+
----
26+
27+
. 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`.
28+
+
29+
Optionally, to hide the *Kubernetes* tab in the Software Catalog, disable the feature with this dynamic plugin configuration:
30+
+
31+
[source,yaml]
32+
----
33+
global:
34+
dynamic:
35+
plugins:
36+
- package: ./dynamic-plugins/dist/backstage-plugin-kubernetes
37+
disabled: false
38+
pluginConfig:
39+
dynamicPlugins:
40+
frontend:
41+
backstage.plugin-kubernetes:
42+
mountPoints: []
43+
- package: ./dynamic-plugins/dist/backstage-plugin-kubernetes-backend-dynamic
44+
disabled: false
45+
----
1046

11-
Backstage CR versions `v1alpha1` and `v1alpha2` are deprecated in 1.7 and will be removed in 1.9
1247

1348

1449
.Additional resources
15-
* link:https://issues.redhat.com/browse/RHIDP-6917[RHIDP-6917]
50+
* link:https://issues.redhat.com/browse/RHIDP-5309[RHIDP-5309]
1651

17-
[id="deprecated-functionality-rhidp-8525"]
18-
== Deprecation of Bundled Plugin Wrappers
52+
[id="deprecated-functionality-rhidp-9180"]
53+
== OCM Plugins are deprecated
1954

20-
To enhance performance, decrease image size, and reduce maintenance, the method of including &#34;wrapped&#34; 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.
55+
The Open Cluster Management (OCM) plugins integrates your {product} instance with the MultiClusterHub and MultiCluster engines of OCM.
56+
The OCM plugins are deprecated as of RHDH 1.8, and will be removed in a future release.
2157

22-
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.
23-
24-
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].
2558

2659
.Additional resources
27-
* link:https://issues.redhat.com/browse/RHIDP-8525[RHIDP-8525]
60+
* link:https://issues.redhat.com/browse/RHIDP-9180[RHIDP-9180]
61+
62+
63+
Lines changed: 33 additions & 101 deletions
Original file line numberDiff line numberDiff line change
@@ -1,153 +1,85 @@
11
:_content-type: REFERENCE
2+
23
[id="fixed-issues"]
34
= Fixed issues
45

56
This section lists issues fixed in {product} {product-version}.
67

7-
== Fixed issues in 1.7.0
8-
9-
[id="bug-fix-rhidp-6536"]
10-
=== Improved keyboard accessibility
11-
12-
In this release, various fixes and improvements have been made to improve the keyboard accessibility in {product}.
13-
14-
15-
.Additional resources
16-
* link:https://issues.redhat.com/browse/RHIDP-6536[RHIDP-6536]
17-
18-
19-
[id="bug-fix-rhdhbugs-249"]
20-
=== Fixed `techdocs-module-addons-contrib` plugin not displayed as preinstalled plugin
21-
22-
Previously, the `techdocs-module-addons-contrib` plugin was not displayed as preinstalled in Extensions. With this update, the plugin is displayed as preinstalled.
23-
24-
25-
.Additional resources
26-
* link:https://issues.redhat.com/browse/RHDHBUGS-249[RHDHBUGS-249]
27-
28-
29-
[id="bug-fix-rhdhbugs-322"]
30-
=== Excessive queries to the `relations` database table from the `rbac-backend` plugin
31-
32-
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 &#39;relations&#39; database table.
33-
34-
35-
.Additional resources
36-
* link:https://issues.redhat.com/browse/RHDHBUGS-322[RHDHBUGS-322]
37-
38-
39-
[id="bug-fix-rhdhbugs-503"]
40-
=== The Operator reverts the number of replicas set automatically by a Horizontal Pod Autoscaler (HPA)
41-
42-
Previously the {product-very-short} Operator enforced `replicas: 1` from its default deployment config, which overrode scaling decisions.
43-
44-
With this update, `replicas: 1` is removed from the default deployment profile and the DB-statefulset manifest.
45-
46-
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.
47-
48-
49-
.Additional resources
50-
* link:https://issues.redhat.com/browse/RHDHBUGS-503[RHDHBUGS-503]
51-
8+
== Fixed issues in 1.8.0
529

53-
[id="bug-fix-rhdhbugs-512"]
54-
=== Improved error messaging for bulk imports
10+
[id="bug-fix-rhdhbugs-1000"]
11+
=== Improved startup speed with updated init container image pull policy for {product-short} Helm Chart
5512

56-
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.
13+
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.
5714

5815

5916
.Additional resources
60-
* link:https://issues.redhat.com/browse/RHDHBUGS-512[RHDHBUGS-512]
17+
* link:https://issues.redhat.com/browse/RHDHBUGS-1000[RHDHBUGS-1000]
6118

6219

63-
[id="bug-fix-rhdhbugs-622"]
64-
=== Excessive authorize requests generated by the RBAC backend API
20+
[id="bug-fix-rhdhbugs-2003"]
21+
=== Customizable image names for job and data index services in {product-short} Helm Chart
6522

66-
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 &#39;user&#39; credentials.
23+
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.
6724

6825

6926
.Additional resources
70-
* link:https://issues.redhat.com/browse/RHDHBUGS-622[RHDHBUGS-622]
27+
* link:https://issues.redhat.com/browse/RHDHBUGS-2003[RHDHBUGS-2003]
7128

7229

73-
[id="bug-fix-rhdhbugs-632"]
74-
=== Custom title not persisting on refresh of visited cards
30+
[id="bug-fix-rhdhbugs-2020"]
31+
=== Network policy installation fix for {product-short} RHDH Helm Chart with Orchestrator flavor
7532

76-
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}_.
77-
78-
With this update, after each refresh, the cards correctly display the custom title defined in the `app.title` configuration.
33+
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.
7934

8035

8136
.Additional resources
82-
* link:https://issues.redhat.com/browse/RHDHBUGS-632[RHDHBUGS-632]
37+
* link:https://issues.redhat.com/browse/RHDHBUGS-2020[RHDHBUGS-2020]
8338

8439

85-
[id="bug-fix-rhdhbugs-834"]
86-
=== Fixed role name updates via API to correctly propagate to permissions, metadata, and conditions
40+
[id="bug-fix-rhdhbugs-2036"]
41+
=== Resolved SonataFlow Pod Crash Issue
8742

88-
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.
89-
With this update, role name changes are now correctly updated.
43+
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.
9044

9145

9246
.Additional resources
93-
* link:https://issues.redhat.com/browse/RHDHBUGS-834[RHDHBUGS-834]
47+
* link:https://issues.redhat.com/browse/RHDHBUGS-2036[RHDHBUGS-2036]
9448

49+
== Fixed issues in 1.7.2
9550

96-
[id="bug-fix-rhdhbugs-903"]
97-
=== Fixed role actions tooltip delay issue
51+
[id="bug-fix-rhdhbugs-2117"]
52+
=== Fixed SCM integration failures for self-hosted enterprise SCM providers
9853

99-
Previously, tooltips on action icons in the Role list table of the Role-Based Access Control (RBAC) page were slow to appear on hover.
54+
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.
10055

101-
This issue has been fixed, ensuring that tooltips now appear immediately when hovering over action icons in the RBAC page.
56+
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.
10257

10358

10459
.Additional resources
105-
* link:https://issues.redhat.com/browse/RHDHBUGS-903[RHDHBUGS-903]
60+
* link:https://issues.redhat.com/browse/RHDHBUGS-2117[RHDHBUGS-2117]
10661

62+
== Fixed issues in 1.7.1
10763

108-
[id="bug-fix-rhdhbugs-1110"]
109-
=== The Extensions catalog does not show an error when the backend plugin is not installed
110-
111-
Previously, if the backend Extensions was not installed, {product-very-short} showed the skeleton &#34;forever&#34; instead of an error message.
64+
[id="bug-fix-rhdhbugs-1878"]
65+
=== Fixed incorrect version detection for local plugin updates
11266

113-
With this update, the UI shows an empty state with a message to enable the backend plugin.
67+
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.
11468

11569

11670
.Additional resources
117-
* link:https://issues.redhat.com/browse/RHDHBUGS-1110[RHDHBUGS-1110]
71+
* link:https://issues.redhat.com/browse/RHDHBUGS-1878[RHDHBUGS-1878]
11872

11973

120-
[id="bug-fix-rhdhbugs-1139"]
121-
=== Fixed Profile dropdown showing Guest instead of user&#39;s name with OIDC authentication
122-
123-
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.
74+
[id="bug-fix-rhdhbugs-2041"]
75+
=== Orchestrator plugin updated to 1.7.1
12476

125-
With this update, the *Profile dropdown* now correctly displays the user&#39;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.
126-
127-
77+
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.
12878

129-
.Additional resources
130-
* link:https://issues.redhat.com/browse/RHDHBUGS-1139[RHDHBUGS-1139]
131-
132-
133-
[id="bug-fix-rhdhbugs-1162"]
134-
=== Excessive filter arguments generated by the RBAC backend `enforcerDelegate.getFilteredPolicy`
135-
136-
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.
137-
138-
139-
.Additional resources
140-
* link:https://issues.redhat.com/browse/RHDHBUGS-1162[RHDHBUGS-1162]
141-
142-
143-
[id="bug-fix-rhdhbugs-1213"]
144-
=== Fixed Jenkins permissions not being displayed in RBAC UI
145-
146-
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.
14779

14880

14981
.Additional resources
150-
* link:https://issues.redhat.com/browse/RHDHBUGS-1213[RHDHBUGS-1213]
82+
* link:https://issues.redhat.com/browse/RHDHBUGS-2041[RHDHBUGS-2041]
15183

15284

15385

modules/release-notes/ref-release-notes-known-issues.adoc

Lines changed: 1 addition & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -5,21 +5,6 @@
55

66
This section lists known issues in {product} {product-version}.
77

8-
[id="known-issue-rhdhbugs-1979"]
9-
== Latest Orchestrator feature set is unavailable
10-
11-
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.
12-
13-
14-
15-
16-
17-
18-
19-
20-
21-
.Additional resources
22-
* link:https://issues.redhat.com/browse/RHDHBUGS-1979[RHDHBUGS-1979]
23-
248

9+
None.
2510

0 commit comments

Comments
 (0)