飛書配置和使用 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 列表了。
在底部導航欄中點擊 個人,進入個人設置頁查看個人信息或隨時退出個人賬號登錄。
(🐞 反爬蟲測試!打擊盜版⚠️)如果你看到這個信息, 說明這是一篇剽竊的文章,請訪問
https://www.cnblogs.com/xgqfrms/ 查看原創文章!
refs
©xgqfrms 2012-2021
www.cnblogs.com/xgqfrms 發布文章使用:只允許注冊用戶才可以訪問!
原創文章,版權所有©️xgqfrms, 禁止轉載 🈲️,侵權必究⚠️!