remove-immediate-stitching-mode
Backstage 1.51.0 codemod: Migrates catalog.stitchingStrategy.mode: immediate to deferred in app-config YAML files.
Background
In Backstage 1.51.0, catalog.stitchingStrategy.mode: immediate is deprecated. A warning is logged on startup when immediate mode is configured. Immediate mode will be removed in a future Backstage release. Deferred mode is the default.
What it does
- Scans
app-config.yamlandapp-config.*.yamlfiles - Finds
catalog.stitchingStrategy.mode: immediate(any quoting style) - If
stitchingStrategyonly containsmode: immediate, removes the entire block (deferred is the default) - If other
stitchingStrategykeys exist, changes onlymodetodeferred - Adds a migration comment under
catalogdocumenting the change
Usage
Before / After
When other stitching settings are present:
Notes
- Environment-specific config files (
app-config.production.yaml, etc.) are included in the scan. - Files already using
mode: deferredor without astitchingStrategyblock are left unchanged.