企业微信github / gitlab机器人
使用效果
目前支持的事件
Push event 示例
如上,点击链接会直接跳转到项目。
Issue event 示例
Merge Request 示例
Merge Request 会有发起、合并、关闭、重新发起等几种情况,文案会有所不同。
如何使用
Code.oa
打开gitcode项目(gitlab项目通用),在Setting
中选择Advanced Setting
,选中Web Hooks
tab ,添加一个webhook。
url填写http://10.125.60.95:8080/git?id={你的机器人id}
请一定要记得填这个id,否则会发到我的机器人上!
可以在企业微信中查看你的机器人id
另外,这个IP是一个devnet机器,如果需要自建服务,参考本文后面的部分。
Github
如果是使用github,在github项目中的Setting
中选择Webhooks
,选择Add Webhooks
,填写url,如http://weworkrobot.xyz/github?id=7048958e-8b4b-4381-9758-af84347c240c
。
域名weworkrobot.xyz
指向我在腾讯云搭建的通用服务器。
/github
用来区分github和gitlab,这两者的处理方式不同。
id
参数代表自定义的机器人id
如何部署
建议将此服务部署在自己的机器上
最简单的方式
# 在服务器上
git clone https://github.com/LeoEatle/git-webhook-wework-robot.git
npm install
npm run build
pm2 start ./dist/server.js
使用pm2
使用pm2的方式比较简单,对于这种推送服务已经足够使用。
# 在本地编辑好配置文件
npm install -g pm2
pm2 deploy production setup
pm2 deploy production
使用docker
目前已经编译出了一份镜像文件为leoytliu/wework-robot
docker start leoytliu/wework-robot
当然,也可以使用pm2-docker来同时利用到pm2和docker。
机器人id配置
如果需要修改服务器端的默认机器人id设置,请修改项目根目录下的.env
PORT=8080
NODE_ENV=development
JWT_SECRET=your-secret-whatever
DATABASE_URL=postgres://user:pass@localhost:5432/apidb
CHAT_ID=82c08203-82a6-4824-8319-04a361bc0b2a # 改这里!
项目介绍 && 开发
此项目用于连接git webhook和企业微信机器人webhook,采用koa2 + typescript开发,大部分git webhook 和 企业微信机器人的数据结构已经定义好typing,如:
interface Repository {
name: string;
description: string;
homepage: string;
git_http_url: string;
git_ssh_url: string;
url: string;
visibility_level: number;
}
并且项目有配置严格的tslint和lint-staged等检查。
异步解决方案为async/await
github事件handler: github.ts
gitlab事件handler: gilab.ts
chatRobot推送信息相关: chat.ts
提交
git add .
npm run commit # 让commitlint自动生成commit信息
TODO
-
目前gitlab只做了
push
和merge request
事件的handler,以及只做了文字和mardown信息的推送,其余事件和其他类型的推送还需开发。 -
github推送目前只考虑
push
pr
issue
,其他有待添加 -
为了方便其他团队甚至外面开源的使用,考虑使用docker方便自己部署。 -
考虑是不是可以在配置webhook的地方直接配置机器人id,分别推送 -
进一步考虑是不是可以用GUI统一管理项目和机器人id的关系
-
考虑可以补全gitlab的typing,实在太多了,有人帮忙就好了,github已经使用了有人开源整理的typing依赖库