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.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