backstage-custom-resource
Purpose
Create and modify Backstage Custom Resources (CR) for the rhdh-operator. The rhdh-operator manages Red Hat Developer Hub (RHDH) deployments on Kubernetes/OpenShift using these CRs.
API Versions
Ask the user which version they need if not specified:
| API Version | Status | Key Difference |
|---|---|---|
rhdh.redhat.com/v1alpha3 |
Legacy | Base configuration |
rhdh.redhat.com/v1alpha4 |
Current | Adds monitoring field |
rhdh.redhat.com/v1alpha5 |
Latest | Adds deployment.kind, removes replicas/image from application |
Consult references/v1alpha3-spec.md, references/v1alpha4-spec.md, or references/v1alpha5-spec.md for complete Go struct definitions and field documentation.
Workflow
- Determine API version - Ask user or default to v1alpha5
- Identify requirements - Database (local/external), Route, plugins, monitoring
- Consult reference - Read the appropriate version spec from
references/ - Generate CR - Create valid YAML based on spec
- Validate - Ensure referenced ConfigMaps/Secrets exist
Minimal CR
apiVersion: rhdh.redhat.com/v1alpha5
kind: Backstage
metadata:
name: my-rhdh
namespace: rhdh
spec:
application: {}
Creates RHDH with local PostgreSQL, Route enabled, single replica.
Key Configuration Areas
Application
appConfig.configMaps- App-config YAML filesdynamicPluginsConfigMapName- Dynamic plugins ConfigMapextraEnvs- Environment variables from ConfigMaps/SecretsextraFiles- Files from ConfigMaps/Secrets/PVCsroute- OpenShift Route with TLS
Database
enableLocalDb: true- Operator-managed PostgreSQL (default)enableLocalDb: false+authSecretName- External database
Monitoring (v1alpha4+)
monitoring.enabled: true- Prometheus metrics
Deployment
deployment.kind- Deployment or StatefulSet (v1alpha5)deployment.patch- Strategic merge patch for workload
Reference Files
Consult these for complete field definitions:
references/v1alpha3-spec.md- v1alpha3 Go structs and YAML mappingreferences/v1alpha4-spec.md- v1alpha4 with Monitoringreferences/v1alpha5-spec.md- v1alpha5 with Deployment kind
Example Files
examples/backstage-cr.yaml- Common configuration patterns
External Resources
More from kadel/claude-plugins
jira cli usage
This skill should be used when the user asks to "interact with Jira", "list Jira issues", "create Jira issue", "manage sprints", "view epics", "search issues", "move issue status", "assign issue", or mentions using the jira command-line tool for project management.
13worktree feature development
This skill should be used when the user asks to "start a new feature", "create feature branch in worktree", "set up isolated feature development", "work on feature in separate directory", or mentions git worktree for feature isolation.
10generate frontend wiring
This skill should be used when the user asks to "generate frontend wiring", "show frontend wiring", "create RHDH binding", "generate dynamic plugin config", "show plugin wiring for RHDH", "create app-config for frontend plugin", or wants to generate the RHDH dynamic plugin wiring configuration for an existing Backstage frontend plugin. The skill analyzes the plugin's source code and generates the appropriate configuration.
9rhdh frontend dynamic plugin bootstrap
This skill should be used when the user asks to "create RHDH frontend plugin", "bootstrap frontend dynamic plugin", "create UI plugin for RHDH", "new frontend plugin for Red Hat Developer Hub", "add entity card to RHDH", "create dynamic route", "add sidebar menu item", "configure mount points", "create theme plugin", or mentions creating frontend components, UI pages, entity cards, or visual customizations for Red Hat Developer Hub or RHDH. This skill is specifically for frontend plugins - for backend plugins, use the separate backend plugin skill.
9rhdh backend dynamic plugin bootstrap
This skill should be used when the user asks to "create RHDH backend plugin", "bootstrap backend dynamic plugin", "create backstage backend plugin for RHDH", "new backend plugin for Red Hat Developer Hub", "create dynamic backend plugin", "scaffold RHDH backend plugin", "new scaffolder action", "create catalog processor", or mentions creating a new backend plugin, backend module, or server-side functionality for Red Hat Developer Hub or RHDH. This skill is specifically for backend plugins - for frontend plugins, use the separate frontend plugin skill.
9md-to-jira
Converts Markdown text to Jira wiki markup syntax. Use when the user asks to "convert markdown to jira", "format for jira", "jira markup", "md to jira", or has markdown content they want to paste into Jira/Confluence or use it with jira-cli.
3