
本文旨在指导如何在jenkins中自动化执行api调用,解析html响应内容,并根据提取的数值进行条件判断,最终触发邮件通知。文章将详细介绍如何利用jenkins dsl的`httprequest`插件获取数据,结合groovy进行字符串操作或html解析来提取关键数值,并构建条件逻辑以在特定阈值被突破时发送警报邮件,从而实现有效的系统监控和及时响应。
在Jenkins Pipeline中,我们可以利用 httpRequest 插件来向指定的API URL发送HTTP请求并获取其响应。这个插件使得在Jenkins作业中进行外部服务调用变得非常简便。
首先,确保你的Jenkins实例已经安装了 HTTP Request Plugin。如果没有,请通过“Manage Jenkins” -> “Manage Plugins”进行安装。
在Jenkinsfile或Pipeline脚本中,你可以这样调用API:
pipeline {
agent any
stages {
stage('Fetch HTML Response') {
steps {
script {
// 定义目标API URL
def apiUrl = "http://{Project_IP}/{app_name}/ServiceQueueMonitorServlet?Action=retrieve"
// 发送GET请求并获取响应
// customHeaders 可用于设置请求头,例如指定接受的MIME类型
def response = httpRequest url: apiUrl, customHeaders: [[name: 'Accept', value: 'text/html']]
// 响应内容通常在 response.content 中
String htmlContent = response.content
echo "Fetched HTML Content:\n${htmlContent}"
// 将htmlContent存储起来,供后续阶段使用
env.HTML_RESPONSE = htmlContent
}
}
}
// ... 后续阶段
}
}注意事项:
立即学习“前端免费学习笔记(深入)”;
获取到HTML响应内容后,下一步是解析它并提取我们感兴趣的数值。根据HTML结构的复杂程度,我们可以选择不同的方法。
对于结构相对简单、数值嵌入在特定标签内的HTML,使用Groovy的字符串操作和正则表达式是快速有效的方案。例如,如果目标HTML片段是 <TD>502</TD>,我们可以通过正则表达式来捕获数字。
pipeline {
agent any
stages {
stage('Extract Value') {
steps {
script {
// 从上一个阶段获取HTML内容
String htmlContent = env.HTML_RESPONSE
if (!htmlContent) {
error "HTML content is empty. Cannot proceed with extraction."
}
// 定义正则表达式来匹配 <TD>数值</TD> 结构
// (\d+) 是一个捕获组,用于捕获一个或多个数字
def pattern = /<TD>(\d+)<\/TD>/
def matcher = (htmlContent =~ pattern) // 使用 =~ 操作符进行模式匹配
int monitoredValue = -1 // 默认值,表示未找到或错误
if (matcher.find()) {
// 如果找到匹配项,matcher.group(1) 将返回第一个捕获组的内容(即数字)
monitoredValue = matcher.group(1).toInteger()
echo "Successfully extracted value: ${monitoredValue}"
env.MONITORED_VALUE = monitoredValue.toString() // 存储为环境变量
} else {
echo "Could not find the target value in the HTML response using pattern: ${pattern}"
// 可以在此处添加错误处理或通知
}
}
}
}
// ... 后续阶段
}
}优点: 代码简洁,对于固定或简单模式的HTML非常高效。 缺点: 对HTML结构变化敏感,如果HTML布局发生微小改变,正则表达式可能需要更新。
如果HTML结构复杂,或者需要更健壮、更灵活的解析方式(例如通过CSS选择器或XPath定位元素),建议使用专门的HTML解析库。虽然Jenkins Pipeline的默认Groovy环境不包含所有外部库,但可以通过在Jenkins服务器上安装库或使用@Grab注解引入依赖(需要适当配置Jenkins沙箱安全策略)。
常用的Groovy HTML解析库有:
如果选择使用Jsoup,通常需要在Jenkins Agent上确保相关JAR包可用,或者通过@Grab动态下载:
// 示例(仅作示意,实际使用需确保安全沙箱允许并处理依赖)
// @Grab('org.jsoup:jsoup:1.14.3') // 动态引入Jsoup库,需Jenkins配置允许
// import org.jsoup.Jsoup
// import org.jsoup.nodes.Document
// ... 在 script 块中
// Document doc = Jsoup.parse(htmlContent)
// String valueText = doc.select("tr > td:nth-child(2)").first().text() // 示例CSS选择器
// int monitoredValue = valueText.toInteger()优点: 健壮性高,对HTML结构变化有更好的适应性,能够处理更复杂的解析需求。 缺点: 可能需要额外的配置来引入外部库,增加Jenkins环境的复杂性。
提取到数值后,我们就可以根据预设的条件进行判断,并在条件满足时触发邮件通知。Jenkins通常通过 Email Extension Plugin 来发送邮件。
确保你的Jenkins实例已经安装了 Email Extension Plugin 并配置了SMTP服务器设置(在“Manage Jenkins” -> “Configure System”中)。
pipeline {
agent any
stages {
stage('Fetch and Validate') {
steps {
script {
def apiUrl = "http://{Project_IP}/{app_name}/ServiceQueueMonitorServlet?Action=retrieve"
def response = httpRequest url: apiUrl, customHeaders: [[name: 'Accept', value: 'text/html']]
String htmlContent = response.content
if (!htmlContent) {
error "HTML content is empty. Cannot proceed."
}
def pattern = /<TD>(\d+)<\/TD>/
def matcher = (htmlContent =~ pattern)
int monitoredValue = -1
if (matcher.find()) {
monitoredValue = matcher.group(1).toInteger()
echo "Extracted value: ${monitoredValue}"
// 进行条件判断
if (monitoredValue > 100) { // 如果值大于100
echo "Alert: Monitored value ${monitoredValue} exceeds threshold (100). Sending email..."
// 触发邮件通知
mail(
to: 'recipient@example.com, another.recipient@example.com', // 收件人列表,逗号分隔
subject: "Jenkins Alert: Monitored Value Exceeded Threshold (${monitoredValue})", // 邮件主题
body: """
<p>Dear Team,</p>
<p>The monitored value from the API <code>${apiUrl}</code> has exceeded the predefined threshold.</p>
<ul>
<li>Extracted Value: <strong>${monitoredValue}</strong></li>
<li>Threshold: <strong>100</strong></li>
<li>Jenkins Job: ${env.JOB_NAME}</li>
<li>Build URL: ${env.BUILD_URL}</li>
</ul>
<p>Please investigate the service status.</p>
<p>Regards,<br>Jenkins Automation</p>
""", // 邮件正文,支持HTML格式
from: 'jenkins@yourcompany.com', // 发件人地址(可选,通常在全局配置)
cc: 'cc.recipient@example.com', // 抄送
bcc: 'bcc.recipient@example.com', // 密送
mimeType: 'text/html' // 指定邮件内容为HTML
)
} else {
echo "Monitored value ${monitoredValue} is within acceptable limits (<= 100)."
}
} else {
echo "Error: Could not find the target value in the HTML response."
// 也可以在此处发送解析失败的告警邮件
mail(
to: 'admin@example.com',
subject: "Jenkins Error: HTML Parsing Failed for ${env.JOB_NAME}",
body: "Failed to extract value from API response for job ${env.JOB_NAME}. Please check the API URL and HTML structure."
)
}
}
}
}
}
}注意事项:
立即学习“前端免费学习笔记(深入)”;
通过结合Jenkins的 httpRequest 插件和Groovy脚本,我们可以实现强大的自动化监控和通知系统。无论是简单的字符串匹配还是复杂的HTML解析,Jenkins都提供了灵活的工具来处理这些任务。这种自动化实践不仅能够及时发现系统异常,还能大大提高运维效率,确保服务的稳定运行。在实施过程中,务必关注错误处理、安全性以及代码的可维护性,以构建一个健壮可靠的自动化解决方案。
以上就是Jenkins自动化:基于HTML响应内容进行条件判断并触发邮件通知的详细内容,更多请关注php中文网其它相关文章!
HTML怎么学习?HTML怎么入门?HTML在哪学?HTML怎么学才快?不用担心,这里为大家提供了HTML速学教程(入门课程),有需要的小伙伴保存下载就能学习啦!
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号