[RHIDP#14276]: Document new standalone Helm chart values reference by rh-tokeefe · Pull Request #2500 · redhat-developer/red-hat-developers-documentation-rhdh

rh-tokeefe · 2026-07-24T17:02:25Z

IMPORTANT: Do Not Merge - To be merged by Docs Team Only

Version(s): 2.1

Issue: https://redhat.atlassian.net/browse/RHIDP-14276

Preview: N/A (draft — pending chart PR merge)

Summary

Add 13 new reference modules documenting the standalone RHDH Helm chart values (replaces the old upstream Backstage subchart-based reference)
Update assembly to include new modules and remove old upstream namespace references
Update helm show values procedure for new chart name (rhdh)
Update {default-helm-chart-values-link} attribute to point to charts/rhdh/values.yaml

Notes

This is a draft based on the current state of the developer's branch (rhdh-chart PR 438). The values schema may change after the developer returns from PTO. The old reference modules (upstream namespace, additional upstream values) are left on disk for release-1.x branches but removed from the assembly includes.

Related dev feature: RHDHPLAN-1058

Test plan

Verify all 13 new reference modules render correctly in HTML preview
Cross-check values against final charts/rhdh/values.yaml when chart PR merges
Confirm no broken cross-references in the Helm chart config reference title
Run CQA checks

🤖 Generated with Claude Code

…chart Replace the old upstream Backstage subchart-based reference modules with 13 focused reference modules covering the new standalone chart's flat values structure. Update assembly includes, helm CLI procedure, and chart attributes to match. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

This reverts commit 4cb6c21.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

rhdh-bot · 2026-07-24T17:05:22Z

The asterisks in `*Override` and `extra*` inside backticks caused mismatched emphasis/literal tags in DocBook XML. Reworded to use explicit key names instead. Reverted the helm chart values link back to charts/backstage/values.yaml since charts/rhdh/values.yaml does not exist on release-1.10 yet. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

sonarqubecloud · 2026-07-24T17:17:09Z

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

rm3l · 2026-08-06T22:41:17Z

 [,console,subs="+attributes,+quotes"]
 ----
-$ helm pull redhat-developer-hub \
+$ helm pull rhdh \


Suggested change

$ helm pull rhdh \

$ helm pull redhat-developer-hub \

The chart name would remain the same.

This hasn't been updated. Or did I miss anything?

Suggested change

$ helm pull rhdh \

$ helm pull redhat-developer-hub \

rm3l · 2026-08-06T22:44:52Z

 [,console]
 ----
-$ helm show values redhat-developer-hub/charts/backstage
+$ helm show values rhdh


Suggested change

$ helm show values rhdh

$ helm show values redhat-developer-hub

rm3l · 2026-08-06T22:45:10Z

 [,console]
 ----
-$ helm show values redhat-developer-hub/charts/backstage/charts/postgresql
+$ helm show values rhdh/charts/postgresql


Suggested change

$ helm show values rhdh/charts/postgresql

$ helm show values redhat-developer-hub/charts/postgresql

rm3l · 2026-08-06T22:49:11Z

+|list
+|[]
+
+|extraEnvFrom


All extra* fields do not override the default system behavior. They are only appended to the defaults. So I think they should not be listed under this section.

Moved to separate "Extra keys" subsection

rm3l · 2026-08-06T22:50:46Z

+
+[IMPORTANT]
+====
+The override keys (for example, `commandOverride` and `envOverride`) replace system defaults entirely. When you use an override key, system-injected environment variables such as `BACKEND_SECRET` and database credentials are not added automatically. Use the extra keys (for example, `extraEnv` and `extraArgs`) to add values without replacing the defaults.


We could also explicitly call out that it is the user's responsibility to keep track of any changes to the defaults if they use the *Override fields. For example, if we update the defaults in a followup upgrade, users should make sure to somehow reflect that in their override.

rm3l · 2026-08-06T23:03:50Z

+|imageRegistry
+|Global container image registry. Overrides per-image registries for all containers.
+|string
+|""
+
+|imagePullSecrets
+|Global container image registry secret names.
+|list
+|[]
+
+|defaultStorageClass
+|Global default StorageClass for PVCs.
+|string
+|""
+
+|nameOverride
+|Override the chart name used in resource naming.
+|string
+|""
+
+|fullnameOverride
+|Override the full resource name.
+|string
+|""
+
+|commonLabels
+|Labels applied to all chart resources.
+|object
+|{}
+
+|commonAnnotations
+|Annotations applied to all chart resources.
+|object
+|{}
+
+|host


This reads like all those fields are global.
Some of those fields are under the global. scope, others are not; for example global.imageRegistry but simply host.
Refer to the values.yaml in the chart PR.

Split into "Global parameters" (global. prefix) and "Chart-level parameters" sections

rm3l · 2026-09-02T12:33:29Z

FYI, Lightspeed has been rebranded to "Intelligent Assistant" and this has been reflected in the fields of the new chart (redhat-developer/rhdh-chart#515) => s/lightspeed/intelligentAssistant/g and s/Lightspeed/Intelligent Assistant/g

cc @Jdubrick

Thanks for calling that out @rm3l I didn't realize there was an in-progress doc item!

rm3l · 2026-09-02T12:36:11Z

+|===
+d|*Key* |*Description* |*Type* d|*Default*
+
+|imageRegistry


Suggested change

|imageRegistry

|global.imageRegistry

rm3l · 2026-09-02T12:36:23Z

+|string
+|""
+
+|imagePullSecrets


Suggested change

|imagePullSecrets

|global.imagePullSecrets

rm3l · 2026-09-02T12:36:43Z

+|list
+|[]
+
+|defaultStorageClass


Suggested change

|defaultStorageClass

|global.defaultStorageClass

rm3l · 2026-09-02T12:37:24Z

+|lightspeed.core.image.tag
+|Core sidecar image tag.
+|string
+|"0.5.3"


Suggested change

|"0.5.3"

|"0.6.2"

rm3l · 2026-09-02T12:37:46Z

+|test.image.tag
+|Test image tag.
+|string
+|"8.9.1"


Suggested change

|"8.9.1"

|"8.21.0"

rm3l · 2026-09-02T12:38:57Z

 [,console,subs="+attributes,+quotes"]
 ----
-$ helm pull redhat-developer-hub \
+$ helm pull rhdh \


This hasn't been updated. Or did I miss anything?

Suggested change

$ helm pull rhdh \

$ helm pull redhat-developer-hub \

rm3l · 2026-09-02T12:40:51Z

+|""
+
+|imagePullSecrets
+|Secrets for pulling images from private registries. Merged with global `imagePullSecrets`.


Suggested change

|Secrets for pulling images from private registries. Merged with global `imagePullSecrets`.

|Secrets for pulling images from private registries. Merged with `global.imagePullSecrets`.

rh-tokeefe and others added 4 commits July 24, 2026 12:33

Replace bare Lightspeed with {ls-brand-name} attribute

4cb6c21

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Revert "Replace bare Lightspeed with {ls-brand-name} attribute"

b230983

This reverts commit 4cb6c21.

Replace bare Lightspeed with {ls-brand-name} in assembly category list

4c2f723

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

rh-tokeefe temporarily deployed to internal July 24, 2026 17:03 — with GitHub Actions Inactive

rh-tokeefe temporarily deployed to internal July 24, 2026 17:16 — with GitHub Actions Inactive

rh-tokeefe added the do-not-merge/work-in-progress label Jul 27, 2026

rm3l reviewed Aug 6, 2026

View reviewed changes

rm3l reviewed Sep 2, 2026

View reviewed changes

	$ helm show values rhdh
	$ helm show values redhat-developer-hub

	$ helm show values rhdh/charts/postgresql
	$ helm show values redhat-developer-hub/charts/postgresql

	\|Secrets for pulling images from private registries. Merged with global `imagePullSecrets`.
	\|Secrets for pulling images from private registries. Merged with `global.imagePullSecrets`.

Uh oh!

Conversation

rh-tokeefe commented Jul 24, 2026

Summary

Notes

Test plan

Uh oh!

rhdh-bot commented Jul 24, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

PR Build Results

Content Quality Assessment

CQA Report

Summary

Modules not yet in product_product

Uh oh!

sonarqubecloud Bot commented Jul 24, 2026

Quality Gate passed

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

rm3l Sep 2, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

rm3l Sep 2, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

rhdh-bot commented Jul 24, 2026 •

edited

Loading

rm3l Sep 2, 2026 •

edited

Loading

rm3l Sep 2, 2026 •

edited

Loading