<think>我们被要求解释"pipelline的groovy语法"，但注意到用户输入可能存在拼写错误（"pipelline"应为"pipeline"）。因此，我们将解释Jenkins Pipeline的Groovy语法。 Jenkins Pipeline是一种基于Groovy的DSL（领域特定语言），用于定义持续交付流水线。以下是核心语法要点： ### 1. 基本结构 ```groovy pipeline { agent any // 指定执行节点 stages { stage('Build') { // 阶段定义 steps { // 步骤集合 // 具体操作 sh 'make' } } } post { // 后置处理 success { echo 'Pipeline succeeded!' } } } ``` ### 2. 关键指令 - **agent**：指定运行环境（如`any`, `none`, 或具体标签`label:'linux'`） - **stages**：包含多个`stage`的容器 - **stage**：定义流水线中的一个独立阶段（如构建、测试） - **steps**：在stage内定义具体操作步骤 - **post**：根据流水线状态执行操作（如`success`, `failure`） ### 3. 常用步骤 | 步骤 | 用途 | |-----------------------|-------------------------------| | `sh 'command'` | 执行Shell命令 | | `bat 'command'` | 执行Windows批处理命令 | | `echo 'message'` | 打印消息 | | `checkout scm` | 从版本控制检出代码 | | `archiveArtifacts` | 归档构建产物 | ### 4. 变量与环境变量 ```groovy // 定义变量 def version = '1.0' // 环境变量（全局） env.PATH = "/bin:${env.PATH}" // 使用环境变量 echo "Build URL: ${env.BUILD_URL}" ``` ### 5. 条件与循环 **条件判断** ```groovy stage('Deploy') { when { expression { env.BRANCH_NAME == 'master' } } steps { sh './deploy.sh' } } ``` **循环** ```groovy def tools = ['maven', 'gradle', 'ant'] for (int i = 0; i < tools.size(); i++) { stage("Build ${tools[i]}") { steps { sh "echo Building with ${tools[i]}" } } } ``` ### 6. 错误处理 ```groovy steps { retry(3) { sh './flakey-script.sh' } timeout(time: 1, unit: 'MINUTES') { sh './long-running-task.sh' } } ``` ### 7. 共享库 可复用代码封装在共享库中： ```groovy @Library('my-shared-library') _ pipeline { stages { stage('Example') { steps { myCustomStep() // 调用共享库中的函数 } } } } ``` §§相关问题§§ 1. 如何在Jenkins Pipeline中定义并行执行的任务？ 2. `agent none`在什么场景下使用？ 3. 如何捕获并处理Pipeline执行过程中的异常？ 4. 在Pipeline中如何安全地使用凭证（Credentials）？ 5. 如何优化Pipeline脚本以提高可维护性？ </think> ### Jenkins Pipeline 的 Groovy 语法详解 Jenkins Pipeline 使用 Groovy DSL（领域特定语言）定义持续集成/持续部署流程，核心语法结构如下： #### 1. 基础结构 ```groovy pipeline { agent any // 指定执行节点 stages { stage('阶段名称') { steps { // 执行步骤 } } } post { success { /* 成功后操作 */ } failure { /* 失败后操作 */ } } } ``` #### 2. 核心组件 - **agent**：定义执行环境 ```groovy agent { label 'linux-node' // 指定标签的节点 docker 'maven:3.8' // 使用Docker容器 } ``` - **stages/stage**：流程阶段划分 ```groovy stages { stage('Build') { steps { sh 'mvn package' } } stage('Test') { parallel { // 并行执行 stage('Unit Test') { ... } stage('Integration Test') { ... } } } } ``` - **steps**：具体执行命令 ```groovy steps { sh 'echo "Hello World"' // 执行Shell script { // Groovy脚本块 def version = readFile('VERSION').trim() env.APP_VERSION = version } } ``` - **post**：后置处理 ```groovy post { always { junit '**/target/*.xml' // 总是收集测试报告 } regression { emailext body: '测试回退', to: 'team@example.com' } } ``` #### 3. 变量处理 ```groovy environment { PROJECT = "my-app" // 环境变量 } parameters { choice(name: 'ENV', choices: ['dev', 'prod'], description: '部署环境') } script { def timestamp = new Date().format('yyyyMMdd_HHmm') currentBuild.displayName = "${params.ENV}-${timestamp}" } ``` #### 4. 流程控制 ```groovy stage('Deploy') { when { expression { params.ENV == 'prod' } // 条件执行 branch 'main' // 仅main分支触发 } steps { retry(3) { // 重试机制 sh './deploy.sh' } timeout(time: 10, unit: 'MINUTES') { // 超时控制 sh './smoke-test.sh' } } } ``` #### 5. 文件操作 ```groovy steps { checkout([ // 代码检出 $class: 'GitSCM', branches: [[name: '*/main']], extensions: [[$class: 'CleanBeforeCheckout']] ]) archiveArtifacts artifacts: 'target/*.jar' // 归档制品 } ``` #### 6. 错误处理 ```groovy pipeline { options { timeout(time: 1, unit: 'HOURS') retry(2) // 整个Pipeline重试 } stages { stage('Critical Step') { steps { script { try { sh 'critical-command' } catch (Exception e) { error "执行失败: ${e.message}" // 手动抛出错误 } } } } } } ``` ### 最佳实践 1. 使用 `Jenkinsfile` 存储Pipeline代码 2. 避免在Pipeline中使用复杂Groovy逻辑 3. 利用共享库复用通用函数 4. 始终添加超时和重试机制 5. 使用 `when` 条件控制阶段执行