View profile

Roadie's Backstage Weekly - Easier service onboarding

Roadie's Backstage Weekly - Easier service onboarding
By David Tuite • Issue #10 • View online

The Backstage service catalog can unlock productivity gains across your entire engineering organization. However, it’s only useful when the data it collects is complete and correct. Users who search Backstage for services and come up empty will be less likely to continue using it.
For this reason, it must be easy to onboard onto Backstage and get services into the catalog.
With this in mind, Roadie is developing and contributing a GitHub repo importer for Backstage. Here’s a short video to explain how you use it.
Backstage Catalog Importer Introduction
Backstage Catalog Importer Introduction
Once this feature is merged and released (#3121), simply navigate to /catalog-import in Backstage and paste in the URL of a GitHub repo you’d like to import.
Backstage will automatically open a pull request against the repo to add a catalog-info.yaml file. Merge that and the component will appear in the Backstage catalog.
There’s still a ton of work to do to make this even better.
Planned work includes a host of repo processors which will make sensible guesses about what your repos contain and who owns them. If your repo is mostly HTML and CSS, it’s probably a website. If it only has one main contributor, they are probably the owner. There are countless ways that automation work in this area can help Backstage be authoritative and trustworthy.
Please try this out and send any comments to [email protected].
Merged last week...
56 pull requests were merged last week. Here are the highlights…
Configuration schema support
Backstage’s flexible plugin framework is a huge part of its power. But different plugins need different configuration, and config can get complex when you use many plugins at the same time.
#3264 provides the ability for plugins to define a configuration schema. When this is used, users can use the CLI to validate their Backstage config to ensure they have provided all the config that each plugin needs.
Not only does this mean fewer runtime errors, it also unlocks interesting features like editor autocompletion for Backstage config files (#3366).
The docs for Backstage configuration have been updated and are available here.
Microsoft users importer
Oliver Sand from SDA-SE added an integration with the Microsoft Graph API and Azure AD. This allows Backstage to directly import data about employees and the teams they are part of.
In future, you’ll be able to assign ownership of services to the teams they who maintain them, all powered by data from Azure AD. #3293
Stability index
Documentation which shows the stability of various Backstage components has been added. Stability is communicated with a number, with higher numbers inferring increased stability.
For example, you should expect frequent breaking changes if you use the catalog-client package because it has a stability index of 0.
The core package, on the other hand, has a stability index of 2. Thus, you can expect a short deprecation period before breaking changes occur.
The Backstage team is laser focussed on stability and reliability at the moment and this is part of that effort.
Roadie news
We also dropped a Buildkite plugin recently. It works just like the existing plugins for CI tools like CircleCI and GitHub Actions.
A JIRA plugin is on the way and something for ArgoCD is in development.
That’s all for this week. Get upgrading! 🚀
Did you enjoy this issue?
David Tuite

Roadie helps you be successful with Backstage. Each week we send out the latest Backstage news, along with tips to help you get the most value from Backstage.

This newsletter is created by Backstage mega-fans. It is not affiliated with Spotify or the Backstage core team.

If you don't want these updates anymore, please unsubscribe here.
If you were forwarded this newsletter and you like it, you can subscribe here.
Powered by Revue
9450 SW Gemini Dr, PMB 78170, Beaverton, Oregon, 97008-7105, United States