Project

General

Profile

HowTo simply keep Redmine in sync with GitHub » History » Revision 3

Revision 2 (Mischa The Evil, 2011-10-18 21:49) → Revision 3/4 (Adrien Crivelli, 2013-09-12 06:21)

h1. HowTo simply keep Redmine in sync with GitHub 

 There are a lot of means out there. This there, here is the simplest one : I have found out: 

 # 1. Install the "Redmine Github Hook" GitHub Hook plugin 
 * http://www.redmine.org/plugins/redmine_github_hook, it works with Redmine 1.2.1 too 

 2. In Redmine, go to Administration/Settings and follow their instructions click on the Repository tab 
 * Enable Git as SCM. 
 * Select "auto-fetch commits" 
 * Click on "Enable WS for repository management", generate an API key and copy it, we'll need it in a few minutes. 
 * Click "Save". 

 3. Now, you have to create a local repository on the machine Redmine is installed 
 * Use specifically the command @git clone --mirror [repo_url]@. 
 * Pay attention to the fact that Redmine needs read permissions on this folder. 
 * Then go into your projects settings, in the "repository tab". Select "Git" as SCM, and fill the +absolute+ path to the local repository you created just above. 

 4. Finally go to GitHub 
 * Select your repository and click on "Admin". 
 * Click on the "Service Hooks" tab and select Redmine in the list. 
 * Scroll up to fill needed information, don't forget the API Key we generated earlier. For instance, if your project url is http://redmine.mydomain.com/projects/my_project: 
 > Adress = http://redmine.mydomain.com 

 > Project = my_project 

 > API Key = the API key we got from https://github.com/koppen/redmine_github_hook Redmine 

 * Click "Update Settings" and you are done!