継続的インテグレーションとランプ

構成を考える

• ビルドサーバはWindowsで、Cruise Control .NETが稼動している。
• ランプのコントロールプログラムはunix上のスクリプトでさらっと書いてさっさと動かしたい。
• tracでプロジェクトwebを運用しているlinuxサーバにシリアルポートがついている。

• cgiはGETでパラメータ指定。
  • 赤・緑・黄のそれぞれのランプを、点灯・点滅・消灯の状態にすることができる。
  • ブザー制御について、ブザーがけたたましすぎるのと、夜間ビルドで失敗してブザー鳴りっぱなし、というのも困るので実装しない。
• CCNETからcgiの呼び出しは、コマンドラインツールでさくっと実現する。
  • 単一のファイルで実行できるcURL.exe for Windowsを使用することにした。
  • 「Cruise Control .NETとsubversionで文字化け」のiconv.exeでお世話になったKaoriYa.netにまたまたお世話になります。
• cgiはperlで書き（なんでもいいけど）、シリアルポートへの出力は/dev/ttyS0を用いる。

実装

• これを適当なURLで参照できるようにwebサーバ内に配置する。http://サーバ/pat0/のような。
  • パラメータは「r」「g」「y」でそれぞれ赤・緑・黄のLEDに対応する。
  • 指定できる値は、それぞれ「on（点灯）」「blink（点滅）」「off（消灯）」
  • 例：赤だけ点灯＝http://サーバ/pat0/?r=on&g=off&y=off
  • 例：黄だけ点滅＝http://サーバ/pat0/?r=off&g=off&y=blink
• シリアルポートの設定をしていないので・・・
  • 事前に設定しておくか、制御コードを追加してください。設定すべき状態はPHE-3FBのマニュアルに書いてある。9600baud
  • ここではFedora Core 5を使っているが、デフォルトのままで動くようだ。
• 参照するシリアルポートが/dev/ttyS0固定なので・・・
  • 適宜変更するか、コンフィギュレーション可能にしてください。
• /dev/ttyS0はownerがrootでgroupがuucp。otherには読み書き権がないので・・・
  • 今にしてみればsuexecを使うかotherにrwを付与すればよかったのかもしれないが、apacheユーザをuucpグループに加えた。

セットアップ

• ビルドタスクの最初にビルド中を表す「黄」点灯状態に。

  <tasks>
      <exec>
          <executable>pat.bat</executable>
          <buildArgs>begin</buildArgs>
          <buildTimeoutSeconds>30</buildTimeoutSeconds>
      </exec>
  

• pat.batの中身は以下のとおり。パス/URL関係は環境に合わせて適宜。

  @echo off
  set STATUS="%CCNetIntegrationStatus%"
  set url=http://linuxサーバ/pat0/?
  
  if "%1" == "begin" (
    set para="%url%r=off&g=off&y=on"
  ) else (
    if %STATUS% == "Success" (
      set para="%url%r=off&g=on&y=off"
    ) else (
      set para="%url%r=on&g=off&y=off"
    )
  )
  
  curl.exe -s %para% > nul
  

• ビルド結果のpublish時に再度ランプ点灯。
  ビルド成功なら緑、ビルド失敗なら赤を点灯させる。状態の判定は、pat.batの中で変数環境CCNetIntegrationStatusを参照して行っている。

  <publishers>
      <xmllogger logDir="log" />
  
      <exec>
          <executable>pat.bat</executable>
          <buildTimeoutSeconds>30</buildTimeoutSeconds>
      </exec>