Roadie can load your organization team structure and employees from GitHub teams.
This page describes how to do that.
- You must be using GitHub or Okta for sign-in
- You will need a git repository for the configuration of Backstage.
- The github token configured in the backstage secrets must have the
If using Okta configure okta to return a field
githubUsernamein the ID token with profile scope & let the Roadie team know so we can configure your cluster.
If the name of your organization was “acme”, you would create a file in the github repository called github-org.yaml with the following contents:
apiVersion: backstage.io/v1alpha1 kind: Location metadata: name: github-organizations description: Configuration to load data from github teams spec: type: github-org targets: - https://github.com/acme
Next go to the catalog import page in backstage e.g. https://acme.roadie.so/catalog-import
Enter the url to that file you created.
Within the next couple of minutes, you should see the org structure loaded into backstage.