Skip to content

Conversation

@github-actions
Copy link
Contributor

@github-actions github-actions bot commented Sep 23, 2025

Add matomo workspace at commit backstage/community-plugins@3e2c0cf for backstage 1.41.1 on branch main.

This PR was created automatically.

⚠️ Manual approval required
This proposal is a Best-Effort Backstage compatibility match. Plugin sources are built for Backstage 1.41.1. Please review and test before merging.

If you have tested and confirmed compatibility, you should add a backstage.json file in the workspace folder to override the known Backstage compatibility to be the target Backstage version.
Don't forget to also update the repo-backstage-version field in source.json accordingly.

⚠️ Manual approval required
This proposal is a Best-Effort Backstage compatibility match. Plugin sources are built for Backstage 1.41.1. Please review and test before merging.

If you have tested and confirmed compatibility, you should add a backstage.json file in the workspace folder to override the known Backstage compatibility to be the target Backstage version.
Don't forget to also update the repo-backstage-version field in source.json accordingly.

You might need to complete it with additional dynamic plugin export information, like:

  • the associated app-config.dynamic.yaml file for frontend plugins,
  • optionally the scalprum-config.json file for frontend plugins,
  • optionally some overlay source files at the plugin level,
  • optionally patches at the workspace level in the patches/ directory

Before merging, you need to export the workspace dynamic plugins as OCI images,
and if possible test them inside a RHDH instance.

To do so, you can use the /publish instruction in a PR review comment.
This will start a PR check workflow to:

  • export the workspace plugins as dynamic plugins,
  • publish them as OCI images
  • push the oci-images in the GitHub container registry with a PR-specific tag.

@github-actions github-actions bot requested review from a team, gashcrumb and kadel as code owners September 23, 2025 19:49
@github-actions github-actions bot added the workspace-addition PR adds a new workspace label Sep 24, 2025
@github-actions
Copy link
Contributor Author

github-actions bot commented Oct 6, 2025

Successfully updated file versions.jsonfrom branch main into this PR in commit d6c37e4

@github-actions
Copy link
Contributor Author

A new workspace commit 3e2c0cf90b1b6a9c2fae063b5835a632fcf884d5 has been discovered (match type: 'best-effort').
You can update this PR with the latest discovered workspace source commit.

To do so, you can use the /update-commit instruction in a PR review comment.

@davidfestal
Copy link
Member

/update-commit

@github-actions github-actions bot changed the title Add matomo workspace to commit e35fb62 for backstage 1.41.1 on branch main Add matomo workspace to commit 3e2c0cf for backstage 1.41.1 on branch main Oct 16, 2025
@github-actions
Copy link
Contributor Author

Recommended actions after the commit update:

  • Best-Effort upgrade with unknown backstage compatibility: After testing the plugins against the target backstage version, you should add a backstage.json file in the workspace folder to override the known Backstage compatibility to be the target Backstage version.
  • Don't forget to also update the repo-backstage-version field in source.json accordingly.

@github-actions
Copy link
Contributor Author

Update Commit workflow has completed with success.

@davidfestal
Copy link
Member

/publish

@github-actions
Copy link
Contributor Author

Publish workflow has completed with failure.

  • Published container images:
    • ghcr.io/redhat-developer/rhdh-plugin-export-overlays/backstage-community-plugin-matomo:pr_1467__1.13.1
    • ghcr.io/redhat-developer/rhdh-plugin-export-overlays/backstage-community-plugin-matomo-backend:pr_1467__1.14.0

@davidfestal
Copy link
Member

/publish

@github-actions
Copy link
Contributor Author

Publish workflow has completed with failure.

Backstage-incompatible workspaces

Some workspaces have a backstage version (in sources or in their overlay folder) which is incompatible with the target Backstage version (1.42.5).
1 incompatible workspaces, 0 of which are mandatory:

Folder Backstage version Mandatory Info
workspaces/matomo 1.41.1 BS Version History

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 PR link 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 History link might be available in column 4: in the workspace source repository, it points to the list of commits touching the backstage.json file. 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.json probably 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 the package.json files, to find out a commit with an underlying backstage version compatible with the target backstage version.
    • Then, in the overlay repository, update the repo-ref field of the source.json file to the new source commit, and remember to also change the repo-backstage-version field to the corresponding compatible backstage version.
  • No compatible commit : If the workspace sources contain no compatible newer commit ( == a commit that provides a backstage.json version 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: add a backstage.json file at the root of the overlay workspace folder with the desired target backstage version, and remember to also change the repo-backstage-version field of the source.json file to the same target backstage version. This would require full testing of the workspace plugins on the target backstage though.

  • Published container images:

    • ghcr.io/redhat-developer/rhdh-plugin-export-overlays/backstage-community-plugin-matomo:pr_1467__1.13.1
    • ghcr.io/redhat-developer/rhdh-plugin-export-overlays/backstage-community-plugin-matomo-backend:pr_1467__1.14.0

@davidfestal
Copy link
Member

/update-commit

@github-actions
Copy link
Contributor Author

Update Commit workflow has completed with success.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

workspace-addition PR adds a new workspace

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant