如何用建木CI构建/发布建木Hub节点定义版本
事情是这样的，作为一名热爱工作的程序员，定期检查系统服务是我的日常，并且还要将检查结果发送邮件给同事。这事情虽然简单，但是确实有点繁琐，真是脑壳痛
刚好最近正在使用建木CI，里面的任务都是通过一个一个节点来执行的，突然想到🤔，我把检查任务和发送邮件的任务写成两个节点，再加个Trigger定时执行不就行了吗！然后不就可以心安理得的摸个鱼了吗😀
找到了自定义节点的文档：
以发送邮件的节点为例，接下来开始自定义节点！
1.创建节点
点击创建，节点就创建成功了。但是节点是通过版本来管理的，我们还需要添加节点的版本
2.完成节点代码
看了一下，目前的节点，都是通过Docker容器运行的，因此我们也要定义docker运行的环境和脚本文件
脚本文件
脚本文件是节点任务执行时运行的代码，下图为send_email.py文件示例：
Dockerfile
描述自定义镜像信息的文件
DSL
DSL是用来描述节点版本的，包括节点ref、节点版本号、输入输出参数、镜像等信息，文件格式为yml，具体参数信息可以查看官方文档
3.添加节点版本
接下来就到了文章的主题了，添加节点版本，有两种方式可以添加版本
3.1 通过建木Hub添加
在建木Hub，节点详情界面，点击新增版本，将仓库中定义的DSL复制进去，点击确定就可以了
如果是只发一次版本的话，该方法比较简单，粘贴复制就完了
注：在添加版本之前，需要将镜像发布到Dockerhub，否则节点任务执行时会找不到镜像
3.2 通过建木CI添加
hub_publish节点需要输入参数hub_api_ak、hub_api_sk，获取步骤：
手动触发
建木CI可以先通过git_clone节点拉取节点仓库，再通过hub_publish节点发布版本，节点文档已经详细描述了每个参数的作用，这里就不多做解释了
保存好项目DSL后，手动点击触发，待运行完毕后就发布成功了
项目DSL如下：
name: 发布send_email节点
pipeline:
git_clone:
type: git_clone:1.2.0
param:
remote_url: https://gitee.com/WannerBai/send-email.git
# 发布镜像
image_build:
type: docker_image_build:1.0.1
param:
workspace: ${git_clone.git_path}
docker_username: ((dockerhub.username))
docker_password: ((dockerhub.password))
docker_file: dockerfile/Dockerfile
image_name: wannerbai/send_email
image_tag: 1.0.0
docker_build_path: .
# 发布版本
hub_publish:
type: hub_publish:1.1.0
param:
hub_url: https://hub.jianmu.dev
dsl_file_path: ${git_clone.git_path}/dsl/send_email.yml
hub_api_ak: ((jianmuhub.ak))
hub_api_sk: ((jianmuhub.sk))
version: 1.0.0
image: ((dockerhub.username))/send-email:1.0.0webhook触发
如果需要对节点版本进行管理的话，建议使用该方式发布版本，可以新建标签发布节点新版本，也可以通过标签查看之前的版本
步骤如下：
1.在gitee仓库添加webhook，URL为项目保存后，建木CI自动生成的webhook地址，事件为Tag push，密码可以选择设置
查看webhook URL：
在gitee仓库添加webhook：
2.在gitee仓库中，创建新标签，该事件会触发建木CI中的发布send_email节点，然后自动发布版本
项目DSL如下：
name: 发布send_email节点
global:
param:
image_name: wannerbai/send_email
version: 1.0.0
trigger:
type: webhook
param:
- name: gitee_token
type: SECRET
exp: $.header.X-Gitee-Token
- name: gitee_event
type: STRING
exp: $.header.X-Gitee-Event
- name: gitee_tag_created
type: BOOL
exp: $.body.json.created
- name: gitee_ref
type: STRING
exp: $.body.json.ref
# auth校验，value和token相同时才会触发项目
auth:
token: ${trigger.gitee_token}
value: ((gitee.webhook_runner_token))
only: (${trigger.gitee_event} === "Tag Push Hook" && ${trigger.gitee_tag_created})
pipeline:
git_clone:
type: git_clone:1.2.0
param:
remote_url: https://gitee.com/WannerBai/send-email.git
ref: ${trigger.gitee_ref}
# 发布镜像
image_build:
type: docker_image_build:1.0.1
param:
workspace: ${git_clone.git_path}
docker_username: ((dockerhub.username))
docker_password: ((dockerhub.password))
docker_file: dockerfile/Dockerfile
image_name: ${global.image_name}
# 镜像版本为gitee标签
image_tag: ${git_clone.git_tag}
docker_build_path: .
# 发布版本到建木Hub
hub_publish:
type: hub_publish:1.1.0
param:
hub_url: https://hub.jianmu.dev
dsl_file_path: ${git_clone.git_path}/dsl/send_email.yml
hub_api_ak: ((jianmuhub.ak))
hub_api_sk: ((jianmuhub.sk))
image: ${global.image_name}:${git_clone.git_tag}
# 节点版本为gitee标签
version: ${git_clone.git_tag}
至此，节点版本就发布成功了，以后发布新的版本，只需要新建新的标签就可以了，太方便了！
接下来就可以在建木CI中使用自定义的节点了，漂亮！
本文为建木博主「早春的树」的原创投稿文章，转载请联系授权。