通过阅读此文,你可了解如何在飞书上配置 GitLab 助手。
一、功能简介
GitLab 助手是飞书团队开发的实用工具。通过 GitLab 助手,你可以实现飞书与 GitLab 的结合,可以在飞书中第一时间获取所有开发动态,让跟踪管理、沟通交流更顺畅。
二、配置流程
1. 配置 GitLab 系统地址(应用管理员)
飞书租户管理员在管理后台页面启用 GitLab 助手,并在应用管理后台配置企业内部 GitLab 地址。
- •在管理后台进入应用 - 应用列表,找到 GitLab 助手
- •点击页面右侧的配置按钮后,点击打开管理后台链接。
- •点击编辑进入编辑页面进行系统地址配置。
2. 设置 webhook 关联项目与飞书群(项目管理员)
- •项目管理员将 GitLab 助手 Bot 加入群聊中
- •在群内@该机器人发送以下命令,获取 webhook 地址
@GitLab助手 get_webhook
- •群管理员会接收到 Bot 发送的 webhook 地址(仅群管理员会接收到群的 webhook 地址,请联系管理员获取)
- •进入 GitLab 项目设置页面,在 Integrations 页面配置 webhook 地址及相关 Trigger
3. 登录 GitLab 助手小程序(个人用户)
- •前往企业内使用的 GitLab 主页,点击 Settings 按钮
- •在设置页面,进入 Access Tokens 板块,勾选 webhook 的 Scope ,再点击 Create personal access token 创建
- •获取个人的 New Access Token
- •复制 token 在与 GitLab 机器人的会话中使用以下命令绑定
GitLab助手 set_access_token {username} {access_token}
- •username 为 GitLab Account 的 Email 前缀,如下图,username 为 lvfeng
- •或复制 Token 到小程序登录页绑定,从移动端应用中心进入 GitLab 助手小程序,并在登录页设置Access_Token
三、使用方法
Bot
用help命令获取 bot 命令帮助
@GitLab 助手 help
在群内或机器人会话页查看机器人提供的能力。
获取 webhook 地址(仅群管理员可操作)
@GitLab 助手 get_webhook
如果没有 webhook 地址则会创建新的地址,如果已有 webhook 地址则返回已有的地址。
更新 webhook 地址(仅群管理员可操作)
@GitLab 助手 reset_webhook
小程序
- •首次打开需要绑定个人 Token 进行登录,成功之后会自动登录
- •登录后可查看 Pull Request 和 Issues 列表信息
- •Pull Request 和 Issues 详情页可查看更详细信息,还可进行简单评论互动
- •个人设置页展示个人信息,可随时退出个人账号登录
消息卡片
设置 webhook 地址和将 Bot 关联到项目群后,将会发送相关通知卡片到关联的群中,卡片通知内容包含 merge request 通知、issue 新创建通知和评论通知。