Jenkins为您提供了两种开发Pipeline的方式：脚本式和声明式。

1. 脚本式流水线（也称为传统流水线）基于Groovy作为其特定于域的语言。
2. 而声明式流水线提供了简化且更友好的语法，并带有用于定义它们的特定语句，而无需学习Groovy。声明式流水线语法错误在脚本开始时报告。这是一个很好的功能，因为您不会浪费时间，直到某个步骤未能意识到拼写错误或拼写错误。如前所述，流水线可以以声明式或脚本式编写。而且，声明式方法建立在脚本式方法的基础之上，通过添加script步骤，可以很容易地进行扩展。

声明式流水线 vs 脚本式流水线共同点：

• 两者都是pipeline代码的持久实现，都能够使用pipeline内置的插件或者插件提供的steps，两者都可以利用共享库扩展。

区别：

• 两者不同之处在于语法和灵活性。
• Declarative pipeline对用户来说，语法更严格，有固定的组织结构，更容易生成代码段，使其成为用户更理想的选择。
• 但是Scripted pipeline更加灵活，因为Groovy本身只能对结构和语法进行限制，对于更复杂的pipeline来说，用户可以根据自己的业务进行灵活的实现和扩展

声明式流水线

必须使用pipeline语句定义有效的声明式流水线，并包括以下必需的部分：

• agent
• stages
• stage
• steps

另外，还有这些可用的指令：

• environment (在流水线或阶段级别定义)
• input (阶段级别定义)
• options (在流水线或阶段级别定义)
• parallel
• parameters
• post
• dcript
• tools
• triggers
• when

现在，我们将从所需的指令/部分开始，对列出的每个指令/部分进行描述。

agent

agent{ label this k8s-api-label}agent{node{labelthis is k8sapi-labelcustomWorkspace/some/other/path}}agent{docker{imageim-weblabelthis is k8sapi-labelargs-v /tmp:/tmp}}pipeline{agentnonestages{stage(ExampleBuild) {agent{ docker maven:3-alpine }steps{echoHello, Mavenshmvn --version}}stage(ExampleTest) {agent{ docker openjdk:8-jre }steps{echoHello, JDKshjava -version}}}}pipeline{//Executeall the steps defined in this Pipeline within a newly created container of the given name and tag (maven:3-alpine).agent{ docker maven:3-alpine }stages{stage(ExampleBuild) {steps{shmvn -B clean verify}}}}复制代码

options

pipeline{agentanyoptions{retry(3)//将流水线配置为在失败前重试3次：}stages{echodo something}}复制代码

parameters

parameters指令提供用户在触发Pipeline时的参数列表。这些参数值通过该params对象可用于Pipeline步骤目前只支持[booleanParam, choice, credentials, file, text, password, run, string]这几种参数类型，其他高级参数化类型还需等待社区支持。

pipeline {
    agent any
    parameters {
        string(name:user, defaultValue:John, description:A user that triggers the pipeline)
    }
    stages {
        stage(Trigger pipeline) {
            steps {echo"Pipeline triggered by${params.USER}"}
        }
    }
}

pipeline {
    agent any

    options {
        timeout(time:1, unit:HOURS)
    }

    parameters {
        choice(name:PerformMavenRelease,choices:False\nTrue,description:desc)
        //   password(name:CredsToUse,defaultValue:,description:A password to build with)
    }

    environment {
        SONAR_SERVER =http://172.16.230.171:9000JAVA_HOME=/data/jdk}

    stages {
        stage(sonarserver) {
            steps {echo"${SONAR_SERVER}"}
        }
        stage(javahome) {
            steps {echo"${JAVA_HOME}"}
        }
        stage(get parameters) {
            steps {echo"${params.PerformMavenRelease}"}
        }        
    }
}

pipeline {
    agent any
    parameters {
        string(name:PERSON, defaultValue:Mr Jenkins, description:Who should I say hello to?)
    }
    stages {
        stage(Example) {
            steps {echo"Hello${params.PERSON}"}
        }
    }
}
复制代码

stages

pipeline{agentanystages{stage(Example){steps{echoHello World}}}stage(echo){steps{echoI will ........!}}}复制代码

steps

pipeline {
    agent any
    stages {
        stage(Example) {
            steps {
    shecho "A one line step"shecho "A multiline step"
    cd /tests/results
    ls -lrt}
        }
    }
    stage(echo) {
        steps {  
    bat"mvn clean test -Dsuite=SMOKE_TEST -Denvironment=QA"powershell".\funcional_tests.ps1"}
    }
}
复制代码

environment

environment指令指定一系列键值对，这些键值对将被定义为所有step或stage-specific step的环境变量，具体取决于environment指令在Pipeline中的位置。该指令支持一种特殊的方法credentials()，可以通过其在Jenkins环境中的标识符来访问预定义的凭据。对于类型为Secret Text的凭据，该 credentials()方法将确保指定的环境变量包含Secret Text内容；对于标准用户名和密码类型的凭证，指定的环境变量将被设置为username:password。

//在pipeline级别：pipeline{agentanyenvironment{SONAR_SERVER=http://172.16.230.171:9000}stages{stage(Example){steps{echo"${SONAR_SERVER}"}}}}//在stage级别：pipeline{agentanystages{stage(build) {environment{OUTPUT_PATH=./outputs/}...}...}}复制代码

input

input指令在阶段级别定义，提供提示输入的功能。该阶段将被暂停，直到用户手动确认为止。以下配置选项可用于此指令：

• message：这是必需的选项，其中指定了要显示给用户的消息。
• id：可选标识符。默认情况下，使用阶段名称。
• ok：确定按钮的可选文本。
• submitter：允许提交输入的用户或外部组名的可选列表。默认情况下，允许任何用户。
• submitterParameter：要使用提交者名称设置的环境变量的可选名称（如果存在）。
• parameters：提交者将提供的可选参数列表。

这是包含此指令的示例流水线：

pipeline {
    agent any
    stages {
        stage (build) {
            input{
               message"Press Ok to continue"submitter"user1,user2"parameters {
                   string(name:username, defaultValue:user, description:Username of the user pressing Ok)
                }
            }
            steps {echo"User:${username}said Ok."}
        }
    }
}
复制代码

parallel

Jenkins流水线阶段可以在内部嵌套其他阶段，这些阶段将并行执行。这是通过在脚本中添加parallel指令来完成的。使用示例：

stage(run-parallel-branches) {
    steps {
        parallel(
            a: {echo"Tests on Linux"},
            b: {echo"Tests on Windows"}
        )
    }
}
复制代码

从声明式流水线1.2版开始，引入了一种新语法，使并行语法的使用更像声明式的。使用此新语法重写的先前脚本如下所示：

pipeline{agentnonestages{stage(RunTests) {parallel{stage(TestOn Windows) {agent{label"windows"}steps{bat"run-tests.bat"}}stage(TestOn Linux) {agent{label"linux"}steps{sh"run-tests.sh"}}}}}}复制代码

上述的任何一个流水线都将如下所示：

由于两个脚本都运行特定的平台测试，因此它们将在不同的节点上运行测试。如果您的Jenkins服务器具有足够的CPU，则还可以通过使用多线程将并行用于在同一节点上同时运行阶段。使用并行阶段时有一些限制：

• stage指令可以具有parallel指令或steps指令，但不能同时具有两者。
• parallel指令中的一个stage指令不能嵌套另一个parallel指令，仅允许steps。
• 在内部具有parallel指令的stage指令不能定义agent或tools指令。

post

pipeline{agentanystages{stage(Example){steps{echoHello World}}}post{always{echoI will always say Hello again!}}}复制代码

script

此步骤用于将脚本化流水线语句添加到声明式流水线中，从而提供更多功能。此步骤必须包括在stage级别。脚本块可以多次用于不同的项目。这些块使您可以扩展Jenkins功能，并可以实现为共享库。可以在Jenkins共享库中找到有关此内容的更多信息。同样，可以将共享库导入并使用到script中，从而扩展了流水线功能。接下来，我们将提供示例流水线。第一个只有一个包含一段脚本化流水线代码的块，而第二个将展示如何导入和使用共享库：

pipeline{agentanystages{stage(Sample){steps{echo"Scripted block"script{}}}}}复制代码

tools

可以在流水线级别或阶段级别添加tools指令。它允许您指定要在脚本上使用的Maven，JDK或Gradle版本。必须在全局工具配置Jenkins菜单上配置这些工具中的任何一个，在撰写本文时，这三个工具都受支持。另外，Jenkins将尝试安装列出的工具（如果尚未安装）。通过使用此指令，可以确保安装了项目所需的特定版本。

pipeline{agentany
    tools {mavenapache-maven-3.0.1////工具名称必须在Jenkins 管理Jenkins → 全局工具配置中预配置。
    }
    stages {echodo something}
}
复制代码

triggers

触发器允许Jenkins通过使用以下任何一个可用的方式自动触发流水线：

• cron：通过使用cron语法，它可以定义何时重新触发管道。
• pollSCM：通过使用cron语法，它允许您定义Jenkins何时检查新的源存储库更新。如果检测到更改，则将重新触发流水线。（从Jenkins 2.22开始可用）。
• upstream：将Jenkins任务和阈值条件作为输入。当列表中的任何任务符合阈值条件时，将触发流水线。

带有可用触发器的示例流水线如下所示：

pipeline{agentanytriggers{//Execute weekdays every four hours starting at minute 0cron(0 */4 * * 1-5)
    }stages{
        ...
    }
}pipeline{agentanytriggers{//Query repository weekdays every four hours starting at minute 0pollSCM(0 */4 * * 1-5)
    }stages{
        ...
    }
}pipeline{agentanytriggers{//Execute when either job1 or job2 are successfulupstream(upstreamProjects:job1, job2,threshold: hudson.model.Result.SUCCESS)
    }stages{
        ...
    }
}
复制代码

when

when指令允许Pipeline根据给定的条件确定是否执行该阶段。该when指令必须至少包含一个条件。如果when指令包含多个条件，则所有子条件必须为stage执行返回true。这与子条件嵌套在一个allOf条件中相同更复杂的条件结构可使用嵌套条件建：not，allOf或anyOf。嵌套条件可以嵌套到任意深度

|内置条件branch：- 当正在构建的分支与给出的分支模式匹配时执行，例如：when { branch master }。请注意，这仅适用于多分支Pipeline。environment- 当指定的环境变量设置为给定值时执行，例如： when { environment name: DEPLOY_TO, value: production }expression- 当指定的Groovy表达式求值为true时执行，例如： when { expression { return params.DEBUG_BUILD } }not- 当嵌套条件为false时执行。必须包含一个条件。例如：when { not { branch master } }allOf- 当所有嵌套条件都为真时执行。必须至少包含一个条件。例如：when { allOf { branch master; environment name: DEPLOY_TO, value: production } }

使用方法：1.when 仅用于stage内部2. when 的内置条件

• when {branch master} 当是master的时候，才执行某些事情
• when {envionment name:DEPLOY_TO,value:production} 当环境变量name 的值是production的时候，才执行某些事情
• when {expression {return params.DEBUG_BUILD}} 表达式的返回值是真的情况下，才执行
• when {not {branch master}}不是master的情况下，执行
• when {allOf {branch master; environment name: DEPLOY_TO,value:production}} 当大括号中所有的项都成立，才去做某些事情
• when {anyOf {branch master; branch staging}} 只要满足大括号里面的某一个条件，才去做某些事情

例如，流水线使您可以在具有多个分支的项目上执行任务。这被称为多分支流水线，其中可以根据分支名称（例如master， feature*，development等）采取特定的操作。这是一个示例流水线，它将运行master分支的步骤：

pipeline{agentanystages{stage(Deploystage) {when{branchmaster}steps{echoDeploy master to stage}}}}复制代码

脚本式流水线

Groovy脚本不一定适合所有使用者，因此jenkins创建了Declarative pipeline，为编写Jenkins管道提供了一种更简单、更有主见的语法。但是不可否认，由于脚本化的pipeline是基于groovy的一种DSL语言，所以与声明式 pipeline相比为jenkins用户提供了更巨大的灵活性和可扩展性。

流程控制if/else条件

pipeline脚本同其它脚本语言一样，从上至下顺序执行，它的流程控制取决于Groovy表达式，如if/else条件语句

node {
    stage(Example){if(env.BRANCH_NAME ==master){echoI only execute on the master branch}else{echoIexecute elsewhere}
    }
}
复制代码

异常处理try/catch/finally

pipeline脚本流程控制的另一种方式是Groovy的异常处理机制。当任何一个步骤因各种原因而出现异常时，都必须在Groovy中使用try/catch/finally语句块进行处理

node{
    stage(Example){try{
            shexit 1}catch(exc) {echosomething failed,I should sound the klaxons!throw}
    }
}
复制代码

循环

for循环仅存在域脚本式pipeline中，但是可以通过在声明式pipeline中调用script step来执行

pipeline {
    agent any
    stages {
        stage(Example){
            steps{echoHello world!script {
                    def browsers = [chrome,firefox]for(int i = 0;i < browers.size();++i){echo"Testing the${browsers[i]}browser"}
                }
            }
        }
    }
}
复制代码

于大多数用例，script在Declarative Pipeline中的步骤不是必须的，但它可以提供一个有用的加强。