You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardexpand all lines: docs/auth.md
+3-3
Original file line number
Diff line number
Diff line change
@@ -1,4 +1,4 @@
1
-
# Auth Providers within Backstage Showcase
1
+
# Auth Providers within RHDH
2
2
3
3
Currently we incorporate many of the Authentication providers available within Backstage. The Showcase supports the following providers:
4
4
@@ -112,7 +112,7 @@ In an example using Keycloak for authentication with the OIDC provider, there ar
112
112
113
113
1. Create a realm named keycloak.
114
114
2. Create the client backstage with Client authentication checked.
115
-
3. Set the Valid redirect URIs to `<BACKSTAGE_URL>/api/auth/oidc/handler/frame`. If running Backstage Showcase locally, it would look something like this: `http://localhost:7007/api/auth/oidc/handler/frame`.
115
+
3. Set the Valid redirect URIs to `<BACKSTAGE_URL>/api/auth/oidc/handler/frame`. If running RHDH locally, it would look something like this: `http://localhost:7007/api/auth/oidc/handler/frame`.
116
116
4. Set the `metadataUrl` to the URL of your Keycloak instance and realm. It should look similar to this: `<KEYCLOAK_URL>/realms/keycloak`.
117
117
5. Set the `clientId` to `backstage`.
118
118
6. Obtain the client secret for the client backstage within Keycloak and set `clientSecret`.
@@ -127,7 +127,7 @@ For more information on setting up the OIDC auth provider, consult the [Backstag
127
127
128
128
### Sign In Page configuration value
129
129
130
-
After selecting the authentication provider you wish to use with your Backstage Showcase instance, ensure to add the `signInPage` configuration value to ensure that the frontend displays the appropriate authentication provider.
130
+
After selecting the authentication provider you wish to use with your RHDH instance, ensure to add the `signInPage` configuration value to ensure that the frontend displays the appropriate authentication provider.
131
131
132
132
- Add the corresponding Authentication provider key as the value to `signInPage` in your `app-config`. Where `provider-id` matches the chosen provider from the table above.
Copy file name to clipboardexpand all lines: docs/dynamic-plugins/debugging.md
+3-3
Original file line number
Diff line number
Diff line change
@@ -3,7 +3,7 @@
3
3
4
4
## Backend Dynamic Plugins Local Debug
5
5
6
-
For local debugging of Dynamic Plugins you need to clone `backstage-showcase`, run it with debugging enabled and attach your IDE debugger to the backend process. First it is required to build and copy the dynamic plugin:
6
+
For local debugging of Dynamic Plugins you need to clone `rhdh`, run it with debugging enabled and attach your IDE debugger to the backend process. First it is required to build and copy the dynamic plugin:
7
7
8
8
* Build your plugin and export the dynamic package
9
9
@@ -16,7 +16,7 @@ yarn build && yarn run export-dynamic
16
16
17
17
Once the plugin is built and deployed, it is time to prepare the showcase to run it debug mode:
18
18
19
-
* Go to `backstage-showcase` root directory;
19
+
* Go to `rhdh` root directory;
20
20
* Run `yarn workspace backend start --inspect`
21
21
* In logs you should see something like the following:
22
22
@@ -30,7 +30,7 @@ Debugger listening on ws://127.0.0.1:9229/9299bb26-3c32-4781-9488-7759b8781db5
30
30
31
31
## Backend Dynamic Plugins Container Debug
32
32
33
-
It is possible to run RHDH on a container and debug plugins that are running on it. In this case you don't need to clone the `backstage-showcase` code locally, instead you must make sure that the running container has the [Node.js debug](https://nodejs.org/en/learn/getting-started/debugging) port open and exposed to the host machine. These are the steps to debug backend dynamic plugins on a container:
33
+
It is possible to run RHDH on a container and debug plugins that are running on it. In this case you don't need to clone the `rhdh` code locally, instead you must make sure that the running container has the [Node.js debug](https://nodejs.org/en/learn/getting-started/debugging) port open and exposed to the host machine. These are the steps to debug backend dynamic plugins on a container:
34
34
35
35
* Create directory `dynamic-plugins-root`
36
36
* Build your plugin and copy the folder `dist-dynamic` to `dynamic-plugins-root`
Copy file name to clipboardexpand all lines: docs/e2e-tests/CI.md
+1-1
Original file line number
Diff line number
Diff line change
@@ -4,7 +4,7 @@ This document provides a comprehensive overview of our Continuous Integration (C
4
4
5
5
## GitHub Pull Requests
6
6
7
-
When a new Pull Request (PR) is opened at [backstage-showcase](https://github.com/redhat-developer/rhdh), tests are triggered based on the nature of the changes and the contributor's role.
7
+
When a new Pull Request (PR) is opened at [rhdh](https://github.com/redhat-developer/rhdh), tests are triggered based on the nature of the changes and the contributor's role.
Copy file name to clipboardexpand all lines: docs/index.md
+3-3
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,6 @@
1
-
# Getting Started running Backstage Showcase
1
+
# Getting Started running RHDH
2
2
3
-
There are several different methods for running the Backstage Showcase app today. We currently have support for running the application locally, using a helm chart to deploy to a cluster, and manifests for deployment using ArgoCD.
3
+
There are several different methods for running the RHDH app today. We currently have support for running the application locally, using a helm chart to deploy to a cluster, and manifests for deployment using ArgoCD.
4
4
5
5
## Telemetry collection
6
6
@@ -153,7 +153,7 @@ If you wish to subsequently disable telemetry data collection, use one of the fo
153
153
154
154
## Running Locally with a basic configuration
155
155
156
-
The easiest and fastest method for getting started: Backstage Showcase app, running it locally only requires a few simple steps.
156
+
The easiest and fastest method for getting started: RHDH app, running it locally only requires a few simple steps.
157
157
158
158
1. Copy `app-config.example.yaml` and rename it as `app-config.local.yaml`.
Copy file name to clipboardexpand all lines: docs/monitoring-and-logging.md
+6-6
Original file line number
Diff line number
Diff line change
@@ -1,8 +1,8 @@
1
-
# Setting up Metrics Monitoring and Logging for Backstage Showcase
1
+
# Setting up Metrics Monitoring and Logging for RHDH
2
2
3
-
The Backstage Showcase provides a `/metrics` endpoint on port `9464` that provides OpenTelemetry metrics about your backstage application. This endpoint can be used to monitor your backstage instance using OpenTelemetry and Grafana.
3
+
The RHDH provides a `/metrics` endpoint on port `9464` that provides OpenTelemetry metrics about your backstage application. This endpoint can be used to monitor your backstage instance using OpenTelemetry and Grafana.
4
4
5
-
When deploying Backstage Showcase onto a kubernetes cluster with the [RHDH Helm chart](https://github.com/redhat-developer/rhdh-chart) or the [RHDH Operator](https://github.com/janus-idp/operator), monitoring and logging for your RHDH instance can be configured using the following steps.
5
+
When deploying RHDH onto a kubernetes cluster with the [RHDH Helm chart](https://github.com/redhat-developer/rhdh-chart) or the [RHDH Operator](https://github.com/janus-idp/operator), monitoring and logging for your RHDH instance can be configured using the following steps.
6
6
7
7
## Prerequisites
8
8
@@ -86,13 +86,13 @@ Similar to the instructions above for a Helm-based deployment, you can then veri
86
86
87
87
### Enabling Metrics Monitoring on Azure Kubernetes Service (AKS)
88
88
89
-
To enable metrics monitoring for Backstage Showcase on Azure Kubernetes Service (AKS), you can use the [Azure Monitor managed service for Prometheus](https://learn.microsoft.com/en-us/azure/azure-monitor/essentials/prometheus-metrics-overview). The AKS cluster will need to have an associated [Azure Monitor workspace](https://learn.microsoft.com/en-us/azure/azure-monitor/containers/prometheus-metrics-enable?tabs=azure-portal).
89
+
To enable metrics monitoring for RHDH on Azure Kubernetes Service (AKS), you can use the [Azure Monitor managed service for Prometheus](https://learn.microsoft.com/en-us/azure/azure-monitor/essentials/prometheus-metrics-overview). The AKS cluster will need to have an associated [Azure Monitor workspace](https://learn.microsoft.com/en-us/azure/azure-monitor/containers/prometheus-metrics-enable?tabs=azure-portal).
90
90
91
91
One method is to configure the metrics scraping of your AKS cluster using the [Azure Monitor _metrics_ add-on](https://learn.microsoft.com/en-us/azure/azure-monitor/containers/prometheus-metrics-scrape-configuration).
92
92
93
93
The other method is to configure the Azure Monitor _monitoring_ add-on which also allows you to [send Prometheus metrics to the Log Analytics workspace](https://learn.microsoft.com/en-us/azure/azure-monitor/containers/container-insights-prometheus-logs). These metrics can then be queried using [Log Analytics queries](https://learn.microsoft.com/en-us/azure/azure-monitor/containers/container-insights-log-query#prometheus-metrics) as well as be visible in a Grafana instance.
94
94
95
-
In both methods, we can configure the metrics scraping to scrap from pods based on pod Annotations. Follow the steps below depending on how the Backstage Showcase application is deployed.
95
+
In both methods, we can configure the metrics scraping to scrap from pods based on pod Annotations. Follow the steps below depending on how the RHDH application is deployed.
96
96
97
97
#### Helm deployment
98
98
@@ -196,7 +196,7 @@ InsightsMetrics
196
196
197
197
## Logging
198
198
199
-
Logging in backstage showcase is conducted using the [winston](https://github.com/winstonjs/winston) library. By default, logs of level `debug` are not logged. To enable debug logs, you will need to set the environment variable `LOG_LEVEL` to `debug` in your deployment.
199
+
Logging in RHDH is conducted using the [winston](https://github.com/winstonjs/winston) library. By default, logs of level `debug` are not logged. To enable debug logs, you will need to set the environment variable `LOG_LEVEL` to `debug` in your deployment.
Copy file name to clipboardexpand all lines: docs/patch-package.md
+12-12
Original file line number
Diff line number
Diff line change
@@ -4,7 +4,7 @@ This guide will show you how to patch a package in Backstage using the `patch-pa
4
4
5
5
## Prerequisites
6
6
7
-
- Have a `backstage-showcase` instance locally cloned
7
+
- Have a `rhdh` instance locally cloned
8
8
- Have a `backstage` instance/fork locally cloned
9
9
10
10
## Manually patching a package
@@ -33,11 +33,11 @@ This guide will show you how to patch a package in Backstage using the `patch-pa
33
33
34
34
# This is an optional step to remove the old .cjs.js and .cjs.js.map files in the dist/cjs directory of the package. Please refer to the caveats section for more information
35
35
update_file_references
36
-
# Merge the contents of the patched package into the node_modules directory of the backstage-showcase project
1. The script will create patch files in the `patches` directory of the `backstage-showcase` project. Run `yarn install --force`in the `backstage-showcase` project and verify that the patches were applied correctly
68
+
1. The script will create patch files in the `patches` directory of the `rhdh` project. Run `yarn install --force`in the `rhdh` project and verify that the patches were applied correctly
69
69
70
70
## Caveats
71
71
72
-
- The `patch-package` script will not work if the package you are trying to patch is not installed in the `backstage-showcase` project
72
+
- The `patch-package` script will not work if the package you are trying to patch is not installed in the `rhdh` project
73
73
- The `patch-package` script will not be able to patch modifications to the `package.json` to add new dependencies or change the version of existing dependencies
74
-
- You will need to manually update the `package.json`in the `backstage-showcase` project to include the new dependencies or changes to existing dependencies since the patches are applied after the `yarn install`command is run
74
+
- You will need to manually update the `package.json`in the `rhdh` project to include the new dependencies or changes to existing dependencies since the patches are applied after the `yarn install`command is run
75
75
- The `patch-package` script will leave behind the old `.cjs.js` and `.cjs.js.map` files in the `dist/cjs` directory of the package if the resultant package's a `dist/cjs` directory that contains more than 2 files
76
76
77
77
- This is due to the resultant file names after a build being different if any modifications were made to them.
@@ -115,4 +115,4 @@ This guide will show you how to patch a package in Backstage using the `patch-pa
115
115
```
116
116
117
117
3. Repeat for any other files that need to be renamed
118
-
4. Merge the patched package with the `node_modules` package in the `backstage-showcase` project
118
+
4. Merge the patched package with the `node_modules` package in the `rhdh` project
Copy file name to clipboardexpand all lines: dynamic-plugins/wrappers/red-hat-developer-hub-backstage-plugin-catalog-backend-module-marketplace-dynamic/package.json
0 commit comments