The Backstage Circle CI plugin integrates with Circle CI to show your build information inside Backstage where it can be associated with your services.
- Add a proxy configuration in Roadie at
/administration/settings/proxy- see guide here.
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.
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.