Viewing CircleCI Builds in Roadie
Published on February 23rd, 2021Introduction
The Backstage Circle CI plugin integrates with Circle CI to show your build information inside Backstage where it can be associated with your services.
Using the Plugin
-
Get and provide a CIRCLECI_AUTH_TOKEN as an environment variable in Roadie at
/administration/settings/secrets
- see below for instructions on how to get the token. -
Add a circleci.com/project-slug annotation to your respective catalog-info.yaml files following the Component format
# Example catalog-info.yaml entity definition file
apiVersion: backstage.io/v1alpha1
kind: Component
metadata:
# ...
annotations:
# This also supports bitbucket/xxx/yyy
circleci.com/project-slug: github/my-org/my-repo
spec:
type: service
# ...
- Add the CircleCi plugin to one of your entities with the correct annotation in Roadie as a new tab.
Creating a token
In order to make requests to the CircleCI API, you must provide Roadie with an API key.
-
Make sure you are logged in to Circleci as the user you want to use for Backstage. We recommend creating a Github bot account for this.
-
Go to https://app.circleci.com/settings/user/tokens and select Create New Token.
-
Give the token a name and click Add API Token.
-
Circleci will print the token that Backstage needs.
-
Follow the instructions on how to share the API Token with Roadie.