glhooks 0.1.0

This is simple server (receiver) for GitLab’s webhooks feature.

Alternatives

• https://github.com/shawn-sterling/gitlab-webhook-receiver
• https://github.com/vinodc/gitlab-webhook-branch-deployer

Installation

Make sure you have Python 2.6+/3.2+ properly installed (Windows/Linux). Then just type [sudo] pip install glhooks in your favorite shell. Now you have glhooks installed so you can run it like this python -m glhooks <path_to_config_file>.... You can find skeleton for the configuration file in git repository in config/config.ini.

I recommend Supervisor or similar application to run the glhooks server. Install it via [sudo] apt-get install supervisor. You can find the example of Supervisor configuration file for glhooks in git repository in config/glhooks.conf. But you can just create some shell script and copy it into /etc/init.d/ (example in git repository in config/glhooks.sh).

Next step is to generate a SSH key without the passphrase: ssh-keygen -b 4096 -t rsa. Then add the generated SSH public key to your GitLab account. If you have multiple SSH keys in $HOME/.ssh/ you probably has to create file $HOME/.ssh/config. You can find the example file in git repository in config/config.ssh.

Finally add the hook http://server.example.com:8000/ into your project webhooks at GitLab.

Updating

When you change at least one of the configuration files you has to restart glhooks server by [sudo] supervisorctl restart glhooks or [sudo] service glhooks restart.

Contributing

Feel free to send a pull request or to report an issue.

Changelog

0.1.0 (2014-01-14)

• First public release.