Merge branch 'release-1.10' into release-1.10

themr0c · web-flow · commit f94d4499ce5c · 2026-06-09T10:41:43.000+02:00
diff --git a/artifacts/snip-tag-for-quay-and-registry-OCI-paths.adoc b/artifacts/snip-tag-for-quay-and-registry-OCI-paths.adoc
@@ -0,0 +1,13 @@
+:_mod-docs-content-type: SNIPPET
+where:
+
+`<tag>`::
+Enter your {product-very-short} version and the plugin version, in the format `pass:c,a,q[<rhdh-version>--<plugin-version>]`.
+To find these versions, complete the following steps: 
+. Locate the plugin version in the {dynamic-plugins-reference-book-link}[Dynamic Plugins Reference guide].
+For example, for {product-very-short} 1.10, use the format `pass:c,a,q[1.10--<plugin-version>]`.
++
+[TIP]
+====
+To ensure environment stability, use a SHA256 digest instead of a version tag.  See {dynamic-plugins-reference-book-link}#troubleshooting[Determining SHA256 Digests].
+====
diff --git a/modules/integrate_accelerating-ai-development-with-openshift-ai-connector-for-rhdh/proc-set-up-with.adoc b/modules/integrate_accelerating-ai-development-with-openshift-ai-connector-for-rhdh/proc-set-up-with.adoc
@@ -168,10 +168,12 @@ The {product-very-short} Pod requires two dynamic plugins.
 ----
 plugins:
   - disabled: false
-    package: oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/red-hat-developer-hub-backstage-plugin-catalog-backend-module-model-catalog:bs_1.49.4__0.9.0
+    package: oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/red-hat-developer-hub-backstage-plugin-catalog-backend-module-model-catalog:<tag>
   - disabled: false
-    package: oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/red-hat-developer-hub-backstage-plugin-catalog-techdoc-url-reader-backend:bs_1.49.4__0.5.0
+    package: oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/red-hat-developer-hub-backstage-plugin-catalog-techdoc-url-reader-backend:<tag>
 ----
++
+include::{docdir}/artifacts/snip-tag-for-OCI-package-paths.adoc[]
 
 . Add the `Connector` sidecar containers to the {product-very-short} Pod.
 +
diff --git a/modules/integrate_interacting-with-model-context-protocol-tools-for-rhdh/proc-install-the-backend-mcp-server-plugin.adoc b/modules/integrate_interacting-with-model-context-protocol-tools-for-rhdh/proc-install-the-backend-mcp-server-plugin.adoc
@@ -17,9 +17,11 @@ To run MCP tools within {product-very-short}, you must add the MCP server plugin
 [source,yaml]
 ----
 plugins:
-    - package: oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/backstage-plugin-mcp-actions-backend:bs_1.49.4__0.1.11!backstage-plugin-mcp-actions-backend
+    - package: oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/backstage-plugin-mcp-actions-backend:<tag>
       disabled: false
 ----
++
+include::{docdir}/artifacts/snip-tag-for-OCI-package-paths.adoc[]
 
 .Verification
 
diff --git a/modules/integrate_interacting-with-model-context-protocol-tools-for-rhdh/proc-install-the-mcp-tool-plugins.adoc b/modules/integrate_interacting-with-model-context-protocol-tools-for-rhdh/proc-install-the-mcp-tool-plugins.adoc
@@ -22,23 +22,29 @@ The previous MCP plugins (`software-catalog-mcp-tool` and `techdocs-mcp-tool`) a
 +
 [source,yaml]
 ----
-  - package: oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/red-hat-developer-hub-backstage-plugin-software-catalog-mcp-extras:bs_1.49.4__0.2.2!red-hat-developer-hub-backstage-plugin-software-catalog-mcp-tool
+  - package: oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/red-hat-developer-hub-backstage-plugin-software-catalog-mcp-extras:<tag>
     disabled: false
 ----
++
+include::{docdir}/artifacts/snip-tag-for-OCI-package-paths.adoc[]
 ** TechDocs MCP extras:
 +
 [source,yaml]
 ----
-- package: oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/red-hat-developer-hub-backstage-plugin-techdocs-mcp-extras:bs_1.49.4__0.2.3!red-hat-developer-hub-backstage-plugin-techdocs-mcp-tool
+- package: oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/red-hat-developer-hub-backstage-plugin-techdocs-mcp-extras:<tag>
   disabled: false
 ----
++
+include::{docdir}/artifacts/snip-tag-for-OCI-package-paths.adoc[]
 ** Scaffolder MCP extras:
 +
 [source,yaml]
 ----
-- package: oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/red-hat-developer-hub-backstage-plugin-scaffolder-mcp-extras:bs_1.49.4__0.4.1!red-hat-developer-hub-backstage-plugin-scaffolder-mcp-tool
+- package: oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/red-hat-developer-hub-backstage-plugin-scaffolder-mcp-extras:<tag>
     disabled: false
 ----
++
+include::{docdir}/artifacts/snip-tag-for-OCI-package-paths.adoc[]
 
 .Verification
 
diff --git a/modules/integrate_interacting-with-model-context-protocol-tools-for-rhdh/proc-verify-successful-installation-of-mcp-plugins.adoc b/modules/integrate_interacting-with-model-context-protocol-tools-for-rhdh/proc-verify-successful-installation-of-mcp-plugins.adoc
@@ -28,16 +28,20 @@ $ oc logs -c install-dynamic-plugins deployment/<my-product-deployment>
 [source]
 ----
 ..... prior logs ....
-======= Installing dynamic plugin oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/backstage-plugin-mcp-actions-backend:bs_1.42.5__0.1.2
-	==> Copying image oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/backstage-plugin-mcp-actions-backend:next__0.2.0 to local filesystem
-	==> Successfully installed dynamic plugin oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/backstage-plugin-mcp-actions-backend:bs_1.42.5__0.1.2
+======= Installing dynamic plugin oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/backstage-plugin-mcp-actions-backend:<tag>
+	==> Copying image oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/backstage-plugin-mcp-actions-backend:<tag> to local filesystem
+	==> Successfully installed dynamic plugin oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/backstage-plugin-mcp-actions-backend:<tag>
 ----
++
+include::{docdir}/artifacts/snip-tag-for-OCI-package-paths.adoc[]
 . You must see entries for any of the MCP tool plugins you installed as shown in the following code:
 +
 [source]
 ----
 ..... prior logs ....
-======= Installing dynamic plugin oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/red-hat-developer-hub-backstage-plugin-software-catalog-mcp-tool:bs_1.42.5__0.2.3
-	==> Copying image oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/red-hat-developer-hub-backstage-plugin-software-catalog-mcp-tool:bs_1.42.5__0.2.3 to local filesystem
-	==> Successfully installed dynamic plugin oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/red-hat-developer-hub-backstage-plugin-software-catalog-mcp-tool:bs_1.42.5__0.2.3
+======= Installing dynamic plugin oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/red-hat-developer-hub-backstage-plugin-software-catalog-mcp-tool:<tag>
+	==> Copying image oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/red-hat-developer-hub-backstage-plugin-software-catalog-mcp-tool:<tag> to local filesystem
+	==> Successfully installed dynamic plugin oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/red-hat-developer-hub-backstage-plugin-software-catalog-mcp-tool:<tag>
 ----
++
+include::{docdir}/artifacts/snip-tag-for-OCI-package-paths.adoc[]
diff --git a/modules/observability_evaluate-project-health-using-scorecards/proc-configure-portfolio-health-on-a-customizable-home-page.adoc b/modules/observability_evaluate-project-health-using-scorecards/proc-configure-portfolio-health-on-a-customizable-home-page.adoc
@@ -61,6 +61,8 @@ plugins:
                 importName: DynamicCustomizableHomePage
 ----
 +
+include::{docdir}/artifacts/snip-tag-for-OCI-package-paths.adoc[]
++
 For more information, see {customizing-book-link}[{customizing-book-title}].
 . Log in to the {product-very-short} application.
 . Enter the *Edit* mode on the home page.
diff --git a/modules/observability_evaluate-project-health-using-scorecards/proc-configure-portfolio-health-on-a-read-only-home-page.adoc b/modules/observability_evaluate-project-health-using-scorecards/proc-configure-portfolio-health-on-a-read-only-home-page.adoc
@@ -72,6 +72,8 @@ plugins:
                 importName: DynamicHomePage
 ----
 +
+include::{docdir}/artifacts/snip-tag-for-OCI-package-paths.adoc[]
++
 [NOTE]
 ====
 The widget automatically calculates and displays aggregations for the entities you own. You do not have to manually configure filters or specify target owner groups in the widget settings.
diff --git a/modules/observability_evaluate-project-health-using-scorecards/proc-enable-scorecards.adoc b/modules/observability_evaluate-project-health-using-scorecards/proc-enable-scorecards.adoc
@@ -35,6 +35,8 @@ plugins:
                   if:
                     allOf:
                       - isKind: component
-  - package: oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/red-hat-developer-hub-backstage-plugin-scorecard-backend:bs_1.49.4__2.7.7
+  - package: oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/red-hat-developer-hub-backstage-plugin-scorecard-backend:<tag>
     disabled: false
-----
+----
++
+include::{docdir}/artifacts/snip-tag-for-OCI-package-paths.adoc[]
diff --git a/modules/observability_evaluate-project-health-using-scorecards/proc-integrate-github-health-metrics-using-scorecards.adoc b/modules/observability_evaluate-project-health-using-scorecards/proc-integrate-github-health-metrics-using-scorecards.adoc
@@ -88,9 +88,11 @@ integrations:
 [source,yaml]
 ----
 plugins:
-  - package: oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/red-hat-developer-hub-backstage-plugin-scorecard-backend-module-github:bs_1.45.3__2.3.5
+  - package: oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/red-hat-developer-hub-backstage-plugin-scorecard-backend-module-github:<tag>
     disabled: false
 ----
++
+include::{docdir}/artifacts/snip-tag-for-OCI-package-paths.adoc[]
 
 . Annotate catalog entities: Link a component to the GitHub data source by editing the `catalog-info.yaml` file for your {product-very-short} entity and adding the required annotations as shown in the following code:
 +
diff --git a/modules/observability_evaluate-project-health-using-scorecards/proc-integrate-jira-health-metrics-using-scorecards.adoc b/modules/observability_evaluate-project-health-using-scorecards/proc-integrate-jira-health-metrics-using-scorecards.adoc
@@ -43,9 +43,11 @@ You must use the proxy setup to ensure configuration compatibility if you also u
 [source,yaml]
 ----
 plugins:
-  - package: oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/red-hat-developer-hub-backstage-plugin-scorecard-backend-module-jira:bs_1.45.3__2.3.5
+  - package: oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/red-hat-developer-hub-backstage-plugin-scorecard-backend-module-jira:<tag>
     disabled: false
 ----
++
+include::{docdir}/artifacts/snip-tag-for-OCI-package-paths.adoc[]
 ... In your {product-very-short} `{my-app-config-file}` file, add the following direct setup settings:
 +
 [source,yaml]
@@ -67,9 +69,11 @@ where:
 [source,yaml]
 ----
 plugins:
-  - package: oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/red-hat-developer-hub-backstage-plugin-scorecard-backend-module-jira:bs_1.45.3__2.3.5
+  - package: oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/red-hat-developer-hub-backstage-plugin-scorecard-backend-module-jira:<tag>
     disabled: false
 ----
++
+include::{docdir}/artifacts/snip-tag-for-OCI-package-paths.adoc[]
 
 ... In your {product-very-short} `{my-app-config-file}` file, add the following proxy settings:
 +
diff --git a/modules/shared/proc-configure-the-github-events-module-plugin.adoc b/modules/shared/proc-configure-the-github-events-module-plugin.adoc
@@ -25,9 +25,11 @@ dynamic-plugins.yaml: |
 includes:
 - dynamic-plugins.default.yaml
 plugins:
-- package: oci://registry.access.redhat.com/rhdh/backstage-plugin-events-backend-module-github@sha256:2c1ccc4fb01883dc4da1aa0c417d6e28d944c6ce941454ee41698f2c1812035c
+- package: oci://registry.access.redhat.com/rhdh/backstage-plugin-events-backend-module-github:<tag>
 disabled: false
 ----
++
+include::{docdir}/artifacts/snip-tag-for-quay-and-registry-OCI-paths.adoc[]
 . To create HTTP endpoints to receive events for the `github`, add the following to your `{my-app-config-file}` file:
 +
 [source,yaml]
diff --git a/modules/shared/proc-enable-kubernetes-custom-actions-plugin-in-rhdh.adoc b/modules/shared/proc-enable-kubernetes-custom-actions-plugin-in-rhdh.adoc
@@ -16,7 +16,7 @@ In {product}, the Kubernetes custom actions are provided as a preinstalled plugi
 [source,yaml,subs="+quotes"]
 ----
 plugins:
-  - package: oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/backstage-community-plugin-scaffolder-backend-module-kubernetes-dynamic:__<tag>__
+  - package: oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/backstage-community-plugin-scaffolder-backend-module-kubernetes:__<tag>__
     disabled: false
 ----
 
diff --git a/modules/shared/proc-enable-the-argo-cd-plugin.adoc b/modules/shared/proc-enable-the-argo-cd-plugin.adoc
@@ -62,6 +62,18 @@ If you do not set this annotation, the Argo CD plugin defaults to the first Argo
 
 . To enable the Argo CD plugin, set the `disabled` property to `false` in your `dynamic-plugins.yaml` file as follows:
 +
+--
+[source,yaml,subs="+quotes"]
+----
+plugins:
+  - package: oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/backstage-community-plugin-argocd-backend:__<tag>__
+    disabled: false
+  - package: oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/backstage-community-plugin-argocd:__<tag>__
+    disabled: false
+----
+
+include::{docdir}/artifacts/snip-tag-for-OCI-package-paths.adoc[]
+
 [IMPORTANT]
 ====
 Argo CD contains multiple plugin options you can choose from for your Argo CD configuration:
@@ -79,23 +91,8 @@ the Community version contains scaffolder actions by default, the Roadie version
 
 The recommended combination is to use `@backstage-community/plugin-argocd` together with `@backstage-community/plugin-argocd-backend`.
 
-However,
-you can also combine `@roadiehq/backstage-plugin-argo-cd` together with `@roadiehq/backstage-plugin-argo-cd-backend`.
+However, you can also combine `@roadiehq/backstage-plugin-argo-cd` together with `@roadiehq/backstage-plugin-argo-cd-backend`.
 
 Mixing Community and Roadie plugins is *not recommended*.
 ====
-+
-[source,yaml,subs="+quotes"]
-----
-global:
-  dynamic:
-    includes:
-      - dynamic-plugins.default.yaml
-    plugins:
-      - package: oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/backstage-community-plugin-argocd-backend:__<tag>__
-        disabled: false
-      - package: oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/backstage-community-plugin-argocd:__<tag>__
-        disabled: false
-----
-
-include::{docdir}/artifacts/snip-tag-for-OCI-package-paths.adoc[]
+--
diff --git a/modules/shared/proc-enable-the-keycloak-plugin.adoc b/modules/shared/proc-enable-the-keycloak-plugin.adoc
@@ -26,7 +26,7 @@ Enable the Keycloak plugin to synchronize users and groups from your {rhbk-brand
 [source,yaml,subs="+quotes"]
 ----
 plugins:
-  - package: oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/backstage-community-plugin-catalog-backend-module-keycloak-dynamic:__<tag>__
+  - package: oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/backstage-community-plugin-catalog-backend-module-keycloak:__<tag>__
     disabled: false
 ----
 
diff --git a/modules/shared/proc-install-the-topology-plugin.adoc b/modules/shared/proc-install-the-topology-plugin.adoc
@@ -19,15 +19,13 @@ If you have the {product-short} Kubernetes plugin configured, then the `ClusterR
 * The Topology plugin is pre-loaded in {product-short} with basic configuration properties.
 To enable it, set the disabled property to false as follows:
 +
+--
 .`{my-app-config-file}` fragment
 [source,yaml]
 ----
-auth:
-global:
-  dynamic:
-    includes:
-      - dynamic-plugins.default.yaml
-    plugins:
-      - package: ./dynamic-plugins/dist/backstage-community-plugin-topology
-        disabled: false
+plugins:
+  - package: oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/backstage-community-plugin-topology:<tag>
+    disabled: false
 ----
+include::{docdir}/artifacts/snip-tag-for-OCI-package-paths.adoc[]
+--
diff --git a/modules/shared/proc-mirror-plugins-from-a-file.adoc b/modules/shared/proc-mirror-plugins-from-a-file.adoc
@@ -13,10 +13,12 @@ Example `plugins.txt` file:
 +
 [source,text]
 ----
-oci://quay.io/rhdh-plugin-catalog/backstage-community-plugin-quay:1.8.0--1.22.1
-oci://quay.io/rhdh-plugin-catalog/backstage-community-plugin-github-actions:1.8.0--0.11.1
-oci://quay.io/rhdh-plugin-catalog/backstage-community-plugin-azure-devops:1.8.0--0.8.2
+oci://quay.io/rhdh-plugin-catalog/backstage-community-plugin-quay:<tag>
+oci://quay.io/rhdh-plugin-catalog/backstage-community-plugin-github-actions:<tag>
+oci://quay.io/rhdh-plugin-catalog/backstage-community-plugin-azure-devops:<tag>
 ----
++
+include::{docdir}/artifacts/snip-tag-for-quay-and-registry-OCI-paths.adoc[]
 . Download the mirroring script:
 +
 [source,terminal,subs="+quotes,+attributes"]
diff --git a/modules/shared/proc-mirror-specific-plugins-by-direct-reference.adoc b/modules/shared/proc-mirror-specific-plugins-by-direct-reference.adoc
@@ -20,9 +20,11 @@ For example:
 [source,terminal,subs="+quotes,+attributes"]
 ----
 bash mirror-plugins.sh \
-    --plugins oci://quay.io/rhdh-plugin-catalog/backstage-community-plugin-quay:1.8.0--1.22.1 \
-              oci://quay.io/rhdh-plugin-catalog/backstage-community-plugin-github-actions:1.8.0--0.11.1 \
+    --plugins oci://quay.io/rhdh-plugin-catalog/backstage-community-plugin-quay:<tag> \
+              oci://quay.io/rhdh-plugin-catalog/backstage-community-plugin-github-actions:<tag> \
     --to-registry _<my.registry.example.com>_
 ----
++
+include::{docdir}/artifacts/snip-tag-for-quay-and-registry-OCI-paths.adoc[]
 where:
 `--to-registry _<my.registry.example.com>_`:: Enter the URL for the target mirror registry where you want to mirror the catalog index.

Original file line number	Diff line number	Diff line change
`@@ -61,6 +61,8 @@ plugins:`
`61`	`61`	`importName: DynamicCustomizableHomePage`
`62`	`62`	`----`
`63`	`63`	`+`
	`64`	`+include::{docdir}/artifacts/snip-tag-for-OCI-package-paths.adoc[]`
	`65`	`++`
`64`	`66`	`For more information, see {customizing-book-link}[{customizing-book-title}].`
`65`	`67`	`. Log in to the {product-very-short} application.`
`66`	`68`	`. Enter the Edit mode on the home page.`
Original file line number	Diff line number	Diff line change
`@@ -72,6 +72,8 @@ plugins:`
`72`	`72`	`importName: DynamicHomePage`
`73`	`73`	`----`
`74`	`74`	`+`
	`75`	`+include::{docdir}/artifacts/snip-tag-for-OCI-package-paths.adoc[]`
	`76`	`++`
`75`	`77`	`[NOTE]`
`76`	`78`	`====`
`77`	`79`	`The widget automatically calculates and displays aggregations for the entities you own. You do not have to manually configure filters or specify target owner groups in the widget settings.`