极狐GitLab和企业微信的集成实战

企业微信是国内企业使用较多的即时通信工具，极狐GitLab 自16.2 就和企业微信做了集成，极狐GitLab 相关的变更都可以直接发送到对应的企业微信群，然后开发人员去处理。仅需两步即可完成极狐GitLab 和企业微信的集成。

前提

由于该功能使用 Feature Flag wecom_integration控制，当前还是默认禁用的。所以首先要开启此功能。使用如下命令打开控制台：

gitlab-rails console
--------------------------------------------------------------------------------
 Ruby:         ruby 3.1.4p223 (2023-03-30 revision 957bb7cb81) [x86_64-linux]
 GitLab:       16.9.1-jh (6197bd7e29f) EE
 GitLab Shell: 14.33.0
 PostgreSQL:   14.10
------------------------------------------------------------[ booted in 26.18s ]
Loading production environment (Rails 7.0.8)

先查一下这个功能开关是否是开启的：

Feature.enabled?(:wecom_integration)
=> false

false 说明这个功能是禁止的。使用下面的命令开启此功能：

Feature.enable(:wecom_integration)
WARNING: Understand the stability and security risks of enabling in-development features with feature flags.
See https://docs.gitlab.com/ee/administration/feature_flags.html#risks-when-enabling-features-still-in-development for more information.
=> true

再次确认一下：

 Feature.enabled?(:wecom_integration)
=> true

可以看到功能已经开启，这时候可以在管理中心 --> 设置 --> 集成中看到企业微信的集成选项了：

上图演示的是已经激活了集成操作，如果未激活的话“企业微信通知”的选项会在集成列表的下面找到。

下面就可以执行集成操作了。

在企业微信群中添加机器人

这一步需要在企业微信群中添加机器人来获得 webhook key，此 key 是后面从极狐GitLab 侧发送消息到企业微信群的关键。

选择一个需要发送消息的企业微信群，点击右上角的三个点并选择添加群机器人：

然后选择新增机器人：

填写机器人的名称（自定义）：

添加完毕就会出现一个 webhook URL：

保存此 URL，会在后续的集成环节用到。key 的值就是后面要用到的 webhook key。一定保存好。

在极狐GitLab 中添加 webhook

在管理中心 --> 设置 --> 集成中找到企业微信集成的选项。然后填写页面信息即可：

选择想要触发消息通知的事件类型，然后在事件类型中填写上第一步中获取到的 wehook key。然后保存更改即可。这时候可以在某个仓库上做测试，比如推送一些代码变更，即可在企业微信群里看到推送的消息：

可以看到一些基本的信息，包括变更的仓库、变更的人员以及变更的 commit message。

以后只要是极狐GitLab 的项目仓库做了某些变更，这些变更和配置的触发事件匹配上了，就会将对应的变更事件信息发送到对应的企业微信群里。

极狐GitLab 是一个一体化的 DevOps 平台，包含敏捷项目管理、源代码托管、CI/CD 以及 DevSecOps 等功能。除了能够和企业微信进行集成，还能和钉钉集成，详细操作可以看过往的文章极狐GitLab和钉钉集成实战。

更多 DevOps 企业级实践或极狐GitLab 的具体功能使用，可以登录极狐GitLab 官网 在首页找到对应的二维码加入群聊，或搜索关注【极狐GitLab】公众号，公众号后台输入关键字“加群”，扫描出现的二维码加群即可。