servd

Documentation

Documentation > Project Settings >

Webhooks

You can add webhooks to both GitHub and GitLab in order to trigger bundle builds and deployments whenever you push a new commit to a nominated branch.

Builds triggered by a webhook will use the same base software and directory map as your most recent, manual bundle build.

GitHub

  1. Navigate to the Project Settings page in the Servd dashboard

  2. In the webhooks section, enter the branch that you would like to track with your automated builds.

  3. Optionally select an environment that you'd like to automatically deploy new bundles to.

  4. Make a note of the webhook URL and secret. You'll need them in a moment.

  5. Open a browser tab and navigate to your Git repo on GitHub. Find the 'Settings' section and select 'Webhooks'.

  6. Click 'Add Webhook'

  7. Enter the webhook URL and secret from the Servd dashboard into the appropriate fields.

    Set the 'Content Type' to 'application/json'.

    Select 'Just the push event'

    Ensure 'Active' is checked.

  8. Click 'Add Webhook' and you're done! The next commit added to your nominated branch will trigger a bundle to be built in Servd.

Debugging Github Webhooks

If your webhook isn't working as expected, the best place to debug is on the 'Recent Deliveries' tab within the Github Webhook Settings.

This page will show you all of the recent attempts that GitHub has made to trigger the webhook, along with the response from Servd. Checking this response for errors will usually reveal the problem.

GitLab

  1. Navigate to the Project Settings page in the Servd dashboard.

  2. In the webhooks section, enter the branch that you would like to track with your automated builds.

  3. Optionally select an environment that you'd like to automatically deploy new bundles to.

  4. Make a note of the webhook URL and secret. You'll need them in a moment.

  5. Open a browser tab and navigate to your Git repo on GitLab. Find the 'Settings' section and select 'Integrations'.

  6. Enter the webhook URL and secret obtained from the Servd dashboard.

    Check only 'Push Events' (everything else will be ignored anyway)

  7. Click 'Add Webhook' and you're done! The next commit added to your nominated branch will trigger a bundle to be built in Servd.

Bitbucket

  1. Navigate to the Project Settings page in the Servd dashboard.

  2. In the webhooks section, enter the branch that you would like to track with your automated builds.

  3. Optionally select an environment that you'd like to automatically deploy new bundles to.

  4. Copy the webhook URL. You'll need it in a moment.

  5. Open a browser tab and navigate to your Git repo on Bitbucket. Find the 'Repository Settings' section and select 'Webhooks'. Click 'Add Webhook'.

  6. Give the webhook a name and paste the webhook URL obtained from the Servd dashboard.

    Check that 'Triggers' is set to 'Repository Push'

  7. Click 'Save' and you're done! The next commit added to your nominated branch will trigger a bundle to be built in Servd.