近期openEuler社區(qū)了解到部分開發(fā)者存在不方便訪問Gitee網(wǎng)站的問題，為了方便這些開發(fā)者們，openEuler社區(qū)增加了提交Patch的方式，社區(qū)開發(fā)者可將Patch通過郵件列表轉(zhuǎn)PR提交。

本文就跟大家分享一下社區(qū)開發(fā)者可以如何申請這個(gè)功能？以及申請之后這個(gè)功能如何使用 ？

功能簡介

此功能以patchwork，git-pw以及getmail等開源工具為基礎(chǔ)進(jìn)行搭建，使用自定義腳本進(jìn)行業(yè)務(wù)處理。

通過此功能，不方便在Gitee頁面提交PR的社區(qū)開發(fā)者可將Patch通過郵件列表轉(zhuǎn)PR提交。無需安裝其他軟件，向社區(qū)申請即可使用。

如何申請

1.請?jiān)诨A(chǔ)設(shè)施倉庫下新建issue，表明需要納管到服務(wù)下的倉庫，分支以及郵件列表地址。

2.提交配置相關(guān)的PR，配置文件路徑

3.社區(qū)基礎(chǔ)設(shè)施團(tuán)隊(duì)將根據(jù)issue中提供的參數(shù)以及合入相關(guān)pr進(jìn)行服務(wù)配置，完成后會在issue上進(jìn)行回復(fù)并關(guān)閉issue，通知責(zé)任人功能已可用。

配置參考：

mapping:
  src-openeuler/kernel:                            # 組織/倉庫
    mailing-list: "kernel-build@openeuler.org"     # 郵件列表地址
    env:                                           # 服務(wù)所需環(huán)境變量
      host: "SRC_OPENEULER_KERNEL_HOST"            # 郵件host,建議格式為SRC_OPENEULER_REPO_HOST, REPO值根據(jù)倉庫名進(jìn)行修改
      pass: "SRC_OPENEULER_KERNEL_PASS"            # 郵件password,建議格式為SRC_OPENEULER_REPO_PASS, REPO值根據(jù)倉庫名進(jìn)行修改
    branches:                                      # 分支信息
      build-5.10-rc: 'build-5.10-rc'
      master: 'master'
      openEuler-20.03-LTS: 'openEuler-20.03-LTS'

如何使用

制作patch

開發(fā)者使用git format-patch命令進(jìn)行補(bǔ)丁制作，命令示例如下。

①單一補(bǔ)丁+封面

git format-patch -1 --subject-prefix="PATCH branch_name" --cover-letter

git format-patch -1 --subject-prefix="PATCH branch_name"

③多個(gè)補(bǔ)丁

git format-patch -n --subject-prefix="PATCH branch_name" --cover-letter

n表示要選取的commit數(shù)

2.發(fā)送patch郵件到郵件列表

開發(fā)者通過git send-email的方式發(fā)送郵件到郵件列表；

命令示例：

git send-email *.patch --to "" --cc "" --suppress-cc=all

注意?。?！

①創(chuàng)建的補(bǔ)丁如果含有封面，請將封面和補(bǔ)丁郵件一并進(jìn)行發(fā)送，如果不發(fā)送封面則無法創(chuàng)建pr ； ②發(fā)送補(bǔ)丁集請發(fā)送完整，不要出現(xiàn)遺漏；

3.patch轉(zhuǎn)化為pr

后臺服務(wù)每5分鐘會進(jìn)行一次輪詢，合并補(bǔ)丁到對應(yīng)分支， 提交pr并郵件通知補(bǔ)丁發(fā)送者，抄送郵件列表。開發(fā)者發(fā)送郵件后耐心等待即可。

審核編輯：劉清