当前位置：首页 > 资讯 >

Jenkins基础教程（121）Jenkins IRC 通知：Jenkins IRC通知：让机器人去频道里“插嘴”的完整指南

时间：2025-11-30 21:05 作者：来源：阅读：5
扫一扫，手机访问

摘要：还在为团队成员忽略Jenkins构建失败消息而烦恼？试试IRC通知，让提醒更直接、更醒目。在当今众多的即时通讯工具中，IRC可能看起来像个老古董，但它轻量、简单、高效的特点，使其在某些技术场景中仍有着不可替代的地位。对于使用Jenkins的团队，通过IRC接收构建通知，既能及时获取信息，又不会因过多的商业软件依赖而造成困扰。今天，我们就来深入探讨如何在Jenkins中配置IRC通知，让你的

还在为团队成员忽略Jenkins构建失败消息而烦恼？试试IRC通知，让提醒更直接、更醒目。

在当今众多的即时通讯工具中，IRC可能看起来像个老古董，但它轻量、简单、高效的特点，使其在某些技术场景中仍有着不可替代的地位。

对于使用Jenkins的团队，通过IRC接收构建通知，既能及时获取信息，又不会因过多的商业软件依赖而造成困扰。今天，我们就来深入探讨如何在Jenkins中配置IRC通知，让你的自动化流程更加完善。

1 IRC通知：为什么选择这个“老派”方式？

IRC作为早期网络即时通讯工具，虽然在大众领域已被Slack、Discord等取代，但在开发者和技术团队中仍保持一定使用率。对于Jenkins这样的自动化服务器，通知功能至关重要。

虽然搜索结果中提到了Slack、HipChat等替代方案，但IRC有其独特优势：有很多免费IRC服务器；通知不涉及敏感消息；通知是即时的；使用Linux办公时使用钉钉、企业微信多有不便。

在企业内，很少有使用IRC进行通讯的情况，或者说“根本没有吧”。但对于技术团队，特别是开源项目，IRC仍然是高效的沟通渠道。

2 准备工作：安装IRC插件

要在Jenkins中实现IRC通知，首先需要安装IRC插件。这可以通过Jenkins的插件管理界面完成。

2.1 安装步骤

在Jenkins左侧菜单中，点击"Manage Jenkins"（管理Jenkins），然后选择"Manage Plugins"（管理插件）。在"Available"（可用插件）选项卡中，搜索"IRC"，找到"IRC Notification"（IRC通知）插件并安装。

安装完成后，需要重启Jenkins服务以使插件生效。

2.2 配置IRC连接

插件安装完成后，需要进行全局配置：

进入"Manage Jenkins" → "Configure System"（系统配置）找到"IRC Notification"部分添加IRC服务器信息，包括主机名、端口、是否使用SSL等设置频道信息，包括频道名称、密码（如果有）

注意事项：修改配置后，jenkins-bot可能会暂时离线，需要一段时间才能重新进入频道。如果需要向频道发送消息，必须先进行这些设置，以便JenkinsBot能加入频道。

3 基础配置：让Jenkins连接IRC频道

在系统配置中，我们需要详细设置IRC连接参数。以下是一个典型的配置示例：

IRC服务器：可以选择常见的公共IRC服务器，如irc.freenode.net，或团队自建的IRC服务器端口：通常为6667（非SSL）或6697（SSL）昵称：默认为jenkins，但建议根据项目或团队进行自定义频道：以#开头，例如#jenkins-notifications

配置完成后，可以通过测试连接功能验证配置是否正确。如果一切正常，JenkinsBot应该会出现在指定的IRC频道中。

重要提示：在修改配置之后的一段时间内，jenkins-bot可能会显示为离线，需要等待一段时间才能重新进入频道。这是正常现象，耐心等待即可。

4 Pipeline集成：在流水线中发送IRC消息

配置好IRC插件后，我们就可以在Jenkins Pipeline中发送通知了。Jenkins Pipeline提供了声明式和脚本式两种写法，都支持IRC通知。

4.1 基础通知示例

以下是一个简单的声明式Pipeline示例，它在构建开始时发送IRC通知：



pipeline {
    agent any
    stages {
        stage('# 构建开始') {
            steps {
                ircNotify targets: "#k4nz", customMessage: "Hello from IRCBot
AAAAAAAAAAAAAAAAAAAAA"
            }
        }
    }
}

在这个示例中，当流水线执行到"构建开始"阶段时，会向#k4nz频道发送一条消息。

4.2 进阶：在构建的不同阶段发送通知

在实际项目中，我们通常希望在构建的不同阶段发送通知，例如构建开始、成功或失败时。以下是一个更完整的示例：



pipeline {
    agent any
    stages {
        stage('构建') {
            steps {
                ircNotify targets: "#k4nz", customMessage: "构建已开始：${env.JOB_NAME} #${env.BUILD_NUMBER}"
                // 这里是构建步骤
            }
        }
        stage('测试') {
            steps {
                // 这里是测试步骤
            }
        }
    }
    post {
        success {
            ircNotify targets: "#k4nz", customMessage: "✅ 构建成功：${env.JOB_NAME} #${env.BUILD_NUMBER}"
        }
        failure {
            ircNotify targets: "#k4nz", customMessage: "❌ 构建失败：${env.JOB_NAME} #${env.BUILD_NUMBER}"
        }
        unstable {
            ircNotify targets: "#k4nz", customMessage: "⚠️ 构建不稳定：${env.JOB_NAME} #${env.BUILD_NUMBER}"
        }
    }
}

在这个示例中，我们使用了Jenkins的post部分，它专门用于处理构建后的操作。根据构建的不同结果，我们会发送不同类型的通知。

5 高级技巧：让IRC通知更生动

IRC支持使用颜色和格式来增强消息的可读性。通过使用特殊字符，我们可以让Jenkins发送的消息更加醒目。

5.1 彩色消息发送

IRC使用特殊字符来控制文本颜色和格式。以下是一个发送彩色消息的示例：



pipeline {
    agent any
    stages {
        stage('# 构建开始') {
            steps {
                ircNotify targets: "#k4nz", 
                    customMessage: "u00030,3Hello from IRCBot
AAAAAAAAAAAAAAAAAAAAA"
            }
        }
    }
}

在这个示例中，u00030,3会使"Hello from IRCBot"显示为白色文字、红色背景。需要注意的是，IRC的消息以行为单位，所以格式控制符通常只影响当前行。

5.2 IRC颜色代码简介

IRC颜色代码以Ctrl+K（Unicode字符u0003）开头，后跟前景色和背景色代码（用逗号分隔）。常用的颜色代码包括：

0：白色1：黑色2：蓝色3：绿色4：红色5：棕色6：紫色7：橙色8：黄色9：浅绿色10：浅青色11：浅蓝色12：浅紫色13：浅灰色14：灰色15：浅灰色

例如，u00034会显示红色文字，u00034,8会显示红色文字配黄色背景。

6 实际应用场景与示例

IRC通知可以应用于各种场景，以下是一些实际应用示例：

6.1 基础构建通知

最基本的应用是发送构建状态通知：



pipeline {
    agent any
    stages {
        stage('Checkout') {
            steps {
                git 'https://github.com/example/repo.git'
            }
        }
        stage('Build') {
            steps {
                ircNotify targets: "#dev-team", customMessage: "开始构建项目：${env.JOB_NAME} #${env.BUILD_NUMBER}"
                sh 'mvn compile'
            }
        }
        stage('Test') {
            steps {
                sh 'mvn test'
            }
        }
    }
    post {
        always {
            ircNotify targets: "#dev-team", customMessage: "构建完成：${env.JOB_NAME} #${env.BUILD_NUMBER} - 状态：${currentBuild.result}"
        }
    }
}

6.2 结合质量门禁的通知

如果与代码质量工具（如SonarQube）结合，可以发送质量门禁状态：



pipeline {
    agent any
    stages {
        stage('Build & Test') {
            steps {
                sh 'mvn clean verify'
            }
        }
        stage('Quality Gate') {
            steps {
                sh 'mvn sonar:sonar'
                ircNotify targets: "#quality-team", customMessage: "质量检查完成：${env.JOB_NAME} - 详细信息：${env.SONAR_HOST_URL}/dashboard?id=${project.key}"
            }
        }
    }
}

6.3 系统状态通知

除了构建通知，IRC还可以用于发送系统状态信息。例如，当节点离线时发送通知：



# 这是一个Shell脚本示例，可用于检测节点状态并发送IRC通知
if [ "$NODE_STATUS" = "offline" ]; then
    MESSAGE="$SICK has health problems and has temporarily been marked as offline."
    # 这里可以添加发送IRC通知的逻辑
fi