> 本文首發於 **[Nebula Graph Community 公眾號](https://nebula-website-cn.oss-cn-hangzhou.aliyuncs.com/nebula-blog/WeChatOffical.png)**

![GitHub 自動合併 pr 的機器人——auto-merge-bot](https://www-cdn.nebula-graph.com.cn/nebula-blog/auto-merge-bot.jpg)

## 背景

作為一款開源的分散式圖資料庫產品，Nebula 所有的研發流程都在 GitHub 上運作。基於 GitHub 生態 Nebula 技術團隊有一套 pr 的自動化流程：每次 pr 提上來的時候， pull request bot 跑一遍測試，看看這個 pr merge 到主分支以後是否可以保證當前的一些功能還可以繼續正常執行。

這時候，問題出現了：每個 pr 上來一次都要跑一遍測試，這樣的操作既費時又對測試機造成不必要的消耗。於是，Nebula 研發團隊打算演變現有的 pr 合併機器人。

本文主要講述如何在原先的設定下，最佳化設計，從而節省測試資源。

## 設計思路

基於現有 bot 的實現思路，來開發一款新的 bot 最佳化 pr 合併。新的 bot 主要特點是，利用 github action 提供的 on schedule 功能，在每隔一段時間後可以自動執行所有 pull request 合併後的測試，這樣一來就不需要每個 pull request 都跑一次 CI，節省了時間和效能消耗。若測試失敗，則用隨機剔除的方案剔除其中某個 pull request 然後繼續執行測試，直到測試透過或者沒用可用的 pull request 為止。隨後將此次測試透過中的包含的 pull request merge 到主分支中，並且提供傳送此次 merge 資訊到釘釘群裡的功能。

假設使用者有一個新的 pull request 提上來，它的一生需要經歷：

![](https://www-cdn.nebula-graph.com.cn/nebula-blog/auto-merge-workflow.png)

1. pull request 被 reviewers approve
2. Repository maintainer 評論/merge，表明同意 merge
3. 完成 1，2 後， pull request 就會被 bot 識別為可 merge 的 pull request
4. bot 將所有標為可 merge 的 pull request 預載入到 runner 的本地基於 master 的分支中進行 ci 測試
5. 測試透過，pull request 被 merge 到主分支；測試失敗，bot 會隨機剔除現有包含的 pull request，再進行測試，直到測試透過或者沒有可用的分支為止。
6. （可選）bot 將本次 merge 的結果傳送到釘釘群中

需要注意：

* 使用 auto-merge-bot 時，repository 需要在 GitHub orgnization 中配置一個 team，這個 team 裡的部分 member 的 role 需被標識為 maintainer，對應上述步驟2。

![](https://www-cdn.nebula-graph.com.cn/nebula-blog/auto-merge-team.png)

![](https://www-cdn.nebula-graph.com.cn/nebula-blog/auto-merge-maintainer.png)

* maintainer 可以透過評論 / merge 表示同意 merge 該 pull request，也可以透過評論 / wait a minute 或者刪除評論取消 merge，但是目前如果 bot 已經在執行中，只能透過手動停止此次 bot 的 workflow 來取消 merge，在未來版本中會加入該功能。
* 關於釘釘群 NULL 傳送功能，需在釘釘群中配置機器人，詳見 [https://developers.dingtalk.com/document/robots/custom-robot-access](https://developers.dingtalk.com/document/robots/custom-robot-access) 和 [https://developers.dingtalk.com/document/robots/customize-robot-security-settings](https://developers.dingtalk.com/document/robots/customize-robot-security-settings)，目前僅支援加簽的安全設定方式。
* ci 測試的程式碼需要使用者在入參中傳入。
* Github Action 的 schedule 有延遲，並不會按照指定的時間如期執行，通常延遲 15 - 30 分鐘。

## 測試用例

```
 ...

on:
  schedule:
    - cron: '* */1 * * *'  --- 每小時跑一次
  workflow_dispatch:

...

- name: Run merge script
      uses: klay-ke/auto-merge-pr@master  --- 該地址以後可能會改
      id: merge-pr
      with:
        send-to-dingtalk-group: true
        dingtalk-access-token: ${{ secrets.DINGTALK_ACCESS_TOKEN }}
        dingtalk-secret: ${{ secrets.DINGTALK_SECRET }}
        maintainer-team-name: ${{ secrets.MAINTAINER_TEAM_NAME }}
        gh-token: ${{ secrets.GH_TOKEN }}
        ci-command: 'bash ./build.sh'
```

### 輸入

| 引數                   | 型別    | required                              | 預設值   | 描述                                                         |
| ---------------------- | ------- | ------------------------------------- | -------- | ------------------------------------------------------------ |
| send-to-dingtalk-group | boolean | 否                                    | false    | 若為 true，則表明需要傳送 merge 資訊到釘釘群中，同時 dingtalk-access-token 和 dingtalk-access-token 欄位需要提供 |
| dingtalk-access-token  | string  | 當 send-to-dingtalk-group 為 true     | 空字串 | 釘釘群機器人的 access token                                   |
| dingtalk-secret        | string  | 當 send-to-dingtalk-group 為 true     | 空字串 | 釘釘群機器人的 secret.                                        |
| maintainer-team-name   | string  | 是                                    | None     | maintainer team 的名字                                        |
| gh-token               | string  | 是                                    | None     | Github Token                                                 |
| ci-command             | string  | 否                                    | None     | ci 測試程式碼                                                   |

## 輸出

可透過 `${{ steps.{action設定的id - 對應用例中的merge-pr}.outputs.{引數名} }}` 在後續 step 中讀取輸出；

| 引數       | 型別    | 描述                        |
| ---------- | ------- | --------------------------- |
| merge-info | string  | 本次 merge 資訊               |
| error-log  | string  | 錯誤日誌                    |
| pass-log   | string  | 日誌資訊                    |
| merged     | boolean | 是否有 pull request 成功 merge |

以上。

-------

[Nebula 社群首屆徵文活動正式開啟啦 ](https://discuss.nebula-graph.com.cn/t/topic/8304 "Nebula 社群首屆徵文活動正式開啟啦 ")?  獎品豐厚，全場景覆蓋：擼碼機械鍵盤、手機無線充、健康小助手智慧手環，更有資料庫設計、知識圖譜實踐書籍等你來領，還有 Nebula 精緻周邊送不停?

歡迎對 Nebula 有興趣、喜鑽研的小夥伴來書寫自己和 Nebula 有趣的故事呀～ 
![](https://oscimg.oschina.net/oscnet/up-e4c07a9cc9d1d780641394076ec663b1d8f.jpg)

交流圖資料庫技術？加入 Nebula 交流群請先[填寫下你的 Nebula 名片](https://wj.qq.com/s2/8321168/8e2f/)，Nebula 小助手會拉你進群~~

GitHub 自動合併 pr 的機器人——auto-merge-bot

相關文章