本文是2020年的文章,在公司当时的环境写的了,现在大部分公司都有Devops效能平台采用docker或者oss部署
前言
本篇是之前写的《利用 Gitlab CI/CD 实现自动构建,自动部署》的续篇。我们知道 Gitlab 的 Pipeline 中的 Job 执行成功或者失败之后,对应 Job 状态会改变为 passedorfailed,当 Job 的状态改变之后, 我们需要再到 Gitlab CI/CD 的页面下查看 Job 的状态,去看看有没有打包完成。
实践表明,某些时候我们的 gitlab 执行 Job 往往需要等待很长且不稳定。导致我们反复到 CI/CD 的页面看看 Job 是否执行完毕。所以我们需要一个更友好,高效的 Job 执行完成状态的反馈方案。由此我想到了钉钉通知机器人。
引入钉钉机器人
其实就是在一个钉钉群引入 webhook 机器人,然后给你提供 token 和 secret, 依照指定的格式发起 http 请求就可以了
详情请看:https://ding-doc.dingtalk.com/doc#/serverapi3/iydd5h
官方文档解析很清楚,需要注意点就是需要加签这个步骤:
/* 把timestamp+"\n"+密钥当做签名字符串,使用HmacSHA256算法计算签名,然后进行Base64 encode,\n
最后再把签名参数再进行urlEncode,得到最终的签名(需要使用UTF-8字符集)。
- 这里用node的crypto加密模块实现,大概实现如下
*/
const encryptSign = (secret, content) => {
const str = crypto
.createHmac("sha256", secret)
.update(content)
.digest()
.toString("base64");
return encodeURIComponent(str);
};
const sign = encryptSign(this.secret, timestamp + "\n" + this.secret);
定制钉钉机器人
钉钉机器人支持多种类型消息,我们需要的是一个文本和卡片类型消息,图片如下。
结合钉钉文档,我们封装了自己的机器人 dingtalkBot 类,支持快速发送文本和卡片消息。脚本如下:
/* eslint-disable @typescript-eslint/no-var-requires */
const crypto = require("crypto");
const axios = require("axios");
const encryptSign = (secret, content) => {
const str = crypto
.createHmac("sha256", secret)
.update(content)
.digest()
.toString("base64");
return encodeURIComponent(str);
};
/**
* 钉钉机器人 WebHook:用于支持钉钉机器人消息发送
*
* 官方文档:https://ding-doc.dingtalk.com/doc#/serverapi2/qf2nxq
*/
class DingtalkBot {
/**
* 机器人工厂,所有的消息推送项目都会调用 this.webhook 接口进行发送
*
* @param {String} options.webhook 完整的接口地址
* @param {String} options.baseUrl 接口地址
* @param {String} options.accessToken accessToken
* @param {String} options.secret secret
*/
constructor(options) {
options = options || {};
if (!options.webhook && !(options.accessToken && options.baseUrl)) {
throw new Error("Lack for arguments!");
}
// 优先使用 options.webhook
// 次之将由 options.baseUrl 和 options.accessToken 组合成一个 webhook 地址
this.webhook =
options.webhook ||
`${options.baseUrl}?access_token=${options.accessToken}`;
this.secret = options.secret;
}
/**
* 发送钉钉消息
*
* @param {Object} content 发动的消息对象
* @return {Promise}
*/
send(content) {
let singStr = "";
if (this.secret) {
const timestamp = Date.now();
singStr =
"×tamp=" +
timestamp +
"&sign=" +
encryptSign(this.secret, timestamp + "\n" + this.secret);
}
return axios.request(this.webhook + singStr, {
method: "POST",
headers: {
"Content-Type": "application/json",
},
data: JSON.stringify(content),
});
}
/**
* 发送纯文本消息,支持@群内成员
*
* @param {String} content 消息内容
* @param {Object} at 群内@成员的手机号
* @return {Promise}
*/
text(content, at) {
at = at || {};
return this.send({
msgtype: "text",
text: {
content,
},
at,
});
}
/**
* 发送actionCard(动作卡片)
* Ps: 支持多个按钮,支持Markdown
*
* @param {String} card.title 标题
* @param {String} card.text 消息内容
* @param {String} card.btnOrientation 按钮排列的方向(0竖直,1横向,默认为0)
* @param {String} card.btn.title 某个按钮标题
* @param {String} card.btn.actionURL 某个按钮链接
* @return {Promise}
*/
actionCard(card) {
return this.send({
msgtype: "actionCard",
actionCard: {
title: card.title,
text: card.text,
btnOrientation: card.btnOrientation || 0,
btns: card.btns || [],
},
});
}
}
module.exports = DingtalkBot;
定制消息模板
上面的消息类型我们知道,我们需要一些构建信息(项目,分支,环境等),还有需要@指定的提交人。经过折腾,我们知道 gitlab runner 执行 node 脚本时, process.env 这个变量下包含着我们需要的所有变量,如图所示
上面的截图只是一部分
由此我们定义如下的 markdown 格式模板
除了卡片消息之外。我们需要@通知指定提交人。依据钉钉提供的 API, 我们需要提交人的电话号码信息。那我们暴露提交人的电话号码信息在 node 执行 js 的时候呢。同样经过折腾,我们可以为项目设置环境变量,gitlab runner 执行 Job 时,就会暴露在其中执行环境中,详情看:https://docs.gitlab.com/help/ci/variables/README#variables
例如:
这里设置了 luxuemin 的变量名,变量值为我的号码:xxxxx。
注意:这里存在映射关系, 变量名为 luxuemin, 是我的 gitlab 平台上的用户名,应该也是 git 的用户名,如图
配置好映射关系,我们就能@指定的提交人了。
const gitlabUserName = process.env.GITLAB_USER_NAME;
const phoneNumber = process.env[gitlabUserName]; // 在gitlab CI/CD上配置GITLAB_USER_NAME映射的电话号码
await robot.text("请查收你的构建信息", {
atMobiles: [phoneNumber],
isAtAll: false,
});
发送消息脚本文件notify.js
上面的脚本文件还加了一个 Github Today Trending 的小彩蛋(随机推荐一个 github 的今日流行趋势项目),和随机一张养眼图片。
如图:
在之前的脚本中使用
根据模拟 jenkins 请求的结果,node 执行上面的脚本之前,携带成功,失败状态,这里用 status 表示, 同时推出 js 脚本是,用 process.exit(status)退出,可参考下面脚本
RES=$( curl -X POST \
--user tao-tao:1169ee9c0493b27d915632c0577fdd66fd \
--data 'json={"parameter":[{"name":"PJ","value":"crm-finance-static"},{"name":"MYENV", "value":"'$env'"},{"name":"TAG","value":"'$branch'"}]}' \
--compressed \
'http://xxxx/job/tao.tao/build?delay=0sec' \
)
# if [ "$RES" ]; then { echo 'failed!'; exit 1; } fi
if [ "$RES" ]; then
node scripts/notify.js $env $branch --status=1 || { echo 'failed!'; exit 1;}
else
node scripts/notify.js $env $branch --status=0 && { echo 'succused!'; exit 0;}
fi
最后
目前配置了 crm-finance 引入了这个机器人。后续需要的小伙伴可在自己的项目中引入,如果小伙伴想进入 Gitlab&Dingtalk 通知机器人测试群,可扫码加入哈。热烈欢迎!
!
原文地址:https://github.com/jackluson/learn-path-recording-and-coding/blob/master/docs/develop-flow/dingtalk-gitlab.md