Build triggers (poll SCM, webhook, timer) in Jenkins - Time & Space Complexity

Time Complexity: Build triggers (poll SCM, webhook, timer)

O(n)

Understanding Time Complexity

We want to understand how the time Jenkins spends checking for changes grows as the number of triggers or polling intervals increase.

How does Jenkins' work change when using different build triggers like polling, webhooks, or timers?

Scenario Under Consideration

Analyze the time complexity of this Jenkins pipeline snippet with polling and timer triggers.

pipeline {
  triggers {
    pollSCM('H/5 * * * *')
    cron('H 0 * * *')
  }
  stages {
    stage('Build') {
      steps {
        echo 'Building...'
      }
    }
  }
}

This pipeline triggers builds by checking the source code every 5 minutes and also runs once daily at midnight.

Identify Repeating Operations

Look at what repeats over time in this setup.

• Primary operation: Polling the source code management (SCM) system every 5 minutes.
• How many times: About 12 times per hour for polling, plus 1 time daily for the timer.

How Execution Grows With Input

As the number of polling intervals or timers increases, the checks Jenkins performs also increase.

Input Size (number of triggers or intervals)	Approx. Operations (checks)
10 (polls per hour)	10 checks per hour
100 (polls per hour)	100 checks per hour
1000 (polls per hour)	1000 checks per hour

Pattern observation: The number of checks grows directly with how often Jenkins polls or triggers builds.

Final Time Complexity

Time Complexity: O(n)

This means the time Jenkins spends checking grows linearly with the number of polling intervals or timer triggers.

Common Mistake

[X] Wrong: "Polling more often doesn't affect Jenkins' workload much because it's just a quick check."

[OK] Correct: Each poll requires Jenkins to connect and check the SCM, so more frequent polling increases the total work linearly.

Interview Connect

Understanding how build triggers affect Jenkins' workload helps you design efficient pipelines and shows you can think about system performance in real projects.

Self-Check

"What if we replaced polling with only webhook triggers? How would the time complexity change?"

Practice

1. Which Jenkins build trigger checks the source code repository regularly for changes before starting a build?

easy

A. poll SCM

B. webhook

C. timer (cron)

D. manual trigger

Solution

1. Step 1: Understand the purpose of poll SCM

   poll SCM trigger makes Jenkins check the source code repository at set intervals for any changes.

2. Step 2: Compare with other triggers

   Webhook triggers build instantly on code push, timer triggers build at scheduled times, manual trigger requires user action.

3. Final Answer:

   poll SCM -> Option A

4. Quick Check:

   poll SCM = checks repo regularly [OK]

Hint: poll SCM means Jenkins checks repo regularly [OK]

Common Mistakes:

• Confusing webhook with poll SCM
• Thinking timer triggers check repo changes
• Assuming manual trigger is automatic

2. Which of the following is the correct syntax to schedule a Jenkins build every day at midnight using cron?

easy

A. * * * * 0

B. 0 0 * * *

C. 0 12 * * *

D. 0 0 0 * *

Solution

1. Step 1: Understand cron syntax

   Cron format is 'minute hour day month weekday'. To run at midnight daily, minute=0 and hour=0.

2. Step 2: Match the correct expression

   0 0 * * * "0 0 * * *" means every day at 00:00 hours (midnight).

3. Final Answer:

   0 0 * * * -> Option B

4. Quick Check:

   Midnight daily cron = 0 0 * * * [OK]

Hint: Midnight daily cron is always '0 0 * * *' [OK]

Common Mistakes:

• Mixing hour and minute fields
• Using wrong day or weekday values
• Confusing 12 PM with midnight

3. Given this Jenkins pipeline snippet, what will trigger the build?

triggers {
  pollSCM('H/15 * * * *')
}

medium

A. Build runs only if SCM changes detected every 15 minutes

B. Build runs every 15 minutes regardless of changes

C. Build runs once daily at 15 minutes past midnight

D. Build runs immediately after a webhook event

Solution

1. Step 1: Understand pollSCM with 'H/15 * * * *'

   This means Jenkins checks the SCM every 15 minutes for changes.

2. Step 2: Determine when build triggers

   Build triggers only if changes are detected during these checks, not every 15 minutes automatically.

3. Final Answer:

   Build runs only if SCM changes detected every 15 minutes -> Option A

4. Quick Check:

   pollSCM triggers on changes every 15 mins [OK]

Hint: pollSCM triggers only on changes, not just time [OK]

Common Mistakes:

• Assuming build runs every 15 minutes regardless
• Confusing pollSCM with timer trigger
• Thinking webhook triggers are involved here

4. A Jenkins job with this trigger configuration does not start builds as expected:

triggers {
  pollSCM('H/5 * * * *')
}

What is the most likely cause?

medium

A. Timer trigger conflicts with pollSCM

B. The cron syntax 'H/5 * * * *' is invalid

C. Webhook is required for pollSCM to work

D. SCM polling is disabled in Jenkins global settings

Solution

1. Step 1: Check pollSCM prerequisites

   pollSCM requires SCM polling enabled globally in Jenkins settings.

2. Step 2: Validate other options

   Syntax 'H/5 * * * *' is valid; webhook is separate trigger; no conflict with timer here.

3. Final Answer:

   SCM polling is disabled in Jenkins global settings -> Option D

4. Quick Check:

   pollSCM needs global SCM polling enabled [OK]

Hint: pollSCM needs global SCM polling enabled [OK]

Common Mistakes:

• Assuming cron syntax is wrong
• Thinking webhook is mandatory for pollSCM
• Believing timer conflicts cause failure

5. You want Jenkins to build your project automatically every weekday at 6 AM and also immediately when code is pushed to GitHub. Which trigger setup is best?

hard

A. Use only pollSCM with cron '0 6 * * 1-5'

B. Use webhook only without timer

C. Use timer trigger '0 6 * * 1-5' and configure GitHub webhook

D. Use pollSCM every minute

Solution

1. Step 1: Understand requirements

   Build at 6 AM weekdays and immediately on GitHub push means two triggers needed: timer and webhook.

2. Step 2: Evaluate options

   Use timer trigger '0 6 * * 1-5' and configure GitHub webhook combines timer for scheduled build and webhook for instant build on push, fulfilling both needs.

3. Final Answer:

   Use timer trigger '0 6 * * 1-5' and configure GitHub webhook -> Option C

4. Quick Check:

   Timer + webhook = scheduled + instant builds [OK]

Hint: Combine timer and webhook for schedule plus instant build [OK]

Common Mistakes:

• Using only pollSCM misses instant build
• Using webhook alone misses scheduled build
• Polling every minute is inefficient