Editable Email Notification 插件Pre-send Script获取构建的常用的属性和方法

Pre-send Script Editable Email Notification 插件的 build 对象中 result 属性是一个常见的属性，但具体的属性会根据不同的插件和实现而有所不同。以下是一些可能的属性列表，以帮助你了解 build 对象的完整属性：

常见属性

1. result:
   • status: 构建的状态（如成功、失败、取消等）。
   • number: 构建的编号。
   • url: 构建的 URL。
   • fullDisplayName: 构建的完整显示名称。
   • timestamp: 构建开始的时间戳。
   • duration: 构建的持续时间。

其他可能的属性

1. build:

   • id: 构建的唯一标识符。
   • displayName: 构建的显示名称。
   • description: 构建的描述信息。
   • result: 构建的结果（如 SUCCESS, FAILURE, UNSTABLE 等）。
   • actions: 构建的动作列表，可能包括各种插件的动作。
   • artifacts: 构建生成的工件列表。
   • changeSets: 构建的变更集列表。
   • culprits: 构建失败的可能原因列表（责任人）。
   • executor: 执行构建的执行器信息。
   • keepLog: 是否保留日志。
   • nextBuild: 下一个构建的引用。
   • previousBuild: 上一个构建的引用。
   • queueId: 队列中的唯一标识符。
   • timestamp: 构建开始的时间戳。
   • url: 构建的 URL。

2. job:

   • name: 作业的名称。
   • url: 作业的 URL。
   • builds: 构建的历史列表。
   • color: 作业的状态颜色（如蓝色表示成功，红色表示失败）。

3. parameters:

   • 构建时使用的参数列表，包含参数名和值。

示例对象结构

{ "build": { "id": "123", "number": 456, "url": "http://example.com/job/my-job/456/", "result": "SUCCESS", "timestamp": 1657003200000, "duration": 30000, "fullDisplayName": "My Job #456", "description": "Build description", "actions": [], "artifacts": [], "changeSets": [], "culprits": [], "executor": null, "keepLog": false, "nextBuild": null, "previousBuild": { "number": 455, "url": "http://example.com/job/my-job/455/" }, "queueId": 789, "job": { "name": "my-job", "url": "http://example.com/job/my-job/" } } }

Jenkins中的日志相关属性和方法

在Jenkins中，构建对象通常会有以下与日志相关的属性和方法：

1. log: 获取构建日志的简化版本。
2. logText: 获取构建日志的完整文本内容。
3. logFile: 获取构建日志的文件对象。

示例脚本

以下是一个使用Groovy脚本在Jenkins中获取构建日志的示例：

// 获取当前构建对象 def build = currentBuild.rawBuild // 获取日志内容 def logContent = build.getLog() // 输出日志内容 println logContent.join('\n') // 获取日志文件对象 def logFile = build.getLogFile() // 输出日志文件路径 println "Log file path: ${logFile.absolutePath}"

Jenkins Pipeline 中的示例

在Jenkins Pipeline中，可以使用 currentBuild 对象来访问构建日志：

pipeline { agent any stages { stage('Build') { steps { script { // 打印当前构建日志 echo currentBuild.rawBuild.getLog().join('\n') } } } } }

获取部分日志

如果只需要获取日志的一部分，可以使用类似的方法：

// 获取最近10行日志 def lastTenLines = build.getLog(10) println lastTenLines.join('\n')

Editable Email Notification 插件的 build 对象中 查看日志 属性

获取构建日志的属性

在 Jenkins 的 build 对象中，通常可以通过以下方法访问日志信息：

• build.getLog(): 获取整个构建日志，返回一个字符串列表，每个元素是日志的一行。
• build.getLog(int maxLines): 获取构建日志的前 maxLines 行。
• build.getLogFile(): 获取构建日志的文件对象，可以直接读取文件内容。

示例脚本

以下是一个在 Editable Email Notification 插件中使用的示例脚本，展示如何获取和包含构建日志信息：

// 获取当前构建对象 def build = currentBuild.rawBuild // 获取构建日志的前50行 def logContent = build.getLog(50).join('\n') // 构建邮件内容 def emailContent = """ <h2>Build ${build.number} Result: ${build.result}</h2> <p>Build URL: <a href="${build.absoluteUrl}">${build.absoluteUrl}</a></p> <h3>Build Log (last 50 lines):</h3> <pre>${logContent}</pre> """ // 发送邮件 emailext( subject: "Build ${build.number} Result: ${build.result}", body: emailContent, recipientProviders: [[$class: 'DevelopersRecipientProvider']] )