A flexible web server for reacting GitHub Webhooks
A stand-alone GitHub Webhook end-point server.
github-webhook \--port=9999 \--path=/webhook \--secret=mygithubsecret \--log=/var/log/webhook.log \--rule='push:ref == refs/heads/master && repository.name == myrepo:echo "yay!"'
You can also specify a
--config <file> where file is a JSON file containing the same properties as are available as commandline options. The commandline will always override properties in the config file though.
PORTenv var), should match what you tell GitHub
listen()to a specific host
DEBUGenv var to see debug output (see debug)
--rulecommandline arguments where the 3 properties are separated by
When reacting to valid GitHub Webhook payloads, you can specify any number of rules that will be matched and execute commands in a forked shell. Rules have three components:
"event": the event type to match, see the GitHub Webhooks documentation for more details on the events you can receive
"match": a basic object matching rule that will be applied against the payload received from GitHub. Should be flexible enough to match very specific parts of the PayLoad. See matchme for how this works.
"exec": a system command to execute if this rule is matched, should obviously be something related to the event, perhaps a deploy on
"push"events? Note: if you provide a string it will be run with
sh -c "<string>"(unlikely to be Windows-friendly), however if you provide an array of strings then the first element will be executed with the remaining elements as its arguments.
You can either specify these rules in an array on the
"rules" property in the config file, or as separate
--rule commandline arguments where the components are separated by
--rule event:match:exec (you will generally want to quote the rule to prevent shell trickery).
var server = require('github-webhook')(options) and you'll receive a
http.Server object that has been prepared but not started.
github-webhook is powered by github-webhook-handler, see that for more details.
github-webhook is Copyright (c) 2015 Rod Vagg @rvagg and licensed under the MIT License. All rights not explicitly granted in the MIT License are reserved. See the included LICENSE.md file for more details.