nodedash
nodedash is a web UI for hardware
administration of Ironic bare metal nodes: power, maintenance, inventory, BIOS,
firmware, runbooks and console. Operators sign in through Keystone WebSSO and
pick a region, and nodedash finds that region's Ironic in the Keystone service
catalog, so one deployment serves every site.
Deployment Scope
- Cluster scope: global
- Values key:
global.nodedash - ArgoCD Application template:
charts/argocd-understack/templates/application-nodedash.yaml
How ArgoCD Builds It
- ArgoCD renders Helm chart
nodedash. - The deploy repo contributes
values.yamlfor this component. - The deploy repo overlay directory for this component is applied as a second source, so
kustomization.yamland any referenced manifests are part of the final Application.
How to Enable
Enable this component under the scope that matches your deployment model:
It deploys into the nodedash namespace. Set global.nodedash.namespace to
use another, and make sure the understack AppProject allows it.
Deployment Repo Content
Use any secret delivery mechanism you prefer. The contract that matters is the final Kubernetes Secret or manifest shape described below.
Required or commonly required items:
values.yaml: Set the chart'sconfig, at leastPUBLIC_URL,KEYSTONE_URL
andIDENTITY_PROVIDERS, and how the page is reached (httpRouteor
ingress). See the chart'svalues.yamlfor every option.- Session key Secret:
SESSION_KEYSencrypts the session cookie that carries
each user's Keystone tokens. Give each environment its own key, from
openssl rand -base64 32. Either setsessionKeys.externalSecretin
values.yamlso the chart creates an ExternalSecret, or provide the Secret
yourself and name it insessionKeys.secretName. kustomization.yaml: The directory is also applied as a second source, so
list any extra manifests here, orresources: []when there are none.
Outside this directory, Keystone must list ${PUBLIC_URL}/api/auth/websso in
its trusted_dashboard setting, or WebSSO sign-in is refused.
Optional additions:
- CA bundle: Mount it with
extraVolumes,extraVolumeMountsand
NODE_EXTRA_CA_CERTSinextraEnvwhen Keystone or Ironic use a private CA. networkPolicy: Restrict ingress to the gateway and egress to Keystone and
Ironic.