TracLightningには、プロジェクト・リポジトリデータをバックアップするスクリプトbackup.batが含まれていますが、 TracLightning 3.1.2以降ではバックアップをJenkinsで定期実行するためのジョブが追加されました。

このジョブを利用することで定期的なバックアップを簡単に取ることができます。Jenkinsに興味がある方で、まずは使ってみたいという人にも最適です。

Jenkins設定内容

• 毎日深夜午前0時1分に実行されます。(ビルド・トリガ)
• ログは7回分まで保存されます(ビルドの最大保存数)
• 環境変数：TL_BACKUP_DIR に設定されている場所にバックアップを保管します。
  • TL_BACKUP_DIR の設定がない場合には TRAC_LIGHT_HOME 以下に backup　フォルダーを作成しを TL_BACKUP_DIR として扱います。
  • TL_BACKUP_DIR 以下に実行日の日付のフォルダを作成し、TL_BACKUP_DIR を日付つきのものに置き換えます。
• backup.bat を実行し TL_BACKUP_DIR バックアップを行います。
• 過去7回を超える分のバックアップを削除します。
• 削除はコメントアウトしてあります。
• ビルドの最大保存数に合わせて設定すると良いと思います。

バックアップ対象・内容

バックアップ対象及び内容の詳細はスタートメニューにあるバックアップに準拠しますが概要は以下の通りです。

• 全プロジェクトの svn の hotcopy
• 全プロジェクトの trac の hotcopy
• hudson ( Jenkins )のディレクトリを丸ごと
• maven のディレクトリを丸ごと

詳細については TRAC_LIGHT_HOME 以下にある backup.bat を参照してください。

利用についての注意

Jobはデフォルトで無効化されています。

そのまま有効化しても利用可能ですが今後のバージョンアップにて変更される可能性があるため、ジョブをコピーするかジョブ名を変更して利用することをお奨めします。

ジョブのコピーはJenkinsの"新規ジョブ作成"から"既存ジョブのコピー"を利用して、BackupSampleのジョブをコピーし有効化してからご利用下さい。

このページでは、TracLightningのリリースマネージメントについて記述します。読者対象は、TracLightningのリリースマネージャです。

リリースマネージャ

リリースマネージャは、TracLightningをリリースすることができます。現在のところ、下記の開発者がリリースマネージャです。

• id:jun66j5
• id:okamototk
• id:kanu

次のリリースのリリースマネージャは id:jun66j5 さんです。

ナンバリング

ここでは、バージョンのナンバリングについて説明します。

• メジャーバージョン
  • Tracのバージョンが上がるとメジャーバージョンを上げます。
  • 例えば、TracLight1.xはtrac 0.10、TracLightning2.xは trac0.11、TracLightning3.xはtrac0.12に対応しています。
• マイナーバージョン
  • 機能追加を行った場合、マイナーバージョンを上げます。
  • マイナーバージョンが上がった場合、既存のプロジェクトへ対してアップグレードが必要なことがあります。
• サブマイナーバージョン
  • バグフィックスやささいな機能追加を行った場合、サブマイナーバージョンを上げます。
  • サブマイナーバージョンを上げた場合、アップグレードしても既存のプロジェクトへ影響を及ぼすことはありません。

正式リリース時には、コンポーネントとしてtrac-lightningを指定します。また、チケット対応、コミット時に 解決方法を解決済に、正式リリース時にチケットをクローズにします。

次バージョンのリリース日について

• リリースマネージャは、次バージョンのタスクを整理し、リリース予定日を決めます。
• リリース予定日は、前のバージョンがリリースされてから1ヶ月～3ヶ月後に設定します。次のバージョンで対応するチケットの数と稼動の取れ具合を考慮してリリース日を設定します。
• ただし、重大なバグが発生した場合、できるだけ早くリリースします。

α、β、rc版について

リリースをする前に必要に応じて、α版、β版、rc版をリリースすることができます。マイナーバージョン以上のバージョンアップ時は開発版を必ずリリースするようにします。リリース時にコンポーネントとしてtrac-lightning-devを選択します。なお、開発版リリース時にはまだチケットはクローズしません。チケットに対応した時点で解決方法を「解決済み」にするのは問題ありません。

• α版
  • 次のリリースまでの途中のマイルストーンとしてリリースします。
  • 今後大きな機能変更がある可能性があります。
  • 不安定でバグが沢山残っている可能性があります。
  • 主に開発者及びへヴィーユーザー向けです。
• β版
  • 機能確認やテスターにテストして貰うためにリリースします。
  • 今後若干の機能変更がある可能性があります。
  • バグが残っている可能がありますが、致命的なバグは多分ありません。
  • テスター向けです。β版をリリースしたら、バグ報告や機能追加を要求したユーザに機能確認をしてもらうように依頼します。
• rc版
  • リリース前の最終確認用のリリースです。テスター向けです。
  • 殆どバグは枯れていますが、若干バグが残っている場合もあります。
  • 基本的には、ささいなバグフィックス後、正式版をリリースします。

バージョンの変更時のソースの変更

バージョンを変更する際は、set-version.cmd で以下のように実行することで必要なファイルを書き換えられるようになっています。

C> set-version.cmd 3.1.3rc1

変更になる箇所は、以下の部分です。

• trac.iss
  • AppVerName=.... の部分
• install/replace/trac.ini.in
  • footer の部分

リリース作業

1. 上記のバージョンを確認します。
2. ISCC 環境変数を Inno Setup のコンパイラに設定し、build.cmd を実行します。
   • ISCC 環境変数を設定しない場合、Inno Setup をデフォルトの場所にインストールしたと仮定して %ProgramFiles%\Inno Setup 5\iscc.exe を使います。
   • trac.iss と install/replace/trac.ini.in のバージョン情報に差異があるとエラーになります。
3. 出来上がったバイナリの名前がバージョン情報が付与されているかを確認します。(例えば、TracLightning-3.1.2rc1.exe)
4. sf.jpの「ダウンロード」→「管理」からバイナリをリリースします。コンポーネントは、trac-lightningもしくはtrac-lightning-dev(開発版)を利用のこと
5. hg tagでバージョンのタグをうち、pushします。(ex. hg tag 3.1.2rc1)

情報共有について

大きな変更を加えたり、他の開発者と情報共有する際には wiki:Development を利用することにします。

背景

TracLightning 3.1.2までは、プラグインのバージョン管理がまともに出来ていませんでした。幾つかのプラグインはバグ修正や日本語化対応を行っていますが、Upstreamとの差分の管理は厳密には行われていません。.svnをインポートしているプラグインもありますが、編集の競合が起るとインポートしたsvnリポジトリが破壊される可能性があります。

また、TracLightningとKanonでプラグインが2重管理になっているのもなんとかしたいです。

そこで、プラグインをきちんと管理できるようにリポジトリ構成を変更したいと思います。

管理案

id:jun66j5さんのところでのプラグイン管理を習って次のようにしたいと思います。

Trac本体

• bitbucketのミラーをクローンして管理するのがベター
  • https://bitbucket.org/edgewall/trac

プラグイン

全部のプラグインをmercurialでクローンして管理

• mercurialでプラグインをクローンして管理
• 1プラグイン1リポジトリ作成
• TracLightningからはmercurialのプラグインリポジトリをsubrepoで参照
• 独自の修正を加えていないプラグインはTracLightningのリポジトリに直接subrepoを作成。独自修正が入った時点でmercurialでクローンして管理する方式に変更(できるだけforkしたリポジトリ数を減らす)

確認事項

• gitリポジトリはhgでcloneできるか? 更新を取り込めるか?(hg-gitを検証?)
• svnリポジトリはhgで取り込めるか? svnのアップデートのマージをhgで取り込めるか?

検証項目

	hg-svn	hg-git
日本語	?	?
取り込み(clone)	?	?
アップデート	?	?
マージ	?	?

• 何処のリポジトリを使うか?
  • bitbucket(王道)
  • sf.jpのShibuya.trac/TracLightning(sf.jpのアカウントが利用できる)
  • kanon-lab
  • ciklone?(使わせて貰えれば)
  • その他

移行方針

• 取り敢えず、修正していないプラグインをsubrepoへ移行する
• 修正したプラグインは量が多いので段階的に移行

検討事項

• cikloneのプラグインと共通化できないか?
• マージしたときに、マージしたリビジョンをログに書くなど、規約を作成。

同梱しているプラグインの一覧とその入手元URLとそのリビジョンを列挙。同梱するにあたって変更しているものは、その内容を記載する。 ? になっている部分は調査中。

• acct_mgr
  • URL: https://trac-hacks.org/svn/accountmanagerplugin/0.11
  • Rev: 10429
  • 修正内容: なし
• addcomment
  • URL: http://trac-hacks.org/svn/addcommentmacro/0.11/
  • Rev: ?
  • 修正内容: なし
• advancedticketworkflow
  • URL: http://trac-hacks.org/svn/advancedticketworkflowplugin/0.12
  • Rev: 9962
  • 修正内容: なし
• autowikifyplugin
  • URL: http://trac-hacks.org/svn/autowikifyplugin/trunk/
  • Rev: ?
  • 修正内容: なし
• batchmodify
  • URL: http://trac-hacks.org/svn/batchmodifyplugin/0.12/
  • Rev: ?
  • 修正内容: なし
• changedaterecordplugin
  • URL: ?
  • Rev: ?
  • 修正内容: ?
• completeuser
  • URL: https://svn.sourceforge.jp/svnroot/shibuya-trac/plugins/completeuserplugin/trunk/
  • Rev: ?
  • 修正内容: なし
• customfieldadmin
  • URL: http://trac-hacks.org/svn/customfieldadminplugin/0.11/
  • Rev: ?
  • 修正内容: 日本語化
• datefield
  • URL: http://trac-hacks.org/svn/datefieldplugin/0.11/
  • Rev: ?
  • 修正内容: 日本語化
• discussion
  • URL: http://trac-hacks.org/svn/discussionplugin/0.11
  • Rev: 9877
  • 修正内容: 日本語化
• extendedversionplugin
  • URL: http://trac-hacks.org/svn/extendedversionplugin/0.11
  • Rev: 9267

• • 修正内容: ?
• flashembedmacro
  • URL: http://trac-hacks.org/svn/flashembedmacro/0.11
  • Rev: 7801
  • 修正内容: ?
• footnotemacro
  • URL: http://trac-hacks.org/svn/footnotemacro/0.11
  • Rev: 8450
  • 修正内容: ?
• ganttcalendar
  • URL: http://svn.sourceforge.jp/svnroot/shibuya-trac/plugins/ganttcalendarplugin/trunk
  • Rev: 801
  • 修正内容: ?
• hudsontracplus
  • URL: ?
  • Rev: ?
  • 修正内容: ?
• iniadmin
  • URL: http://trac-hacks.org/svn/iniadminplugin/0.11/
  • Rev: ?
  • 修正内容: 多分なし
• lightningtheme
  • URL: ?
  • Rev: ?
  • 修正内容: ?
• macropost
  • URL: http://trac-hacks.org/svn/macropostplugin/0.11/
  • Rev: ?
  • 修正内容: なし
• mailarchiveplugin
  • URL: ?
  • Rev: ?
  • 修正内容: ?
• masterticketsplugin
  • URL: http://trac-hacks.org/svn/masterticketsplugin/0.11/
  • Rev: ?
  • 修正内容: なし
• newwikipagebutton
  • URL: http://svn.sourceforge.jp/svnroot/shibuya-trac/plugins/NewWikiPageButtonPlugin/trunk/0.11/
  • Rev: ?
  • 修正内容: なし
• privatewikiplugin
  • URL: http://trac-hacks.org/svn/privatewikiplugin/0.11/
  • Rev: ?
  • 修正内容: 多分なし
• querychart
  • URL: ?
  • Rev: ?
  • 修正内容: ?
• reportincludeplugin
  • URL: http://svn.sourceforge.jp/svnroot/shibuya-trac/plugins/reportincludeplugin/trunk/0.12
  • Rev: 800
  • 修正内容: ?
• searchhyperestraier
  • URL: ?
  • Rev: ?
  • 修正内容: ?
• sectioneditplugin
  • URL: http://trac-hacks.org/svn/sectioneditplugin/0.12/
  • Rev: ?
  • 修正内容: 多分なし
• svnauthzadminplugin
  • URL: http://trac-hacks.org/svn/svnauthzadminplugin/0.11/
  • Rev: ?
  • 修正内容: 日本語化+何か直した記憶があるが、、、
• themeengineplugin
  • URL: http://trac-hacks.org/svn/themeengineplugin/0.11
  • Rev: 7741
  • 修正内容: ?
• ticketclone
  • URL: たしかtracのサンプルプラグインから。
  • Rev: ?
  • 修正内容: ?
• ticketimportplugin
  • URL: http://trac-hacks.org/svn/ticketimportplugin/0.11/
  • Rev: ?
  • 修正内容: 日本語化+ネスト化チケット対応
• ticketsubmitpolicyplugin
  • URL: ?
  • Rev: ?
  • 修正内容: ?
• timingandestimationplugin
  • URL: ?
  • Rev: ?
  • 修正内容: ?
• tocmacro
  • URL: ?
  • Rev: ?
  • 修正内容: ?
• tracavatarplugin
  • URL: https://svn.sourceforge.jp/svnroot/shibuya-trac/plugins/tracavatarplugin/branches/0.12/
  • Rev: 806
  • 修正内容: なし
• tracdragdropplugin
  • URL: ?
  • Rev: ?
  • 修正内容: ?
• tracjsganttplugin
  • URL: http://trac-hacks.org/svn/tracjsganttplugin
  • Rev: 9673
  • 修正内容: ?
• TracMacOSTheme
  • URL: ?
  • Rev: ?
  • 修正内容: アイコン周りを修正
• tracmsofficexmlplugin
  • URL: ?
  • Rev: ?
  • 修正内容: ?
• tracnav
  • URL: ?
  • Rev: ?
  • 修正内容: ?
• tracsteinschartplugin
  • URL: http://svn.sourceforge.jp/svnroot/shibuya-trac/plugins/tracsteinschartplugin/trunk
  • Rev: 794
  • 修正内容: なし
• tracsubticketsplugin
  • URL: https://svn.sourceforge.jp/svnroot/shibuya-trac/sandbox/okamototk/tracsubticketsplugin/
  • Rev: 806
  • 修正内容: 無いはず...
• tracwysiwyg
  • URL: http://trac-hacks.org/svn/tracwysiwygplugin/0.12
  • Rev: 9676
  • 修正内容: なし
• usermanager
  • URL: ?
  • Rev: ?
  • 修正内容: 日本語化
• workfloweditorplugin
  • URL: http://trac-hacks.org/svn/workfloweditorplugin/0.12/
  • Rev: ?
  • 修正内容: ?
• xdocview
  • URL: ?
  • Rev: ?
  • 修正内容: ?
• xmlrpcplugin
  • URL: http://trac-hacks.org/svn/xmlrpcplugin/trunk
  • Rev: 10514
  • 修正内容: なし

ここでは、TracLightningの開発者向けの情報について記述します。

リポジトリ

TracLightningの最新版は、BitBucket上で開発しています。SourceForge.JP上のリポジトリは利用していません。詳細は下記のリポジトリをご覧ください。

• https://bitbucket.org/okamototk/traclightning

ソースコードを取得するには、次のようにします。

パッチなどを作成した場合は、BitBucket上からPullリクエストを出してください。

バグ報告や機能リクエストなど

バグ報告、パッチなどのトラッキングシステムへの登録は、引き続きSourceForge.JPのチケットをお使いください。

開発メンバ

開発メンバは下記の通りです(アルファベット順)。

メンバ

akihirox

okamototk

jun66j5

kanu_orz

同梱ソフトウェア

• プラグイン

Agiloの情報

カスタマイズなど

• デフォルトの表示項目のカスタマイズ
  • http://www.ryuzee.com/contents/blog/2969
• Agilo の高速化
  • http://www.ryuzee.com/contents/blog/2864

考慮事項

• メニューを増やし過ぎると Agilo のアイコンで表示しきれずメニューが押せないので、プラグインの選別か、Agilo 側での対応が必要と思われる

変更サマリー

• AccountManagerの持つフォーム認証が利用できるようになりました。(#25243)
• TracLightningのバックアップがJenkinsのjob(サンプル)に追加になりました(#25536)
• 他詳細については TracLightning3.1.1からの変更点を参照してください。

機知の不具合

• #25834 管理メニューのアカウントの部分に"ユーザ"の項目が二重に表示される

注意事項

カスタムフィールドの削除について

以下2つのカスタムフィールドは、デフォルトで設定されるプラグインの動作に必要なカスタムフィールドです。
削除する場合は該当するプラグインをdisabledにしてから削除してください。
プラグインを有効なまま削除するとプロジェクトが開けなくなり、trac.iniを直接編集するしなければいけない可能性があります。

• parent(親)
  • TracSubticketsPlugin で利用しているカスタムフィールドです。
• complete(進捗率)
  • tracganttcalendarplugin で利用しているカスタムフィールドです。

TracLightning3.1.1からの変更点

Trac全般

• #25267 csvダウンロード時にutf-8になってしまうことへの対処
• #25501 loginを含むwikiを作成するとログインを求められることへの対応
• #25830 TicketImportでidだけで変更を行うととエラーになることへの対応
• #25536 JenkinsへのBackup用job(サンプル)の追加
• #25647 Tracからsvnリポジトリ参照時の不具合対応

Tracプラグイン

• 更新
  • #25245 tracsteinschartplugin (0.1.9)
  • #25247 AdvancedTicketWorkflowPlugin (0.11)
  • #25246 tracwysiwygplugin (0.12.0.3)
  • #25243 AccountManagerPlugin (0.11branch r10429))
  • ReportIncludePlugin to (0.5-SNAPSHOT)
  • xmlrpcplugin (1.1.2 trunk@10514)
  • #25477 QueryChartの更新
• 追加
  • #25244 ExtendVersionPlugin
  • #25248 FootNoteMacro
  • FlashEmbedMacro
  • ChangeDaterecordPlugin

Jenkins(Hudson)

• Jenkins本体ののバージョンアップ(1.413)
• プラグイン更新
  • Static Analysis Utilities
  • Dashboard View
  • FindBug
  • Checkstyle
  • PDM
  • Duplicate Code Scanner
  • Hudson Violations plugin

• TracLightning3.1.2をリリースしました。プラグインの最新化と不具合への対応が主です。詳しくはこちら
• @ITの「Hudson」改め「Jenkins」で始めるCI（継続的インテグレーション）入門にてTracLightningが紹介されました。CIやJenkinsに興味がある方は是非ご一読ください。
• TracLightningの後継ソフトウェアKanonを公開しました。詳しくはこちらのページをご覧ください。なお、TracLightningの開発・メンテナンスは継続されますので、ご安心ください。TracLightningの開発継続の表明については、こちらをご覧ください。
• TracLightning3.0でMercurialを簡単に使うhglightが公開されています。分散バージョン管理ツールを導入をご検討の方は是非お試しください。
• TracLightning3.0.0をリリースしました。Trac0.11からTrac0.12への以降がメインで、幾つかのTrac0.12で動作しないプラグインは削除されています。TracLightning2.xをお使いの場合で、特に不満がない場合はアップグレードをお勧めしません。TracLightning2.xからのアップグレードの注意は、ここをご覧ください。

• ITProの2009年末において、TracLightningの紹介記事がランキング2位になりました。詳細は、［Development］プロジェクト管理ツールTracに高い関心 をご覧ください。

TracLightningってなに?

TracLightningは、ものぐさな開発者をターゲットとたプロジェクト管理ツールです。開発プロジェクト、運用・保守プロジェクトで利用でき、営業や総務のような汎用的なタスク管理ツールとしても利用できます。従来的なタスク、バグ管理に加え、3.0からスクラムをお手本としたアジャイル開発にも対応しました。

TracLightningでできることは、ぶっちゃけTracLightningを使わなくてもできるでしょう。しかしながら、Trac/Redmineに色々と拡張プラグインを設定したり、バージョン管理ツールとCIとの連携の設定をしたり、色々と面倒な設定が必要です。また、そもそもどのツールを使えば良いのかツールを選定するところから始まるかも知れませんし、沢山の拡張プラグインの中から使えるプラグインを見つけ出すのは初心者にとっては不可能と言って過言ではないでしょう。

TracLightningは、数々のプロジェクトで採用実績があるツール群を採用しています。チケット(課題、バグ、タスク)管理にTrac、バージョン管理にSubversion、継続的インテグレーションにHudsonと、どれもほぼデファクトスタンダードとして広く利用されているツール達です。TracLightningを使えば、これらのツール群がきちんと連携した状態でわずか数クリックで導入可能です。

また、最近では、hglightなど、分散バージョン管理システムを利用するための拡張なども登場してきており、よりモダンな開発をサポートします。

是非、TracLightningを試してみてください。

Trac Lightningの画面イメージ(クリックすると拡大します)

Agile用プロジェクトの画面イメージ(クリックすると拡大します)

おしらせ

• (2010/11/15) TracLightning 3.0.0 リリース
  • アップグレード時の注意
• (2010/06/26) TracLightning 2.5.2 リリース
• (2010/06/01) TracLightning 2.5.1 リリース
• (2010/05/19) TracLightning 2.5.0 リリース
• (2010/03/30)リポジトリブラウザに関するセキュリティホールについて
• アップグレード時の注意

ユーザの評判はこちらから

• TracLightning-2.5.0 リリース
• TracLightning2.1 正式版リリース
• Trac Lighting 2.1正式リリース!
• Trac Lightning 2.1リリース

新着情報

• 12月17日(金)分散バージョン管理勉強会が開催されました。50名超の参加がありました。詳細はレポートをご覧ください。
• 10月1日(金)Shibuya.trac第8回勉強会が開催されました。前回と同じく総勢57名もの参加がありました。詳細はレポートをご覧ください。
• 7/7日(水)にShibuya.trac第7回勉強会七夕.tracが開催されました。総勢57名もの参加がありました。詳細はレポートをご覧ください。
• 6月9日(水)TracLightningを題材にした第六回　プロジェクト効率化勉強会が開催されました。大勢のご参加ありがとうございました。
• 5月12日(水)TracLightningを題材にした第五回　プロジェクト効率化勉強会が開催されました。大勢のご参加ありがとうございました。
• 4月27日(火)Shibuya.trac第6回勉強会が開催されました。
• 4月14日(水)第4回プロジェクト効率化勉強会にて、TracLightningを利用したWikiの使い方についての勉強会が行われました。
• 3月10日(水)第三回 プロジェクト効率化勉強会にて、TracLightningを利用したWikiの使い方についての勉強会が行われました。
• 2月10日(水)第二回　プロジェクト効率化勉強会にて、TracLightningを利用したプロジェクト管理の効率化の勉強会が行われました。Subversionブランチやマージなどの構成管理の基礎について演習を通して勉強しました。

• gihyo.jpのTracを使って開発プロジェクトを楽しもう！ 第2回　Trac Lightningの紹介にて、TracLightningが紹介されました
• かおるんさんによりTrac LightningでHudsonをWindowsサービスとして動かす方法が紹介されました。
• IT ProTracで開発現場を交通整理「Trac Lightningで簡単インストール」で紹介されました。
• @ITの記事SubversionとTracでファイル管理の“迷宮”から脱出にてTrac Lightningが紹介されました。
• @ITのTrac Lightningで始めるチケット式開発「電撃」入門にてTrac Lightningが紹介されました。是非ご覧ください。
• TECH WORLDのプロジェクト管理の統合環境を手軽に構築できる「Trac Lightning」で紹介されました。
• Shibuya.trac勉強会0.11に参加ました。

Trac0.11/Subversion1.5.0を採用した、数々の新機能を盛り込んだTrac Lightning2.0.0をリリースしました。2.xの概要については下記のサイトをご覧ください。

• Trac Lightning 2.0.0 Beta3
• Trac Lightning 2.0の新機能
• ワークフロー機能のカスタマイズ方法

注:Trac Lightning 1.x系から最新のTrac Lightning2.0.xへアップグレードは自動で行われません。詳細は、インストールのページのアップグレードのセクションをご覧ください。

• チケットによるバグ、課題、タスク管理
• ガントチャート、タスクのプログレッシブバーによる進捗管理
• カレンダーによるスケジュール管理
• ワークフロー機能

がご利用頂けます。

インストール

新規インストールであれば、TracLight-x.x.exeをダウンロードしてクリックしてインストールするだけです。詳細は上記のインストールのページを参考にしてください。1.5以降は、下一桁が奇数の場合は開発バージョン(不安定バージョン)で、仕様変更や大幅な機能追加が行われる可能性があります。下一桁が偶数の場合は安定バージョンで基本的にはバグフィックスや細微な機能追加したものです。現在の安定バージョンは2.0.0です。1.9.x、2.1.xは不安定バージョンなのでご注意ください。

はじめに

みなさんは、プロジェクト管理をどのようにしているでしょうか?殆どの人はMS ProjectやExcelを利用しているのではないかと思います。MS ProjectやExcelを利用した場合、タスクや課題などを一覧として管理するには優れていますが、タスクの進行状況や、課題、故障を解決していった作業の過程を残すのには、向いておらず、ある作業で何をやったのかは、担当者とそのリーダー位しか把握していないのが現状ではないでしょうか。

また、ある程度大きな規模の会社になると社内で開発したプロジェクト管理ツールを利用していると思いますが、そのようなプロジェクト管理ツールは、開発経験のない開発者に作らせていることが多く、使い易いとは言えないのが実態です。

オープンソースでも幾つかのプロジェクト管理ツールが提供されていますが、インストールが面倒だったり、業務で利用するには機能が不足していたりします。また、それらのツールを利用するのにRDBMSが必要、各スクリプト言語のセットアップが必要、更に設定が複雑であったりと、導入の敷居が高いのが現状です。Trac Lightningは、非常に手軽に導入できることを第一目標に掲げたツールです。Trac Lightningを利用することにより、インストールのみならず、プロジェクトの設定も簡単に行うことができます。

Trac Lightningは環境構築をするのが面倒くさい「ものぐさな」開発者をターゲットとしています。腕に自信があって、カスタマイズをバリバリやれる方はTracを素でインストールしたり、redMineをgemでガリガリやりながらインストールした方が幸せになれるかもしれません。私は面倒くさがり屋なのでTrac Lightningを使いますが...

Trac月となにが違うの?

• Trac月は1.6.0からTrac Lightningと名前を変更してリリースしました。
• CIツールとして、Apache Continuumに換わり川口耕介さんが開発するHudsonに変更しました。HudsonはGlassfish、JBossを始め、多くのオープンソースプロダクトで利用されている実績のあるJavaのCIツールです。

ユーザの声

色々美辞零句を並べても疑り深いあなたは絶対信用しないと思いますので、Web上のユーザの声を並べてみましたので参考にしてください。

• TracLightの初期セットアップ手順

  開発においてコーディング以外は付帯作業なので、できれば支援形のツールに手間はかけたくない。
  この点TracLightは、即効でセットアップがすむのは非常に便利です!
  

• Trac Lightning におねがい

  リーダの机の横の Win 2003 Server 上にTrac Lightningを入れる。
  TracとSubversionを一気に構築できて便利です、これ。
  

• 理想と現実 Winと*nix Tracの場合

  　ユーザー管理やフォーラム、カレンダーにガントチャート、
  果ては統計とか言うプラグインまで入ってる。それに結構な
  量が日本語化されてるし・・こりゃーこっちを使うわなぁと
  おもった。
  ...
  TracLigningは手軽さが、かなりいい！Winのライセンス代
  払っても良いかもしれないと思わせる簡便さに、やりたい事
  とやれる事の差を感じた。もっと精進せねば行けないと思った。
  

• 5th - SoftGrid が App-V 4.5 で RTMed

  本っっっっっっ当にきっつい trac の導入をインストーラで！
  これは大変ありがたいプロジェクトです。感謝！
  

• Trac　インストール完了の巻

  やばい何これ楽しいやばい
  議事録もWikiで書けるしデータも添付できるしなぁんぞこれ
  ちょ　これ　すげぇぞー！（大声）
  

• Trac LightningのCSSを変更する

  プロジェクト管理に"Trac"というWebアプリケーションを使用しています。
  このアプリケーションはインストールすれば、すごい使い勝手が良いのですが、
  インストールが大変です。それを補ってくれるのが、"Trac Lightning"という
  パッケージです。Windowsであれば、インストーラをダブルクリックするだけで、
  設定が完了してしまいます。
  

• Trac Lightning のインストール。

  Trac Lightning 使っちゃうと、一から色々と関連ソフトウェア
  入れるなんてアホらしくてできないね。
  

• TracLightning-2.0.0beta3

  てなわけで、Bate3を試したのですが、無事テストサーバで稼働しました。
  
  本番のプロジェクトをコピーして upgrade.batを実行したら、
  
  
  無事インポートもできました。
  ちなみに本番のTracLightはver1.1.2 なんですがね。
  すばらしい互換性です。
  

• Trac Lightning 2.0.0 Beta3

  Trac Lightning 2.0.0 Beta2 の不具合の解消を試そうと思ったら、
  Trac Lightning 2.0.0 Beta3 がリリースされていた＾＾；
  
  ＃仕事が速い！
  ...
  管理側としては管理方法が直感的になってるので、とてもウレシイ。
  本当にこんないいソフトを提供してくれてる開発者さんに感謝感謝！！
  

• Trac Lightningはヤバすぎる

  これはヤバい。使えすぎ。
  すごくインストールが簡単。3クリック。
  ...
  一緒にWikiは立っちゃうし、MavenとHudsonも一緒に入れれちゃう。
  一緒に入れれちゃうってことは、デフォルトで連携するってことで。
  WikiのユーザーとSubversionのユーザーと、Tracのユーザーは同一。
  

• Trac Lightningが凄い件

  会社で使っているオレオレ Trac を、半年ぶりくらいに新しいバージョンをインストールしてみた。
  チケットとカレンダとガントチャートの連携のすごさに吹いたwww
  何これ。普通にプロジェクトで使えるじゃん。見た目カッコいいじゃん。
  これなら会社でのマネージャー層への求心力も半端無いですよ！！
  Tracを使った事無い人は今すぐここからインストールだ！
  

• TracをUSBデバイスに入れて持ち運ぶ

  最近のTrac Lightning はどんどん見た目がきれいになっている。
  
  しかもカレンダーとガントチャートがキレイに表示されるので、
  インストールの手軽さから redMine から一歩抜きん出たカンジかな。
  

• trac lightning (月1.6.0)

  WINDOWSでTracやるならtracLightning最高ですよ！！！
  tracLightning使いたいからWINDOWSサーバ作ろうかってぐらいのノリですよ。
  

• Trac月でらくらく開発スタート

  OSSのツールは運用が無視だったり、日本語環境が充実していなかったりと、
  使う人を選びますが(と思う)、Trac月は本当に現場ですぐ使えるツールだと
  思います。
  

• 10分で使えるtrac「trac月」

  10分あればtracを使ったプロジェクト管理が開始できてしまう。
  

• Trac月(でぃべろっぱーず・さいど)

  Subversionとの連携がとれているという点やWebの管理画面
  から設定が行えるのはポイントが高いですね。この辺の設定は
  結構苦労しがちなところなので。
  

• Second Wave

  Trac月（Trac-Light）が一番いいんじゃないかな。ということで
  USBメモリにTrac月を入れてみた。
  

• 個人的にはTortoiseGITが欲しい

  TortoiseSVNとTrac月を使っているが、DEATH MARCHで新世界の神に
  なれるかもしれないとは思う。
  

• kareの日記

  All-In-One Tracと比べると後発なだけあってこちらの方が
  ずいぶんと良い．
  これからは，WindowsでTracを使うなら迷わずTrac月がお奨め！
  

• ＷＥＢ版えんどぅー

  で、そんなこんなして見つけたのが Trac月
  
  すごい、たったの数分で環境が一気に整った！(笑
  すごすぎて、思わず笑みがこぼれますよ、これは！！
  

紹介サイト

下記のサイトで紹介されています。

• 入門Trac with Subversion
• Mylyn＆Tracでリズムに乗ってタスクを大掃除♪
• バージョン管理に便利なSubversiveプラグイン

Trac Lightningの特徴

タスクの作業履歴を管理可能

タスク(故障処理、課題解決も含みます)に対する作業履歴をコメントとして残すことができます。これにより、作業過程を明確にすることができます。

SVNとの連携

例えば、○×実装やバグ解決と言ったタスクがあったとします。SVNと連携し、そのタスクの実行過程でソースコードがどのように修正されたのか、タスクと紐づけることができます。

オールインワンパッケージ

構成管理ツールであるSubversionと、シンプルな使い易さと拡張性によるカスタマイズによる簡単な機能追加を両立させたTrac、それらを動作させるために必要なApache、Python、SQLite等のミドルウェアを一式含んでいます。直ぐに導入することができます。

インストールが極めて単純

MS製品並にインストールが簡単です。WindowsXPに簡単にインストールすることができます。インストール操作自身は1分程で完了します。インストール後、直ぐご利用頂くことができます。

WebのGUIで設定可能

デフォルトのTracでもWebでの管理機能が含まれていますが、機能的に貧弱です。Trac Lightningは管理機能を強化し、必要な設定項目は概ねWebから設定できるようになっています。もちろん、設定ファイルを直接書き換えることによる変更にも対応します。

プロジェクト作成機能

プロジェクト作成機能を提供し、SubversionとTracのリポジトリを簡単に作成することができます。

Mavenとサンプルプロジェクトを同梱

MavenとMaven用のサンプルプロジェクトを用意しており、簡単にMavenを試すことができます。また、Apache Continuumも一緒に同梱し、Apache Continuumによる継続的インテグレーションも直ぐに試すことができます。Javaによる開発を行わない場合は、インストールしないことも可能です。

Tracとは、Subversionと連携するプロジェクト管理ツールです。Tracを利用することにより、故障管理、タスク管理、構成管理を行うことができます。これらを管理する要素はチケットと呼ばれ、チケットはSubversion、Wiki、他のチケットと連携することができます。Trac自身は、Ruby on RailsやSpringIDEの開発に利用されています。

その他、SQLite3コマンドラインで日本語を利用すると文字化けするバグを修正したりしています。

All In One Tracと何が違うの?

Tracのディストリビューションとして、All In One Tracがありますが、下記の点がAll In One Tracと異なります。

• TracのバージョンがAll In One Tracより新しいです(2007/01/01現在)。All In One Tracは0.9.x系ですが、Trac Lightningは0.11.x系を採用しています。
• SubversionのコミットメッセージをTracのチケットのコメントに追加することができます。SubversionとTracがより蜜に連携させることができます。
• Webの管理画面から様々な設定を簡単に行うことができます。
• プログラムメニューからサービスとして起動することができます｡
• Mavenを利用するためのテンプレートプロジェクトが用意されており、簡単にMavenを導入することができます。

Trac Lightningの改造について

• %TRAC_LIGHT_HOME%\python-libにpythonのライブラリが入っています。
• %TRAC_LIGHT_HOME%\svn\pluginsにTracのプラグインが入っています。

%TRAC_LIGHT_HOME%ディレクトリで、

> bin\post-install.bat C:\TracLight  (C:\TracLightはTracLightningをインストールしたディレクトリ名)

デバッグなどで動的に変更を反映させる場合は、%TRAC_LIGHT_HOME%\python\Lib\site-packagesディレクトリ以下のファイルを変更すると便利ですが、post-install.batを実行するとファイルが上書きされてしまうので、ご注意ください。

利用方法

プロジェクトの作成

かおるんさんの新規プロジェクトの作成方法をご覧ください。

Trac/SVNのURL

http://<ホスト名>/tracにアクセスすると、利用可能なプロジェクト一覧が表示されます。各プロジェクトのSVNリポジトリは、 http://<ホスト名>/svn/<プロジェクト名>でアクセスすることができます。デフォルトでは、SampleProjectプロジェクトが作成されています。

ユーザアカウント

また、デフォルトのユーザアカウントとして、下記の2つが利用できます。

デフォルトのパスワードを変更するには、それぞれのユーザ名でTracにログインして、画面右上の「My Account」のリンクをクリックしてパスワードを変更します。新しいアカウントを作成するには、adminでログインし、メニュの「Admin」から「Accounts/Users」を選択します。ユーザアカウントは全てのプロジェクトで共有されていますが、アクセス権は、各プロジェクト毎に設定することができます。必要に応じて権限の設定を行ってください。

TracとSubversionのアカウントは共通で、%TRAC_LIGHT_HOME%\projects\trac.htdigestファイルにhtdigest形式で格納されていますが、通常意識する必要はありません。

各種コマンド

Subversion、Tracの各種コマンドを利用したい場合は、プログラムメニューの「Trac」→「コマンドプロンプト」を実行し、表示されたコマンドプロンプトからコマンドを実行します。 Python、Subversion、Apacheの各コマンドとカスタムスクリプトを利用することができます。カスタムスクリプトの説明を下に示します。

create-project.bat

プロジェクトを作成するコマンドです。引数にプロジェクト名を設定することで、SVNのリポジトリとTracのプロジェクトを作成します。使用例を以下に示します。

> create-project.bat MyProject

Tracに表示されるタイトルを変更したい場合は、adminでTracにログインし、Adminメニューの「trac.ini/project」のnameの設定を変更します。

trac-admin.bat

trac-adminコマンドを実行するスクリプトです。利用方法はtrac-adminと同じです。説明は省略します。

あとは、一般的なTracの記事を参照してください。

create-servercert.bat

SSLを利用するためのサーバ証明書を作成します｡実行すると証明書の情報を聞いてくるので､適当に入力します｡Common Nameだけはアクセスされるホストのホスト名にして下さい｡https://<ホスト名>/でSSLでアクセス出きるようになります｡Common Nameとホスト名が異なると､Subversionに正しくアクセスできないので注意してください｡ 証明書が作成できたら､http.confを次のようにへんこうします｡

#LoadModule ssl_module modules/mod_ssl.so

LoadModule ssl_module modules/mod_ssl.so

SVNリポジトリのアクセス権限の設定

SVNリポジトリのアクセス権の設定は、%TRAC_LIGHT_HOME%\projects\svnauthzで行うことができます。SVNの機能により、ユーザグループ毎に各リポジトリ、ディレクトのアクセス権を細かく設定することができます。

バックアップ

プログラムメニューの「Trac」→「バックアップ」を選択すると、TracとSVNリポジトリのバックアップを行うことができます。バックアップした backupディレクトリは他のマシンの共有フォルダにコピーしたり、メディアに書き込んだりしてマシンの故障に備えましょう。

カスタマイズ

• カスタマイズメモ

Mavenの利用

リポジトリへのアップロード

Trac Lightningをインストールしたサーバ上で下記のように実行すると、サンプルプロジェクトで作成したライブラリをMavenのリポジトリへインストールすることができます。

> svn co http://localhost/svn/SampleProject/LibraryProject/trunk
> cd trunk
> mvn deploy -Dtest=false

リポジトリの利用

サンプルWebProjectは、LibraryProjectで生成したライブラリをmavenリポジトリからダウンロードしてプロジェクトをビルドします。サンプルWebProjectをビルドするには下記のようにします。

> svn co http://localhost/svn/SampleProject/WebProject/trunk
> cd trunk
> mvn package

• http://localhost/maven/

レポートの作成

次のようにすると、mavenのリポートが作成されます。

> svn co http://localhost/svn/SampleProject/LibraryProject/trunk
> cd trunk
> mvn site-deploy

その他情報

• TracLightningリリースプロセス
• TracLightning Hacking Guide
• Trac月の開発情報

Wiki ドキュメント

• Wiki の文法 - SourceForge.jp Wiki の文法一覧
• リンクの種類と文法 - さまざまな方法でリンクを生成できます
• ブロックプロセッサ - ブロックの書式指定によってハイライトなどができます
• 拡張文法 - ファイルの埋め込み等、特殊機能を持つ文法一覧

このページでは、TracLightningをソースコードからコンパイルする方法やカスタマイズする方法を説明しています。カスタマイズしたTracの配布や、TracLightningの開発に参加したい方は、このページをご覧ください。

ソースコードの閲覧

最新のソースコードは下記のBitBucketから取得できます。

• https://bitbucket.org/okamototk/traclightning

過去のコードは、下記のリポジトリから取得してください。

• 2.x以前のコード(git)
  • http://git.sourceforge.jp/view?p=traclight/traclightning.git
• 3.0～3.0.6のコード(Subversion)
  • https://svn.sourceforge.jp/svnroot/traclight/branches/tl3_0/

※コミッタの方は、gitとsubversionにはコミットしないでください。

ビルドについて

TracLightningは、インストーラにInnoSetupを利用しています。開発は、主にISToolを利用しています。ISToolをマシンにインストールしてtrac.issをISToolで開くとビルドスクリプトを編集可能です。

メッセージが文字化けしていますが、trac.issの日本語メッセージを編集するときは、他の日本語に対応したエディタで開いて編集してください。

Trac Lightningのインストールの仕組み

ここでは、Trac Lightningのインストールの仕組みについて解説します。実質install\post-install.batファイルがその役割を担っています。C:\TracLightディレクトリに移動して

install\post-install.bat C:\TracLight

• installディレクトリ
  • インストールスクリプトや、置き換える設定ファイルなど。install\replaceディレクトリには内部を置換するファイルが置いてあります。trac.ini.inはTracのグローバル設定ファイル、trac.ini.defaultは各プロジェクト固有の設定ファイルとなっています。
• python-libディレクトリ
  • Pythonのアプリケーション、ライブラリ等が入っています。trac-jaはパッチを当てた状態でコピーされているので、差分を知りたい場合はオリジナルと差分を取ってください
• pluginsディレクトリ
  • Tracのプラグインが入っています。
• projectsディレクトリ
  • 各プロジェクトのファイルが入っています。
• python
  • Python本体が入っています。ただし、TracLightningインストールスクリプト実行後はアプリケーション、ライブラリやプラグインがインストール済みの状態になっています。
• binディレクトリ
  • 各種実行ファイルが入っています。create-project.batなど環境依存の実行ファイルはpost-install.batスクリプト実行後に作成されます。

ざっとこんな感じです。それなりに知識があれば、この情報を元にインストールスクリプトを解析することができるでしょう。

プラグインの追加

TracLightningを利用していて、プラグインの不足を感じることがあると思います。TracLightningをカスタマイズした他の担当に配布したい場合、TracLightning自身にプラグインを追加しておくと便利です。プラグインの追加は、次のようにして行います。

プラグインのコピー

plugins\svnディレクトリにプラグインをコピーする。

インストールスクリプトへの追加

trac.issに次のようにしてプラグインをインストーラを含める設定を記述します。(XXXXXの箇所がプラグインのディレクトリ名になります)

Source: plugins\svn\xmlrpcplugin\*; DestDir: {app}\plugins\svn\xmlrpcplugin; Flags: recursesubdirs sortfilesbyextension; Excludes: *.pyc,*.pyo,.svn\*,\build\*,\dist\*,\*.egg-info\*
Source: plugins\svn\tracjsganttplugin\*; DestDir: {app}\plugins\svn\tracjsganttplugin; Flags: recursesubdirs sortfilesbyextension; Excludes: *.pyc,*.pyo,.svn\*,\build\*,\dist\*,\*.egg-info\*
Source: plugins\svn\XXXXXX\*; DestDir: {app}\plugins\svn\XXXXXX; Flags: recursesubdirs sortfilesbyextension; Excludes: *.pyc,*.pyo,.svn\*,\build\*,\dist\*,\*.egg-info\*
Source: backup.bat; DestDir: {app}\

ビルド対象に追加

build.cmdに下記のようにして、ビルド対象に追加します。

for %%i in (
   ....
    tracsubticketsplugin newwikipagebutton tracdragdropplugin tracjsganttplugin
    XXXXXXX
) do (

trac.iniへの追加

デフォルトでプラグインを有効にしたい場合、trac.iniにプラグインの設定を記述します。Trac全体で設定を行いたい場合と、各プロジェクト毎に設定を変えたい場合で設定場所が異なります。

プロジェクト全体への設定

install\replace\trac.ini.in にプロジェクト全体の設定を追加します。componentsセクションでプラグインの有効化の設定の他、プラグイン個別の設定も個々に追加します。ここで行った設定は、全てのプロジェクトへ反映されます。

プロジェクト個別の設定

install\trac.ini.defaultとinstall\trac.ini.agileでプロジェクト個別の設定を行います。defaultは通常のプロジェクトでagileはアジャイル用のプロジェクトを作成したときに設定されます。プロジェクト全体への設定と同じようにcomponentsセクションやその他の設定を追加してください。

なお、必ずしも全ての人が必要としないプラグインの場合、プラグインのインストールだけ行って、trac.iniへcomponentsの設定を追加しなければ、後でプラグインを有効化したユーザのみそのプラグインを使えるようになります。

TracLightning3.0.0からは以前のバージョンからTracとPythonがバージョンアップになっています。そのため、従来のTracLightningに上書きインストールしても正しく動作しない場合があります。基本的には、スクラッチからインストールしてください。そうは言っても新しいTracLightningへ古いプロジェクトを移行したい方も居るでしょう。そんな人のために非公式ドキュメントとしてプロジェクトのアップグレード方法を解説します。

アップデート時の注意

projectsディレクトリのバックアップを取っておいて、新しいTracをインストール後、バックアップしたprojectsディレクトリを基に戻します。
その後、Tracにアクセスした際に表示されるメッセージに基づきDBとWikiのUpgradeを行ってください。

日付フィールドについて

日付フィールドは、2.x以前はdecoratorプラグインで行っていましたが、3.0からdatepickerプラグインを利用するようになりました。
trac.iniに下記のように「フィールド名.date/date_empty」を設定してください。

[ticket-custom]
due_assign = text
due_assign.date = true
due_assign.date_empty = on
due_assign.label = 開始予定日
due_assign.order = 0
due_close = text
due_close.date = true
due_close.date_empty = on
due_close.label = 終了予定日
due_close.order = 1
complete = text
complete.label = 進捗率(%)
complete.order = 2

Subversionについて

アップグレードするとSubversionが動作しないことがあるようです。詳細は、下記のスレッドをご覧ください。

• http://sourceforge.jp/ticket/browse.php?group_id=2810&tid=24143

レポートについて

Trac本体の0.11から0.12へのバージョンアップに伴い、チケット関連のテーブルが仕様変更になっています。
具体的には登録日時と更新日時等(created, modified, date, time)の日時関連のカラムをミリ秒まで格納するようになりました。(参照：Microsecondtimestamps)
この影響でレポート中のSQLで日付のカラム(created, modified, date, time)をdateやstrftimeなどの日付関連の関数で変換している場合には、変換元の値を1000000で割らなければ日付関数での変換が出来なくなっています。

レポート表示の為の整形については後述する列名による表示整形で対処可能ですが、比較条件として日付を処理している場合には注意が必要です。

具体的にdate関数の場合には

0.11以前： date(time,'unixepoch','localtime')
0.12以降： date(time/1000000,'unixepoch','localtime')

とする必要があります。

strftime関数の場合にはさらに注意が必要で、直接値を割るとレポートでエラーとなってしまうため、一旦date関数で変換後に再変換を行う必要があります。

0.11以前： strftime('%Y/%m/%d', time,'unixepoch''localtime') 
0.12以降： strftime('%Y/%m/%d', date(time/1000000,'unixepoch','localtime'))

この仕様変更に伴いTracLightning3.0.0に含まれるTrac-0.12.1.ja1では、レポート機能での列名による表示整形を日本語対応しています。
列名による表示整形では列名の末尾が 時刻 で終わるカラムはtimeとして、 日付で終わるカラムは date として、 日時 で終わるカラムは datetime に、それぞれ整形されます。
列名を整形規則に合わせた場合には自動的に整形されるためSQLの関数での表示用の整形が不要になっています。
表示整形についての詳しい内容については、インストールしたTracに同梱のwiki TracReportsを参照してください。

以下執筆中。

不具合について

メニューのチケットから登録するか、ここに記述してください。

Tracプラグイン

3.0.6現在

TODO(メモ)

• (DONE)Trac0.12.1のバグ修正を取り込む。
• (DONEexcelreportを反映させる。
  • jun66j5さんのプラグインを取り入れる
  • http://github.com/jun66j5/tracmsofficexmlplugin/blob/master/
• (DONE)BurndownChartプラグインの日本語化
  • 翻訳完了(未ミット)
• (DONE)Staticsプラグインを削除
• (DONE)フォーラムをデフォルトプラグインから外す
  • 日本語化は中止
• (DONE)UserManagerプラグインの日本語化
• (DONE)メール送信を修正し、添付ファイルと変更者名が表示されるようにする。
• (DONE)timingandestimateプラグインの翻訳改善

連絡票

• ~peerreviewplugin,stractisticsは削除の方向で。~
• ~svnauthzadminpluginとtimingandestimatepluginはtrac-hacksのものはgenshiを使うように変更されている。~

開発情報

3.0.0alpha(コードネーム:TagBoat)の開発状況について記述していきます。

現在3.0.0alpha5では

<pythonとライブラリ(tracプラグイン除く)>

python	2.6.6(win)
trac	0.12.ja1	~レポートをCSVで出力すると文字化け。~
genshi	0.6
babel	0.9.5
Setuptools	0.6c11
svn-python	svn-win32-1.6.6_py26
xlrd	0.7.1
simplejson	2.1.1	Python2.6から標準でjsonのライブラリを含む。削除の方向で。completeuserプラグインがsimplejsonに依存しているので注意。
Pygments	1.3.1
docutils	0.7
configobj	4.7.2
pywin32	pywin32-214.win32-py2.6
feedparser	4.1
pyExcelerator	0.6.3a
clearsilver	削除	windowsでClearSilverをbuildするにbuild方法とpython2.6/win用neo_cgi.pydを置いてます。
mod_python	削除

<その他の同梱アプリケーション>

CollabNetSVN	Subversion1.6.6/Apache2.2.14(Win32))
Hudson	1.353	install\replace\hudson.bat.inがないとインストールスクリプト実行時にエラーがでる。要確認。
maven	|2.2.1
SQLite	3.5.9
mod_wsgi	mod_wsgi-win32-ap22py26-3.3.so

<動作確認OS>

OS	動作状況(○/×/△/未)	スクラッチ/上書き	備考
Windows XP	○	スクラッチ	ベータ3で確認
Windows Vista 32bit	未
Windows Vista 64bit	未
Windows 7(32bit)	○	スクラッチ
Windows 7(64bit)	未
Windows Server 2003(32bit)	未
Windows Server 2003(64bit)	未
Windows Server 2008(32bit)	未
Windows Server 2008(64bit)	未
Windows Server 2008 R2(32bit)	未
Windows Server 2008 R2(64bit)	未

という構成になってます。

※まだtracやプラグインなどには未確認の事項が多いです。
　協力していただける方で、動作報告などありましたら
　スレッド名:Trac Lightning3.0.0alphaについてまでよろしくお願いします。

プラグイン動作

現時点で導入するプラグインは決定してませんが、
現状(3.0.0alpha4)で同梱しているプラグインの動作は以下のとおりです。

※1…3.0.0beta1では時間はかかるが復帰できた。何に時間がかかっているのか調べたら
最初に開始予定を入力した直後が時間がかかっていてlogを出したらerrorがでていた。

パフォーマンスチューニング

• ~ログレベルは、DEBUGからINFOに変更。~
• ~余計な画面でwysiwygプラグインのJavaScriptを読まないようにする(パッチ済み。jun66j5さんの返答まち)~
• ~Decoratorプラグインは遅いので削除。カレンダーの部分だけ抜き出すかDateFiledプラグインを使う~(rev.54)
• ~TicketSubmitPolicyは動作が重くなる上、使われているかどうかわからないので無効にする。~
• jQueryの競合問題により中止。jqueryのautocompleteプラグインがdatefieldプラグインに当たっている?CompleteUserプラグインは、YahooUIを利用しているが、jQueryに統一するため、jQuery UI AutoCompleteに置き換える。

その他trac全体の動作

• チケット登録やチケットに対する変更・コメント追加などを行うと「警告: チケットは作成しましたが、通知処理中にエラーが発生しました: "change" not defined 」が表示される。→trac.iniのticket_subject_templateの定義「ticket_subject_template = $prefix #$ticket.id: [$change.author] $summary」に入ってる「change」が問題(使用できる変数でない)になっているようだ。[$change.author]を削除すると出なくなる。次回リリースで修正。→notificationの設定は今のままでいい？
• 「DeprecationWarning: the md5 module is deprecated; use hashlib instead import md5」というメッセージが出る。python2.6で入ってる。当面そのまま。

影響するバージョン

• 2.4.2以前のバージョン。このセキュリティホールは2.5.0以降では修正されています。
• リポジトリのアクセス権限を設定していない場合、もしくは全てのユーザがリードできる環境では影響は受けません。

概要

TracLightningのリポジトリブラウザでは、ユーザ/グループ毎にリポジトリの各ディレクトリへのアクセス制御ができるようになっています。しかしながら、TracLightning2.4.2以前のバージョンでは、複数のユーザでリポジトリへのアクセスを繰り返していると、下記のような問題が生じます。

• アクセス権を許していないユーザでもディレクトリを閲覧できてしまうことがある
• アクセス権を持つユーザがディレクトリを閲覧できないことがある

上記の影響はTracのリポジトリブラウザ上での問題のため、Subversionのリポジトリ自身への影響はありません。

原因

Trac内部でリポジトリを保持するオブジェクトをキャッシュしていますが、認証ユーザの情報の引き継ぎが正しく行われておらず、以前の認証ユーザ情報を保持したまま、他のユーザへのリポジトリ表示処理にリポジトリオブジェクトを利用してしまうためです。

解決方法

TracLightningのインストールディレクトリの下のpython\share\trac\conf\trac.iniの下記の行を

repository_type = svn

repository_type = direct-svnfs

TracLightning 2.2.5のリリースについて

TracLightning 2.2.0～2.2.3以前のバージョンには、クエリーが利用できないなどTracのパフォーマンスを発揮できないバグがあります。2.2.5以降への速やかなバージョンアップをお勧めします。

アップグレード時の注意

2.0から2.1/2.2へのバージョンアップについて

TracLightning2.0のプロジェクトをTracLightning2.2へ移行するには、カスタムフィールドの設定を変更する必要があります。 詳細は、かおるんダイアリーの下記の記事を参考にしてください。

• TL 2.0.9 から TL 2.1 への更新の際に、開始日、終了日の入力項目が消える

2.0から2.1/2.2へのバージョンアップについて

TracLightning2.0のプロジェクトをTracLightning2.2へ移行するには、カスタムフィールドの設定を変更する必要があります。 詳細は、かおるんダイアリーの下記の記事を参考にしてください。

• TL 2.0.9 から TL 2.1 への更新の際に、開始日、終了日の入力項目が消える

TracLightningの機能が肥大化し、テストでバグを潰し切れずリリース時にバグの混入が目立つようになってきました。 趣味で適当に開発するには限界に達して来たため、リリースプロセスを定めることとします。

αリリース

極めて不安定なバージョン。開発者が動作確認を行うために利用する。大きなアーキテクチャ変更(trac0.10->trac0.11などの変更)があった場合、α版をリリースしテスターを募る。

βリリース

不安定なバージョン。開発者が動作確認を行うために利用する。TracやApacheを自力でインストールする知識があれば、不具合があっても自力で解決し運用で利用することができるレベル。Trac Lightningのマイナーバージョンアップ以降はまずはβ版をリリースする。

RCリリース

リリース候補(Release Candidate)バージョン。βリリースを行った後1週間以上クリティカルなバグが発生しない場合、RCリリースとすることができる。1週間以内にリリースするのにクリティカルなバグや機能追加要求があった場合、RC2,RC3とRCのバージョンをインクリメントする。

正式リリース

一般ユーザ向けのリリース。RCリリース後、1週間以上クリティカルなバグが発生しない場合、RCリリースから正式リリースへ昇格することができる。新しいRCリリースを行った場合、最後のRCリリースから1週間以上待つこととする。

リリースの作成方法

trac.issの下記の行を書き換え、バージョンを変更する。

[Setup]
..
AppVerName=Trac Lightning 2.2.4

[project]
footer=Powerd by<br />Trac Lightning<br />Version 2.2.4

新規インストール

TracLight-x.x.exeをクリックして実行するだけです。インストール終了後、コンピュータを再起動してください｡再起動後、プログラムメニューのTracから｢サービスとして実行｣もしくは､｢コマンドプロンプトから実行｣を選択すると､Apacheが起動します｡ http://localhost/にアクセスして動作を確認してください。より詳しく知りたい方は、discypusさんのサイトをご覧ください。

TracLightningはデフォルトで80番と8980番のポートを利用します。インストール時の注意として、IISやApache等のWebサーバが起動していないことを確認してください。起動している場合は、停止もしくはアンインストールしておいてください。Trac月をインストールするとマシンを再起動するので再起動後、インストール済みのIISやApacheが自動的に起動しないようにしておく必要があります。また、PythonやSubversionを既にインストールされている場合、これらのアプリケーションの環境が変更されるので注意してください。分からない場合は、PythonやSubversionをコントロールパネルのプログラムの追加と削除からアンインストールしておくことをお勧めしておきます (プログラムの追加と削除に表示されていない場合はアンインストールする必要はありません)。

プロジェクトデータの配置位置の変更

プロジェクトデータは、TracLightをインストールしたディレクトリの下のprojectsディレクトリの下にあります。

ディレクトリ/ファイル名	説明
maven/	Mavenリポジトリ
trac/	Tracのプロジェクトデータ
svn/	SVNのリポジトリ
trac.htdigest	Trac/SVNのユーザ認証情報
svnauthz	SVNの認証設定

プロジェクトデータを別のディレクトリに置く場合は、CollabNetSVN/httpd/conf/httpd.confを次のように書き換えます。下記の例は、D:\projectsに置く場合です。

<LocationMatch "/[^/]+/login">
  AuthType Digest
  AuthName trac
  AuthDigestFile "D:\projects\trac.htdigest"
  Require valid-user
</LocationMatch>

# PythonDebug On 
ScriptAlias /trac "D:\TracLight\apache2\cgi-bin\trac.cgi"
<Location "/trac">
#  SetEnv TRAC_ENV_PARENT_DIR "D:\projects\trac"
  SetHandler mod_python
  PythonHandler trac.web.modpython_frontend
  PythonOption TracEnvParentDir "D:\projects\trac"
  PythonOption TracUriRoot /trac
</Location>

<Location "/svn">
  DAV svn
  SVNParentPath "D:\projects\svn"
  AuthType Digest
  AuthName trac
  AuthDigestFile "D:\projects\trac.htdigest"
  Require valid-user
  AuthzSVNAccessFile "D:\projects\svnauthz"
</Location>

Alias /maven "D:\projects\maven"
<Directory "D:\projects\maven">
    Options Indexes
</Directory>

Alias /report "D:\projects\report"
<Directory "D:\projects\report">
    Options Indexes
</Directory>

create-project.batを実行したときのディレクトリの位置は変更できないので、下記の2つのディレクトリをそれぞれコピーしてください。

• C:\TracLight\projects\svn\<プロジェクト名>
• C:\TracLight\projcets\trac\<プロジェクト名>

バージョン1.xからのアップグレード

Trac Lightningは上書きインストールすれば自動的にアップグレードされるように設計されています。 しかしながら、Trac月/Trac Lightning 1.xからTrac Lightning2.xへアップグレードする際に一部のファイルが自動でアップグレードすることができなくなってしまいました。次のように手動でファイルを書きかえる必要があります。

Trac Lightning2.xインストール後、Trac Lightningのインストールディレクトリでupgrade.batを実行します。

C:\TracLight>bin\upgrade.bat

[inherit]
file = C:\TracLight\python\share\trac\conf\trac.ini

また、Apacheの設定ファイルの場所が%TRACLIGHT%\apache2\conf\httpd.confから%TRACLIGHT%\CollabNetSVN\httpd\httpd.confに変更になっています。必要に応じて設定ファイルをコピーする等してください。

All In One Tracからの移行

All In One Tracを既にお扱いの方は、ここの手順に従い移行してください。All In One TracからTrac月へ移行時のポイントは次の通りです。

• ディレクトリ構成が異なる
• Trac月はHTTPの認証にDigest認証を利用しているが、All In One TracはBasic認証である。
• Trac月はtrac0.10を採用しているが、All In One Tracは0.9(trac-admin upgradeが必要)
• All In One Tracはpython2.3だが、Trac月はpython2.4(キャラクタセットの名前が異なる)

このポイントを抑えておけば、それほど難しくありません。まず最初に、 All In One Tracのプロジェクトのファイルをコピーします。All In One Tracのデフォルトプロジェクトの例で示すと下記の通りとなります。

tracのtrac.iniファイル(projects\trac\default\conf\trac.ini)を次のように変更します。

...
#default_charset = japanese.ms932   変更前
default_charset = cp932             変更後
...
#templates_dir = C:\trac-0.1.1\python\share\trac\templates 変更前
templates_dir = C:\TracLight\python\share\trac\templates   変更後
...
#repository_dir = C:\trac-0.1.1\svn_repo\projects\default  変更前
repository_dir =C:\TracLight\projects\svn\default         変更後
...
# 以下追加
[account-manager]
password_format = htpasswd
password_store = HtPasswdStore
password_file = C:/TracLight/projects/trac.htpasswd

[inherit]
file = C:\\TracLight\\python\\share\\trac\\conf\\trac.ini

プログラムメニューの「Trac」->「コマンドプロンプト」でコマンドプロンプトを起動し、次のようにして、Tracのデータベースのアップグレード、SVNリポジトリとの再同期、htpasswdファイルのコピーを行います。

> trac-admin.bat C:\TracLight\projects\trac\default upgrade 
> trac-admin.bat C:\TracLight\projects\trac\default resync

Apacheの設定(httpd.conf)をBasic認証を利用するように変更します。

...
  AuthType Digest
  AuthName trac
  AuthDigestFile "C:\TracLight\projects\trac.htdigest"
...

  AuthType Basic
  AuthName trac
  AuthUserFile "C:\TracLight\projects\trac.htpasswd"
...

Apacheのサービスを再起動します。他にもプロジェクトがある場合は、同等の手順で移行します。うまくいかない場合は、下記のサイトにAll In One Tracから移行した際のメモがありますので、こちらも参考にしてください。

• All In One Trac から Trac Lightning への移行

Trac Lightning 2.0では、1.8系に比べ大幅な機能追加がなされています。これからTrac Lightningをご利用される方は是非2.0をご利用ください。画面キャプチャがかおるんさんの体験レポートにありますので、こちらもご覧ください。

• Trac 0.11、Subversion1.5対応
  • TracとSubversionのバージョンを最新化しました。最新の機能を余すことなくご利用頂けます。
• ワークフロー機能
  • Trac Lightning 1.8まではnew-assigned-closeの3ステータス固定でした。2.0からは、確認などのステータスを追加したり、クローズをリーダしか行えないようにしたり、ワークフローをカスタマイズできるようになりました。権限や業務フローの規定が厳しめのプロジェクトでもご利用頂けます。また、AdvancedTicketWorkflowPluginを同梱することにより、デフォルトのTrac0.11よりも高度なワークフローのカスタマイズができるようになっています。
• パーミッション設定時のユーザ補完
  • 管理ツールのユーザへのパーミッション設定時にもユーザの補完ができるようになりました。管理者の負担を下げることができます。
• Subversionアクセス権設定ファイル編集機能
  • 管理ツールにSubversionのアクセス権を直観的に編集する機能を追加しました。面倒なSubversionのアクセス権の設定を簡単に行えます。
• パスワード変更機能
  • 各ユーザが自由にパスワードを変更することができるようになりました(なんで今までできなかったんだろうという感じですが)
• チケットの一括変更
  • カスタムクエリーの画面で選択した複数のチケットの属性を一括して変更可能です。
• Subversionのライトスルーキャッシュ機能
  • Subversionで分散構成を取る際にライトスルーキャッシュを利用できるようになり、大規模な開発でも利用できるようになりました。チェックアウト、コミットをスレーブのリポジトリへ行うことができます。コミット時には、スレーブのサーバからマスターのサーバへ自動的にコミット、同期が取られます。チェックアウト時はスレーブのサーバからチェックアウトするので、マスターのサーバへは負荷を掛けません。

Subversion1.5.0の新機能については、Subversion 1.5.0 リリースをご覧ください。

decoratorセクションのcalednar_fieldsにカレンダ機能を付与するフィールドを設定します。

[decorator]
calendar_fields=due_assign,due_close,custom_field

ユーザ名補完フィールドの追加

カスタムフィールドにユーザ名補完機能を追加する場合は、次のようにします。

[complete-user]
# 一人のユーザを補完
single_fields=reviewer
# カンマ区切りで複数のユーザを補完
compotite_fields=reviewers

補完ウィンドウの表示タイミングの調整

環境によっては、チケットの担当者欄や関係者欄の補完ウィンドウの表示が速すぎたり遅すぎたりして入力しずらいことがあります。下記のようにtrac.iniに設定を記述して補完ウィンドウの表示タイミングを調整します。

[complete-user]
popup_delay=1