Developer Hub 2.1 makes custom plug-ins an upgrade prerequisite, not an afterthought
Red Hat’s migration guide says legacy Scalprum mounts can stop the portal at startup, while standalone OCI plug-in images and Backstage extension blueprints redraw the packaging boundary.
Red Hat is warning platform teams not to treat the Red Hat Developer Hub 2.1 upgrade as a routine image bump. The release removes the old front-end system and Scalprum-based runtime mounts, making custom plug-in migration a prerequisite for a clean startup rather than a post-upgrade cleanup task.
What changes in 2.1
Developer Hub 1.10 let adopters switch between the old and new Backstage front ends with environment flags. In 2.1, the app-next architecture becomes the application shell, and plug-ins that still depend on dynamicPlugins.frontend Scalprum mount points will not load. Red Hat says those legacy plug-ins can cause the deployment to fail during startup.
The replacement is upstream Backstage’s extension-blueprint model. Plug-in authors define pages, entity cards and other placement in TypeScript, then expose an ./alpha entry point alongside the existing root export. That dual-export pattern lets one package continue serving Developer Hub 1.10 while it is prepared for 2.1.
Configuration changes with the code. Routes, cards and default placement move out of scattered dynamic-plug-in YAML and into plug-in defaults, while operators use app.extensions and app.routes.bindings for overrides. One subtle migration risk is that app.extensions is an array: a higher-priority configuration file replaces the whole array rather than merging entries by identifier.
Packaging moves out of the core image
Developer Hub 2.1 also removes dynamic plug-in wrappers from the main product container. Red Hat says wrappers will instead ship as standalone OCI images built through Konflux and published on Quay. That separates plug-in fixes from the core Developer Hub release cycle and gives platform teams a more explicit artifact to promote and pin.
For custom authors, Red Hat’s six-step workflow is to inventory exports and mount points, add the alpha export, convert React components to Backstage blueprints, update the package map, add a new-front-end development harness, and verify with TypeScript and a build.
What platform teams should do now
Before moving a production portal to 2.1, teams should identify every custom front-end plug-in, convert legacy mount configuration, remove bundled-wrapper paths and test the resulting portal against an early 2.1 image. Red Hat provides experimental coding-agent skills for both plug-in migration and configuration conversion, but labels them community utilities rather than supported product features.
The practical gate is simple: a staging portal should boot with every custom route and entity card accounted for before the production upgrade begins. Teams that wait until deployment time risk discovering that the portal shell itself cannot start.
sources
- Migrate your custom plug-ins to Red Hat Developer Hub 2.1developers.redhat.com
comments · 0