企业微信Jenkins构建通知插件下载及安装教程

企业微信Jenkins构建通知插件下载及安装教程

1. 项目介绍

企业微信Jenkins构建通知插件是一个用于在Jenkins项目构建时，通过企业微信群机器人进行状态通知的插件。该插件适用于使用企业微信工作的小伙伴，能够在构建开始、成功或失败时，通过群机器人发送通知消息，方便团队成员及时了解构建状态。

2. 项目下载位置

要下载企业微信Jenkins构建通知插件，请访问GitHub上的项目仓库。项目仓库地址为：

https://github.com/jenkinsci/qy-wechat-notification-plugin.git

3. 项目安装环境配置

3.1 环境要求

• Jenkins 2.x 及以上版本
• 企业微信 2.8.7 及以上版本
• Java 8 及以上版本

3.2 配置示例

以下是配置示例的图片：

4. 项目安装方式

4.1 通过Jenkins插件管理器安装

1. 打开Jenkins管理界面，点击“系统管理”。
2. 在“系统管理”页面中，点击“插件管理”。
3. 在“插件管理”页面中，选择“可选插件”选项卡。
4. 在搜索框中输入“企业微信通知”，找到“企业微信Jenkins构建通知插件”。
5. 勾选该插件，点击“安装”按钮进行安装。

4.2 手动安装

1. 从GitHub仓库下载插件的.hpi文件。
2. 打开Jenkins管理界面，点击“系统管理”。
3. 在“系统管理”页面中，点击“插件管理”。
4. 在“插件管理”页面中，选择“高级”选项卡。
5. 在“上传插件”部分，点击“选择文件”按钮，选择下载的.hpi文件。
6. 点击“上传”按钮进行安装。

5. 项目处理脚本

5.1 Freestyle Job配置

在Jenkins项目底部的“构建后操作”中，添加“企业微信通知配置”，将Webhook地址信息输入Jenkins中，即可完成最简单配置。

5.2 Pipeline Job参考配置

pipeline {
    agent any
    stages {
        stage('Hello') {
            steps {
                echo 'Hello World'
            }
        }
    }
    post {
        success {
            qyWechatNotification(
                failNotify: true,
                mentionedId: '需要通知UserID',
                mentionedMobile: '需要通知的通知手机号码',
                webhookUrl: 'https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=xxx-xxxxxx-xxxxxx',
                moreInfo: '额外的信息'
            )
        }
        failure {
            qyWechatNotification(
                failNotify: true,
                mentionedId: '需要通知UserID',
                mentionedMobile: '需要通知的通知手机号码',
                webhookUrl: 'https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=xxx-xxxxxx-xxxxxx',
                moreInfo: '额外的信息'
            )
        }
    }
}

通过以上步骤，您可以成功下载并安装企业微信Jenkins构建通知插件，并配置相应的构建通知脚本。