From 890bff14ee4d32f5fbffe90aa647696bf71991f7 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Fabrice=20Flore-Th=C3=A9bault?= Date: Fri, 7 Mar 2025 16:10:09 +0100 Subject: [PATCH 01/25] RHIDP-5409 update book links MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Fabrice Flore-Thébault --- artifacts/attributes.adoc | 98 +++++++++---------- .../argocd/argocd-plugin-admin.adoc | 8 +- .../argocd/argocd-plugin-readme.adoc | 4 +- .../argocd/argocd-plugin-user.adoc | 4 +- assemblies/assembly-configuring-techdocs.adoc | 2 +- ...embly-rhdh-installing-dynamic-plugins.adoc | 4 +- ...c-enabling-authentication-with-github.adoc | 2 +- ...g-authentication-with-microsoft-azure.adoc | 2 +- ...roc-enabling-authentication-with-rhbk.adoc | 2 +- .../proc-enabling-the-rbac-plugin.adoc | 2 +- ...rovisioning-your-custom-configuration.adoc | 2 +- .../proc-customize-rhdh-tech-radar-page.adoc | 14 +-- .../ref-rh-compatible-plugins.adoc | 8 +- ...g-the-bulk-import-from-github-feature.adoc | 2 +- 14 files changed, 74 insertions(+), 80 deletions(-) diff --git a/artifacts/attributes.adoc b/artifacts/attributes.adoc index db23e741df..64a9378f6a 100644 --- a/artifacts/attributes.adoc +++ b/artifacts/attributes.adoc @@ -85,75 +85,69 @@ :gcp-brand-name: Google Cloud Platform :gcp-short: GCP -// Release Notes -:rn-product-title: Release notes for Red Hat Developer Hub - -// Red Hat Developer Hub administration guide -:ag-product-title: Administration guide for Red Hat Developer Hub - -// Red Hat Developer Hub getting started guide -:gs-product-title: Getting started with Red Hat Developer Hub - -// Backstage Plugins for Red Hat Developer Hub -//:bs-product-title: Backstage Plugins for Red Hat Developer Hub - -// User Guide -:ug-product-title: Red Hat Developer Hub User Guide // Links -:LinkPluginsGuide: https://access.redhat.com/documentation/en-us/red_hat_developer_hub/{product-version}/html-single/configuring_plugins_in_red_hat_developer_hub/index -:NameOfPluginsGuide: Configuring plugins in {product} - -:release-notes-url: https://docs.redhat.com/en/documentation/red_hat_developer_hub/{product-version}/html-single/release_notes/index -:release-notes-title: Release notes - -:installing-and-viewing-dynamic-plugins-url: https://docs.redhat.com/en/documentation/red_hat_developer_hub/{product-version}/html-single/installing_and_viewing_dynamic_plugins/index -:installing-and-viewing-dynamic-plugins-title: Installing and viewing dynamic plugins - -:authentication-book-url: https://docs.redhat.com/documentation/en-us/red_hat_developer_hub/{product-version}/html-single/authentication/index -:authentication-book-title: Authentication - -:authorization-book-url: https://docs.redhat.com/documentation/en-us/red_hat_developer_hub/{product-version}/html-single/authorization/index -:authorization-book-title: Authorization - -:configuring-book-url: https://docs.redhat.com/documentation/en-us/red_hat_developer_hub/{product-version}/html-single/configuring/index -:configuring-book-title: Configuring +:discover-category-url: https://docs.redhat.com/en/documentation/red_hat_developer_hub/{product-version}/#Discover +:about-book-url: https://docs.redhat.com/en/documentation/red_hat_developer_hub/{product-version}/html-single/about_red_hat_developer_hub/index +:about-book-title: About {product} -:customizing-book-url: https://docs.redhat.com/documentation/en-us/red_hat_developer_hub/{product-version}/html-single/customizing/index -:customizing-book-title: Customizing +:release-notes-category-url: https://docs.redhat.com/en/documentation/red_hat_developer_hub/{product-version}/#Release Notes +:release-notes-book-url: https://docs.redhat.com/en/documentation/red_hat_developer_hub/{product-version}/html-single/red_hat_developer_hub_release_notes/index +:release-notes-book-title: {product} release notes -:installing-on-osd-on-gcp-book-url: https://docs.redhat.com/en/documentation/red_hat_developer_hub/{product-version}/html-single/installing_red_hat_developer_hub_on_openshift_dedicated_on_google_cloud_platform/index -:installing-on-osd-on-gcp-book-title: Installing {product} on {gcp-brand-name} on {gcp-brand-name} - -:installing-on-ocp-book-url: https://docs.redhat.com/en/documentation/red_hat_developer_hub/{product-version}/html-single/installing_red_hat_developer_hub_on_openshift_container_platform/index +:install-category-url: https://docs.redhat.com/en/documentation/red_hat_developer_hub/{product-version}/#Install :installing-on-ocp-book-title: Installing {product} on {ocp-short} - -:installing-on-gke-book-url: https://docs.redhat.com/en/documentation/red_hat_developer_hub/{product-version}/html-single/installing_red_hat_developer_hub_on_google_kubernetes_engine/index -:installing-on-gke-book-title: Installing {product} on {gke-brand-name} - -:installing-on-eks-book-url: https://docs.redhat.com/en/documentation/red_hat_developer_hub/{product-version}/html-single/installing_red_hat_developer_hub_on_amazon_elastic_kubernetes_service/index +:installing-on-ocp-book-url: https://docs.redhat.com/en/documentation/red_hat_developer_hub/{product-version}/html-single/installing_red_hat_developer_hub_on_openshift_container_platform/index :installing-on-eks-book-title: Installing {product} on {eks-brand-name} - -:installing-on-aks-book-url: https://docs.redhat.com/en/documentation/red_hat_developer_hub/{product-version}/html-single/installing_red_hat_developer_hub_on_microsoft_azure_kubernetes_service/index +:installing-on-eks-book-url: https://docs.redhat.com/en/documentation/red_hat_developer_hub/{product-version}/html-single/installing_red_hat_developer_hub_on_amazon_elastic_kubernetes_service/index :installing-on-aks-book-title: Installing {product} on {aks-brand-name} - -:installing-in-air-gap-book-url: https://docs.redhat.com/en/documentation/red_hat_developer_hub/{product-version}/html-single/installing_red_hat_developer_hub_in_an_air-gapped_environment/index +:installing-on-aks-book-url: https://docs.redhat.com/en/documentation/red_hat_developer_hub/{product-version}/html-single/installing_red_hat_developer_hub_on_microsoft_azure_kubernetes_service/index +:installing-on-osd-on-gcp-book-title: Installing {product} on {gcp-brand-name} on {gcp-brand-name} +:installing-on-osd-on-gcp-book-url: https://docs.redhat.com/en/documentation/red_hat_developer_hub/{product-version}/html-single/installing_red_hat_developer_hub_on_openshift_dedicated_on_google_cloud_platform/index +:installing-on-gke-book-title: Installing {product} on {gke-brand-name} +:installing-on-gke-book-url: https://docs.redhat.com/en/documentation/red_hat_developer_hub/{product-version}/html-single/installing_red_hat_developer_hub_on_google_kubernetes_engine/index :installing-in-air-gap-book-title: Installing {product} in an air-gapped environment +:installing-in-air-gap-book-url: https://docs.redhat.com/en/documentation/red_hat_developer_hub/{product-version}/html-single/installing_red_hat_developer_hub_in_an_air-gapped_environment/index +:upgrade-category-url: https://docs.redhat.com/en/documentation/red_hat_developer_hub/{product-version}/#Upgrade :upgrading-book-url: https://docs.redhat.com/en/documentation/red_hat_developer_hub/{product-version}/html-single/upgrading_red_hat_developer_hub/index :upgrading-book-title: Upgrading {product} +:configure-category-url: https://docs.redhat.com/en/documentation/red_hat_developer_hub/{product-version}/#Configure +:configuring-book-url: https://docs.redhat.com/documentation/en-us/red_hat_developer_hub/{product-version}/html-single/configuring_red_hat_developer_hub/index +:configuring-book-title: Configuring {product} +:customizing-book-url: https://docs.redhat.com/documentation/en-us/red_hat_developer_hub/{product-version}/html-single/customizing_red_hat_developer_hub/index +:customizing-book-title: Customizing {product} +:techdocs-book-url: https://docs.redhat.com/documentation/en-us/red_hat_developer_hub/{product-version}/html-single/techdocs_for_red_hat_developer_hub/index +:techdocs-book-title: TechDocs for {product} + +:control-access-category-url: https://docs.redhat.com/en/documentation/red_hat_developer_hub/{product-version}/#Control access +:authentication-book-url: https://docs.redhat.com/documentation/en-us/red_hat_developer_hub/{product-version}/html-single/authentication_in_red_hat_developer_hub/index +:authentication-book-title: Authentication in {product} +:authorization-book-url: https://docs.redhat.com/documentation/en-us/red_hat_developer_hub/{product-version}/html-single/authorization_in_red_hat_developer_hub/index +:authorization-book-title: Authorization in {product} + +:observability-category-url: https://docs.redhat.com/en/documentation/red_hat_developer_hub/{product-version}/#Observability +:audit-log-book-url: https://docs.redhat.com/en/documentation/red_hat_developer_hub/{product-version}/html-single/audit_logs_in_red_hat_developer_hub/index +:audit-log-book-title: Audit logs in {product} +:monitoring-and-logging-book-url: https://docs.redhat.com/en/documentation/red_hat_developer_hub/{product-version}/html-single/monitoring_and_logging/index +:monitoring-and-logging-book-title: Monitoring and logging :telemetry-data-collection-book-url: https://docs.redhat.com/en/documentation/red_hat_developer_hub/{product-version}/html-single/telemetry_data_collection/index :telemetry-data-collection-book-title: Telemetry data collection -:audit-log-book-url: https://docs.redhat.com/en/documentation/red_hat_developer_hub/{product-version}/html-single/audit_log/index -:audit-log-book-title: Audit log +:extend-category-url: https://docs.redhat.com/en/documentation/red_hat_developer_hub/{product-version}/#Extend +:introduction-to-plugins-book-url: https://docs.redhat.com/en/documentation/red_hat_developer_hub/{product-version}/html-single/introduction_to_plugins/index +:introduction-to-plugins-book-title: Introduction to plugins +:configuring-dynamic-plugins-book-url: https://docs.redhat.com/en/documentation/red_hat_developer_hub/{product-version}/html-single/introduction_to_plugins/index +:configuring-dynamic-plugins-book-title: Configuring dynamic plugins +:installing-and-viewing-plugins-book-url: https://docs.redhat.com/en/documentation/red_hat_developer_hub/{product-version}/html-single/installing_and_viewing_plugins_in_red_hat_developer_hub/index +:installing-and-viewing-plugins-book-title: Installing and viewing plugins in {product} +:using-dynamic-plugins-book-url: https://docs.redhat.com/en/documentation/red_hat_developer_hub/{product-version}/html-single/installing_and_viewing_plugins_in_red_hat_developer_hub/index +:using-dynamic-plugins-book-title: Using dynamic plugins +:dynamic-plugins-reference-book-url: https://docs.redhat.com/en/documentation/red_hat_developer_hub/{product-version}/html-single/dynamic_plugins_reference/index +:dynamic-plugins-reference-book-title: Dynamic plugins reference -:monitoring-and-logging-book-url: https://docs.redhat.com/en/documentation/red_hat_developer_hub/{product-version}/html-single/monitoring_and_logging/index -:monitoring-and-logging-book-title: Monitoring and logging -:plugins-configure-book-url: https://docs.redhat.com/en/documentation/red_hat_developer_hub/{product-version}/html-single/configuring_dynamic_plugins/index -:plugins-configure-book-title: Configuring dynamic plugins diff --git a/artifacts/rhdh-plugins-reference/argocd/argocd-plugin-admin.adoc b/artifacts/rhdh-plugins-reference/argocd/argocd-plugin-admin.adoc index e4afe5f108..7415d895c4 100644 --- a/artifacts/rhdh-plugins-reference/argocd/argocd-plugin-admin.adoc +++ b/artifacts/rhdh-plugins-reference/argocd/argocd-plugin-admin.adoc @@ -32,7 +32,7 @@ annotations: ... # The label that Argo CD uses to fetch all the applications. The format to be used is label.key=label.value. For example, rht-gitops.com/janus-argocd=quarkus-app. - argocd/app-selector: '${ARGOCD_LABEL_SELECTOR}' + argocd/app-selector: '${ARGOCD_LABEL_SELECTOR}' ---- * (Optional) Add the following annotation to the entity’s `catalog-info.yaml` file to switch between Argo CD instances as shown in the following example: @@ -44,7 +44,7 @@ annotations: ... # The Argo CD instance name used in `app-config.yaml`. - argocd/instance-name: '${ARGOCD_INSTANCE}' + argocd/instance-name: '${ARGOCD_INSTANCE}' ---- + @@ -226,6 +226,6 @@ If using the label selector annotation (backstage.io/kubernetes-label-selector), [role="_additional-resources"] .Additional resources -* The package path, scope, and name of the {company-name} ArgoCD plugin has changed since 1.2. For more information, see link:{release-notes-url}#removed-functionality-rhidp-4293[Breaking Changes] in the _{rn-product-title}_. +* The package path, scope, and name of the {company-name} ArgoCD plugin has changed since 1.2. For more information, see link:{release-notes-book-url}#removed-functionality-rhidp-4293[Breaking Changes] in the _{rn-product-title}_. -* For more information on installing dynamic plugins, see link:{installing-and-viewing-dynamic-plugins-url}[{installing-and-viewing-dynamic-plugins-title}]. +* For more information on installing dynamic plugins, see link:{installing-and-viewing-plugins-book-url}[{installing-and-viewing-plugins-book-title}]. diff --git a/artifacts/rhdh-plugins-reference/argocd/argocd-plugin-readme.adoc b/artifacts/rhdh-plugins-reference/argocd/argocd-plugin-readme.adoc index 681434ddc2..acb2d0a98d 100644 --- a/artifacts/rhdh-plugins-reference/argocd/argocd-plugin-readme.adoc +++ b/artifacts/rhdh-plugins-reference/argocd/argocd-plugin-readme.adoc @@ -12,7 +12,7 @@ You can use the Argo CD plugin to visualize the Continuous Delivery (CD) workflo . Select the *Catalog* tab and choose the component that you want to use. -. Select the *CD* tab to view insights into deployments managed by Argo CD. +. Select the *CD* tab to view insights into deployments managed by Argo CD. + image::rhdh-plugins-reference/argocd.png[CD tab Argo CD] @@ -33,4 +33,4 @@ image::rhdh-plugins-reference/deployment_summary.png[Deployment summary] [role="_additional-resources"] .Additional resources -* For more information on installing dynamic plugins, see link:{installing-and-viewing-dynamic-plugins-url}[{installing-and-viewing-dynamic-plugins-title}]. +* For more information on installing dynamic plugins, see link:{installing-and-viewing-plugins-book-url}[{installing-and-viewing-plugins-book-title}]. diff --git a/artifacts/rhdh-plugins-reference/argocd/argocd-plugin-user.adoc b/artifacts/rhdh-plugins-reference/argocd/argocd-plugin-user.adoc index 2b7b1d4139..4b62e2ac69 100644 --- a/artifacts/rhdh-plugins-reference/argocd/argocd-plugin-user.adoc +++ b/artifacts/rhdh-plugins-reference/argocd/argocd-plugin-user.adoc @@ -10,7 +10,7 @@ You can use the Argo CD plugin to visualize the Continuous Delivery (CD) workflo . Select the *Catalog* tab and choose the component that you want to use. -. Select the *CD* tab to view insights into deployments managed by Argo CD. +. Select the *CD* tab to view insights into deployments managed by Argo CD. + image::rhdh-plugins-reference/argocd.png[CD tab Argo CD] @@ -31,4 +31,4 @@ image::rhdh-plugins-reference/deployment_summary.png[Deployment summary] [role="_additional-resources"] .Additional resources -* For more information on installing dynamic plugins, see link:{installing-and-viewing-dynamic-plugins-url}[{installing-and-viewing-dynamic-plugins-title}]. +* For more information on installing dynamic plugins, see link:{installing-and-viewing-plugins-book-url}[{installing-and-viewing-plugins-book-title}]. diff --git a/assemblies/assembly-configuring-techdocs.adoc b/assemblies/assembly-configuring-techdocs.adoc index 9c35554c7c..98796ff533 100644 --- a/assemblies/assembly-configuring-techdocs.adoc +++ b/assemblies/assembly-configuring-techdocs.adoc @@ -17,7 +17,7 @@ After you configure {odf-name} to store the files that TechDocs generates, you c [role="_additional-resources"] .Additional resources -* For more information, see link:{LinkPluginsGuide}[Configuring plugins in {product}]. +* For more information, see link:{configuring-dynamic-plugins-url}[Configuring plugins in {product}]. include::modules/customizing-techdocs/con-techdocs-configure-storage.adoc[leveloffset=+1] diff --git a/assemblies/dynamic-plugins/assembly-rhdh-installing-dynamic-plugins.adoc b/assemblies/dynamic-plugins/assembly-rhdh-installing-dynamic-plugins.adoc index 2ef19277e8..1d53b790ef 100644 --- a/assemblies/dynamic-plugins/assembly-rhdh-installing-dynamic-plugins.adoc +++ b/assemblies/dynamic-plugins/assembly-rhdh-installing-dynamic-plugins.adoc @@ -15,7 +15,7 @@ include::../modules/dynamic-plugins/ref-rh-supported-plugins.adoc[leveloffset=+3 [NOTE] ==== -* For more information about configuring KeyCloak, see link:{plugins-configure-book-url}[{plugins-configure-book-title}]. +* For more information about configuring KeyCloak, see link:{configuring-dynamic-plugins-url}[{configuring-dynamic-plugins-book-title}]. * For more information about configuring TechDocs, see link:{customizing-book-url}#configuring-techdocs[Configuring TechDocs]. ==== @@ -29,7 +29,7 @@ include::../modules/dynamic-plugins/ref-rh-tech-preview-plugins.adoc[leveloffset [NOTE] ==== -* A new Technology Preview plugin for Red Hat Ansible Automation Platform (RHAAP) is available, which replaces this older one. See link:{LinkPluginsGuide}#rhdh-compatible-plugins[Other installable plugins] in the _{NameOfPluginsGuide} guide_ for further details. See xref:rhdh-compatible-plugins[Dynamic plugins support matrix]. +* A new Technology Preview plugin for Red Hat Ansible Automation Platform (RHAAP) is available, which replaces this older one. See link:{configuring-dynamic-plugins-url}#rhdh-compatible-plugins[Other installable plugins] in the _{configuring-dynamic-plugins-book-title} guide_ for further details. See xref:rhdh-compatible-plugins[Dynamic plugins support matrix]. ==== // Community plugins diff --git a/modules/authentication/proc-enabling-authentication-with-github.adoc b/modules/authentication/proc-enabling-authentication-with-github.adoc index 0c7c4f42b1..64223936b9 100644 --- a/modules/authentication/proc-enabling-authentication-with-github.adoc +++ b/modules/authentication/proc-enabling-authentication-with-github.adoc @@ -51,7 +51,7 @@ TIP: If you plan to make changes using the GitHub API, ensure that `Read and wri * **Private key** * **Webhook secret** -. To add your GitHub credentials to {product-short}, add the following key/value pairs to link:{plugins-configure-book-url}#provisioning-your-custom-configuration[your {product-short} secrets]: +. To add your GitHub credentials to {product-short}, add the following key/value pairs to link:{configuring-dynamic-plugins-url}#provisioning-your-custom-configuration[your {product-short} secrets]: + `AUTH_GITHUB_APP_ID`:: Enter the saved **App ID**. `AUTH_GITHUB_CLIENT_ID`:: Enter the saved **Client ID**. diff --git a/modules/authentication/proc-enabling-authentication-with-microsoft-azure.adoc b/modules/authentication/proc-enabling-authentication-with-microsoft-azure.adoc index 25a2c856ff..557995f30d 100644 --- a/modules/authentication/proc-enabling-authentication-with-microsoft-azure.adoc +++ b/modules/authentication/proc-enabling-authentication-with-microsoft-azure.adoc @@ -44,7 +44,7 @@ To grant administrator consent, a directory administrator must go to the link:ht - **Application (client) ID** - **Application (client) secret** -. To add your Microsoft Azure credentials to {product-short}, add the following key/value pairs to link:{plugins-configure-book-url}#provisioning-your-custom-configuration[your {product-short} secrets]: +. To add your Microsoft Azure credentials to {product-short}, add the following key/value pairs to link:{configuring-dynamic-plugins-url}#provisioning-your-custom-configuration[your {product-short} secrets]: + `AUTH_AZURE_TENANT_ID`:: Enter your saved *Directory (tenant) ID*. `AUTH_AZURE_CLIENT_ID`:: Enter your saved *Application (client) ID*. diff --git a/modules/authentication/proc-enabling-authentication-with-rhbk.adoc b/modules/authentication/proc-enabling-authentication-with-rhbk.adoc index 3b4a100ff9..0d836be591 100644 --- a/modules/authentication/proc-enabling-authentication-with-rhbk.adoc +++ b/modules/authentication/proc-enabling-authentication-with-rhbk.adoc @@ -25,7 +25,7 @@ Save the value for the next step: .. To prepare for the verification steps, in the same realm, get the credential information for an existing user or link:https://docs.redhat.com/en/documentation/red_hat_build_of_keycloak/24.0/html-single/getting_started_guide/index#getting-started-zip-create-a-user[create a user]. Save the user credential information for the verification steps. -. To add your {rhsso} credentials to your {product-short}, add the following key/value pairs to link:{plugins-configure-book-url}#provisioning-your-custom-configuration[your {product-short} secrets]: +. To add your {rhsso} credentials to your {product-short}, add the following key/value pairs to link:{configuring-dynamic-plugins-url}#provisioning-your-custom-configuration[your {product-short} secrets]: + `AUTH_OIDC_CLIENT_ID`:: Enter the saved **Client ID**. `AUTH_OIDC_CLIENT_SECRET`:: Enter the saved **Client Secret**. diff --git a/modules/authorization/proc-enabling-the-rbac-plugin.adoc b/modules/authorization/proc-enabling-the-rbac-plugin.adoc index 6cda18d35e..c585179a14 100644 --- a/modules/authorization/proc-enabling-the-rbac-plugin.adoc +++ b/modules/authorization/proc-enabling-the-rbac-plugin.adoc @@ -22,7 +22,7 @@ plugins: disabled: false ---- + -See link:{installing-and-viewing-dynamic-plugins-url}[{installing-and-viewing-dynamic-plugins-title}]. +See link:{installing-and-viewing-plugins-book-url}[{installing-and-viewing-plugins-book-title}]. . Declare policy administrators to enable a select number of authenticated users to configure RBAC policies through the REST API or Web UI, instead of modifying the CSV file directly. The permissions can be specified in a separate CSV file referenced in the `app-config-rhdh` ConfigMap, or permissions can be created using the REST API or Web UI. diff --git a/modules/configuring/proc-provisioning-your-custom-configuration.adoc b/modules/configuring/proc-provisioning-your-custom-configuration.adoc index 58b1fc6276..2d9c1365d8 100644 --- a/modules/configuring/proc-provisioning-your-custom-configuration.adoc +++ b/modules/configuring/proc-provisioning-your-custom-configuration.adoc @@ -87,6 +87,6 @@ Consider provisioning additional config maps and secrets: * To use an external PostgreSQL database, xref:configuring-external-postgresql-databases[provision your PostgreSQL database secrets]. -* To enable dynamic plugins, link:{installing-and-viewing-dynamic-plugins-url}[provision your dynamic plugins config map]. +* To enable dynamic plugins, link:{installing-and-viewing-plugins-book-url}[provision your dynamic plugins config map]. * To configure authorization by using external files, link:{authorization-book-url}#managing-authorizations-by-using-external-files[provision your RBAC policies config map]. diff --git a/modules/customizing-the-tech-radar-page/proc-customize-rhdh-tech-radar-page.adoc b/modules/customizing-the-tech-radar-page/proc-customize-rhdh-tech-radar-page.adoc index 7fccb0536d..9ea7dae17c 100644 --- a/modules/customizing-the-tech-radar-page/proc-customize-rhdh-tech-radar-page.adoc +++ b/modules/customizing-the-tech-radar-page/proc-customize-rhdh-tech-radar-page.adoc @@ -1,7 +1,7 @@ [id='proc-customize-rhdh-tech-radar-page_{context}'] = Customizing the Tech Radar page in {product} -In {product}, the Tech Radar page is provided by the `tech-radar` dynamic plugin, which is disabled by default. For information about enabling dynamic plugins in {product} see link:{LinkPluginsGuide}[Configuring plugins in {product}]. +In {product}, the Tech Radar page is provided by the `tech-radar` dynamic plugin, which is disabled by default. For information about enabling dynamic plugins in {product} see link:{configuring-dynamic-plugins-url}[Configuring plugins in {product}]. In {product}, you can configure Learning Paths by passing the data into the `app-config.yaml` file as a proxy. The base Tech Radar URL must include the `/developer-hub/tech-radar` proxy. @@ -33,7 +33,7 @@ To access the data from the JSON files, complete the following step: + [source,yaml] ---- -techRadar: +techRadar: url: ${TECH_RADAR_DATA_URL} <1> ---- <1> `TECH_RADAR_DATA_URL` is the URL from which the JSON data is loaded. @@ -59,16 +59,16 @@ To use a separate service to provide the Tech Radar data, complete the following + [source,yaml] ---- -backend: - reading: - allow: +backend: + reading: + allow: - host: 'hostname' ---- . Add the following to the `app-config.yaml` file: + [source,yaml] ---- -techRadar: +techRadar: url: ${TECH_RADAR_DATA_URL} <1> ---- -<1> `TECH_RADAR_DATA_URL` is the URL from which the JSON data is loaded. \ No newline at end of file +<1> `TECH_RADAR_DATA_URL` is the URL from which the JSON data is loaded. diff --git a/modules/dynamic-plugins/ref-rh-compatible-plugins.adoc b/modules/dynamic-plugins/ref-rh-compatible-plugins.adoc index cf8740ca12..d80dbc40bd 100644 --- a/modules/dynamic-plugins/ref-rh-compatible-plugins.adoc +++ b/modules/dynamic-plugins/ref-rh-compatible-plugins.adoc @@ -1,4 +1,4 @@ -= Other installable plugins += Other installable plugins The following Technology Preview plugins are not preinstalled and must be installed from an external source: @@ -10,11 +10,11 @@ The following Technology Preview plugins are not preinstalled and must be instal | https://docs.redhat.com/en/documentation/red_hat_ansible_automation_platform/2.4/html/installing_ansible_plug-ins_for_red_hat_developer_hub[Learn more] |Ansible Automation Platform -| `https://access.redhat.com/downloads/content/480/ver=2.4/rhel---9/2.4/x86_64/product-software[@ansible/plugin-backstage-rhaap-backend]` |1.0.0 +| `https://access.redhat.com/downloads/content/480/ver=2.4/rhel---9/2.4/x86_64/product-software[@ansible/plugin-backstage-rhaap-backend]` |1.0.0 | https://docs.redhat.com/en/documentation/red_hat_ansible_automation_platform/2.4/html/installing_ansible_plug-ins_for_red_hat_developer_hub[Learn more] |Ansible Automation Platform Scaffolder Backend -|`https://access.redhat.com/downloads/content/480/ver=2.4/rhel---9/2.4/x86_64/product-software[@ansible/plugin-scaffolder-backend-module-backstage-rhaap]` |1.0.0 +|`https://access.redhat.com/downloads/content/480/ver=2.4/rhel---9/2.4/x86_64/product-software[@ansible/plugin-scaffolder-backend-module-backstage-rhaap]` |1.0.0 | https://docs.redhat.com/en/documentation/red_hat_ansible_automation_platform/2.4/html/installing_ansible_plug-ins_for_red_hat_developer_hub[Learn more] // temporarily removed until we have a good installation story from the Orchestrator team @@ -29,6 +29,6 @@ The following Technology Preview plugins are not preinstalled and must be instal [NOTE] ==== -* The above Red Hat Ansible Automation Platform (RHAAP) plugins, can be used as a replacement for the older plugin listed in the link:{LinkPluginsGuide}#rhdh-tech-preview-plugins[Technology Preview plugins] section of the _{NameOfPluginsGuide} guide_. +* The above Red Hat Ansible Automation Platform (RHAAP) plugins, can be used as a replacement for the older plugin listed in the link:{configuring-dynamic-plugins-url}#rhdh-tech-preview-plugins[Technology Preview plugins] section of the _{configuring-dynamic-plugins-book-title} guide_. ==== diff --git a/modules/importing-repositories/procedure-enabling-the-bulk-import-from-github-feature.adoc b/modules/importing-repositories/procedure-enabling-the-bulk-import-from-github-feature.adoc index 124317ae2c..9f3bc6f80f 100644 --- a/modules/importing-repositories/procedure-enabling-the-bulk-import-from-github-feature.adoc +++ b/modules/importing-repositories/procedure-enabling-the-bulk-import-from-github-feature.adoc @@ -21,7 +21,7 @@ plugins: disabled: false ---- + -See link:{installing-and-viewing-dynamic-plugins-url}[{installing-and-viewing-dynamic-plugins-title}]. +See link:{installing-and-viewing-plugins-book-url}[{installing-and-viewing-plugins-book-title}]. . Configure the required `bulk.import` RBAC permission for the users who are not administrators as follows: + From fa23c767ce350bbf99622c2362a41122ca76744a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Fabrice=20Flore-Th=C3=A9bault?= Date: Fri, 7 Mar 2025 16:12:23 +0100 Subject: [PATCH 02/25] Update assemblies/assembly-configuring-techdocs.adoc --- assemblies/assembly-configuring-techdocs.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/assemblies/assembly-configuring-techdocs.adoc b/assemblies/assembly-configuring-techdocs.adoc index 98796ff533..815d8a7579 100644 --- a/assemblies/assembly-configuring-techdocs.adoc +++ b/assemblies/assembly-configuring-techdocs.adoc @@ -17,7 +17,7 @@ After you configure {odf-name} to store the files that TechDocs generates, you c [role="_additional-resources"] .Additional resources -* For more information, see link:{configuring-dynamic-plugins-url}[Configuring plugins in {product}]. +* For more information, see link:{configuring-dynamic-plugins-url}[{configuring-dynamic-plugins-title}]. include::modules/customizing-techdocs/con-techdocs-configure-storage.adoc[leveloffset=+1] From b7805c12e5ff8ec10a7bee288f8cc6a98199b27e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Fabrice=20Flore-Th=C3=A9bault?= Date: Fri, 7 Mar 2025 16:12:49 +0100 Subject: [PATCH 03/25] Update artifacts/rhdh-plugins-reference/argocd/argocd-plugin-admin.adoc --- .../rhdh-plugins-reference/argocd/argocd-plugin-admin.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/artifacts/rhdh-plugins-reference/argocd/argocd-plugin-admin.adoc b/artifacts/rhdh-plugins-reference/argocd/argocd-plugin-admin.adoc index 7415d895c4..b4cea137ba 100644 --- a/artifacts/rhdh-plugins-reference/argocd/argocd-plugin-admin.adoc +++ b/artifacts/rhdh-plugins-reference/argocd/argocd-plugin-admin.adoc @@ -32,7 +32,7 @@ annotations: ... # The label that Argo CD uses to fetch all the applications. The format to be used is label.key=label.value. For example, rht-gitops.com/janus-argocd=quarkus-app. - argocd/app-selector: '${ARGOCD_LABEL_SELECTOR}' + argocd/app-selector: '${ARGOCD_LABEL_SELECTOR}' ---- * (Optional) Add the following annotation to the entity’s `catalog-info.yaml` file to switch between Argo CD instances as shown in the following example: From 9fb69b3b7ebf028da89b43dec617b6dd449b004d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Fabrice=20Flore-Th=C3=A9bault?= Date: Fri, 7 Mar 2025 16:13:05 +0100 Subject: [PATCH 04/25] Update artifacts/rhdh-plugins-reference/argocd/argocd-plugin-admin.adoc --- .../rhdh-plugins-reference/argocd/argocd-plugin-admin.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/artifacts/rhdh-plugins-reference/argocd/argocd-plugin-admin.adoc b/artifacts/rhdh-plugins-reference/argocd/argocd-plugin-admin.adoc index b4cea137ba..7ffd2c02f7 100644 --- a/artifacts/rhdh-plugins-reference/argocd/argocd-plugin-admin.adoc +++ b/artifacts/rhdh-plugins-reference/argocd/argocd-plugin-admin.adoc @@ -44,7 +44,7 @@ annotations: ... # The Argo CD instance name used in `app-config.yaml`. - argocd/instance-name: '${ARGOCD_INSTANCE}' + argocd/instance-name: '${ARGOCD_INSTANCE}' ---- + From a56c70a73b8229d9ef354d59e39bae396d3a53b8 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Fabrice=20Flore-Th=C3=A9bault?= Date: Fri, 7 Mar 2025 16:13:46 +0100 Subject: [PATCH 05/25] Update artifacts/rhdh-plugins-reference/argocd/argocd-plugin-admin.adoc --- .../rhdh-plugins-reference/argocd/argocd-plugin-admin.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/artifacts/rhdh-plugins-reference/argocd/argocd-plugin-admin.adoc b/artifacts/rhdh-plugins-reference/argocd/argocd-plugin-admin.adoc index 7ffd2c02f7..f683c8bb2c 100644 --- a/artifacts/rhdh-plugins-reference/argocd/argocd-plugin-admin.adoc +++ b/artifacts/rhdh-plugins-reference/argocd/argocd-plugin-admin.adoc @@ -226,6 +226,6 @@ If using the label selector annotation (backstage.io/kubernetes-label-selector), [role="_additional-resources"] .Additional resources -* The package path, scope, and name of the {company-name} ArgoCD plugin has changed since 1.2. For more information, see link:{release-notes-book-url}#removed-functionality-rhidp-4293[Breaking Changes] in the _{rn-product-title}_. +* The package path, scope, and name of the {company-name} ArgoCD plugin has changed since 1.2. For more information, see link:{release-notes-book-url}#removed-functionality-rhidp-4293[Breaking Changes] in the _{release-notes-book-title}_. * For more information on installing dynamic plugins, see link:{installing-and-viewing-plugins-book-url}[{installing-and-viewing-plugins-book-title}]. From c1cf59d740eceb0f78a7eecb93118e04efc1705e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Fabrice=20Flore-Th=C3=A9bault?= Date: Fri, 7 Mar 2025 16:14:05 +0100 Subject: [PATCH 06/25] Update artifacts/rhdh-plugins-reference/argocd/argocd-plugin-readme.adoc --- .../rhdh-plugins-reference/argocd/argocd-plugin-readme.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/artifacts/rhdh-plugins-reference/argocd/argocd-plugin-readme.adoc b/artifacts/rhdh-plugins-reference/argocd/argocd-plugin-readme.adoc index acb2d0a98d..306101bfc2 100644 --- a/artifacts/rhdh-plugins-reference/argocd/argocd-plugin-readme.adoc +++ b/artifacts/rhdh-plugins-reference/argocd/argocd-plugin-readme.adoc @@ -12,7 +12,7 @@ You can use the Argo CD plugin to visualize the Continuous Delivery (CD) workflo . Select the *Catalog* tab and choose the component that you want to use. -. Select the *CD* tab to view insights into deployments managed by Argo CD. +. Select the *CD* tab to view insights into deployments managed by Argo CD. + image::rhdh-plugins-reference/argocd.png[CD tab Argo CD] From 4356b40d368815488788f13a2e6fba6418881d76 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Fabrice=20Flore-Th=C3=A9bault?= Date: Fri, 7 Mar 2025 16:14:36 +0100 Subject: [PATCH 07/25] Update artifacts/rhdh-plugins-reference/argocd/argocd-plugin-user.adoc --- artifacts/rhdh-plugins-reference/argocd/argocd-plugin-user.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/artifacts/rhdh-plugins-reference/argocd/argocd-plugin-user.adoc b/artifacts/rhdh-plugins-reference/argocd/argocd-plugin-user.adoc index 4b62e2ac69..c82da2d9f4 100644 --- a/artifacts/rhdh-plugins-reference/argocd/argocd-plugin-user.adoc +++ b/artifacts/rhdh-plugins-reference/argocd/argocd-plugin-user.adoc @@ -10,7 +10,7 @@ You can use the Argo CD plugin to visualize the Continuous Delivery (CD) workflo . Select the *Catalog* tab and choose the component that you want to use. -. Select the *CD* tab to view insights into deployments managed by Argo CD. +. Select the *CD* tab to view insights into deployments managed by Argo CD. + image::rhdh-plugins-reference/argocd.png[CD tab Argo CD] From d8ec30487436d649849f39771edf8cec91ac2c86 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Fabrice=20Flore-Th=C3=A9bault?= Date: Fri, 7 Mar 2025 16:15:30 +0100 Subject: [PATCH 08/25] Update assemblies/dynamic-plugins/assembly-rhdh-installing-dynamic-plugins.adoc --- .../assembly-rhdh-installing-dynamic-plugins.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/assemblies/dynamic-plugins/assembly-rhdh-installing-dynamic-plugins.adoc b/assemblies/dynamic-plugins/assembly-rhdh-installing-dynamic-plugins.adoc index 1d53b790ef..667b2e1d6c 100644 --- a/assemblies/dynamic-plugins/assembly-rhdh-installing-dynamic-plugins.adoc +++ b/assemblies/dynamic-plugins/assembly-rhdh-installing-dynamic-plugins.adoc @@ -29,7 +29,7 @@ include::../modules/dynamic-plugins/ref-rh-tech-preview-plugins.adoc[leveloffset [NOTE] ==== -* A new Technology Preview plugin for Red Hat Ansible Automation Platform (RHAAP) is available, which replaces this older one. See link:{configuring-dynamic-plugins-url}#rhdh-compatible-plugins[Other installable plugins] in the _{configuring-dynamic-plugins-book-title} guide_ for further details. See xref:rhdh-compatible-plugins[Dynamic plugins support matrix]. +* A new Technology Preview plugin for Red Hat Ansible Automation Platform (RHAAP) is available, which replaces this older one. See link:{configuring-dynamic-plugins-url}#rhdh-compatible-plugins[Other installable plugins] in _{configuring-dynamic-plugins-book-title}_ for further details. See xref:rhdh-compatible-plugins[Dynamic plugins support matrix]. ==== // Community plugins From fad169fd0a06ac549ff897d90a51121820a3389d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Fabrice=20Flore-Th=C3=A9bault?= Date: Fri, 7 Mar 2025 16:16:35 +0100 Subject: [PATCH 09/25] Update modules/customizing-the-tech-radar-page/proc-customize-rhdh-tech-radar-page.adoc --- .../proc-customize-rhdh-tech-radar-page.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/customizing-the-tech-radar-page/proc-customize-rhdh-tech-radar-page.adoc b/modules/customizing-the-tech-radar-page/proc-customize-rhdh-tech-radar-page.adoc index 9ea7dae17c..b7cd9bfde8 100644 --- a/modules/customizing-the-tech-radar-page/proc-customize-rhdh-tech-radar-page.adoc +++ b/modules/customizing-the-tech-radar-page/proc-customize-rhdh-tech-radar-page.adoc @@ -1,7 +1,7 @@ [id='proc-customize-rhdh-tech-radar-page_{context}'] = Customizing the Tech Radar page in {product} -In {product}, the Tech Radar page is provided by the `tech-radar` dynamic plugin, which is disabled by default. For information about enabling dynamic plugins in {product} see link:{configuring-dynamic-plugins-url}[Configuring plugins in {product}]. +In {product}, the Tech Radar page is provided by the `tech-radar` dynamic plugin, which is disabled by default. For information about enabling dynamic plugins in {product} see link:{configuring-dynamic-plugins-url}[{configuring-dynamic-plugins-title}]. In {product}, you can configure Learning Paths by passing the data into the `app-config.yaml` file as a proxy. The base Tech Radar URL must include the `/developer-hub/tech-radar` proxy. From 4e4e5803eddf13ab4bf7b167cb43f7d4ad8e073e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Fabrice=20Flore-Th=C3=A9bault?= Date: Fri, 7 Mar 2025 16:17:15 +0100 Subject: [PATCH 10/25] Update modules/dynamic-plugins/ref-rh-compatible-plugins.adoc --- modules/dynamic-plugins/ref-rh-compatible-plugins.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/dynamic-plugins/ref-rh-compatible-plugins.adoc b/modules/dynamic-plugins/ref-rh-compatible-plugins.adoc index d80dbc40bd..9cfa553c56 100644 --- a/modules/dynamic-plugins/ref-rh-compatible-plugins.adoc +++ b/modules/dynamic-plugins/ref-rh-compatible-plugins.adoc @@ -29,6 +29,6 @@ The following Technology Preview plugins are not preinstalled and must be instal [NOTE] ==== -* The above Red Hat Ansible Automation Platform (RHAAP) plugins, can be used as a replacement for the older plugin listed in the link:{configuring-dynamic-plugins-url}#rhdh-tech-preview-plugins[Technology Preview plugins] section of the _{configuring-dynamic-plugins-book-title} guide_. +* The above Red Hat Ansible Automation Platform (RHAAP) plugins, can be used as a replacement for the older plugin listed in the link:{configuring-dynamic-plugins-url}#rhdh-tech-preview-plugins[Technology Preview plugins] section of _{configuring-dynamic-plugins-book-title}_. ==== From af02f4faff1f30c9730046c50780536ad9938877 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Fabrice=20Flore-Th=C3=A9bault?= Date: Fri, 7 Mar 2025 16:18:45 +0100 Subject: [PATCH 11/25] Update modules/authentication/proc-enabling-authentication-with-github.adoc --- .../proc-enabling-authentication-with-github.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/authentication/proc-enabling-authentication-with-github.adoc b/modules/authentication/proc-enabling-authentication-with-github.adoc index 64223936b9..7314972c4d 100644 --- a/modules/authentication/proc-enabling-authentication-with-github.adoc +++ b/modules/authentication/proc-enabling-authentication-with-github.adoc @@ -51,7 +51,7 @@ TIP: If you plan to make changes using the GitHub API, ensure that `Read and wri * **Private key** * **Webhook secret** -. To add your GitHub credentials to {product-short}, add the following key/value pairs to link:{configuring-dynamic-plugins-url}#provisioning-your-custom-configuration[your {product-short} secrets]: +. To add your GitHub credentials to {product-short}, add the following key/value pairs to link:{configuring-dynamic-plugins-book-url}#provisioning-your-custom-configuration[your {product-short} secrets]: + `AUTH_GITHUB_APP_ID`:: Enter the saved **App ID**. `AUTH_GITHUB_CLIENT_ID`:: Enter the saved **Client ID**. From 21e48b31e9e1fe2515bab85974c8518ed6b0acd8 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Fabrice=20Flore-Th=C3=A9bault?= Date: Fri, 7 Mar 2025 16:21:18 +0100 Subject: [PATCH 12/25] Update assemblies/assembly-configuring-techdocs.adoc --- assemblies/assembly-configuring-techdocs.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/assemblies/assembly-configuring-techdocs.adoc b/assemblies/assembly-configuring-techdocs.adoc index 815d8a7579..7a6f12040b 100644 --- a/assemblies/assembly-configuring-techdocs.adoc +++ b/assemblies/assembly-configuring-techdocs.adoc @@ -17,7 +17,7 @@ After you configure {odf-name} to store the files that TechDocs generates, you c [role="_additional-resources"] .Additional resources -* For more information, see link:{configuring-dynamic-plugins-url}[{configuring-dynamic-plugins-title}]. +* For more information, see link:{configuring-dynamic-plugins-book-url}[{configuring-dynamic-plugins-book-title}]. include::modules/customizing-techdocs/con-techdocs-configure-storage.adoc[leveloffset=+1] From 2e14b193de6b15e50b7d77f179bf65bb896f78b5 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Fabrice=20Flore-Th=C3=A9bault?= Date: Fri, 7 Mar 2025 16:21:48 +0100 Subject: [PATCH 13/25] Update assemblies/dynamic-plugins/assembly-rhdh-installing-dynamic-plugins.adoc --- .../assembly-rhdh-installing-dynamic-plugins.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/assemblies/dynamic-plugins/assembly-rhdh-installing-dynamic-plugins.adoc b/assemblies/dynamic-plugins/assembly-rhdh-installing-dynamic-plugins.adoc index 667b2e1d6c..83e6fa8ec1 100644 --- a/assemblies/dynamic-plugins/assembly-rhdh-installing-dynamic-plugins.adoc +++ b/assemblies/dynamic-plugins/assembly-rhdh-installing-dynamic-plugins.adoc @@ -15,7 +15,7 @@ include::../modules/dynamic-plugins/ref-rh-supported-plugins.adoc[leveloffset=+3 [NOTE] ==== -* For more information about configuring KeyCloak, see link:{configuring-dynamic-plugins-url}[{configuring-dynamic-plugins-book-title}]. +* For more information about configuring KeyCloak, see link:{configuring-dynamic-plugins-book-url}[{configuring-dynamic-plugins-book-title}]. * For more information about configuring TechDocs, see link:{customizing-book-url}#configuring-techdocs[Configuring TechDocs]. ==== From 525d1949d6cc44c171ef43c51d529aa0bbdfbb46 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Fabrice=20Flore-Th=C3=A9bault?= Date: Fri, 7 Mar 2025 16:22:23 +0100 Subject: [PATCH 14/25] Update assemblies/dynamic-plugins/assembly-rhdh-installing-dynamic-plugins.adoc --- .../assembly-rhdh-installing-dynamic-plugins.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/assemblies/dynamic-plugins/assembly-rhdh-installing-dynamic-plugins.adoc b/assemblies/dynamic-plugins/assembly-rhdh-installing-dynamic-plugins.adoc index 83e6fa8ec1..c381eb0f26 100644 --- a/assemblies/dynamic-plugins/assembly-rhdh-installing-dynamic-plugins.adoc +++ b/assemblies/dynamic-plugins/assembly-rhdh-installing-dynamic-plugins.adoc @@ -29,7 +29,7 @@ include::../modules/dynamic-plugins/ref-rh-tech-preview-plugins.adoc[leveloffset [NOTE] ==== -* A new Technology Preview plugin for Red Hat Ansible Automation Platform (RHAAP) is available, which replaces this older one. See link:{configuring-dynamic-plugins-url}#rhdh-compatible-plugins[Other installable plugins] in _{configuring-dynamic-plugins-book-title}_ for further details. See xref:rhdh-compatible-plugins[Dynamic plugins support matrix]. +* A new Technology Preview plugin for Red Hat Ansible Automation Platform (RHAAP) is available, which replaces this older one. See link:{configuring-dynamic-plugins-book-url}#rhdh-compatible-plugins[Other installable plugins] in _{configuring-dynamic-plugins-book-title}_ for further details. See xref:rhdh-compatible-plugins[Dynamic plugins support matrix]. ==== // Community plugins From 0b32f275281c47786049cce134a80314b5892144 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Fabrice=20Flore-Th=C3=A9bault?= Date: Fri, 7 Mar 2025 16:23:16 +0100 Subject: [PATCH 15/25] Update modules/authentication/proc-enabling-authentication-with-microsoft-azure.adoc --- .../proc-enabling-authentication-with-microsoft-azure.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/authentication/proc-enabling-authentication-with-microsoft-azure.adoc b/modules/authentication/proc-enabling-authentication-with-microsoft-azure.adoc index 557995f30d..bf76cf6756 100644 --- a/modules/authentication/proc-enabling-authentication-with-microsoft-azure.adoc +++ b/modules/authentication/proc-enabling-authentication-with-microsoft-azure.adoc @@ -44,7 +44,7 @@ To grant administrator consent, a directory administrator must go to the link:ht - **Application (client) ID** - **Application (client) secret** -. To add your Microsoft Azure credentials to {product-short}, add the following key/value pairs to link:{configuring-dynamic-plugins-url}#provisioning-your-custom-configuration[your {product-short} secrets]: +. To add your Microsoft Azure credentials to {product-short}, add the following key/value pairs to link:{configuring-dynamic-plugins-book-url}#provisioning-your-custom-configuration[your {product-short} secrets]: + `AUTH_AZURE_TENANT_ID`:: Enter your saved *Directory (tenant) ID*. `AUTH_AZURE_CLIENT_ID`:: Enter your saved *Application (client) ID*. From a986bbd758523ae29075f4a046f19f15f44bb99d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Fabrice=20Flore-Th=C3=A9bault?= Date: Fri, 7 Mar 2025 16:23:45 +0100 Subject: [PATCH 16/25] Update modules/dynamic-plugins/ref-rh-compatible-plugins.adoc --- modules/dynamic-plugins/ref-rh-compatible-plugins.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/dynamic-plugins/ref-rh-compatible-plugins.adoc b/modules/dynamic-plugins/ref-rh-compatible-plugins.adoc index 9cfa553c56..e6d66dc2ea 100644 --- a/modules/dynamic-plugins/ref-rh-compatible-plugins.adoc +++ b/modules/dynamic-plugins/ref-rh-compatible-plugins.adoc @@ -29,6 +29,6 @@ The following Technology Preview plugins are not preinstalled and must be instal [NOTE] ==== -* The above Red Hat Ansible Automation Platform (RHAAP) plugins, can be used as a replacement for the older plugin listed in the link:{configuring-dynamic-plugins-url}#rhdh-tech-preview-plugins[Technology Preview plugins] section of _{configuring-dynamic-plugins-book-title}_. +* The above Red Hat Ansible Automation Platform (RHAAP) plugins, can be used as a replacement for the older plugin listed in the link:{configuring-dynamic-plugins-book-url}#rhdh-tech-preview-plugins[Technology Preview plugins] section of _{configuring-dynamic-plugins-book-title}_. ==== From 4205085b4932c5694d9b1db7c96679b2d51e41c6 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Fabrice=20Flore-Th=C3=A9bault?= Date: Fri, 7 Mar 2025 16:24:37 +0100 Subject: [PATCH 17/25] Update modules/customizing-the-tech-radar-page/proc-customize-rhdh-tech-radar-page.adoc --- .../proc-customize-rhdh-tech-radar-page.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/customizing-the-tech-radar-page/proc-customize-rhdh-tech-radar-page.adoc b/modules/customizing-the-tech-radar-page/proc-customize-rhdh-tech-radar-page.adoc index b7cd9bfde8..7ffe13fce4 100644 --- a/modules/customizing-the-tech-radar-page/proc-customize-rhdh-tech-radar-page.adoc +++ b/modules/customizing-the-tech-radar-page/proc-customize-rhdh-tech-radar-page.adoc @@ -1,7 +1,7 @@ [id='proc-customize-rhdh-tech-radar-page_{context}'] = Customizing the Tech Radar page in {product} -In {product}, the Tech Radar page is provided by the `tech-radar` dynamic plugin, which is disabled by default. For information about enabling dynamic plugins in {product} see link:{configuring-dynamic-plugins-url}[{configuring-dynamic-plugins-title}]. +In {product}, the Tech Radar page is provided by the `tech-radar` dynamic plugin, which is disabled by default. For information about enabling dynamic plugins in {product} see link:{configuring-dynamic-plugins-book-url}[{configuring-dynamic-plugins-book-title}]. In {product}, you can configure Learning Paths by passing the data into the `app-config.yaml` file as a proxy. The base Tech Radar URL must include the `/developer-hub/tech-radar` proxy. From 3db1624823bc84be7022ac516dfc9cfc6c7fa389 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Fabrice=20Flore-Th=C3=A9bault?= Date: Fri, 7 Mar 2025 16:26:16 +0100 Subject: [PATCH 18/25] Update modules/authentication/proc-enabling-authentication-with-rhbk.adoc --- .../authentication/proc-enabling-authentication-with-rhbk.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/authentication/proc-enabling-authentication-with-rhbk.adoc b/modules/authentication/proc-enabling-authentication-with-rhbk.adoc index 0d836be591..6c9d4540ab 100644 --- a/modules/authentication/proc-enabling-authentication-with-rhbk.adoc +++ b/modules/authentication/proc-enabling-authentication-with-rhbk.adoc @@ -25,7 +25,7 @@ Save the value for the next step: .. To prepare for the verification steps, in the same realm, get the credential information for an existing user or link:https://docs.redhat.com/en/documentation/red_hat_build_of_keycloak/24.0/html-single/getting_started_guide/index#getting-started-zip-create-a-user[create a user]. Save the user credential information for the verification steps. -. To add your {rhsso} credentials to your {product-short}, add the following key/value pairs to link:{configuring-dynamic-plugins-url}#provisioning-your-custom-configuration[your {product-short} secrets]: +. To add your {rhsso} credentials to your {product-short}, add the following key/value pairs to link:{configuring-dynamic-plugins-book-url}#provisioning-your-custom-configuration[your {product-short} secrets]: + `AUTH_OIDC_CLIENT_ID`:: Enter the saved **Client ID**. `AUTH_OIDC_CLIENT_SECRET`:: Enter the saved **Client Secret**. From e451ee0a141260514126c026b312287d0108c826 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Fabrice=20Flore-Th=C3=A9bault?= Date: Fri, 7 Mar 2025 16:27:14 +0100 Subject: [PATCH 19/25] Update modules/dynamic-plugins/ref-rh-compatible-plugins.adoc --- modules/dynamic-plugins/ref-rh-compatible-plugins.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/dynamic-plugins/ref-rh-compatible-plugins.adoc b/modules/dynamic-plugins/ref-rh-compatible-plugins.adoc index e6d66dc2ea..56adef7843 100644 --- a/modules/dynamic-plugins/ref-rh-compatible-plugins.adoc +++ b/modules/dynamic-plugins/ref-rh-compatible-plugins.adoc @@ -1,4 +1,4 @@ -= Other installable plugins += Other installable plugins The following Technology Preview plugins are not preinstalled and must be installed from an external source: From ae0c5fe9be5ae38123af6618c90d410441356159 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Fabrice=20Flore-Th=C3=A9bault?= Date: Fri, 7 Mar 2025 16:27:29 +0100 Subject: [PATCH 20/25] Update modules/dynamic-plugins/ref-rh-compatible-plugins.adoc --- modules/dynamic-plugins/ref-rh-compatible-plugins.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/dynamic-plugins/ref-rh-compatible-plugins.adoc b/modules/dynamic-plugins/ref-rh-compatible-plugins.adoc index 56adef7843..d85352b287 100644 --- a/modules/dynamic-plugins/ref-rh-compatible-plugins.adoc +++ b/modules/dynamic-plugins/ref-rh-compatible-plugins.adoc @@ -10,7 +10,7 @@ The following Technology Preview plugins are not preinstalled and must be instal | https://docs.redhat.com/en/documentation/red_hat_ansible_automation_platform/2.4/html/installing_ansible_plug-ins_for_red_hat_developer_hub[Learn more] |Ansible Automation Platform -| `https://access.redhat.com/downloads/content/480/ver=2.4/rhel---9/2.4/x86_64/product-software[@ansible/plugin-backstage-rhaap-backend]` |1.0.0 +| `https://access.redhat.com/downloads/content/480/ver=2.4/rhel---9/2.4/x86_64/product-software[@ansible/plugin-backstage-rhaap-backend]` |1.0.0 | https://docs.redhat.com/en/documentation/red_hat_ansible_automation_platform/2.4/html/installing_ansible_plug-ins_for_red_hat_developer_hub[Learn more] |Ansible Automation Platform Scaffolder Backend From 9e06e5685e2e07d9f569360ef7226e8ded3c72a8 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Fabrice=20Flore-Th=C3=A9bault?= Date: Fri, 7 Mar 2025 16:27:47 +0100 Subject: [PATCH 21/25] Update modules/dynamic-plugins/ref-rh-compatible-plugins.adoc --- modules/dynamic-plugins/ref-rh-compatible-plugins.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/dynamic-plugins/ref-rh-compatible-plugins.adoc b/modules/dynamic-plugins/ref-rh-compatible-plugins.adoc index d85352b287..67946f99ae 100644 --- a/modules/dynamic-plugins/ref-rh-compatible-plugins.adoc +++ b/modules/dynamic-plugins/ref-rh-compatible-plugins.adoc @@ -14,7 +14,7 @@ The following Technology Preview plugins are not preinstalled and must be instal | https://docs.redhat.com/en/documentation/red_hat_ansible_automation_platform/2.4/html/installing_ansible_plug-ins_for_red_hat_developer_hub[Learn more] |Ansible Automation Platform Scaffolder Backend -|`https://access.redhat.com/downloads/content/480/ver=2.4/rhel---9/2.4/x86_64/product-software[@ansible/plugin-scaffolder-backend-module-backstage-rhaap]` |1.0.0 +|`https://access.redhat.com/downloads/content/480/ver=2.4/rhel---9/2.4/x86_64/product-software[@ansible/plugin-scaffolder-backend-module-backstage-rhaap]` |1.0.0 | https://docs.redhat.com/en/documentation/red_hat_ansible_automation_platform/2.4/html/installing_ansible_plug-ins_for_red_hat_developer_hub[Learn more] // temporarily removed until we have a good installation story from the Orchestrator team From 7892bc138eaac9b5bdc643203d18b90e9fd31d57 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Fabrice=20Flore-Th=C3=A9bault?= Date: Fri, 7 Mar 2025 16:28:10 +0100 Subject: [PATCH 22/25] Update modules/customizing-the-tech-radar-page/proc-customize-rhdh-tech-radar-page.adoc --- .../proc-customize-rhdh-tech-radar-page.adoc | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/modules/customizing-the-tech-radar-page/proc-customize-rhdh-tech-radar-page.adoc b/modules/customizing-the-tech-radar-page/proc-customize-rhdh-tech-radar-page.adoc index 7ffe13fce4..084db0d737 100644 --- a/modules/customizing-the-tech-radar-page/proc-customize-rhdh-tech-radar-page.adoc +++ b/modules/customizing-the-tech-radar-page/proc-customize-rhdh-tech-radar-page.adoc @@ -59,9 +59,9 @@ To use a separate service to provide the Tech Radar data, complete the following + [source,yaml] ---- -backend: - reading: - allow: +backend: + reading: + allow: - host: 'hostname' ---- . Add the following to the `app-config.yaml` file: From 987fb481383948787ec54172ea1c205c97792922 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Fabrice=20Flore-Th=C3=A9bault?= Date: Fri, 7 Mar 2025 16:28:37 +0100 Subject: [PATCH 23/25] Update modules/customizing-the-tech-radar-page/proc-customize-rhdh-tech-radar-page.adoc --- .../proc-customize-rhdh-tech-radar-page.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/customizing-the-tech-radar-page/proc-customize-rhdh-tech-radar-page.adoc b/modules/customizing-the-tech-radar-page/proc-customize-rhdh-tech-radar-page.adoc index 084db0d737..84036a9d26 100644 --- a/modules/customizing-the-tech-radar-page/proc-customize-rhdh-tech-radar-page.adoc +++ b/modules/customizing-the-tech-radar-page/proc-customize-rhdh-tech-radar-page.adoc @@ -61,7 +61,7 @@ To use a separate service to provide the Tech Radar data, complete the following ---- backend: reading: - allow: + allow: - host: 'hostname' ---- . Add the following to the `app-config.yaml` file: From 6c32cde5365604eaebcb3a72fe32a166fa26ef49 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Fabrice=20Flore-Th=C3=A9bault?= Date: Fri, 7 Mar 2025 16:29:08 +0100 Subject: [PATCH 24/25] Update modules/customizing-the-tech-radar-page/proc-customize-rhdh-tech-radar-page.adoc --- .../proc-customize-rhdh-tech-radar-page.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/customizing-the-tech-radar-page/proc-customize-rhdh-tech-radar-page.adoc b/modules/customizing-the-tech-radar-page/proc-customize-rhdh-tech-radar-page.adoc index 84036a9d26..3c4e87e8c1 100644 --- a/modules/customizing-the-tech-radar-page/proc-customize-rhdh-tech-radar-page.adoc +++ b/modules/customizing-the-tech-radar-page/proc-customize-rhdh-tech-radar-page.adoc @@ -33,7 +33,7 @@ To access the data from the JSON files, complete the following step: + [source,yaml] ---- -techRadar: +techRadar: url: ${TECH_RADAR_DATA_URL} <1> ---- <1> `TECH_RADAR_DATA_URL` is the URL from which the JSON data is loaded. From 9fdebab814529401e23686e3c7a3e1abbd7e54af Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Fabrice=20Flore-Th=C3=A9bault?= Date: Fri, 7 Mar 2025 16:29:24 +0100 Subject: [PATCH 25/25] Update modules/customizing-the-tech-radar-page/proc-customize-rhdh-tech-radar-page.adoc --- .../proc-customize-rhdh-tech-radar-page.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/customizing-the-tech-radar-page/proc-customize-rhdh-tech-radar-page.adoc b/modules/customizing-the-tech-radar-page/proc-customize-rhdh-tech-radar-page.adoc index 3c4e87e8c1..3c9b133941 100644 --- a/modules/customizing-the-tech-radar-page/proc-customize-rhdh-tech-radar-page.adoc +++ b/modules/customizing-the-tech-radar-page/proc-customize-rhdh-tech-radar-page.adoc @@ -68,7 +68,7 @@ backend: + [source,yaml] ---- -techRadar: +techRadar: url: ${TECH_RADAR_DATA_URL} <1> ---- <1> `TECH_RADAR_DATA_URL` is the URL from which the JSON data is loaded.