Webhooks

These endpoints are served by the API on hooks.clusterz.eu, outside /api/v1.

GitHubCopy Anchor Link

POST /webhooks/github/{projectID}
X-Hub-Signature-256: sha256=<hmac>
X-GitHub-Event: push

GitLabCopy Anchor Link

POST /webhooks/gitlab/{projectID}
X-Gitlab-Token: <secret>
X-Gitlab-Event: Push Hook

BitbucketCopy Anchor Link

POST /webhooks/bitbucket/{projectID}
X-Hub-Signature: sha256=<hmac>
X-Event-Key: repo:push

A push to the repository of any service of an app rebuilds and redeploys the services built from that repository and branch; the others keep their images. A push to the project's own repository reads clusterz.yaml first and applies what changed. GitLab and Bitbucket hooks are registered on every repository of the app and deliver to the project's URL, each with its own secret; GitHub delivers through its App to every project a repository builds.

All webhook endpoints return 200 on success (including non-matching branches).