Installing the GitHub App
Published on March 21st, 2022Introduction
This tutorial will guide you through the steps required to connect Roadie to your GitHub org.
Prerequisites
If your IT department filters your outbound access by hostname, you may need to allow access to Roadie hostnames before proceeding. More information on this can be found here.
Step 1: Install the Roadie GitHub app
Installing the GitHub App will allow Roadie to access the YAML metadata files that Backstage needs to operate. Learn more about the permissions required.
- Click the Administration link in the bottom left of the application.
- Click the Settings tab along the top of the Administration page.
- Click on Integrations in the left sidebar.
- Open the GitHub accordion and click “Add GitHub App”
- Choose your GitHub organization and follow the steps to install the app.
⚠️ You may need to wait up to 2 minutes for the GitHub integration to become active.
ℹ️ If you are not an owner of your GitHub organization, you will need to ask an owner to approve the App installation and then contact us to enable the App.
ℹ️ To enable the github-org
processor, please navigate here.
ℹ️ To enable the github-discovery
processor, please navigate here.
Next steps
Now that a connection to GitHub is established, you can make yourself an admin on Roadie.