钉钉集成

  • 引入于极狐GitLab 15.1,功能标志为 dingtalk_integration。默认禁用。
  • 功能标志 dingtalk_integration 移除于极狐GitLab 15.5。

当您想从钉钉上控制或查看极狐GitLab 内容时,您可以在钉钉中使用命令实现。首先您需要分别配置钉钉与极狐GitLab,完成集成。

配置钉钉

  • 在钉钉中创建企业机器人
  • 在钉钉群组中添加机器人

在钉钉中创建企业机器人:

  1. 访问 https://open.dingtalk.com,进入 钉钉开放平台 页面,选择右上角 开发者后台
  2. 扫描二维码,登录进入您的组织。
  3. 在顶部栏上,选择 应用开发 > 企业内部开发
  4. 在左侧边栏上,选择 机器人。在右侧页面中选择右上角的 创建应用
  5. 在弹出的窗口中填写应用名称、应用描述和应用图标,选择 确定创建。您可以记录跳转页面中显示的 AppKeyAppSecret,以便后续使用。
  6. 在左侧边栏上,选择 开发管理,在右侧页面中填写 服务器出口IP消息接收地址,其中 服务器出口IP 是您的极狐Gitlab 站点公网 IP,消息接收地址 需要以您的极狐Gitlab 站点网址或者 IP 作为前缀,后面补充 “/api/v4/integrations/dingtalk/robot”,比如 http://my-jihulab.com/api/v4/integrations/dingtalk/robot。
  7. 在左侧边栏上,选择 权限管理。在右侧页面中申请 企业内机器人发送消息权限,确保您拥有该项权限。
  8. 在左侧边栏上,选择 版本管理与发布,在右侧页面中选择 上线

在钉钉群组中添加机器人:

  1. 打开一个钉钉群组,选择右上角 群设置 > 智能群助手
  2. 选择 添加机器人 后面的三个点将您创建的机器人添加进来。

配置极狐GitLab

  1. 启动极狐GitLab Rails 控制台,在控制台中运行 Feature.enable(:dingtalk_integration), 完成钉钉特性开关的启用。详情请参见功能标志文档(功能标志为 dingtalk_integration,15.5 及之后的版本跳过此步骤)。
  2. 以管理员身份登录极狐GitLab,在左侧边栏上选择 管理中心 > 设置 > 通用
  3. 选择 钉钉集成 右侧的 展开,勾选 启用钉钉集成 复选框,并填写 钉钉CorpId钉钉AppKey钉钉AppSecret,选择 保存更改
  4. 在左侧边栏上,选择 管理中心 > 设置 > 集成
  5. 选择 钉钉 > 设置,输入 钉钉CorpId,选择 保存更改

提示钉钉CorpId 是您的企业在钉钉的唯一 ID,可以在钉钉开放平台的首页中查询到;钉钉AppKey 是钉钉机器人的 AppKey; 钉钉AppSecret 是钉钉机器人的 AppSecret。

至此,您已经完成了钉钉和极狐GitLab 集成所需的所有配置工作。