Input Function in Pipeline

What Does the Input Function Do?

The input function pauses a pipeline and takes an explicit input/approval from the user before continuing.

• If the user clicks OK/Yes, the build continues.
• If the user clicks Abort/No, the build fails/stops right there.

Real-Time Scenario

Continuous Integration (build + test) happens automatically without asking anyone. But when it comes to the deploy stage, we often want a human checkpoint — typically an approval manager reviews everything and clicks OK to approve the deployment.

To make this work properly, managers are usually given full build permissions via Role-Based Strategy (see the User Management topic).

Example

pipeline {
    agent any
    stages {
        stage('Input function') {
            steps {
                sh 'echo "hi my name is sandeep"'
                input {
                    message "are you sure ?"
                    ok "yes"
                }
            }
        }
    }
}

What Happens on Build

• The pipeline pauses at the input step and shows a prompt: "are you sure ?" with yes / Abort options.
• Clicking yes marks the stage as approved (Jenkins even logs who approved it) and the build succeeds.
• Clicking Abort stops the build immediately.

This is exactly how manual approval gates are implemented before a production deployment in real projects.