Skip to main content

Backstage Plugins

Overview​

The SKE Backstage Frontend plugin extends Backstage so it can be used to view and manage SKE objects.

The SKE Backstage Backend plugin enables the communication between the Backstage instance and the SKE Platform.

The plugins are available as NPM packages at:

@syntasso/plugin-ske-frontend
@syntasso/plugin-ske-backend

Check the release notes below for information on each available version.

Release Notes​

ske-backend v0.17.0 (2025-05-20)​

Features​

  • Better error handling when communicating with the Backend fails

ske-backend v0.16.1 (2025-05-16)​

Bug Fixes​

  • No longer tries to parse the Backstage Access Token when not authenticating with Kubenetes via OIDC. This was causing issues when both the Access Token was present but not valid for Kubernetes communication.

ske-frontend v0.16.0 (2025-05-09)​

🚨 Breaking changes 🚨​

  • The React components KratixPromiseAboutCard and KratixResourceAboutCard have been removed. Those two were merged into the KratixAboutCard Component, that can be used to display information about both the Promise and Resource. This is only a breaking change if you were using one of those two components directly; the KratixPromiseEntityPage and KratixResourceEntityPage components (which are the ones documented in the installation steps) are already using the new KratixAboutCard component.

Features​

  • Two new components are available: KratixOverviewTab and KratixManageTab. Those are registered with Backstage via the plugin .provide method, and should render the inside of the Overview and Manage tabs of the Entity pages.
  • The KratixPromiseEntityPage and KratixResourceEntityPage components were updated to use the new KratixOverviewTab and KratixManageTab components.

ske-backend v0.16.0; ske-frontend v0.15.0 (2025-05-07)​

🚨 Breaking changes 🚨​

  • backend: enable dynamically loading of the plugin. This means you no longer need to manually add the scaffolding in your Backend app.

    To migrate, locate the lines in your packages/backend/src/index.ts file that looks like this:

    import { scaffolderModuleSkeExtensions } from '@syntasso/plugin-ske-backend';

    backend.add(import('@syntasso/plugin-ske-backend'));
    backend.add(scaffolderModuleSkeExtensions);

    Update it to just:

    backend.add(import('@syntasso/plugin-ske-backend'));

Features​

  • frontend: add compatibility with the new Frontend plugin architecture under the alpha sub-path.

ske-backend v0.15.0; ske-frontend v0.14.0 (2025-04-16)​

Features​

  • If ske.mode is set to gitops, the backend plugin will use the Git repository to execute CRUD operations on the Kubernetes Cluster
    • This is to keep compatibility for existing deployments; upcoming features will only be available when the plugin is configured for direct API communication
    • gitops mode will be removed in a future release
  • Compatibility with Backstage v1.37.1
  • UX improvements

ske-backend v0.14.0; ske-frontend v0.13.0 (2025-03-31)​

🚨 Breaking changes 🚨​

  • The plugins will no longer rely on a Git repository to execute CRUD operations on the Kubernetes Cluster. Instead, they will now use the Kubernetes API to manage the resources. This enables users to get the most up-to-date information on their resources, as well as manage resources created via other means, like via kubectl. The migration is quite simple and only requires changes to the Backstage app config. Read the Installing the backend plugin documentation for more information.
  • The Backstage Component Promise is now deprecated; its features are now available within the plugins and SKE v0.21.0+.

Features​

  • Backend plugin now uses the Kubernetes API to fetch/create/update/delete resources
  • Support for OIDC and Service Account authentication
  • Users can now manage resource created outside backstage
  • UX improvements

ske-backend v0.13.0 (2024-12-27)​

Maintenance​

  • compatibility with Backstage v1.34.1
  • no longer use deprecated @backstage/backend-common package

ske-backend v0.12.0 (2024-10-12)​

ske-frontend v0.12.0 (2024-10-12)​

Features​

  • compatibility with Backstage v1.32.5

ske-frontend v0.11.1 (2024-10-15)​

Bug Fixes​

  • Fixed a bug where the "Create" button wasn't being displayed on the Promise Entity page when a custom type was specified.
    • There's now a new kratix.io/type annotation that can be used to specify the type of the Component. Users of the SKE Backstage Generator (v0.10.1) will have this annotation automatically added to their Component YAML files.
    • This requires changes to your Catalog Entity page. Please refer to the Configuring the Plugins documentation for instructions.

v0.11.0 (2024-09-19)​

Bug Fixes​

  • Fix bug where resources request created in namespaces other than 'default' could not be managed

v0.10.0 (2024-09-18)​

Features​

  • Add 'promise summary' section to resource about page
  • compatibility with Backstage 1.30.4

Bug Fixes​

  • fix manage resource duplicate creation

v0.9.0 (2024-08-08)​

Features​

  • compatibility with Backstage 1.29.2

Bug Fixes​

  • improve the update experience with language tweaks