Skip to content

feat: backstage-override package for seamless local stack setup - #57

Open
punkwalker wants to merge 1 commit into
mainfrom
feat/local-stack-override
Open

feat: backstage-override package for seamless local stack setup#57
punkwalker wants to merge 1 commit into
mainfrom
feat/local-stack-override

Conversation

@punkwalker

Copy link
Copy Markdown
Contributor

Summary

Adds a backstage-override idpbuilder package that replaces the ref-implementation's default Backstage deployment, eliminating the manual image swap and ArgoCD revert loop.

What changed

  • examples/local-stack/backstage-override/ — Full Backstage deployment manifest with CI-built image, guest auth, NODE_OPTIONS, homepage quick links, and k8s config baked in
  • examples/local-stack/backstage-override.yaml — ArgoCD Application named backstage that overrides the ref-implementation's default
  • Taskfile.ymltask stack:up is now a single command: idpbuilder + keycloak fix + kro + patches
  • examples/local-stack/README.md — Updated with quick start and troubleshooting

Problems solved

  1. ArgoCD image revert loop — Override package owns the backstage ArgoCD app, so no more sync conflicts
  2. Keycloak secret bugstack:keycloak-fix task automatically extracts secrets from job logs
  3. Manual image swap — CI image is baked into the manifest, no kubectl set image needed

Usage

task stack:up      # Full stack from scratch
task stack:iterate # Fast rebuild after code changes
task stack:down    # Tear down

Test Plan

  • task --list shows all stack commands
  • Verified backstage-override manifest matches ref-implementation structure
  • CI image tag matches current main HEAD

- Custom backstage-override ArgoCD app replaces ref-implementation's
  default backstage deployment with CI-built image
- Includes guest auth, NODE_OPTIONS, homepage quick links, k8s config
- Automated keycloak-fix task for upstream kubectl download bug
- Updated Taskfile: stack:up is now a single command that handles
  idpbuilder + keycloak fix + kro + patches
- New stack:swap task to deploy specific CI image by SHA
- Updated README with quick start and troubleshooting

Signed-off-by: Pankaj Walke <punkwalker@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant