這裡以 OFBiz r1096871 為例, 檔案有 {java:1436, xml:2626, groovy:454, properties:103, js:451, css:101, jar:391}, 它一直保持在更新的 狀態。
面對必要的客製化, 過去常用上游分支 (vender branch) 手法處理, 以固定目錄版本管理為主, 實務上要面對許多細節。現在流行的分散式版本管理, 加上 rebase 大大改善舊有的方式。但分支有版本相依的特性, 而 OFBiz 的版本存檔 (snapshot) 就有 215mb 之譜 ... 要保存和轉移都負擔。
利用補丁管理(Patch Management)是不錯的主意, Mercurial 的 MQ 到 1.8 已經相當成熟。唯一問題是 OFBiz 使用 Apache 官方版本管理 Subversion, 由於版本存檔太大導致 hg-svn 掛點, 不得不生出對策。
因此, 題目變成上游是 svn (原本用 git, 簡化問題還是用 svn 示範), 實際處理用 hg 加 mq。
以自己流通的 mq 版本存檔為例, 大小約 100kb 左右(zip), svn 與對應 hg 則依需要而建。在 hg 功能的協助下, 能快速跟隨 trunk 版本更新, 而 mq 存檔小也利於保存和繁殖。(OFBiz 的 mq 範例放在 bitbucket )
但是實際運作起來, 操作有些瑣碎, 對象也繁多 ... 還好有 Fabric 加持簡化成三種操作, 得以省略一堆指令。
三種操作
- 初始 (init)
拿到 mq 存檔, 加上 OFBiz Apache 上的 zip 檔 (附帶 .svn)。先把 OFBiz zip 檔解開有了 svn 儲存庫 (repository), 再更新與 mq 相同的 svn rev. 版本, 接著複製到 hg 儲存庫。
- 更新 (update)
因應上游 trunk 更新, 把 svn 儲存庫與上游同步, 再更新 hg 儲存庫, 最後把 mq 做 rebase 處理。需要留意 OFBiz 會更新 *jar, 是不在 svn diff 服務範圍, 得由外部 diff 助拳。而後, 視情況對 mq 進行提交 (mqcommit), 或上送(mqpush)。
- mq變更 (mqpull)
上游版本變更與驗證已完成, 並上送 bitbucket (第二個操作)。這時要對運作端進行更新, 先把新的 mq 取下, 依據新 mq 更新 svn 儲存庫, 同時更新對應 hg 儲存庫。
常見方式是: 只有開發與測試使用版本管理工具, 運作端用 rsync 之類工具同步, 符合標準 開發,
測試, 正式環境 分階段的開發週期。
用 svn-hg-mq 的好處是可從容面對應用系統會遇到的因地制宜 ... 如果不時在 正式環境 被要求改一點顯示文字或邏輯, 用此法就放手去改。然後以 mq commit 保存差異並列管, 之後再看看要怎麼處理, 同時也可放心進行上游版本更新(如果有的話)。
假使開發語言單一, 系統規模在一定範圍之內, 人力還是可以處理。而像 OFBiz 有 java, xml, groovy, ... 子系統多, 關連又盤根錯節, 就最好有固定的方式處理。
實際操作
在 OS X 10.6 + macports 與 Ubuntu 10.10 測試過。要有 gcc, python, virtualenv, apple/sun jdk 6 (openjdk 6 還是無法使用 OFBiz)。因為 mercurial 1.8 和 fabric 1.0.1 都要用新版, 習慣用 virtualenv 來建, 這時得有 gcc 相關工具備著。
環境建立:
@ /w/proj $ virutalenv --no-site-packages fab $ cd fab $ source bin/activate (fab) $ pip install mercurial ... (fab) $ pip install fabric ... (fab) $ curl -O https://bitbucket.org/tcc/ofbiz-util/raw/38e378fef189/fabfile.py
準備 ~/.hgrc:
[ui] username = jia@side.org [extensions] pager = hgext.mq = [pager] pager = LESS='FSRX' less
注意 username, pager, mq 都要有 ... fabfile.py 會用到。
執行:
假設主要目錄是 /w/proj/fab/ofbiz, 會在下面自動建立 svn/, hg/, zip/ 三個目錄 ...
- svn/ 目錄為 svn 儲存庫, 和遠端 svn 同步。
- hg/ 目錄為 hg 儲存庫, 用來執行應用系統。和本地 svn/ 同步, 並且以 hg-mq 進行客製化處理。
- zip/ 目錄存放 ofbiz-trunk-current.zip 檔案, 只在 "初始" 步驟有用, 之後可刪除。
- 進行初始儲存庫:
@ /w/proj/fab $ source bin/activate (fab) $ fab init:/w/proj/fab/ofbiz ...
就會進行, 由於部份操作挺費時間, 或須備妥網路, 像下載 ofbiz-trunk-current.zip 會停下來詢問, 若要執行到底:
(fab) $ fab init:/w/proj/fab/ofbiz,auto=Y ...
加上參數 auto=Y 即可。 - 當 mq@bitbucket 有新版本要更新:
(fab) $ fab mqpull:/w/proj/fab/ofbiz,sync=Y ...
若沒有 sync=Y 就得手動進行 sync:
(fab) $ fab sync:/w/proj/fab/ofbiz ...
- 註解第 31 列 hg_mq_url = 'https://bitbucket.org/tcc/ofbiz-mq'。
- 打開第 32 列 hg_mq_url = 'file:///w/proj/ofbiz/mq2' 做必要修改。
(fab) $ fab update:/w/proj/fab/ofbiz ...接著提交寫入, 並上送:
(fab) $ fab mqcommit:/w/proj/fab/ofbiz,push=Y ...若沒下 push=Y, 要手動進行上送:
(fab) $ fab mqpush:/w/proj/fab/ofbiz ...
全部操作就這樣了。
建置 OFBiz 前先置入 hg-mq:
@/w/proj/fab/ofbiz/hg (fab) $ hg qpush -a ...
然後按 OFBiz 安裝進行:
(fab) $ ./ant clean-all ... (fab) $ ./ant run-install-extseed ... (fab) $ ./ant create-admin-user-login ... (fab) $ ./startofbiz.sh ...
如果要建立另一份系統做開發, 把目錄 /w/proj/fab/ofbiz/ 改為其他的, 例如 /w/proj/yi/side/ ... 依據客製 hg-mq 很快就能建立一套新的應用系統。不用辛辛苦苦裝完系統, 再逐一做客製相關設定。
試試看, 或許有更好的做法 :)
