Standing Up Backstage

40 MINS

Adding components

There's multiple ways of adding new entities to the Backstage Catalog. INSERT EXPLANATION

Register an existing component

Animation of the Backstage of the steps of the create flow as described below
  • In the sidebar, choose create and click Register existing component
  • As URL use https://github.com/backstage/backstage/blob/master/catalog-info.yaml. This is used in our demo site catalog.
Screenshot of the Backstage Entity registration screen, asking for a URL to a yaml file in a repo
  • Hit Analyze and review the changes. Apply them if correct
Screenshot of the Backstage Entity registration screen, asking for a URL to a yaml file in a repo
  • You should receive a message that your entities have been added.
  • If you go back to Home, you should be able to find backstage. You should be able to click it and see the details of this newly imported entity.

Create a new component

  • In the sidebar, click on create and choose to create a website with the Example Node.js Template Screenshot of the Backstage Entity registration screen, asking for a URL to a yaml file in a repo
  • Type in a name, for instance rocket-app Screenshot of the Backstage Entity registration screen, asking for a URL to a yaml file in a repo
  • Select the group team-a which will own this new website, and go to the next step Screenshot of the Backstage Entity registration screen, asking for a URL to a yaml file in a repo
  • For the location, leave it at github.com
  • As owner, enter your GitHub username Screenshot of the Backstage Entity registration screen, asking for a URL to a yaml file in a repo
  • For the repository name, type rocket-app.
  • Review the details of this new service, and press Create if you want to deploy it like this.
  • As soon as every step is finished succesfull, you can take a look at your new service by clicking Open in catalog Screenshot of the Backstage Entity registration screen, asking for a URL to a yaml file in a repo