Dynamic plugins reference
Red Hat Developer Hub is preinstalled with a selection of dynamic plugins that you can enable and configure to extend Developer Hub functionality
Abstract
Preface
Red Hat Developer Hub (RHDH) is preinstalled with a selection of dynamic plugins that users can enable and configure to extend RHDH functionality.
The dynamic plugin support is based on the backend plugin manager package, which is a service that scans a configured root directory (dynamicPlugins.rootDirectory in the app config) for dynamic plugin packages and loads them dynamically.
You can use the dynamic plugins that come preinstalled with Red Hat Developer Hub or install external dynamic plugins from a public NPM registry.
Chapter 1. Preinstalled dynamic plugins
Red Hat Developer Hub is preinstalled with a selection of dynamic plugins.
The following 19 preinstalled dynamic plugins are enabled by default:
-
@backstage-community/plugin-analytics-provider-segment -
@backstage-community/plugin-scaffolder-backend-module-regex -
@backstage/plugin-org -
@backstage/plugin-techdocs -
@backstage/plugin-techdocs-backend -
@backstage/plugin-techdocs-module-addons-contrib -
@red-hat-developer-hub/backstage-plugin-adoption-insights -
@red-hat-developer-hub/backstage-plugin-adoption-insights-backend -
@red-hat-developer-hub/backstage-plugin-analytics-module-adoption-insights -
@red-hat-developer-hub/backstage-plugin-app-auth -
@red-hat-developer-hub/backstage-plugin-app-defaults -
@red-hat-developer-hub/backstage-plugin-app-integrations -
@red-hat-developer-hub/backstage-plugin-catalog-backend-module-extensions -
@red-hat-developer-hub/backstage-plugin-extensions -
@red-hat-developer-hub/backstage-plugin-extensions-backend -
@red-hat-developer-hub/backstage-plugin-global-header -
@red-hat-developer-hub/backstage-plugin-homepage -
@red-hat-developer-hub/backstage-plugin-homepage-backend -
@red-hat-developer-hub/backstage-plugin-quickstart
The dynamic plugins that require custom configuration are disabled by default.
Upon application startup, for each plugin that is disabled by default, the install-dynamic-plugins init container within the Developer Hub pod log displays a message similar to the following:
======= Skipping disabled dynamic plugin oci://quay.io/rhdh/backstage-plugin-auth-backend-module-github-provider@sha256:eb10d24f00439c17d2bd2d71aaa3adbf91527d8e72811264259b4408458e3aea
To enable this plugin, add a package with the same name to the Helm chart and set the enabled field to true. For example:
global:
dynamic:
includes:
- dynamic-plugins.default.yaml
plugins:
- package: oci://quay.io/rhdh/backstage-plugin-auth-backend-module-github-provider@sha256:eb10d24f00439c17d2bd2d71aaa3adbf91527d8e72811264259b4408458e3aea
enabled: true
The default configuration for a plugin is extracted from the dynamic-plugins.default.yaml file, however, you can use a pluginConfig entry to override the default configuration.
Chapter 2. Red Hat Generally Available (GA) plugins
Red Hat provides full support for the following 50 dynamic plugins.
| Name | Plugin | Plugin Version | Path and required variables | Artifact Tag |
|---|---|---|---|---|
|
Adoption Insights |
1.0.4 |
|
2.2.0—1.0.4 | |
|
Adoption Insights |
|
1.0.4 |
|
2.2.0—1.0.4 |
|
Analytics Module Adoption Insights |
|
1.0.4 |
|
2.2.0—1.0.4 |
|
Analytics Provider Segment |
2.0.0 |
|
2.2.0—2.0.0 | |
|
App Auth |
1.3.0 |
|
2.2.0—1.3.0 | |
|
App Defaults |
1.13.0 |
|
2.2.0—1.13.0 | |
|
App Integrations |
1.2.0 |
|
2.2.0—1.2.0 | |
|
Auth Backend Module GitHub Provider |
0.5.6 |
|
2.2.0—0.5.6 | |
|
Auth Backend Module GitLab Provider |
0.4.6 |
|
2.2.0—0.4.6 | |
|
Auth Backend Module Guest Provider |
0.2.22 |
|
2.2.0—0.2.22 | |
|
Auth Backend Module Keycloak Provider |
|
0.6.0 |
|
2.2.0—0.6.0 |
|
Auth Backend Module Microsoft Provider |
0.3.18 |
|
2.2.0—0.3.18 | |
|
Auth Backend Module Oidc Provider |
0.4.20 |
|
2.2.0—0.4.20 | |
|
Auth Backend Module Pingfederate Provider |
|
0.4.0 |
|
2.2.0—0.4.0 |
|
Bulk Import |
9.1.1 |
|
2.2.0—9.1.1 | |
|
Bulk Import |
9.1.1 |
|
2.2.0—9.1.1 | |
|
GitHub |
0.13.5 |
|
2.2.0—0.13.5 | |
|
GitHub |
0.9.13 |
|
2.2.0—0.9.13 | |
|
GitHub Org |
0.3.25 |
|
2.2.0—0.3.25 | |
|
GitLab |
0.8.7 |
|
2.2.0—0.8.7 | |
|
GitLab Org |
0.2.24 |
|
2.2.0—0.2.24 | |
|
Global Header |
3.2.1 |
|
2.2.0—3.2.1 | |
|
Homepage |
3.1.0 |
|
2.2.0—3.1.0 | |
|
Homepage |
0.6.0 |
|
2.2.0—0.6.0 | |
|
Http Request |
5.9.0 |
|
2.2.0—5.9.0 | |
|
Intelligent Assistant |
|
5.3.10 |
|
2.2.0—5.3.10 |
|
Intelligent Assistant |
|
5.3.10 |
|
2.2.0—5.3.10 |
|
Keycloak |
3.23.1 |
|
2.2.0—3.23.1 | |
|
Kubernetes |
0.12.22 |
|
2.2.0—0.12.22 | |
|
Kubernetes |
0.21.10 |
|
2.2.0—0.21.10 | |
|
Kubernetes |
|
2.21.0 |
|
2.2.0—2.21.0 |
|
Ldap |
0.12.8 |
|
2.2.0—0.12.8 | |
|
MS Graph |
0.10.5 |
|
2.2.0—0.10.5 | |
|
Orchestrator |
6.2.5 |
|
2.2.0—6.2.5 | |
|
Orchestrator |
|
8.13.3 |
|
2.2.0—8.13.3 |
|
Orchestrator |
|
1.8.2 |
|
2.2.0—1.8.2 |
|
Orchestrator Backend Module Loki |
|
1.5.2 |
|
2.2.0—1.5.2 |
|
Orchestrator Form Widgets |
|
2.2.2 |
|
2.2.0—2.2.2 |
|
Org |
0.7.8 |
|
2.2.0—0.7.8 | |
|
Quickstart |
2.2.0 |
|
2.2.0—2.2.0 | |
|
RBAC |
2.3.6 |
|
2.2.0—2.3.6 | |
|
Regex |
2.18.0 |
|
2.2.0—2.18.0 | |
|
Signals |
0.0.34 |
|
2.2.0—0.0.34 | |
|
Signals |
0.3.18 |
|
2.2.0—0.3.18 | |
|
Tech Radar |
1.22.0 |
|
2.2.0—1.22.0 | |
|
Tech Radar |
1.21.0 |
|
2.2.0—1.21.0 | |
|
TechDocs |
1.18.0 |
|
2.2.0—1.18.0 | |
|
TechDocs |
2.2.5 |
|
2.2.0—2.2.5 | |
|
TechDocs Module Addons Contrib |
1.1.39 |
|
2.2.0—1.1.39 | |
|
Topology |
3.0.7 |
|
2.2.0—3.0.7 |
- For more information about configuring KeyCloak, see Configuring dynamic plugins.
- For more information about configuring TechDocs, see Configuring TechDocs.
Chapter 3. Red Hat Technology Preview plugins
Red Hat provides Technology Preview support for the following 18 plugins.
These features are for Technology Preview only. Technology Preview features are not supported with Red Hat production service level agreements (SLAs), might not be functionally complete, and Red Hat does not recommend using them for production. These features provide early access to upcoming product features, enabling customers to test functionality and provide feedback during the development process.
For more information on Red Hat Technology Preview features, see Technology Preview Features Scope.
| Name | Plugin | Plugin Version | Path and required variables | Artifact Tag |
|---|---|---|---|---|
|
Events Backend Module GitHub |
0.4.15 |
|
2.2.0—0.4.15 | |
|
Extensions |
1.0.2 |
|
2.2.0—1.0.2 | |
|
Extensions |
1.0.2 |
|
2.2.0—1.0.2 | |
|
Extensions |
|
1.0.2 |
|
2.2.0—1.0.2 |
|
GitLab |
0.11.10 |
|
2.2.0—0.11.10 | |
|
Notifications |
0.5.20 |
|
2.2.0—0.5.20 | |
|
Notifications |
0.6.8 |
|
2.2.0—0.6.8 | |
|
Notifications |
0.3.24 |
|
2.2.0—0.3.24 | |
|
Scaffolder Relation Processor |
|
2.17.1 |
|
2.2.0—2.17.1 |
|
Scorecard |
4.5.2 |
|
2.2.0—4.5.2 | |
|
Scorecard |
4.5.2 |
|
2.2.0—4.5.2 | |
|
Scorecard Backend Module Dependabot |
|
1.1.7 |
|
2.2.0—1.1.7 |
|
Scorecard Backend Module Dora |
|
0.2.6 |
|
2.2.0—0.2.6 |
|
Scorecard Backend Module Filecheck |
|
1.1.7 |
|
2.2.0—1.1.7 |
|
Scorecard Backend Module GitHub |
|
4.5.2 |
|
2.2.0—4.5.2 |
|
Scorecard Backend Module Jira |
|
4.5.2 |
|
2.2.0—4.5.2 |
|
Scorecard Backend Module Openssf |
|
2.0.4 |
|
2.2.0—2.0.4 |
|
Scorecard Backend Module SonarQube |
|
4.5.2 |
|
2.2.0—4.5.2 |
Chapter 4. Red Hat community supported plugins
Red Hat provides community support for the following 37 dynamic plugins in ghcr.io.
Replace <tag> with the version tag corresponding to your Developer Hub version. See Determining Tag Values
| Name | Plugin Version | Path and required variables | Artifact Tag |
|---|---|---|---|
|
3Scale |
3.17.0 |
|
bs_1.54.9__3.17.0 |
|
ACR |
1.28.1 |
|
bs_1.54.9__1.28.1 |
|
APIC |
1.0.4 |
|
bs_1.54.9__1.0.4 |
|
ArgoCD |
3.1.3 |
|
bs_1.54.9__3.1.3 |
|
ArgoCD Backend |
1.7.2 |
|
bs_1.54.9__1.7.2 |
|
Azure DevOps Backend |
0.32.0 |
|
bs_1.54.9__0.32.0 |
|
Azure DevOps Frontend |
0.34.0 |
|
bs_1.54.9__0.34.0 |
|
Catalog Backend Module Bitbucket Cloud |
0.5.14 |
|
bs_1.54.9__0.5.14 |
|
Catalog Backend Module Bitbucket Server |
0.5.14 |
|
bs_1.54.9__0.5.14 |
|
Datadog |
2.8.0 |
|
bs_1.54.9__2.8.0 |
|
Dynatrace |
10.23.0 |
|
bs_1.54.9__10.23.0 |
|
GitHub Actions |
1.4.0 |
|
bs_1.54.9__1.4.0 |
|
GitHub Insights |
3.6.0 |
|
bs_1.54.9__3.6.0 |
|
GitHub Issues |
1.4.0 |
|
bs_1.54.9__1.4.0 |
|
GitHub Pull Requests |
3.9.0 |
|
bs_1.54.9__3.9.0 |
|
JFrog Artifactory |
2.0.3 |
|
bs_1.54.9__2.0.3 |
|
Jenkins Backend |
0.31.0 |
|
bs_1.54.9__0.31.0 |
|
Jenkins Frontend |
0.34.0 |
|
bs_1.54.9__0.34.0 |
|
Lighthouse |
0.26.0 |
|
bs_1.54.9__0.26.0 |
|
Nexus Repository Manager |
1.27.4 |
|
bs_1.54.9__1.27.4 |
|
PagerDuty Backend |
0.14.0 |
|
bs_1.54.9__0.14.0 |
|
PagerDuty Frontend |
0.21.0 |
|
bs_1.54.9__0.21.0 |
|
Quay |
1.38.3 |
|
bs_1.54.9__1.38.3 |
|
Quay Backend |
1.18.1 |
|
bs_1.54.9__1.18.1 |
|
Roadie ArgoCD Backend |
4.9.0 |
|
bs_1.54.9__4.9.0 |
|
Scaffolder Backend ArgoCD |
1.9.0 |
|
bs_1.54.9__1.9.0 |
|
Scaffolder Backend Module Azure |
0.2.25 |
|
bs_1.54.9__0.2.25 |
|
Scaffolder Backend Module Bitbucket Cloud |
0.3.10 |
|
bs_1.54.9__0.3.10 |
|
Scaffolder Backend Module Bitbucket Server |
0.2.25 |
|
bs_1.54.9__0.2.25 |
|
Scaffolder Backend Module Gerrit |
0.2.24 |
|
bs_1.54.9__0.2.24 |
|
Scaffolder Backend Module Quay |
2.22.1 |
|
bs_1.54.9__2.22.1 |
|
Scaffolder Backend Module ServiceNow |
2.17.0 |
|
bs_1.54.9__2.17.0 |
|
Scaffolder Backend Module SonarQube |
2.17.0 |
|
bs_1.54.9__2.17.0 |
|
Scaffolder Backend Module Utils |
4.2.1 |
|
bs_1.54.9__4.2.1 |
|
SonarQube Backend |
1.3.0 |
|
bs_1.54.9__1.3.0 |
|
SonarQube Frontend |
1.3.0 |
|
bs_1.54.9__1.3.0 |
|
Tekton |
4.0.5 |
|
bs_1.54.9__4.0.5 |
4.1. Troubleshooting
Plugin not loading
If a plugin fails to load, perform the following checks:
-
Verify the
ghcr.iopath is correct and the image tag or digest exists. -
Confirm your cluster has network access to
ghcr.io. - Review Developer Hub logs for OCI pull errors.
Determining tag values
where:
<tag>Enter your RHDH version of Backstage and the plugin version, in the format
bs_<backstage-version>__<plugin-version>(note the double underscore delimiter). To find these versions, complete the following steps:- Find your Backstage version in the RHDH release notes preface.
Locate the plugin version in the Dynamic Plugins Reference guide. For example, for RHDH 1.9 based on Backstage 1.45.3, use the format
bs_1.45.3__<plugin-version>.TipTo ensure environment stability, use a SHA256 digest instead of a version tag. See Determining SHA256 Digests.
Determining SHA256 digests
You can look up the SHA256 digest using the Skopeo CLI or by searching in the RHDH Plugin Export Overlays repository.
Skopeo CLI
Ensure you have skopeo and jq installed.
- Locate the plugin path and artifact tag in the Dynamic plugins reference.
Remove the
oci://prefix and@sha256:…suffix from the path, then run:skopeo inspect docker://<registry>/<image>:<tag> | jq -r '.Digest'
RHDH Plugin Export Overlays Repo
Go to the plugin packages list in the rhdh-plugin-export-overlays repository. Search for your plugin and select the tag that is associated with this release.
4.2. Additional resources
Chapter 5. Deprecated plugins
There are no deprecated plugins in this release of Red Hat Developer Hub (RHDH)
Chapter 6. Other installable plugins
The following Technology Preview plugins are not preinstalled and must be installed from an external source.
These features are for Technology Preview only. Technology Preview features are not supported with Red Hat production service level agreements (SLAs), might not be functionally complete, and Red Hat does not recommend using them for production. These features provide early access to upcoming product features, enabling customers to test functionality and provide feedback during the development process.
For more information on Red Hat Technology Preview features, see Technology Preview Features Scope.
| Name | Plugin | Version | Installation Details |
|---|---|---|---|
|
Ansible Automation Platform Frontend |
1.0.0 | ||
|
Ansible Automation Platform |
1.0.0 | ||
|
Ansible Automation Platform Scaffolder Backend |
1.0.0 |