gitlab-webhooks.cr
GitLab can trigger events with well configured webhooks. When that event occurs, the source app makes an HTTP request to the URI configured for the webhook, you can use the Crystal HTTP class to manage that. The action taken may be anything... Common uses are to trigger builds with continuous integration systems or to notify deployments.
Installation
- Add the dependency to your
shard.yml
:
dependencies:
gitlab-webhooks:
github: chussenot/gitlab-webhooks
version: 0.3.3
- Run
shards install
Usage
You just have to require the lib.
require "gitlab-webhooks"
The Crystal is new ... Crystal has downsides just like every other languages.
To relay the catched Gitlab events on hundreds of Ruby, Python libraries made
by thousands of open source contributors over the last decade or monitoring
systems like Prometheus. You can contribute and add your exemple in the
exemples
folder.
HTTP requests
This Crystal exemple show you how to implement where all endpoints can catch some events, parse them and print the values of some attributes.
require "json"
require "http/server"
require "gitlab-webhooks"
server = HTTP::Server.new do |context|
if body = context.request.body
event : Gitlab::Event = Gitlab.event_from(JSON.parse(body).to_json.to_s)
puts event.commit.message
context.response.content_type = "text/plain"
context.response.print "Hello world!"
else
context.response.print "You didn't POST any data :("
end
end
server.bind_tcp 8080
puts "Listening on http://0.0.0.0:8080"
server.listen
Then you can curl the server with a sample file
curl -X POST --data @data.json http://localhost:8080/
References
- How to add a GitLab project hook documentation
- The Rake task to add a project hooks
- The Grape API endpoint implementation
Contributing
- Fork it (https://github.com/chussenot/gitlab-webhooks.cr/fork)
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Add some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create a new Pull Request
Contributors
- Clement - creator and maintainer