General Information

Setting up webhooks which trigger a Jenkins job upon commit to a repo.

Checklist

• Jenkins server setup
• GitLab repo available (GitHub may be similar)

Creating a Jenkins job that is triggered upon push to a gitlab project.

• Create Jenkins job
  • Under “Build Triggers”
    • Check: 'Build when a change is pushed to GitLab. GitLab webhook URL:….'
  • Click 'Advanced'
    • Under Secret token, click 'Generate'

• Configure GitLab project settings
  • Settings > Integrations
  • Copy/paste webhook url from Jenkins job into URL field
  • Copy/paste secret token from Jenkins job into Secret Token field
  • Check the Triggers that you want to send a notification to Jenkins about
  • Optionally, uncheck 'Enable SSL Verification'
  • Click “Add webhook”

• Configure GitLab project members
  • Go to Settings > Members
  • Ensure that the user configured to clone the project in the Jenkins job has “Developer” permissions to the project.
    • This will ensure that the job can write back job status to the gitlab commit (job running, success, failed, etc)