Poll SCM Vs. Webhook to automate build-triggers

 Double-click on the image to zoom-out ...Larger.

To return to Home page: Refresh Page or Take ESC Button on Keyboard.

Using the Poll SCM to automate build-triggers

Using the Poll SCM feature in Jenkins allows you to automate the triggering of builds based on changes in your source code repository (such as Git). This is useful for continuous integration (CI) pipelines, as it ensures that builds are automatically triggered whenever there are updates to the repository.

Here's how you can set up Poll SCM to automate build triggers:

Steps to configure Poll SCM:

1. Open Jenkins Dashboard:

   • Log in to your Jenkins instance and go to your desired job or create a new one.

2. Configure Job:

   • Select the job you want to configure and click Configure on the left sidebar.

3. Set Up Source Code Management (SCM):

   • Under the Source Code Management section, select the repository you want to use (e.g., Git, SVN).
   • Provide the necessary repository URL and credentials if required.

4. Enable Build Triggers:

   • Scroll down to the Build Triggers section.
   • Check the box for Poll SCM.
   • In the text field, enter a cron-like expression. This expression tells Jenkins how often to check for changes in the SCM repository.

   Example:

   • H/5 * * * *    Polls every 5 minutes.
   • H/15 * * * *   Polls every 15 minutes.
   • * * * * *     Polls every minute (not recommended for high load).

   The H in the expression helps distribute the load across Jenkins instances by avoiding simultaneous polling on every job at the same time.

5. Save Configuration:

   • After configuring the SCM and Poll SCM settings, click Save to apply the changes.

Cron Syntax:

Jenkins uses cron syntax for scheduling tasks. Here's a breakdown of the components:

• Minute (0 - 59)
• Hour (0 - 23)
• Day of month (1 - 31)
• Month (1 - 12)
• Day of week (0 - 6) (Sunday to Saturday)

Example cron expression:

• H/5 * * * *    Polls every 5 minutes, with the job randomly starting at minute 0, 5, 10, 15, etc.

How Poll SCM works:

• Once configured, Jenkins will periodically check the repository for any changes based on the cron schedule.
• If any changes (commits) are found, Jenkins will trigger a build automatically.
• If no changes are detected, the build won't be triggered.

This method is commonly used for repositories that are not integrated with webhooks or when you want more control over when builds are triggered.

twtech-Best practice: Using webhook for Jenkins automation.

Using a Webhook in Jenkins for automation is a great way to trigger builds in response to events in your source code repository (like commits or pull requests). Instead of polling your SCM (like with Poll SCM), webhooks let Jenkins know immediately when there's a change in the repository, making it a more efficient solution.

Here's how you can set up a webhook to trigger Jenkins builds:

Steps to set up a webhook in Jenkins:

1. Create or Configure a Jenkins Job

• Open your Jenkins dashboard.
• Either create a new job or configure an existing one.
• Go to the Configure section of the desired Jenkins job.

2. Configure Source Code Management (SCM)

• Under Source Code Management, choose the SCM you are using (e.g., Git).
• Provide the repository URL and credentials as needed.

3. Enable Build Triggers (Webhook Setup)

• Scroll down to the Build Triggers section.
• Check the GitHub hook trigger for GITScm polling (for GitHub repositories) or select the appropriate webhook trigger for your SCM.

4. Install Necessary Plugins

• Make sure you have the necessary plugins installed in Jenkins, like:
  • GitHub Plugin (for GitHub webhooks)
  • GitLab Plugin (for GitLab webhooks)
  • Bitbucket Plugin (for Bitbucket webhooks)

You can check and install plugins by navigating to Manage Jenkins → Manage Plugins → Available and search for the relevant plugin.

5. Generate Jenkins Webhook URL

• Once you've enabled the appropriate webhook trigger, Jenkins will provide you with a URL.
  • The URL format will look like this:

    # perl
    
    http://<your-jenkins-domain>/github-webhook/
    

  • This is the endpoint that you’ll configure in your source code repository.

6. Configure Webhook in Your Source Code Repository

• GitHub:

  • Go to the GitHub repository you want to link to Jenkins.
  • Navigate to Settings → Webhooks → Add webhook.
  • In the Payload URL field, enter the Jenkins webhook URL (http://<your-jenkins-domain>/github-webhook/).
  • Set the Content type to application/json.
  • Choose which events should trigger the webhook, for example, Push events, Pull requests, etc.
  • Click Add webhook.

• GitLab:

  • Go to your GitLab repository.
  • Navigate to Settings → Webhooks.
  • In the URL field, enter the Jenkins webhook URL.
  • Choose the trigger events (e.g., Push events).
  • Click Add webhook.

• Bitbucket:

  • Go to your Bitbucket repository.
  • Navigate to Repository settings → Webhooks → Add webhook.
  • In the URL field, enter the Jenkins webhook URL.
  • Choose the events you want to trigger the build.
  • Save the webhook.

7. Test the Webhook

• After setting up the webhook, make a change in your repository (like pushing a commit).
• Jenkins should automatically trigger a build when it receives the webhook notification from your repository.

Advantages of Webhooks over Poll SCM:

• Real-time trigger: Webhooks send an immediate notification to Jenkins when a change occurs in your SCM(GitHub), avoiding the delay of polling.
• Efficient: No need for frequent polling, reducing load on Jenkins and the SCM server.
• Scalability: Better for handling large repositories and projects, as it scales well without overloading Jenkins with repeated checks.

Troubleshooting:

If Jenkins doesn't trigger builds after setting up the webhook:

• Check the Jenkins job logs for any errors.
• Verify the Webhook URL in your SCM settings. Make sure it's correct and accessible by your SCM server.
• Test the webhook: Most platforms like GitHub and GitLab offer a "Test" button to simulate a webhook call and check the response.
• Ensure the necessary plugins are installed and up-to-date.