Skip to content

Commit 00d59a3

Browse files
docs: replace more showcase references with RHDH (redhat-developer#2241)
Signed-off-by: Christoph Jerolimov <[email protected]>
1 parent 27012ad commit 00d59a3

File tree

12 files changed

+38
-38
lines changed

12 files changed

+38
-38
lines changed

CONTRIBUTING.md

+4-4
Original file line numberDiff line numberDiff line change
@@ -7,10 +7,10 @@ We are excited to see you want to be a part of this project by contributing. Her
77
### Clone and Install
88

99
```bash
10-
git clone https://github.com/your-username/backstage-showcase.git # Clone your forked repository
11-
cd backstage-showcase # Change to the project directory
12-
yarn install # Install dependencies
13-
yarn tsc # Run type generation and checks
10+
git clone https://github.com/your-username/rhdh.git # Clone your forked repository
11+
cd rhdh # Change to the project directory
12+
yarn install # Install dependencies
13+
yarn tsc # Run type generation and checks
1414
```
1515

1616
### Run the Showcase App

docs/audit-log.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
1-
# Audit Logging for Backstage Showcase
1+
# Audit Logging for RHDH
22

3-
Backstage Showcase supports audit logging for both the catalog and scaffolder. Audit logs can be identified by the `isAuditLog: true` field.
3+
RHDH supports audit logging for both the catalog and scaffolder. Audit logs can be identified by the `isAuditLog: true` field.
44

55
## Configuring the audit logger
66

docs/auth.md

+3-3
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# Auth Providers within Backstage Showcase
1+
# Auth Providers within RHDH
22

33
Currently we incorporate many of the Authentication providers available within Backstage. The Showcase supports the following providers:
44

@@ -112,7 +112,7 @@ In an example using Keycloak for authentication with the OIDC provider, there ar
112112

113113
1. Create a realm named keycloak.
114114
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`.
116116
4. Set the `metadataUrl` to the URL of your Keycloak instance and realm. It should look similar to this: `<KEYCLOAK_URL>/realms/keycloak`.
117117
5. Set the `clientId` to `backstage`.
118118
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
127127

128128
### Sign In Page configuration value
129129

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.
131131

132132
- 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.
133133

docs/dynamic-plugins/debugging.md

+3-3
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33

44
## Backend Dynamic Plugins Local Debug
55

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:
77

88
* Build your plugin and export the dynamic package
99

@@ -16,7 +16,7 @@ yarn build && yarn run export-dynamic
1616

1717
Once the plugin is built and deployed, it is time to prepare the showcase to run it debug mode:
1818

19-
* Go to `backstage-showcase` root directory;
19+
* Go to `rhdh` root directory;
2020
* Run `yarn workspace backend start --inspect`
2121
* In logs you should see something like the following:
2222

@@ -30,7 +30,7 @@ Debugger listening on ws://127.0.0.1:9229/9299bb26-3c32-4781-9488-7759b8781db5
3030

3131
## Backend Dynamic Plugins Container Debug
3232

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:
3434

3535
* Create directory `dynamic-plugins-root`
3636
* Build your plugin and copy the folder `dist-dynamic` to `dynamic-plugins-root`

docs/e2e-tests/CI.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ This document provides a comprehensive overview of our Continuous Integration (C
44

55
## GitHub Pull Requests
66

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.
88

99
### Automatic Triggering of Tests
1010

docs/index.md

+3-3
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
1-
# Getting Started running Backstage Showcase
1+
# Getting Started running RHDH
22

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.
44

55
## Telemetry collection
66

@@ -153,7 +153,7 @@ If you wish to subsequently disable telemetry data collection, use one of the fo
153153

154154
## Running Locally with a basic configuration
155155

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.
157157

158158
1. Copy `app-config.example.yaml` and rename it as `app-config.local.yaml`.
159159

docs/monitoring-and-logging.md

+6-6
Original file line numberDiff line numberDiff 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
22

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.
44

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.
66

77
## Prerequisites
88

@@ -86,13 +86,13 @@ Similar to the instructions above for a Helm-based deployment, you can then veri
8686

8787
### Enabling Metrics Monitoring on Azure Kubernetes Service (AKS)
8888

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).
9090

9191
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).
9292

9393
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.
9494

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.
9696

9797
#### Helm deployment
9898

@@ -196,7 +196,7 @@ InsightsMetrics
196196

197197
## Logging
198198

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.
200200

201201
### Helm deployment
202202

docs/patch-package.md

+12-12
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ This guide will show you how to patch a package in Backstage using the `patch-pa
44

55
## Prerequisites
66

7-
- Have a `backstage-showcase` instance locally cloned
7+
- Have a `rhdh` instance locally cloned
88
- Have a `backstage` instance/fork locally cloned
99

1010
## Manually patching a package
@@ -33,11 +33,11 @@ This guide will show you how to patch a package in Backstage using the `patch-pa
3333

3434
# 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
3535
update_file_references
36-
# Merge the contents of the patched package into the node_modules directory of the backstage-showcase project
37-
cp -Rv plugin-scaffolder-backend/* /home/user/backstage-showcase/node_modules/@backstage/plugin-scaffolder-backend
36+
# Merge the contents of the patched package into the node_modules directory of the rhdh project
37+
cp -Rv plugin-scaffolder-backend/* /home/user/rhdh/node_modules/@backstage/plugin-scaffolder-backend
3838
```
3939

40-
1. Then navigate to the `backstage-showcase` project and run the following commands to generate the patch files:
40+
1. Then navigate to the `rhdh` project and run the following commands to generate the patch files:
4141

4242
```bash
4343
# Generate the patch file
@@ -52,26 +52,26 @@ This guide will show you how to patch a package in Backstage using the `patch-pa
5252

5353
1. Create a new branch in your `backstage` instance for your target backstage version
5454
1. Navigate to the `backstage` project and make your changes to the package/plugin you want to patch as if you were going to submit a PR
55-
1. Navigate to the `backstage-showcase` project and run the `.scripts/patch-package.sh` to create a patch file for the package(s) you want to patch.
55+
1. Navigate to the `rhdh` project and run the `.scripts/patch-package.sh` to create a patch file for the package(s) you want to patch.
5656

5757
- Script Usage: `./patch-package.sh [src] [dest] [package-name-1] [package-name-2] ...`
5858
- The `src` is the path to the `backstage` project containing your patch changes
59-
- The `dest` is the path to the `backstage-showcase` project where the patch file will be created
59+
- The `dest` is the path to the `rhdh` project where the patch file will be created
6060
- The `package-name` array of arguments is the name of the package(s) you want to patch
61-
- When listing package names, please ensure it matches the package name in the `@backstage/node_modules` directory of the `backstage-showcase` project
61+
- When listing package names, please ensure it matches the package name in the `@backstage/node_modules` directory of the `rhdh` project
6262
- Example usage of patching a plugin and a package:
6363

6464
```bash
65-
./patch-package.sh /path/to/backstage /path/to/backstage-showcase @backstage/plugin-scaffolder-backend @backstage/integration
65+
./patch-package.sh /path/to/backstage /path/to/rhdh @backstage/plugin-scaffolder-backend @backstage/integration
6666
```
6767

68-
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
6969

7070
## Caveats
7171

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
7373
- 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
7575
- 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
7676
7777
- 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
115115
```
116116

117117
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

dynamic-plugins/wrappers/red-hat-developer-hub-backstage-plugin-catalog-backend-module-marketplace-dynamic/package.json

+1-1
Original file line numberDiff line numberDiff line change
@@ -47,7 +47,7 @@
4747
},
4848
"repository": {
4949
"type": "git",
50-
"url": "https://github.com/janus-idp/backstage-showcase",
50+
"url": "https://github.com/redhat-developer/rhdh",
5151
"directory": "dynamic-plugins/wrappers/red-hat-developer-hub-backstage-plugin-catalog-backend-module-marketplace-dynamic"
5252
},
5353
"maintainers": [

dynamic-plugins/wrappers/red-hat-developer-hub-backstage-plugin-marketplace-backend-dynamic/package.json

+1-1
Original file line numberDiff line numberDiff line change
@@ -53,7 +53,7 @@
5353
],
5454
"repository": {
5555
"type": "git",
56-
"url": "https://github.com/janus-idp/backstage-showcase",
56+
"url": "https://github.com/redhat-developer/rhdh",
5757
"directory": "dynamic-plugins/wrappers/red-hat-developer-hub-backstage-plugin-marketplace-backend-dynamic"
5858
},
5959
"maintainers": [

dynamic-plugins/wrappers/red-hat-developer-hub-backstage-plugin-marketplace/package.json

+1-1
Original file line numberDiff line numberDiff line change
@@ -49,7 +49,7 @@
4949
},
5050
"repository": {
5151
"type": "git",
52-
"url": "https://github.com/janus-idp/backstage-showcase",
52+
"url": "https://github.com/redhat-developer/rhdh",
5353
"directory": "dynamic-plugins/wrappers/red-hat-developer-hub-backstage-plugin-marketplace"
5454
},
5555
"maintainers": [

scripts/update-backstage.mjs

+1-1
Original file line numberDiff line numberDiff line change
@@ -341,7 +341,7 @@ async function main() {
341341
updateBuildMetadata(backstageVersion);
342342

343343
console.log(
344-
`Successfully updated the Backstage Showcase to ${backstageVersion}!`,
344+
`Successfully updated Backstage to ${backstageVersion}!`,
345345
);
346346
} catch (error) {
347347
console.error("An error occurred during the update process:", error);

0 commit comments

Comments
 (0)