Skip to content

Commit

Permalink
regenerate release notes from jira query using ./modules/release-note…
Browse files Browse the repository at this point in the history
…s/single-source-release-notes.py

Signed-off-by: Nick Boldt <[email protected]>
  • Loading branch information
nickboldt committed Jan 23, 2025
1 parent f9b32a7 commit 6bc66e9
Show file tree
Hide file tree
Showing 4 changed files with 100 additions and 95 deletions.
144 changes: 72 additions & 72 deletions modules/release-notes/ref-release-notes-breaking-changes.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -16,78 +16,78 @@ Prom-client metrics have been removed and replaced with OpenTelemetry metrics. A
[id="removed-functionality-rhidp-4853"]
== Plugins with updated scope

To upgrade from {product-very-short} 1.3 to 1.4, you must update your configuration to use the latest versions of the following plugins from the new scope.

With this update, the following plugins, previously under the `@janus-idp` scope, have now been moved to the `@backstage-community` scope:

[cols=2,%header]
|===
| *RHDH 1.3 Plugin Name*
| *RHDH 1.4 Plugin Name*
|`@janus-idp/backstage-plugin-acr`|`@backstage-community/plugin-acr`
|`@janus-idp/backstage-plugin-acr`|`@backstage-community/plugin-acr`
|`@janus-idp/backstage-plugin-analytics-provider-segment`|`@backstage-community/plugin-analytics-provider-segment`
|`@janus-idp/backstage-plugin-jfrog-artifactory`|`@backstage-community/plugin-jfrog-artifactory`
|`@janus-idp/backstage-plugin-keycloak-backend`|`@backstage-community/plugin-catalog-backend-module-keycloak`
|`@janus-idp/backstage-plugin-nexus-repository-manager`|`@backstage-community/plugin-nexus-repository-manager`
|`@janus-idp/backstage-plugin-ocm`|`@backstage-community/plugin-ocm`
|`@janus-idp/backstage-plugin-ocm-backend`|`@backstage-community/plugin-ocm-backend`
|`@janus-idp/backstage-plugin-quay`|`@backstage-community/plugin-quay`
|`@janus-idp/backstage-plugin-rbac`|`@backstage-community/plugin-rbac`
|`@janus-idp/backstage-plugin-tekton`|`@backstage-community/plugin-tekton`
|`@janus-idp/backstage-plugin-topology`|`@backstage-community/plugin-topology`
|`@janus-idp/backstage-scaffolder-backend-module-quay`|`@backstage-community/plugin-scaffolder-backend-module-quay`
|`@janus-idp/backstage-scaffolder-backend-module-regex`|`@backstage-community/plugin-scaffolder-backend-module-regex`
|`@janus-idp/backstage-scaffolder-backend-module-servicenow`|`@backstage-community/plugin-scaffolder-backend-module-servicenow`
|`@janus-idp/backstage-scaffolder-backend-module-sonarqube`|`@backstage-community/plugin-scaffolder-backend-module-sonarqube`
|===

The following plugins, previously under the `@backstage` scope, have now been moved to the `@backstage-community` scope:
[cols=2,%header]
|===
| *RHDH 1.3 Plugin Name*
| *RHDH 1.4 Plugin Name*
|`@backstage/plugin-azure-devops`|`@backstage-community/plugin-azure-devops`
|`@backstage/plugin-azure-devops-backend`|`@backstage-community/plugin-azure-devops-backend`
|`@backstage/plugin-dynatrace`|`@backstage-community/plugin-dynatrace`
|`@backstage/plugin-github-actions`|`@backstage-community/plugin-github-actions`
|`@backstage/plugin-github-issues`|`@backstage-community/plugin-github-issues`
|`@backstage/plugin-jenkins`|`@backstage-community/plugin-jenkins`
|`@backstage/plugin-jenkins-backend`|`@backstage-community/plugin-jenkins-backend`
|`@backstage/plugin-lighthouse`|`@backstage-community/plugin-lighthouse`
|`@backstage/plugin-sonarqube`|`@backstage-community/plugin-sonarqube`
|`@backstage/plugin-sonarqube-backend`|`@backstage-community/plugin-sonarqube-backend`
|`@backstage/plugin-tech-radar`|`@backstage-community/plugin-tech-radar`
|===

Two plugins previously under the `@janus-idp` scope have moved to `@red-hat-developer-hub` scope:

[cols=2,%header]
|===
| *RHDH 1.3 Plugin Name*
| *RHDH 1.4 Plugin Name*

| `@janus-idp/backstage-plugin-bulk-import`
| `@red-hat-developer-hub/backstage-plugin-bulk-import`

| `@janus-idp/backstage-plugin-bulk-import-backend`
| `@red-hat-developer-hub/backstage-plugin-bulk-import-backend`
|===

With the update to the plugin scope, the dynamic plugin configuration has also been modified.

[cols=2,%header]
|===
|*RHDH 1.3 Configuration*|*RHDH 1.4 Configuration*
|link:https://github.com/janus-idp/backstage-showcase/blob/release-1.3/dynamic-plugins.default.yaml[dynamic-plugins.default.yaml]|link:https://github.com/janus-idp/backstage-showcase/blob/release-1.4/dynamic-plugins.default.yaml[dynamic-plugins.default.yaml]
|===

.Procedure
* To upgrade from {product-very-short} 1.3 to {product-very-short} 1.4, you must update your configuration to use the latest versions of the plugins listed previously from the new scope.

[NOTE]
====
In addition to the previously provided tables, you can compare the link:https://github.com/redhat-developer/red-hat-developers-documentation-rhdh/blob/release-1.4/modules/dynamic-plugins/rhdh-supported-plugins.csv[RHDH 1.4 CSV file] with the link:https://github.com/redhat-developer/red-hat-developers-documentation-rhdh/blob/release-1.3/modules/dynamic-plugins/rhdh-supported-plugins.csv[RHDH 1.3 CSV file] to identify the changes in dynamic plugins.
To upgrade from {product-very-short} 1.3 to 1.4, you must update your configuration to use the latest versions of the following plugins from the new scope.

With this update, the following plugins, previously under the `@janus-idp` scope, have now been moved to the `@backstage-community` scope:

[cols=2,%header]
|===
| *RHDH 1.3 Plugin Name*
| *RHDH 1.4 Plugin Name*
|`@janus-idp/backstage-plugin-acr`|`@backstage-community/plugin-acr`
|`@janus-idp/backstage-plugin-acr`|`@backstage-community/plugin-acr`
|`@janus-idp/backstage-plugin-analytics-provider-segment`|`@backstage-community/plugin-analytics-provider-segment`
|`@janus-idp/backstage-plugin-jfrog-artifactory`|`@backstage-community/plugin-jfrog-artifactory`
|`@janus-idp/backstage-plugin-keycloak-backend`|`@backstage-community/plugin-catalog-backend-module-keycloak`
|`@janus-idp/backstage-plugin-nexus-repository-manager`|`@backstage-community/plugin-nexus-repository-manager`
|`@janus-idp/backstage-plugin-ocm`|`@backstage-community/plugin-ocm`
|`@janus-idp/backstage-plugin-ocm-backend`|`@backstage-community/plugin-ocm-backend`
|`@janus-idp/backstage-plugin-quay`|`@backstage-community/plugin-quay`
|`@janus-idp/backstage-plugin-rbac`|`@backstage-community/plugin-rbac`
|`@janus-idp/backstage-plugin-tekton`|`@backstage-community/plugin-tekton`
|`@janus-idp/backstage-plugin-topology`|`@backstage-community/plugin-topology`
|`@janus-idp/backstage-scaffolder-backend-module-quay`|`@backstage-community/plugin-scaffolder-backend-module-quay`
|`@janus-idp/backstage-scaffolder-backend-module-regex`|`@backstage-community/plugin-scaffolder-backend-module-regex`
|`@janus-idp/backstage-scaffolder-backend-module-servicenow`|`@backstage-community/plugin-scaffolder-backend-module-servicenow`
|`@janus-idp/backstage-scaffolder-backend-module-sonarqube`|`@backstage-community/plugin-scaffolder-backend-module-sonarqube`
|===

The following plugins, previously under the `@backstage` scope, have now been moved to the `@backstage-community` scope:
[cols=2,%header]
|===
| *RHDH 1.3 Plugin Name*
| *RHDH 1.4 Plugin Name*
|`@backstage/plugin-azure-devops`|`@backstage-community/plugin-azure-devops`
|`@backstage/plugin-azure-devops-backend`|`@backstage-community/plugin-azure-devops-backend`
|`@backstage/plugin-dynatrace`|`@backstage-community/plugin-dynatrace`
|`@backstage/plugin-github-actions`|`@backstage-community/plugin-github-actions`
|`@backstage/plugin-github-issues`|`@backstage-community/plugin-github-issues`
|`@backstage/plugin-jenkins`|`@backstage-community/plugin-jenkins`
|`@backstage/plugin-jenkins-backend`|`@backstage-community/plugin-jenkins-backend`
|`@backstage/plugin-lighthouse`|`@backstage-community/plugin-lighthouse`
|`@backstage/plugin-sonarqube`|`@backstage-community/plugin-sonarqube`
|`@backstage/plugin-sonarqube-backend`|`@backstage-community/plugin-sonarqube-backend`
|`@backstage/plugin-tech-radar`|`@backstage-community/plugin-tech-radar`
|===

Two plugins previously under the `@janus-idp` scope have moved to `@red-hat-developer-hub` scope:

[cols=2,%header]
|===
| *RHDH 1.3 Plugin Name*
| *RHDH 1.4 Plugin Name*

| `@janus-idp/backstage-plugin-bulk-import`
| `@red-hat-developer-hub/backstage-plugin-bulk-import`

| `@janus-idp/backstage-plugin-bulk-import-backend`
| `@red-hat-developer-hub/backstage-plugin-bulk-import-backend`
|===

With the update to the plugin scope, the dynamic plugin configuration has also been modified.

[cols=2,%header]
|===
|*RHDH 1.3 Configuration*|*RHDH 1.4 Configuration*
|link:https://github.com/janus-idp/backstage-showcase/blob/release-1.3/dynamic-plugins.default.yaml[dynamic-plugins.default.yaml]|link:https://github.com/janus-idp/backstage-showcase/blob/release-1.4/dynamic-plugins.default.yaml[dynamic-plugins.default.yaml]
|===

.Procedure
* To upgrade from {product-very-short} 1.3 to {product-very-short} 1.4, you must update your configuration to use the latest versions of the plugins listed previously from the new scope.

[NOTE]
====
In addition to the previously provided tables, you can compare the link:https://github.com/redhat-developer/red-hat-developers-documentation-rhdh/blob/release-1.4/modules/dynamic-plugins/rhdh-supported-plugins.csv[RHDH 1.4 CSV file] with the link:https://github.com/redhat-developer/red-hat-developers-documentation-rhdh/blob/release-1.3/modules/dynamic-plugins/rhdh-supported-plugins.csv[RHDH 1.3 CSV file] to identify the changes in dynamic plugins.
====


Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ The `./dynamic-plugins/dist/janus-idp-backstage-plugin-aap-backend-dynamic` plug
[id="deprecated-functionality-rhidp-4913"]
== Audit log rotation is deprecated

With this update, you can evaluate your platform's log forwarding solutions to align with your security and compliance needs. Most of these solutions offer configurable options to minimize the loss of logs in the event of an outage.
With this update, you can evaluate your platform&#39;s log forwarding solutions to align with your security and compliance needs. Most of these solutions offer configurable options to minimize the loss of logs in the event of an outage.


.Additional resources
Expand Down
14 changes: 9 additions & 5 deletions modules/release-notes/ref-release-notes-known-issues.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,10 @@ This section lists known issues in {product} {product-version}.

Currently, when deploying {product-short} using the Helm Chart, two replicas cannot run on different cluster nodes. This might also affect the upgrade from 1.3 to 1.4.0 if the new pod is scheduled on a different node.

A possible workaround for the upgrade is to manually scale down the number of replicas to 0 before upgrading your Helm release. Or manually remove the old {product-short} pod after upgrading the Helm release. However, this would imply some application downtime. You can also leverage a Pod Affinity rule to force the cluster scheduler to run your {product-short} pods on the same node.
Possible workarounds for the upgrade include the following actions:
* Manually scale down the number of replicas to 0 before upgrading your Helm release.
* Manually remove the old {product-short} pod after upgrading the Helm release. However, this would imply some application downtime.
* Leverage a Pod Affinity rule to force the cluster scheduler to run your {product-short} pods on the same node.


.Additional resources
Expand All @@ -18,11 +21,12 @@ A possible workaround for the upgrade is to manually scale down the number of re
[id="known-issue-rhidp-5342"]
== [Helm] Cannot run two RHDH replicas on different nodes due to Multi-Attach errors on the dynamic plugins root PVC

If you are deploying {product-short} using the Helm Chart, it is currently impossible to have 2 replicas running on different cluster nodes. This might also affect the upgrade from 1.3 to 1.4.0 if the new pod is scheduled on a different node.
Currently, when deploying {product-short} using the Helm Chart, two replicas cannot run on different cluster nodes. This might also affect the upgrade from 1.3 to 1.4.0 if the new pod is scheduled on a different node.

A possible workaround for the upgrade is to manually scale down the number of replicas to 0 before upgrading your Helm release. Or manually remove the old {product-short} pod after upgrading the Helm release. However, this would imply some application downtime.
You can also leverage a Pod Affinity rule to force the cluster scheduler to run your {product-short} pods on the same node.

Possible workarounds for the upgrade include the following actions:
* Manually scale down the number of replicas to 0 before upgrading your Helm release.
* Manually remove the old {product-short} pod after upgrading the Helm release. However, this would imply some application downtime.
* Leverage a Pod Affinity rule to force the cluster scheduler to run your {product-short} pods on the same node.


.Additional resources
Expand Down
35 changes: 18 additions & 17 deletions modules/release-notes/ref-release-notes-new-features.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ This section highlights new features in {product} {product-version}.
[id="enhancement-rhidp-2200"]
== Added an individual `mountPath`

This update adds an individual `mountPath` for link:{configuring-book-url}#proc-mounting-additional-files-in-your-custom-configuration-using-rhdh-operator[extra ConfigMaps or Secrets].
This update adds an additional individual `mountPath` for extra configmaps or secrets.

[id="feature-rhidp-3621"]
== `PersistentVolumeClaims` support is available
Expand All @@ -27,25 +27,26 @@ This update removes the `kube-rbac-proxy` sidecar container from the RHDH Operat
[id="feature-rhidp-4414"]
== Identifying Backstage flavor for plugins by using the `developerHub.flavor` field

With this update, you can use the `developerHub.flavor` field to identify whether plugins are running on {product-very-short}, {rhtap-very-short}, or vanilla Backstage, as shown in the following example:

.`app-config.yaml` fragment with the `developerhub.flavor` field

[source,yaml,subs="+quotes"]
----
developerHub:
flavor: <flavor>
----

`flavor`::
Identify the flavor of Backstage that is running. Default value: `rhdh`
With this update, you can use the `developerHub.flavor` field to identify whether plugins are running on {product-very-short}, {rhtap-very-short}, or vanilla Backstage, as shown in the following example:

.`app-config.yaml` fragment with the `developerhub.flavor` field

[source,yaml,subs=&#34;quotes&#34;]
----
developerHub:
flavor: &lt;flavor&gt;;
----

`flavor`::
Identify the flavor of Backstage that is running. Default value: `rhdh`


[id="feature-rhidp-4419"]
== Ability to manage Persistent Volume Claim (PVCs) in {product-very-short} Operator

You can now mount directories from pre-created PersistentVolumeClaims (PVCs) using the `spec.application.extraFiles.pvcs` field, while configuring RHDH Operator.
For more information, see link:https://docs.redhat.com/en/documentation/red_hat_developer_hub/{product-version}/html-single/configuring/index#configuring-the-deployment[Configuring {product} deployment when using the Operator].
You can now mount directories from pre-created PersistentVolumeClaims (PVCs) using the `spec.application.extraFiles.pvcs` field, while configuring RHDH Operator.
For more information, see link:https://docs.redhat.com/en/documentation/red_hat_developer_hub/1.4/html-single/configuring/index#configuring-the-deployment[Persistent Volume Claim (PVC)].


[id="feature-rhidp-4805"]
== Authenticating with {rhbk-brand-name}
Expand All @@ -55,8 +56,8 @@ With this update, you can use {rhbk-brand-name} as an authentication provider. T
[id="feature-rhidp-4806"]
== Ability to install third-party plugins in {product-very-short}

You can now install third-party plugins in {product} without rebuilding the {product-very-short} application.

You can now install third-party plugins in {product} without rebuilding the {product-very-short} application.

For more information, see link:https://docs.redhat.com/en/documentation/red_hat_developer_hub/{product-version}/html-single/installing_and_viewing_plugins_in_red_hat_developer_hub/index#assembly-install-third-party-plugins-rhdh[Installing third-party plugins in {product}].

[id="feature-rhidp-5156"]
Expand Down

0 comments on commit 6bc66e9

Please sign in to comment.