Является ли `input` директивой или шагом

Question

Директива ввода на сцене позволяет вам запрашивать ввод, используя шаг ввода...

(цит. По синтаксису конвейера, документация пользователя Jenkins https://jenkins.io/doc/book/pipeline/syntax/#input)

Так что input на самом деле является директивой или шагом? Как понять фразу "с помощью вводаstep "

Используемый здесь конвейер (извлечение):

stage('StageName') {
    when { environment name: 'VAR1', value: 'true' }
    steps {
        input {
            message: "press OK to continue"
        }
        dir('doithere') {
            git url: gitcoord[0], branch: gitcoord[1], credentialsId: gitcoord[2] 
            cmd('ls -alh') 
        }
    }
}

Время выполнения:

WorkflowScript: 336: Expected a step @ line 336, column 34.
                       message: "press OK to continue"
                                ^

Answer 1

В декларативном конвейере вы должны поместить его непосредственно ниже уровня stage («директива»). Тогда это в форме input { .. }.

В скриптовых конвейерах (или script блоках в декларативных конвейерах) он существует как обычный шаг. Синтаксис тогда будет input(..):

stage('StageName') {
    when { environment name: 'VAR1', value: 'true' }
    steps {
        dir('doithere') {
            git url: gitcoord[0], branch: gitcoord[1], credentialsId: gitcoord[2] 
            cmd('ls -alh') 
            input(message: "press OK to continue")
            cmd('rm -rf *')
        }
    }
}

Answer 2

Ниже у меня работало:

pipeline {
    agent any
    stages {
        stage('stage1') {
            input {
                message "press OK to continue"
            }
            steps {
                sh "mkdir dir1"
                dir("dir1") {
                    sh "echo 'Hello'"
                }
            }
        }
    }
}