Month: July 2009

在Ubuntu上安裝Buildbot是很簡單的事情：sudo apt-get install buildbot。

比較麻煩的是設定，大致瀏覽了一下 Manual，還是不知道怎麼設定，轉而找 Google 大神，Mousebender 的這篇Installing buildbot，就很簡單易懂。但由於這篇提供的設定是 2006 年的，現在的設定稍稍有改變，c[‘bots’] 必須修正為 c[‘slaves’]，後面會提到。

依據 Architecture，Buildbot必須要有 master 跟 slave，master 負責提供 web 介面跟叫 slave 做事，而 slave 就只聽命令做事，所以設定的時候就要分別設定 master 跟 slave。

master 的設定，得先使用 buildbot create-master [目錄名] 來建立，這會幫你建立一個目錄，並提供你設定檔的範本(master.cfg.sample)。第一步就是要把 master.cfg.sample 改為 master.cfg，然後修改 master.cfg。要調整的基本上有這幾個：

• c[‘schedulers’]，要排程的時間。
• f1.addStep()，這決定怎麼編譯。
• c[‘slaves’]、c[‘slavePortnum’]，slave的名稱、密碼以及要 listen 的 port，待會建立 slave 時會用到。
• c[‘projectName’]，你專案的名稱。
• c[‘projectURL’]，你專案的網址。

接著要建立 slave，這邊用 master.cfg.sample 來舉例，也就是假設你剛剛沒改 c[‘slaves’]、c[‘slavePortnum’] 的內容，所以這邊用 buildbot create-slave [目錄名] localhost:9989 bot1name bot1passwd 來建立 slave，接著把 slave 目錄下的 Makefile.sample 改為 Makefile 即可。

啟動的時候，要先啟動 slave 再啟動 master，啟動的指令都是 buildbot start [目錄名]，例如 buildbot start myproject-master、buildbot start myproject-slave。

這樣就大功告成，你可以打開 http://localhost:8010 來看 build 的進度了。

下面是我的設定檔：

# -*- python -*-
c = BuildmasterConfig = {}
####### BUILDSLAVES
from buildbot.buildslave import BuildSlave
c['slaves'] = [BuildSlave("myproject-slave", "password", max_builds=1)]
c['slavePortnum'] = 9989
####### CHANGESOURCES
from buildbot.changes.pb import PBChangeSource
c['change_source'] = PBChangeSource()
####### SCHEDULERS
from buildbot.scheduler import Scheduler, Periodic
c['schedulers'] = [
Periodic("every_12_hours", ["buildbot-full"], 12*60*60 )
]
####### BUILDERS
from buildbot.process import factory
from buildbot.steps.source import CVS
from buildbot.steps.shell import Compile, ShellCommand
from buildbot.steps.python_twisted import Trial
f1 = factory.BuildFactory()
f1.addStep(ShellCommand(command=["/home/user1/build/build.sh"]))
f1.addStep(Compile())
b1 = {'name': "buildbot-full",
'slavename': 'myproject-slave',
'builddir': "full",
'factory': f1,
}
c['builders'] = [b1]
####### STATUS TARGETS
c['status'] = []
from buildbot.status import html
c['status'].append(html.WebStatus(http_port=8010))
####### PROJECT IDENTITY
c['projectName'] = "myproject"
c['projectURL'] = "http://myproject-server"
c['buildbotURL'] = "http://localhost:8010/"

如果你也跟我一樣，因為要安裝 Powershell v2.0 而無法移除 Powershell v1.0 的話，可以研讀 Powershell team 貼的這篇：Windows PowerShell Blog : Behind PowerShell Installer (for Windows XP / Windows Server 2003):，了解一下 Powershell 安裝程式做了什麼。不過這篇字太多了，我其實是參考這篇：BUGBUG: poor title » Blog Archive » How to uninstall Powershell v1.0 from Windows Server 2003 R2 來移除的，除了 pwrshsip.dll 無法刪掉之外，基本上不刪掉也沒關係。接著就可以上 Powershell v2.0 CTP3 了。
為什麼要上 Powershell v2.0 CTP3 呢？這是因為 SQL Server 2008 Management Studio Express 的緣故。真是太機車了…

Ubiquity 升級到 0.5 了，Parser API 也升級到了 2，語法有改變，所以參考轉換指南修正了一下之前的 findbook：

CmdUtils.CreateCommand({
names: ["findbook"],
contributors: ["elleryq"],
license: "MPL",
description: "讓買書變成更簡單的決定！",
arguments: [ {role: 'object', nountype: noun_arb_text, label: '書名關鍵字'} ],
icon: "http://findbook.tw/favicon.ico",
execute: function(args) {
Utils.openUrlInBrowser( "http://findbook.tw/search?keyword_type=keyword&q=" + encodeURIComponent(args.object.text) );
}
});

如果你想入門的話，這份文件可以作為參考：Labs/Ubiquity/Ubiquity Source Tip Author Tutorial。
另外，在Ubiquity Command Editor頁面裡也有 command APIs，告訴你有哪些 API 可用。