v1.28.0-next.1

See docs/releases/v1.28.0-next.1-changelog.md for more information.

v1.27.5

This release fixes an issue where the MultiEntityPicker would crash when using in the Scaffolder plugin

v1.27.4

This release fixes:

• an issue with esm loaded dependencies being different from the cjs import for EXPERIMENTAL_VITE dependencies
• an issue in GitlabOrgDiscoveryEntityProvider where a missing orgEnabled config key was throwing an error.
• an issue in GitlabDiscoveryEntityProvider where the fallback branch was taking precedence over the GitLab default branch.

v1.27.3

This release fixes the $Review label in the Scaffolder form to be Review

v1.28.0-next.0

See docs/releases/v1.28.0-next.0-changelog.md for more information.

v1.27.2

This release fixes the following issues:

• Fix logger crash on logging because of cyclical structures in the meta fields.
• Fix an issue with external config schemas in the app-backend plugin which was previously broken.
• Fix issue where MUI v5 components would not properly receive a v5- class prefix.
• Fix issue with search-backend startup not happening in the correct order

v1.27.1

This release fixes an issue where the backend logger services would throw an error when passing a log meta object with a null prototype.

v1.27.0

These are the release notes for the v1.27.0 release of Backstage.

A huge thanks to the whole team of maintainers and contributors as well as the amazing Backstage Community for the hard work in getting this release developed and done.

Highlights

Backend System Deprecations

As part of the work towards a stable 1.0 release of the new backend system, we will deprecate and move or remove several utilities from @backstage/backend-common. This release contains a few of these deprecations, with more to be expected in the future. The long-term goal is to completely deprecate and remove the @backstage/backend-common package.

Hierarchical Domains

The Backstage System Model has been tweaked with the addition of a hierarchy of Domain entities. The change includes a new spec.subdomainOf property on the Domain entity, which can be used to express that a domain has a partOf (and conversely, hasPart) relation toward another domain.

Contributed by @dawngerpony and @janogonzalez in #17125.

Scaffolder workspace serialization

Added experimental support for serialization of workspaces in the scaffolder. By serializing the workspace, it is possible to re-run the task in a non-sticky way. This means that the task can be restored and retried on a different scaffolder task worker.

To enable this feature, set the EXPERIMENTAL_workspaceSerialization option to true in the scaffolder section of the app-config.yaml file:

scaffolder:
  EXPERIMENTAL_workspaceSerialization: true

Contributed by @acierto in #24570.

Scaffolder notification:send action

The new notification:send action allows sending notifications from templates. This can be used to send notifications to users when executing a template. Please note that the notifications system is still under development.

To install this action, add the new module to your backend:

+ backend.add(import('@backstage/plugin-scaffolder-backend-module-notifications'));

Contributed by @drodil in #24588.

Backend Authentication

The requirement to configure a secret for backend authentication in production has been removed. It is now only needed if you rely on the legacy authentication mechanism. If you don’t configure any secrets you will also not be able to generate tokens with the TokenManager service, although use of this service is discouraged as it has been replaced by the AuthService.

User Authentication

The auth backend plugin now provides an authOwnershipResolutionExtensionPoint that lets you override the default ownership resolution used by sign-in resolvers. This allows you to customize this logic for all sign-in resolvers without replacing them.

Contributed by @drodil in #22765.

Events support for GitLab Entity and Org Discovery

The GitlabDiscoveryEntityProvider and GitlabOrgDiscoveryEntityProvider can now be configured to receive events from GitLab. This allows for the automatic discovery of entities in Backstage when groups or users are created or updated in GitLab.

Contributed by @elaine-mattos in #23373.

Security Fixes

This release does not contain any security fixes.

Upgrade path

We recommend that you keep your Backstage project up to date with this latest release. For more guidance on how to upgrade, check out the documentation for keeping Backstage updated.

Links and References

Below you can find a list of links and references to help you learn about and start using this new release.

• Backstage official website, documentation, and getting started guide
• GitHub repository
• Backstage's versioning and support policy
• Community Discord for discussions and support
• Changelog
• Backstage Demos, Blog, Roadmap and Plugins

Sign up for our newsletter if you want to be informed about what is happening in the world of Backstage.

v1.27.0-next.2

See docs/releases/v1.27.0-next.2-changelog.md for more information.

v1.26.5

This release fixes an issue where it was not possible to mock and require the original @backstage/core-components package in Jest tests. It also fixes an issue where the scaffolder had inconsistent log output formats, along with support for redacting additional meta fields in both the default logger and scaffolder logger.