Lark Notice

Appearance

快速开始 ​

环境准备 ​

开始之前，请确认运行环境满足以下要求：

名称版本
Jenkins2.541.3+

在线安装 ​

当前版本可能无法通过 Jenkins 更新中心直接获取。如果 Jenkins 更新中心地址（升级站点）不是 官方镜像源，通常无法检索到最新版本。

离线安装 ​

建议优先通过发布页下载插件包：

在 Jenkins 中安装插件的步骤如下：

  1. 打开 系统管理 -> 插件管理。
  2. 进入 Advanced 或 高级 页面。
  3. 在 Deploy Plugin 区域上传下载好的插件包，或填写插件地址。
  4. 提交安装并按提示完成 Jenkins 重启。

机器人配置 ​

全局配置 ​

打开 Manage Jenkins 页面后，通过 Lark Notice 管理入口进入插件配置页。

进入 Lark Notice 页面后，可配置默认通知时机、高级设置，并新增或维护可复用的机器人。

添加机器人 ​

添加机器人时，请先选择目标平台，再按提示填写 Token / Key，或切换到 自定义 模式填写完整 Webhook。

当前版本的机器人编辑器支持以下方式：

  • Lark / 飞书：默认输入机器人 Token，插件自动拼接官方 Webhook；如需私有域名或完整地址，请切换为 自定义。
  • 钉钉：默认输入 access_token，插件自动拼接官方 Webhook；如果已拿到完整 Webhook，也可以切换为 自定义。
  • 企业微信：默认输入群机器人 key，插件自动拼接官方 Webhook；如果需要完整地址，也可以切换为 自定义。

保存后建议先点击机器人卡片中的 发送测试，确认当前 Jenkins 网络、签名策略和代理设置均可正常访问目标平台。

更多配置项（代理、重试策略、消息语言、安全策略、配置导入导出等）请参考 高级配置。

Jenkins 重启 ​

插件安装或关键配置调整完成后，可通过以下地址执行 Jenkins 重启：

shell
# 重启服务
https://[jenkins-server-address][:port]/restart