-
Notifications
You must be signed in to change notification settings - Fork 65
Backstage Compatibility Report
GitHub Actions Bot edited this page Jun 26, 2026
·
178 revisions
Some workspaces have a backstage version (in sources or in their overlay folder) which is incompatible with the target Backstage version (1.52.0).
63 incompatible workspaces, 36 of which are mandatory:
How to fix
You have 3 main options:
-
Use the already-opened PR : For automatically-discovered workspaces, there might already be an automatically-opened PR that updates the commit to the target backstage version (
Automatic PRlink in column 4 above): just publish the plugins and test them from the PR by following the PR instructions. -
Manually update the workspace commit :
- Find a newer commit, with a backstage version compatible with the target backstage version :__*
-
Backstage version history available: A
BS Version Historylink might be available in column 4: in the workspace source repository, it points to the list of commits touching thebackstage.jsonfile. This would help you finding out whether this workspace has a commit that has been published for the target backstage version. -
No info available: If no information is is provided in column 4, the
backstage.jsonprobably does not exist in workspace sources. You would have to look deeper into the newer commits of workspace sources, possibly in the low-level dependencies in thepackage.jsonfiles, to find out a commit with an underlying backstage version compatible with the target backstage version.
-
Backstage version history available: A
- Then, in the overlay repository, update the
repo-reffield of thesource.jsonfile to the new source commit, and remember to also change therepo-backstage-versionfield to the corresponding compatible backstage version.
- Find a newer commit, with a backstage version compatible with the target backstage version :__*
-
No compatible commit : If the workspace sources contain no compatible newer commit ( == a commit that provides a
backstage.jsonversion compatible with the target backstage), but the current workspace commit is known to work with the target backstage version, then you can override the declared backstage version compatibility for this workspace commit in the overlay repository using the/override-backstagecommand which will add abackstage.jsonfile at the root of the overlay workspace folder with the desired target backstage version. This would require full testing of the workspace plugins on the target backstage though.
- 64 workspaces
- 11 with patches