iT邦幫忙

第 11 屆 iT 邦幫忙鐵人賽

DAY 29
0
Software Development

用30天介紹 open source 專案 Ohara 系列 第 29

Day 29 關於 Ohara Release 的步驟

前幾天已經介紹了有關於 Ohara 測試程式的撰寫、QA 是如何執行以及開 Pull Request 的部份,有了這些流程會使大型系統的開發更加的方便和讓系統可以更加的穩定,今天就來介紹有關於 Ohara Release 的部份。

Ohara 在每一個 Milestone 開始時會先規劃這次主要要做的功能或是要修哪些 Bug,然後在 Milestone 結束時就會 release 出一個版本,每一個 Milestone 大約是一個月的時間,每一次的 Release 都會選出一個 Release Manager 來做 Release 的工作,今天就來介紹 Ohara 在 Release 所要做哪些的工作。

以下就來介紹 Ohara Release 時要做哪些事情:

  1. 在 github 上建立一個 issue,標題的格式為 Ohara ${VERSION} Release,以 0.8 為例 issue 的標題如下:
    Ohara 0.8 Release,describe 需要寫的內容可以參考以下的連結:
    https://github.com/oharastream/ohara/issues/2278

  2. 確保所有的程式碼都有更新並且建立要 release 的 branch,以 0.8 為例, 指令如下:

$ git fetch origin master && git merge master 
$ git branch -b 0.8.x 
$ git push -u origin 0.8.x 
  1. 開 PR 更新 master 所有程式和文件的版本號,例如這次要 release 的版本號為 0.8 所以要把 master 程式和文件的版本號改成 0.9.0-SNAPSHOT,可以參考以下的 PR:
    https://github.com/oharastream/ohara/pull/2866

  2. 聯絡 QA 的管理員要求開放可以跑 0.9.0-SNAPSHOT QA branch 的權限

  3. 建立 ohara 產品測試的議題,選擇 new issue 的按鈕之後,選擇 Product testing report 的部份,按 Get started 的按鈕。畫面如下:
    https://ithelp.ithome.com.tw/upload/images/20191014/201034565rdYwqdpEb.png

這個步驟主要是在 release 之前再一次做手動測試的部份

  1. 把第 2 點建立的 branch, 如 0.8.x branch 程式碼和文件有 0.8.0-SNAPSHOT 的部份修改成 0.8.0 並且開 PR

  2. 在 github 的 release 畫面先建立草稿 (draf), 畫面如下:
    https://ithelp.ithome.com.tw/upload/images/20191014/20103456JdzFpsIPpD.png

按下 Draf a new release 的按鈕之後,就會看到如下的畫面:
https://ithelp.ithome.com.tw/upload/images/20191014/20103456v8PHcx6m1x.png

主要會輸入 Release 的標題、 Release 了哪些的功能,然後按下 Save draf

  1. Build Ohara 的 jar 檔並且上傳到 Bintray repo, 指令如下:
$ gradle clean build -PskipManager -x test bintrayUpload -PbintrayUser=$user -PbintrayKey=$APIKey -PdryRun=false -Poverride=true 

在這裡有可能需要連絡管理員給上傳 jar 檔的權限

  1. 建立要 release branch 版本的 tag, 指令如下:
$ git checkout 0.8.x 
$ git tag -a 0.8.0 -m "Release 0.8.0" 
$ git push upstream --tags 
  1. 使用 gradle 指令,把要 release 的程式碼 build 成 jar 檔,並且上傳到 github release 的畫面上:
$ gradle clean build -x test -PskipManager 

build 出來的檔案,會放在 $OHARA_HOME/ohara-assembly/build/distributions/ ,主要上傳 ohara-${version}.tar 和 oahra-${version}.zip 二個檔案。

  1. 到 github 的 release 畫面上, 按下 "Publish release" 按鈕,release 完成

當一個版本 release 出去之後就代表一個 Milestone 結束了。


上一篇
Day 28 關於 Ohara 開 PR (Pull Request) 的流程
下一篇
Day 30 開發 Ohara 心得分享
系列文
用30天介紹 open source 專案 Ohara 30

1 則留言

0
konekoya
iT邦新手 5 級 ‧ 2019-10-15 09:05:14

只剩最後一天了,傑克大大加油!

謝謝

konekoya 大大偏心沒幫我加油 XDDDD

是是是是

我要留言

立即登入留言