[Documentation] [TitleIndex] [WordIndex

Manually Authorizing Bloom to Generate Github Pull Requests

If you have two-factor authentication enabled for github, bloom cannot log in with your github password alone. You have two options:

  1. Create a personal access token on github and tell bloom about it.
  2. Re-route https traffic through ssh (assuming you have public-key authentication enabled). (This will only enable git push and pull, but not pull-request opening)

Token-based authentication

Create an access token

Go to the github website and login. Open the settings page, and click on "Personal access tokens" in the menu on the left.

Click the "Generate new token" button, and follow the instructions. Make sure that the "public_repo" authorization is granted under the repo subtree. Set the description to something like "Bloom token". After you have created the token, you will end up back at the "Personal access tokens" page. The new token will be highlighted in green. Copy the alphanumeric token to the clipboard.

Configure bloom to use the token

Open ~/.config/bloom in a text editor. If it doesn't exist, create it. Enter the following text into the file:

Filling in your username and the token you made in the previous step. Save the file. From now on, bloom should be able to automatically create pull requests to rosdistro for you when you do releases.

Re-route https through ssh

As suggested here, you can also re-route bloom's https traffic through ssh by editing your .gitconfig file:

# Always use ssh for github, even if the remote URL uses https or git                                                                                                 
[url "git@github.com:"]                                                                                        
  insteadOf = git://github.com/                                                                                
[url "git@github.com:"]                                                                                        
  insteadOf = https://github.com/

NOTE that if you choose this option, be sure not to forget enable ssh connection with `github`.


2017-09-23 12:31