在Jenkins的Pipeline脚本中，各个组件的配置和Groovy的一些常用函数起到了决定性的作用，帮助开发人员控制自动化流程的执行。以下是对Jenkins Pipeline的主要组件和Groovy常用函数的详细讲解：
1. Jenkins Pipeline主要组件
1.1 agent
- 功能：定义在哪台节点上执行Pipeline任务。
- 语法：
- agent any：表示可以在任何可用节点上执行。
- agent none：表示不在任何节点上执行，适合在 stages 中单独指定 agent。
- agent { label ‘label_name’ }：在特定标签的节点上执行。
- agent { docker { image ‘image_name’ } }：使用特定的Docker镜像来执行Pipeline。
1.2 environment
- 功能：设置环境变量，可以在整个Pipeline中使用。
- 语法：
environment {ENV_VAR = 'value'PATH = "/usr/bin:/usr/local/bin:${PATH}"
}
1.3 options
-
功能：配置Pipeline的高级选项，比如超时设置、丢弃旧的构建等。
-
常见配置：
- timeout(time: 1, unit: ‘HOURS’)：将Pipeline的执行限制在1小时内。
- disableConcurrentBuilds()：防止并发构建。
- buildDiscarder(logRotator(numToKeepStr: ‘5’))：只保留5个构建记录。
-
实例
options {timestamps()timeout(time: 4, unit: 'HOURS')buildDiscarder(logRotator(artifactDaysToKeepStr: '100', artifactNumToKeepStr: '100', daysToKeepStr: '200', numToKeepStr: '200'))copyArtifactPermission('/DS_BFFD/FFGFGGDY/ssffgd_ddfddf-MT');} 1. timestamps() 功能：在构建日志中添加时间戳。 作用：每条日志消息前都会显示时间戳，方便用户查看构建过程中的时间信息。 2. timeout(time: 4, unit: 'HOURS') 功能：设置构建的超时时间。 参数： time: 4：表示超时时间为 4。 unit: 'HOURS'：表示时间单位为小时。 作用：如果构建在 4 小时内没有完成，Jenkins 将自动终止该构建。这有助于防止构建长时间挂起。 3. buildDiscarder(logRotator(...)) 功能：设置构建的保留策略。参数：logRotator 是一个用于控制构建日志和工件保留的类，具体参数如下：artifactDaysToKeepStr: '100'：保留构建工件的天数，设置为 100 天。artifactNumToKeepStr: '100'：保留的构建工件数量，设置为 100 个。daysToKeepStr: '200'：保留构建日志的天数，设置为 200 天。numToKeepStr: '200'：保留的构建日志数量，设置为 200 个。 作用：如果构建在 4 小时内没有完成，Jenkins 将自动终止该构建。这有助于防止构建长时间挂起。 4. buildDiscarder(logRotator(...)) 功能：设置构建的保留策略。 参数：logRotator 是一个用于控制构建日志和工件保留的类，具体参数如下：artifactDaysToKeepStr: '100'：保留构建工件的天数，设置为 100 天。artifactNumToKeepStr: '100'：保留的构建工件数量，设置为 100 个。daysToKeepStr: '200'：保留构建日志的天数，设置为 200 天。numToKeepStr: '200'：保留的构建日志数量，设置为 200 个。 作用：这个选项帮助管理 Jenkins 中的构建历史，确保不会无限制地保留构建日志和工件，从而节省存储空间。 5. copyArtifactPermission('/DS_BFFD/FFGFGGDY/ssffgd_ddfddf-MT') 功能：设置对特定路径的复制工件的权限。 参数：'/DS_BFFD/FFGFGGDY/ssffgd_ddfddf-MT' 是一个路径，表示允许从该路径复制工件。 作用：这个选项确保在构建过程中可以从指定的路径复制工件，通常用于多项目构建或需要共享工件的场景。``` -
总结
- options 块用于设置构建的全局选项，包括时间戳、超时、构建日志和工件的保留策略，以及复制工件的权限。
- buildDiscarder(logRotator(…)) 选项帮助管理构建历史，确保不会占用过多的存储空间。
- copyArtifactPermission 选项确保在构建过程中可以从指定路径复制工件。
这些选项的设置有助于提高 Jenkins 构建的可管理性和可维护性。
1.4 parameters
- 功能：定义构建时用户可以输入的参数。
- 常见配置：
- string(name: ‘ENV’, defaultValue: ‘dev’, description: ‘Environment to deploy’)：文本输入。
- booleanParam(name: ‘DEPLOY’, defaultValue: true, description: ‘是否部署’)：布尔值输入。
- choice(name: ‘BRANCH’, choices: [‘dev’, ‘qa’, ‘prod’], description: ‘分支选择’)：选择输入。
1.5 tools
- 功能：指定运行Pipeline时需要的工具（如JDK、Maven）。
- 常见配置：
tools {jdk 'JDK8'maven 'Maven 3.6.3'}
1.6 triggers
- 功能：定义触发Pipeline的条件，比如定时执行或代码变更。
- 常见配置：
- cron(‘H 4/* 0 0 1-5’)：按照特定时间执行。
- pollSCM(‘H/5 * * * *’)：每5分钟检查SCM是否有代码变更。
- upstream(upstreamProjects: ‘project-name’, threshold: hudson.model.Result.SUCCESS)：当指定的上游项目成功时触发。
1.7 stages
- 功能：包含具体的构建步骤，通常分成若干 stage。
- 语法：
stages {stage('Build') {steps {echo 'Building...'}}stage('Test') {steps {echo 'Testing...'}}
}
1.8 post
- 功能：定义在构建结束时执行的操作，如清理资源、通知等。
- 常见选项：
- always：无论成功或失败都执行。
- success：构建成功时执行。
- failure：构建失败时执行。
- unstable：构建结果不稳定时执行。
- 语法：
post {always {echo 'Cleaning up...'}success {echo 'Success!'}failure {echo 'Build failed!'}
}
2. Groovy常用函数
2.1 发送邮件的实现
Jenkins提供了 emailext 插件，用于发送构建通知邮件。可以自定义 body 内容，格式为HTML或纯文本。以下是一个带HTML格式的邮件发送示例：
post {failure {emailext (subject: "构建失败通知 - ${env.JOB_NAME} #${env.BUILD_NUMBER}",body: """<h3>构建失败通知</h3><p>项目名称: ${env.JOB_NAME}</p><p>构建编号: ${env.BUILD_NUMBER}</p><p>触发原因: ${currentBuild.description}</p><p>详情请查看 <a href="${env.BUILD_URL}">构建日志</a></p>""",recipientProviders: [[$class: 'DevelopersRecipientProvider']])}
}
2.2 sh 和 bat 执行系统命令
在不同操作系统中执行Shell或Batch命令。
Linux/macOS:
sh 'echo "Hello from Linux"'
Windows:
bat 'echo Hello from Windows'
2.3 catchError
用于在步骤中捕获错误并继续执行，以确保流程不中断。
catchError(buildResult: 'UNSTABLE') {sh 'exit 1' // 即使失败，也将当前构建标记为UNSTABLE而不是FAILED
}
2.4 archiveArtifacts
用于归档构建生成的文件，便于后续的访问。
archiveArtifacts artifacts: '**/target/*.jar', allowEmptyArchive: true
2.5 readFile 和 writeFile
用于在Pipeline中读取或写入文件内容。
def content = readFile 'myfile.txt'
writeFile file: 'output.txt', text: content
总结
Jenkins Pipeline脚本的灵活性体现在各个组件的组合使用上，如通过 agent 指定执行节点，parameters 实现构建参数化，post 中加入错误通知等。而Groovy的丰富函数扩展，如 emailext、archiveArtifacts 等，使得Pipeline的配置更加灵活和便捷。通过这些配置和Groovy函数的掌握，能更好地构建、监控和管理CI/CD流程。
