Documentation

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.

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.