The method to add a GitHub Organization to CircleCI was unclear and I wandered around various pages for about 30 minutes before finally being able to add the Organization, so I’ll share those steps.
Steps to Add Organization to CircleCI
Adding an Organization to CircleCI can be completed in roughly the following 2 steps:
- Open the Check permissions link on the CircleCI account page
- Click the Grant button in the GitHub CircleCI app settings
Open the CircleCI Account Page
First, open the CircleCI account page https://circleci.com/account.
It took me about 30 minutes to find this page. Once you understand that you can get GitHub Organization addition permissions from this page, you’re practically done.
Check permissions
Open the Check permissions link under Are you missing a GitHub organization? Check permissions.
Grant in GitHub CircleCI App Settings
When you click the Check permissions link, the GitHub CircleCI application settings page opens. It’s a page with a URL like this:
https://github.com/settings/connections/applications/YOUR_ID
When you first logged into CircleCI with GitHub, you could set whether to grant or not grant permissions for each Organization. However, Organizations you newly create or join afterward haven’t been granted permissions, so you need to separately press the Grant button on this page to handle them.
That’s all from the Gemba, where we want to automate aggressively with CircleCI.