GitHub
Connect GitHub so deliveries show their pull requests, checks, reviews and deployments.
Blume reads GitHub to show where a delivery’s code really is. Connecting is optional, and we recommend doing it before your first merge review. Blume only reads: it never merges, pushes, comments or approves on GitHub.
What Blume reads
For the repositories you choose:
- Pull requests linked to a delivery, with their state, branches and size.
- Checks on each pull request’s head commit.
- Reviews: GitHub’s review decision, and whether a person approved the current head commit.
- Workflow runs on the delivery’s commits.
- Deployments to each GitHub environment, which move the delivery along its release steps.
- Agent setup in each repository, when it is not checked out on this computer.
Set up
GitHub runs in the Blume desktop app, which keeps the authorization on your computer.
- Open Settings, then GitHub.
- Choose Connect GitHub. GitHub opens in your browser, and a one-time code is already on your clipboard.
- Paste the code on GitHub and approve Blume.
- Choose Choose repositories on GitHub. Allow all repositories, or only the ones your projects live in. For an organization’s repositories, choose Use an organization instead.
- Save your choice on GitHub and come back to Blume. The page shows GitHub is set up.
The one-time code expires after a few minutes. To change the repositories later, choose Change on GitHub under Repositories. To stop, choose Disconnect.
Pull requests on a delivery
A pull request joins a delivery when the agent links it, or when it is opened from the branch the agent reported. Blume checks linked pull requests about once a minute while the app is open.
A pull request’s description, comments and changed files are read from GitHub when you open the code review. They are not copied into your cloud workspace.
Approvals from GitHub
An approving review on GitHub counts as your approval of a pull request in Blume only when:
- it comes from a person, not a bot,
- that person is not the pull request’s author, and
- it approves the current head commit and is still their latest decision.
See Merge review.