分类
商品
![[SLG/中文/PC+安卓] 库拉拉酱逃不掉了 [92MB]](https://pic.songma.com/upload/215908/1750557333-215908/0391944001750557416tp215908-1.jpg)
- 商品
- 店铺
- 资讯
在某个深夜，一次失败的构建悄悄发生，直到第二天早上团队才发现问题——而这一切，本可以只是一条IRC消息的事。
虽然现在有Slack、钉钉、企业微信等各种花哨的即时通讯工具，但IRC这个“老家伙”在开发领域依然保持着惊人的活力。事实上，许多大型开源项目，包括Debian、Linux内核等，仍然使用IRC作为主要的开发沟通工具。
那么，在Jenkins通知的战场上，IRC有什么独特的优势？
IRC通知的不可替代之处
• 极低的资源消耗：IRC协议简单轻量，不会因为网络波动而轻易丢失消息，这对于关键构建通知至关重要。
• 跨平台兼容：无论你用的是Windows、Linux还是macOS，都有丰富的IRC客户端可供选择，如HexChat、Irssi等。
• 强大的机器人生态：可以结合各种机器人实现更复杂的交互，比如通过helga-jenkins这样的插件，Jenkins不仅能发送通知，还能响应IRC命令。
• 不依赖商业服务：与你自己的Jenkins实例一样，你可以完全控制IRC服务器，不需要担心第三方服务的API限制或费用问题。
当然，IRC也不是万能的。它的配置相对“老派”，需要一些命令行知识，而且在不熟悉的团队中推广可能需要一点时间。但一旦配置完成，它的稳定性和可靠性会让你感到惊喜。
俗话说“工欲善其事，必先利其器”，在开始之前，我们需要确保Jenkins已经安装了IRC插件并正确配置。
在Jenkins管理界面，进入“Manage Jenkins” → “Manage Plugins” → “Available”，搜索“IRC Notification”并安装。安装完成后，需要重启Jenkins使插件生效。
注意：如果你在企业网络环境中，确保防火墙不会阻止IRC连接。典型的IRC服务器使用6667端口（非SSL）或6697端口（SSL）。
进入“Manage Jenkins” → “Configure System”，找到“IRC Notification”部分。这里我们需要填写以下信息：
IRC Server：IRC服务器地址，如irc.libera.chatIRC Port：通常为6667（非SSL）或6697（SSL）Nick：Jenkins在IRC中显示的名称，如“jenkins-bot”Channel：要加入的频道，如#jenkins-notificationsNick Password：（如果需要）昵称的密码Channel Password：（如果需要）频道密码一个典型的配置示例看起来像这样：
![[ACT/中文/PC+安卓] 扶她山谷/Futaken Valley v0.040 【308M】](https://pic.songma.com/upload/69459/1692094178-69459/0402205001750378602tp69459-1.jpg)
IRC Server: irc.libera.chat
IRC Port: 6697
Nick: jenkins-bot
Channel: #myproject-ci
Use SSL: 选中实际经验：根据实际使用情况，Jenkins-bot可能会因为各种原因意外断开连接。建议在Nick字段中使用一个不常变化的固定昵称，并可选地设置昵称密码，以防止昵称被占用。
完成配置后，保存设置。如果一切正常，你应该能在IRC频道中看到Jenkins-bot加入。如果没有，可以查看Jenkins的系统日志来排查问题。
安装并配置好插件后，我们就可以在Pipeline中使用IRC通知了。与Web API调用相比，使用IRC插件的步骤更简单、更直观。
以下是一个简单的示例，展示如何在Pipeline中发送IRC通知：
pipeline {
agent any
stages {
stage('Build') {
steps {
echo 'Building...'
}
}
stage('Test') {
steps {
echo 'Testing...'
}
}
}
post {
always {
ircNotify targets: "#jenkins-notifications",
customMessage: "Build ${currentBuild.result ?: 'SUCCESS'} - ${env.JOB_NAME} #${env.BUILD_NUMBER}"
}
}
}在这个示例中，无论构建结果如何，我们都会向IRC频道发送一条通知。
currentBuild.result ?: 'SUCCESS' 表示如果
currentBuild.result为null（构建成功时的情况），则使用'SUCCESS'。
当然，我们可能希望根据不同的构建状态发送不同详细程度的通知。以下是一个更精细的示例：
pipeline {
agent any
stages {
stage('Build & Test') {
steps {
echo 'Building and testing...'
}
}
}
post {
success {
ircNotify targets: "#jenkins-notifications",
customMessage: "✅ BUILD SUCCESS - ${env.JOB_NAME} #${env.BUILD_NUMBER} - ${env.BUILD_URL}"
}
failure {
ircNotify targets: "#jenkins-notifications",
customMessage: "❌ BUILD FAILED - ${env.JOB_NAME} #${env.BUILD_NUMBER} - ${env.BUILD_URL} - 需要立即检查！"
}
unstable {
ircNotify targets: "#jenkins-notifications",
customMessage: "⚠️ BUILD UNSTABLE - ${env.JOB_NAME} #${env.BUILD_NUMBER} - ${env.BUILD_URL}"
}
aborted {
ircNotify targets: "#jenkins-notifications",
customMessage: "🚫 BUILD ABORTED - ${env.JOB_NAME} #${env.BUILD_NUMBER} - 可能被手动中止"
}
}
}通过使用不同的表情符号和消息内容，接收者可以快速理解构建状态，并采取相应行动。
基础通知只能告诉团队“发生了什么”，而高级技巧可以告诉他们“该怎么办”以及“哪里出了问题”。
IRC支持颜色代码，可以让消息更加醒目。例如，你可以使用以下方式发送彩色消息：
pipeline {
agent any
stages {
stage('Build') {
steps {
ircNotify targets: "#jenkins-notifications",
customMessage: "u00030,4重要通知：构建开始 - ${env.JOB_NAME} u0003"
}
}
}
}这里的
u00030,4表示设置白色文字（0）和红色背景（4）。颜色代码格式为
u0003[前景],[背景]，要去掉颜色时使用
u0003。
颜色代码参考：
0：白色1：黑色2：蓝色3：绿色4：红色5：棕色6：紫色7：橙色8：黄色9：浅绿色对于失败的构建，我们通常希望看到具体的错误信息。以下示例展示了如何包含日志片段：
pipeline {
agent any
stages {
stage('Build') {
steps {
sh 'mvn clean compile'
}
}
}
post {
failure {
script {
// 获取最后10行构建日志
def log = currentBuild.rawBuild.getLog(10).join('
')
ircNotify targets: "#jenkins-notifications",
customMessage: "❌ BUILD FAILED - ${env.JOB_NAME} #${env.BUILD_NUMBER}
最后日志:
${log}
完整日志: ${env.BUILD_URL}console"
}
}
}
}在关键构建失败时，我们可能希望@提及特定团队成员。不同的IRC网络有不同的提及方式，常见的是使用昵称：
pipeline {
agent any
stages {
stage('Deploy to Production') {
steps {
sh './deploy-to-prod.sh'
}
}
}
post {
failure {
ircNotify targets: "#jenkins-notifications",
customMessage: "🚨 生产环境部署失败！@senior-dev @ops-leader 请立即检查！项目: ${env.JOB_NAME}，构建: #${env.BUILD_NUMBER}，详情: ${env.BUILD_URL}"
}
}
}IRC通知虽然即时，但有时可能需要与其它通知方式结合使用。例如，对于关键任务的失败，除了IRC通知外，还可以发送邮件：
pipeline {
agent any
stages {
stage('Critical Deployment') {
steps {
echo 'Deploying...'
}
}
}
post {
failure {
ircNotify targets: "#jenkins-notifications",
customMessage: "🚨 关键部署失败 - ${env.JOB_NAME}"
emailext to: 'team@example.com',
subject: "紧急：${env.JOB_NAME} 部署失败",
body: "关键部署失败，需要立即处理！
项目：${env.JOB_NAME}
构建：${env.BUILD_NUMBER}
链接：${env.BUILD_URL}"
}
}
}看看大型项目是如何使用IRC通知的，可以给我们提供很多启发。Debian项目的可重复构建系统就是一个很好的例子。
Debian的Jenkins系统会在节点出现问题时发送IRC通知。以下是一个真实示例的简化版本：
#!/bin/bash
# reproducible_maintenance.sh 的简化示例
if [ "$HOSTNAME" = "$MAINNODE" ]; then
MESSAGE="$SICK has health problems and has temporarily been marked as offline."
MESSAGE="$MESSAGE To make this permanent, edit jenkins-home/offline_nodes in git."
# 根据节点类型决定收件人
RECIPIENTS="mattia@debian.org holger@debian.org"
if $(echo -e "$MESSAGE" | grep -q arm64 2>/dev/null); then
RECIPIENTS="$RECIPIENTS vagrant@reproducible-builds.org"
fi
# 发送IRC通知
irc_message reproducible-builds "$MESSAGE"
fi这个脚本会在构建节点出现健康问题时发送IRC通知，并且当涉及arm64架构时，还会额外通知特定的团队成员。
Debian项目还会在用户请求构建产物时发送特定的IRC通知：
#!/bin/bash
# reproducible_build.sh 的简化示例
notification() {
if [ -n "$NOTIFY" ]; then
local MESSAGE="artifacts for ${SRCPACKAGE}, $STATUS in ${SUITE}/${ARCH}: $REPRODUCIBLE_URL/artifacts/"
if [ "$NOTIFY" = "diffoscope_err" ]; then
irc_message debian-reproducible-changes "$DEBIAN_URL/$SUITE/$ARCH/$SRCPACKAGE $STATUS and $DIFFOSCOPE failed"
irc_message debian-reproducible-changes "$MESSAGE (error running $DIFFOSCOPE)"
else
# 用户明确请求产物时提供产物信息
irc_message debian-reproducible "user requested $MESSAGE"
fi
fi
}这个例子显示，Debian项目根据不同的通知类型（普通通知或diffoscope错误）发送不同详细程度的IRC消息。
即使是经验丰富的Jenkins用户，在配置IRC通知时也可能会遇到一些问题。以下是一些常见问题及其解决方案。
问题：在Jenkins中配置了IRC通知，但bot没有出现在频道中。
解决：
检查IRC服务器地址和端口是否正确确认网络连接没有受到防火墙阻挡验证频道名称是否正确（通常以#开头）检查是否需要频道密码查看Jenkins系统日志，寻找错误信息问题：Pipeline执行没有报错，但没有收到IRC通知。
解决：
确认IRC插件已正确安装并启用检查targets参数中的频道名称是否正确确认Jenkins-bot仍然在IRC频道中（有时网络波动会导致bot掉线）尝试在同一个频道中手动发送消息，确认有发送权限问题：消息中的特殊字符（如中文、表情符号）显示异常。
解决：
确保Jenkins系统编码设置为UTF-8避免在消息中使用过多复杂表情符号测试IRC客户端对Unicode字符的支持情况根据实际使用经验，以下是一些最佳实践建议：
保持消息简洁：IRC是即时通讯工具，过长的消息会影响阅读体验使用明确的构建状态标识：如表情符号✅❌⚠️，让接收者快速理解状态包含直接访问链接：确保消息中包含构建详情页面的链接合理使用颜色：颜色可以突出重点，但过度使用会降低可读性设置合理的通知级别：不是每个构建状态都需要@提及团队成员，避免“狼来了”效应定期检查IRC连接：可以将IRC连接状态添加到监控中虽然IRC有很多优点，但并不是所有团队都适合使用它。如果你的团队已经使用了其它通讯工具，也不必担心，Jenkins提供了丰富的通知选项。
如果你和团队在使用Slack，可以安装Slack Notification插件：
post {
failure {
slackSend channel: '#jenkins-alerts',
color: 'danger',
message: "Build Failed: ${env.JOB_NAME} #${env.BUILD_NUMBER}"
}
}对于国内团队，钉钉可能是更常见的选择。虽然没有专门的插件，但可以通过Web API实现：
post {
failure {
sh """
curl 'https://oapi.dingtalk.com/robot/send?access_token=YOUR_TOKEN'
-H 'Content-Type: application/json'
-d '{
"msgtype": "text",
"text": {
"content": "Jenkins构建失败: ${env.JOB_NAME} - Build #${env.BUILD_NUMBER}"
}
}'
"""
}
}类似地，也可以通过Web API发送通知到企业微信：
post {
failure {
sh """
curl 'https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=YOUR_KEY'
-H 'Content-Type: application/json'
-d '{
"msgtype": "text",
"text": {
"content": "Jenkins构建失败: ${env.JOB_NAME} - Build #${env.BUILD_NUMBER}"
}
}'
"""
}
}为了帮助你更好地理解如何在实际项目中使用IRC通知，这里提供了一个完整的Pipeline示例，它结合了我们讨论过的多种技巧：
pipeline {
agent any
options {
timeout(time: 30, unit: 'MINUTES')
}
stages {
stage('Checkout') {
steps {
checkout scm
}
}
stage('Build') {
steps {
sh 'mvn clean compile'
}
}
stage('Unit Test') {
steps {
sh 'mvn test'
}
post {
always {
junit 'target/surefire-reports/*.xml'
}
}
}
stage('Integration Test') {
steps {
sh 'mvn verify -DskipUnitTests'
}
}
stage('Deploy to Staging') {
steps {
sh 'mvn package -DskipTests'
sh './deploy-to-staging.sh'
}
}
}
post {
always {
// 基础IRC通知
ircNotify targets: "#ci-notifications",
customMessage: "构建完成 - ${env.JOB_NAME} #${env.BUILD_NUMBER} - 状态: ${currentBuild.result ?: 'SUCCESS'}"
}
success {
// 成功时的详细通知
ircNotify targets: "#ci-notifications",
customMessage: "✅ ${env.JOB_NAME} 构建成功! #${env.BUILD_NUMBER} - 详情: ${env.BUILD_URL}"
}
failure {
script {
// 获取关键错误日志
def errorLog = currentBuild.rawBuild.getLog(100).findAll {
it.contains('ERROR') || it.contains('FAIL')
}.take(3).join('
')
// 失败时的紧急通知
ircNotify targets: "#ci-notifications",
customMessage: "❌ ${env.JOB_NAME} 构建失败! #${env.BUILD_NUMBER}
关键错误:
${errorLog}
请立即检查: ${env.BUILD_URL}"
// 同时发送邮件给团队
emailext to: 'dev-team@example.com',
subject: "构建失败: ${env.JOB_NAME} #${env.BUILD_NUMBER}",
body: """
<h2>构建失败，需要立即处理！</h2>
<p>项目：${env.JOB_NAME}</p>
<p>构建编号：${env.BUILD_NUMBER}</p>
<p>关键错误：</p>
<pre>${errorLog}</pre>
<p>请及时检查：<a href="${env.BUILD_URL}">${env.BUILD_URL}</a></p>
""",
attachLog: true
}
}
unstable {
ircNotify targets: "#ci-notifications",
customMessage: "⚠️ ${env.JOB_NAME} 构建不稳定! #${env.BUILD_NUMBER} - 测试失败，请检查: ${env.BUILD_URL}testReport"
}
aborted {
ircNotify targets: "#ci-notifications",
customMessage: "🚫 ${env.JOB_NAME} 构建被中止! #${env.BUILD_NUMBER} - 可能被手动中断"
}
}
}这个示例展示了如何在不同的构建阶段和结果状态下发送不同级别的IRC通知，既保证了信息的及时性，又避免了过度通知造成的干扰。
IRC可能是一个“老派”的工具，但在Jenkins通知领域，它依然发挥着不可替代的作用。它的轻量、稳定和高效，使其成为开发团队及时获取构建状态的优秀选择。
通过本文的介绍，希望你不仅学会了如何在Jenkins中配置IRC通知，还了解了如何让它更好地服务于你的项目。记住，一个好的通知系统应该像忠实的守夜人——在需要时发出警报，在平静时保持安静。
现在就去配置你的Jenkins IRC通知吧，让构建失败不再“藏猫猫”，让你的团队能够及时响应问题，提高开发效率！
参考资源：
Jenkins IRC Plugin DocumentationDebian项目Jenkins配置实例IRC彩色消息格式
送码官方微信
手机访问领取大礼包