飞书配置和使用 GitLab 助手 & GitHub 助手 All In One
飞书配置和使用 GitLab 助手 & GitHub 助手 All In One
飞书机器人 🤖️
获取 webhook token
@GitHub 助手 get_webhook
@GitLab 助手 get_webhook
飞书配置和使用 GitLab 助手 All In One
通过 GitLab 助手连接飞书与 GitLab 项目,在飞书中第一时间获取相关的开发动态,让跟踪管理、沟通交流更顺畅。
一、功能简介
- 关于 GitLab
GitLab 是一款基于 Git 搭建的软件开发平台,更多详情可参阅 GitLab 官方文档。 - 关于 GitLab 助手
GitLab 助手使你无需离开飞书,即可实现以下操作:
- 通过在群组中添加 GitLab 机器人,实时接收来自 GitLab 相关项目的更新消息,包括新评论通知、issue 动态以及 merge request 通知等
- 将你的 GitLab 帐号与 GitLab 助手绑定,即可在飞书移动端快速查看你的 pull request 与 issue 列表,还可进入详情页并进行评论
二、使用方法
- 在群组中配置 GitLab 助手机器人
1.1 在飞书桌面端中打开相关群组,添加 GitLab 助手 机器人进群(详细步骤可见如何在群组中使用机器人)。
1.2 在群内 @ 该机器人并发送指令 @GitLab助手 get_webhook ,以获取该群 webhook 地址。
机器人将向该群的群主私信发送 webhook 地址。如果此群已有 webhook 地址,则会发送已有的地址。如果你不是该群的群主,请联系群主获取地址。
注:你还可以向 GitLab 机器人发送以下指令
- @GitLab 助手 help在群组中或机器人单聊中发送此指令,可查看机器人提供的能力
- @GitLab 助手 reset_webhook [仅群主可操作] 重置群组的 webhook 地址,重置后的地址将以私信形式发送给群主
1.3 前往 GitLab ,进入相关项目,在侧边栏中选择 Settings > Webhooks。填写 webhook 地址 (URL) 并勾选相关触发事件 (Trigger)。
注:目前 Gitlab 助手仅支持推送新评论提醒 (Comments),issue动态 (Issues events),merge request动态 (Merge request events)的通知。
1.4 完成上述步骤后,测试配置是否成功。在 GitLab 触发任意你已勾选的事件,如在飞书的对应群组中收到了 GitLab 机器人推送的通知消息,则配置成功。
至此,你和项目成员们就可以在飞书群组中实时接收项目更新消息了!点击卡片上的 查看 按钮,即可在电脑上打开打开你的 GitLab 查看详情
备注:如果希望在手机上也能点击 查看 按钮浏览项目详情,请继续阅读下一章节,完成 GitLab 助手的移动端小程序配置。
2. 配置和使用移动端小程序
GitLab 助手还提供了移动端小程序的能力。将你的个人 GitLab 帐号与 GitLab 助手绑定,即可在飞书移动端内快速查看你的 pull request 与 issue 列表,还可进入详情页并直接添加评论。
2.1 前提
你的飞书团队管理员须在 GitLab 助手的管理后台配置企业内部 GitLab 地址。操作步骤如下:
-
团队管理员进入飞书管理后台 > 工作台 > 应用列表 > GitLab 助手 配置页,点击 打开管理后台
-
点击 编辑 进入编辑页面,进行系统地址配置。如果你使用的是 Gitlab 的 SaaS 版本,只需输入 https://gitlab.com即可;如果是私有化的部署, 则输入私有化部署的域名
如果想测试上述地址是否输入正确,可以在浏览器中输入此地址并加上后缀 /api/v4/projects(例如: https://gitlab.com/api/v4/projects),确认页面可正确打开
2.2 使用移动端小程序
管理员完成上述配置后,你可通过以下步骤登录并使用 GitLab 移动端小程序。
2.2.1 获取 GitLab access token
-
前往企业内使用的 GitLab 主页,点击 Settings 按钮
-
进入 Access Tokens 板块,给你的 token 命名,按需勾选 webhook 的 Scopes ,然后点击 Create personal access token 完成创建
-
在 Your New Personal Access Token 中,复制新生成的 access token
2.2.2 回到飞书中,将你的 GitLab 帐号与 GitLab 助手绑定
- 方法 1: 进入与 GitLab 机器人的单聊会话,发送以下指令进行绑定:
@GitLab助手 set_access_token {username} {access_token}
注:{username} 为你的 GitLab 帐号的 Email 前缀;{access_token} 即前一步中在 GitLab 获取的 access token - 方法 2: 在飞书移动端中搜索并打开 GitLab 助手 小程序,将你的 access token 粘贴到登录页的相应位置,点击 绑定
2.2.3 至此,你就可以在飞书移动端上查看 GitLab 更新消息的详情了
当你在相关的群聊中收到 GitLab 助手推送的项目的消息卡片时,点击 查看 按钮,即可进入 GitLab 助手的小程序查看 pull request 或 issue 详情,还可进行简单的评论。
2.2.4 你还可在 GitLab 助手小程序中,查看所有你关心的项目的 pull request 和 issues 列表
在 GitLab 助手的看板中,Pull Request 和 Issues 标签页分别展示你所关注的项目的 pull request 和 issues 列表,点击某一项即可查看详情、并发送评论。
要使某一项目出现在小程序的首页列表中,先在相关群聊中找到与该项目相关的任一通知卡片,点击 查看 在移动端小程序打开详情页。此后,你就可在小程序中查看该项目下最新的 pull request 和 issue 列表了。
在底部导航栏中点击 个人,进入个人设置页查看个人信息或随时退出个人账号登录。
refs
©xgqfrms 2012-2021
www.cnblogs.com/xgqfrms 发布文章使用:只允许注册用户才可以访问!
原创文章,版权所有©️xgqfrms, 禁止转载 🈲️,侵权必究⚠️!
本文首发于博客园,作者:xgqfrms,原文链接:https://www.cnblogs.com/xgqfrms/p/15873925.html
未经授权禁止转载,违者必究!