docs/releases/v1.36.0-next.3-changelog.md
Upgrade Helper: https://backstage.github.io/upgrade-helper/?to=1.36.0-next.3
b30e788: The new command is now powered by a new template system that allows you to define your own templates in a declarative way, as well as import existing templates from external sources. See the CLI templates documentation for more information.
The following flags for the new command have been deprecated and will be removed in a future release:
--license=<license>: Configure the global license instead.--no-private: Configure the global private instead.--baseVersion=<version>: Configure the global version instead.--npmRegistry=<url>: Configure the global publishRegistry instead.--scope=<scope>: Configure the global namePrefix and/or namePluginInfix instead.As part of this change the template IDs and their options have changed. The following backwards compatibility mappings for the --select and --option flags are enabled when using the default set of templates, but they will also be removed in the future:
--select=plugin is mapped to --select=frontend-plugin instead.--option=id=<id> is mapped to --option=pluginId=<id> instead.5aebc13: The UrlReaderProccessor accepts a new config flag catalog.useUrlReadersSearch to always call the search method of UrlReaders.
This flag currently defaults to false, but adopters are encouraged to enable it as this behavior will be the default in a future release.
Previous behavior was to call the search method only if the parsed Git URL's filename contained a wildcard and use readUrl otherwise. UrlReaderService must implement this logic in the search method instead.
This allows each UrlReaderService implementation to check whether it's a search URL (that contains a wildcard pattern) or not using logic that is specific to each provider.
catalogEntityPermissionResourceRef export via the /alpha sub-path.oneOf output schemas on the Installed Actions page for scaffolder actionscreateTemplateFilter, createTemplateGlobalFunction, createTemplateGlobalValue for template extensions.oneOf output schemas on the Installed Actions page for scaffolder actionsremoteUrl output is no longer required, it can be empty only when using the new createWhenEmpty boolean flag.5c187f9: DEPRECATION: The getOctokitOptions function signature with repoUrl option has been deprecated in favour of a function signature with individual host, owner, and repo parameters:
const octokitOptions = await getOctokitOptions({
integrations,
credentialsProvider,
token,
- repoUrl,
+ host,
+ owner,
+ repo,
});
5d469c9: Added support for autocompletion of GitHub branches in scaffolder
8e67e4a: Added support for autocompletion to GithubRepoPicker component
Updated dependencies
createTemplateFilter, createTemplateGlobalFunction, createTemplateGlobalValue for template extensions.UrlReadersService, the search method have been updated to use the readUrl if the given URL doesn't contain a pattern.
For UrlReaders that didn't implement the search method, readUrl is now called internally and throws if the given URL doesn't contain a pattern.PermissionsRegistryService to use PermissionResourceRefs and added the getPermissionRuleset method.PermissionsRegistryService to use PermissionResourceRefs and added the getPermissionRuleset method.getPermissionRuleset method to mockServices.permissionsRegistry.bfa4ea9: Enable catalog.useUrlReadersSearch configuration by default in newly created Backstage installations.
This parameter makes UrlReaderProcessor always use the search method.
New adopters are encouraged to enable it as this behavior will be the default in a future release.
Updated dependencies
PermissionRuleset type that encapsulates a lookup function for permission rules, which can be created by the new PermissionsRegistryService via the getPermissionRuleset method. The createConditionTransformer and createConditionAuthorizer functions have been adapted to receive these accessors as arguments, with their older counterparts being deprecated.createPermissionResourceRef utility that encapsulates the constants and types related to a permission resource types. The createConditionExports and createPermissionRule functions have also been adapted to accept these references as arguments, deprecating their older counterparts.