Project: Backstage (App Definition and Development / Application Definition & Image Build)
File: v1.13.0.md

id: v1.13.0 title: v1.13.0 description: Backstage Release v1.13.0 These are the release notes for the v1.13.0 release of . A huge thanks to the whole team of maintainers and contributors as well as the amazing Backstage Community for their hard work in getting this release developed and done. This release has an important security fix, along with a lot of squashed bugs and exciting additions! Enjoy. The `Tabs` component was removed from `@backstage/core-components`. It was a thin shim that provided very little value and was considered confusing, when the were already fully usable out of the box. Check out the pull request below for more details. Contributed by in The way that the `GitlabDiscoveryEntityProvider` handles branches has changed, to remove the confusion of whether you want to force the use of a certain branch name or whether you just want to provide a fallback branch name. If you were passing in the `branch` parameter intending it to be just a fallback, you may want to rename it to `fallbackBranch`. Contributed by in The Kubernetes backend is receiving some really nice overhauls to prepare it for the future and streamlining its interfaces. There are a few breaking changes in there, but not everyone is affected by them. Rather than listing each breaking change individually, check out for more information if you see new type errors after upgrading. The Backstage project is now built with the new v5 version of TypeScript! This meant making some small adjustments to types here and there, but we do not expect any end user impact besides having even better and clearer TypeScript support. You are now able to upgrade your own project to depend on version 5 of TypeScript, should you desire to - its an optional upgrade on your end and our libraries should still work fine with version 4 of TypeScript as well. Added in There is a new `catalog.orphanStrategy` app-config option for the catalog, allowing adopters to enable automatic cleanup of entities. This helps with common use cases where catalog-info files are moved around or renamed, or where entities within a single catalog-info file are partially removed. The default behavior is unchanged, i.e. if you do not explicitly set this new option to `'delete'`, orphaned entities will still stay around and await manual deletion. Added in You can now use some new filters in your placeholder expressions in Scaffolder templates. This gives the ability to combine things like: ``` ${{ parameters.entity | parseEntityRef | pick('name') }} ``` to get the name of a specific entity, or ``` ${{ parameters.repoUrl | parseRepoUrl | pick('owner') }}` ``` to get the owner of a

Added in Support for template permissions has finally landed in the Scaffolder! This allows you to define a `backstage:permissions` property to parameters and steps which is then used to authorize part of the template using the permissions framework. Docs for this feature still, its that fresh out of the oven! Contributed by and in We are experimenting with a new `onboard` command for the Backstage CLI. Its still early days, but the intent is to help adopters with some common tasks in the early onboarding / evaluation phase. Contributed by in Backstage now has experimental support for declaring OpenAPI schemas for your services, and automatically building type safe routers out of them. The Catalog plugin is the first user of these facilities. This comes in the form of a `@backstage/backend-openapi-utils` Node package assists with the type trickery, and the new `schema:openapi:verify` and `schema:openapi:generate` commands in the `@backstage/repo-tools` CLI package. Contributed by in Theres new support for running auth flows inline in the current page instead of in a separate popup window, enabled via the `enableExperimentalRedirectFlow` app-config parameter. This will allow the use of some providers that do not support popup flows. Its still an experimental feature, but do try it out if this applies to you! Contributed by in Visualize your data from PuppetDB! Contributed by in This provider lets you ingest org data (users and groups) into your catalog more easily from multiple orgs in one fell swoop. Give it a try! Contributed by in `confluence:transform:markdown`: This action converts Confluence doc pages to Markdown and can be found in the `@backstage/plugin-scaffolder-backend-module-confluence-to-markdown` package. Contributed by in `fetch:plain:file` is the natural sibling to `fetch:plain`, but fetching individual files instead of directories. Contributed by in Search is now available to use in the new backend system! The plugin itself has a new `searchPlugin` alpha export, and most of the collators etc are available as modules for it. The following packages have been created or updated as part of this: `@backstage/plugin-search-backend` `@backstage/plugin-search-backend-module-explore` `@backstage/plugin-search-backend-module-elasticsearch` `@backstage/plugin-search-backend-module-pg` `@backstage/plugin-search-backend-module-explore` `@backstage/plugin-search-backend-module-techdocs` For documentation on how to migrate, check out the convenient . Contributed by and in A used by the Scaffolder plugin was patched by our automated security processes in . The fixed version of `vm2` was already covered by the required version range of the Scaffolder plugin, so adopters are able to address this vulnerability separately without upgrading Backstage itself, as part of their regular security processes. 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 . Below you can find a list of links and references to help you learn about and start using this new release. , , and Backstage's for discussions and support Backstage , , and Sign up for our if you want to be informed about what is happening in the world of Backstage.