Options directive (timeout, retry) in Jenkins - Practice Problems & Coding Challenges

Challenge - 5 Problems

💻 Command Output

intermediate

What happens when a Jenkins pipeline stage exceeds the timeout set by the options directive?

Consider this Jenkins pipeline snippet:

options {
  timeout(time: 1, unit: 'MINUTES')
}
stage('Example') {
  steps {
    sh 'sleep 90'
  }
}

What is the expected outcome when this pipeline runs?

Jenkins

options {
  timeout(time: 1, unit: 'MINUTES')
}
stage('Example') {
  steps {
    sh 'sleep 90'
  }
}

A The stage will be aborted after 1 minute with a timeout error.

B The stage will complete successfully after 90 seconds.

C The pipeline will retry the stage automatically after timeout.

D The pipeline will ignore the timeout and continue running indefinitely.

💡 Hint

Think about what the timeout option does in Jenkins pipelines.

The timeout option stops the stage if it runs longer than the specified time. Here, the stage runs a 90-second sleep but the timeout is 1 minute, so Jenkins aborts the stage with a timeout error.

🧠 Conceptual

intermediate

How does the retry option behave in a Jenkins pipeline?

Given this Jenkins pipeline snippet:

options {
  retry(3)
}
stage('Build') {
  steps {
    sh 'exit 1'
  }
}

What will Jenkins do when the shell command fails?

Jenkins

options {
  retry(3)
}
stage('Build') {
  steps {
    sh 'exit 1'
  }
}

A Jenkins will skip the stage if it fails.

B Jenkins will run the stage only once and fail immediately.

C Jenkins will retry the stage indefinitely until it succeeds.

D Jenkins will retry the stage up to 3 times before failing.

💡 Hint

Consider what the retry option number means.

The retry(3) option tells Jenkins to try the stage up to 3 times if it fails. If all retries fail, the pipeline fails.

🔀 Workflow

advanced

Identify the correct Jenkins pipeline options block to retry a stage 2 times with a 5-minute timeout

Which options block correctly sets a retry count of 2 and a timeout of 5 minutes for a Jenkins pipeline stage?

A

options {
  retry(2)
  timeout(time: 5, unit: 'MINUTES')
}

B

options {
  retry = 2
  timeout = 5
}

C

options {
  timeout(5)
  retry(2)
}

D

options {
  retry(2, timeout: 5)
}

💡 Hint

Remember the syntax for options directives in Jenkins pipelines.

The correct syntax uses separate directives inside the options block. Option A correctly sets retry(2) and timeout(time: 5, unit: 'MINUTES'). Other options have syntax errors or invalid usage.

❓ Troubleshoot

advanced

Why does the Jenkins pipeline not retry despite using retry(3) option?

Given this Jenkins pipeline snippet:

options {
  retry(3)
}
stage('Test') {
  steps {
    script {
      try {
        sh 'exit 1'
      } catch (e) {
        echo 'Caught error'
      }
    }
  }
}

Why does Jenkins not retry the stage even though retry(3) is set?

Jenkins

options {
  retry(3)
}
stage('Test') {
  steps {
    script {
      try {
        sh 'exit 1'
      } catch (e) {
        echo 'Caught error'
      }
    }
  }
}

A Because retry only works with timeout, not shell failures.

B Because the error is caught inside the script block, Jenkins does not see the failure to trigger retry.

C Because retry must be set inside the stage, not in options.

D Because the shell command 'exit 1' is invalid syntax.

💡 Hint

Think about how Jenkins detects failures to retry.

Jenkins retries a stage only if it fails. Here, the failure is caught by the try-catch block, so Jenkins sees the stage as successful and does not retry.

✅ Best Practice

expert

What is the best way to combine timeout and retry options to handle flaky tests in Jenkins pipelines?

You want to run a test stage that might fail sometimes and could hang. You want to retry it up to 2 times and also stop it if it runs longer than 3 minutes each try.

Which Jenkins pipeline options block achieves this correctly?

A

options {
  retry(2)
  timeout(3)
}

B

options {
  timeout(time: 3, unit: 'MINUTES') {
    retry(2)
  }
}

C

options {
  retry(2)
  timeout(time: 3, unit: 'MINUTES')
}

D

options {
  retry(2, timeout: 3)
}

💡 Hint

Check the correct syntax for combining options in Jenkins pipelines.

Option C correctly sets retry and timeout as separate directives inside the options block. Option C uses invalid nested syntax. Option C and D have incorrect syntax for timeout.