ようこそTrac Lightningの世界へ
上記メニューからTracのプロジェクトとSubversionのリポジトリへのアクセス、(Jenkinsをインストールしていれば)Jenkinsへのアクセス、Tracの全てのプロジェクトの横断検索ができます。
デフォルトではユーザ名admin、パスワードadminで管理者権限でログインできます。ユーザ名guest/パスワードguestでログインすると一般ユーザ権限でログインできます
TracLightningはWiki、チケット管理、構成管理、継続的インテグレーション、ビルドシステムを総合的に組み合わせたプロジェクト管理ツールです。TracLightningは下記のような特徴があります。
一般的にプロジェクト管理ツールをセットアップするのは手間が掛る作業ですが、TracLightningはWindowsのインストーラにより非常に簡単にプロジェクト管理環境を構築することができます。
多くの開発現場で利用されている下記の標準的な開発ツールをプリセットアップしています。ユーザはTracLightningをインストールさえすれば下記のツールを簡単に利用することができます。
TracLightningはプロジェクト管理を行うための様々機能を包括して提供します。機能が沢山あるため難しいと思われるかも知れませんが、必要な機能から使い始めることができます。例えば、Wikiを利用したい場合、TracLightningのWikiを利用すれば通常のWikiと変わらず利用できます。Subversionのサーバを構築したい場合は、Subversionの機能のみを利用している人も沢山います。
TracLightningを利用すれば、まずは1機能のみから使い始めて、徐々に管理対象を広げていくことができます。WikiにPukiwikiを利用した場合、バグ管理やバージョン管理はできませんし、Subversionサーバ単独で構築した場合でも将来的にWikiによる情報共有やチケットによるバグ管理、課題管理まで広げることができます。
TracLightningはツールを適用するプロセスを選びません。アジャイルからウォータフォールまで多彩な開発プロセスで利用できます。ワークフローや管理項目はあなたの開発プロセスに応じたカスタマイズが可能です。
(デフォルトの設定では、どちらかと言えばアジャイルプロセスに向いています)
開発以外でも、運用か営業のタスク管理にも利用することができます。
カスタマイズ可能なクエリーやレポート、ガントチャートやカレンダー、バーンダウンチャートなど、様々なビューであなたのプロジェクトの見える化を促進します。更に各ビューはカスタマイズ可能であなたのプロジェクトで見たいビューでプロジェクトの状態を見ることができます。
また、ガントチャートやカレンダーが必要なければ無効にすることも自由にできます。
多くの中小企業で標準のプロジェクト管理ツールとして既に採用され運用されています。また、大企業の一部でも利用されており、社内標準ツールとしての普及促進が進んでいます。
カスタマイズ可能なクエリーやレポート、ガントチャートやカレンダー、バーンダウンチャートなど、様々なビューであなたのプロジェクトの見える化を促進します。更に各ビューはカスタマイズ可能であなたのプロジェクトで見たいビューでプロジェクトの状態を見ることができます。
また、ガントチャートやカレンダーが必要なければ無効にすることも自由にできます。
TracLightningはオープンソースソフトウェアとして、ソースコードを公開して提供しています。そのため、誰でもTracLightningの開発に参加することができます。参加とは、開発のみならず機能の要望を上げたり開発版を試験しています。
多くのユーザがTracLightningをカスタマイズしたノウハウは、TracLightningにフィードバックされより良いソフトウェアに進化させます。
TracLightningに関する情報は、Web上で簡単に手に入れることができます。
TracLightning-x.x.exeをクリックして実行するだけです。インストール終了後、
コンピュータを再起動してください。再起動後、プログラムメニューのTracから「サービスとして実行」もしくは、「コマンドプロンプトから実行」を選択すると、Apacheが起動します。
http://localhost/にアクセスして動作を確認してください。
インストール時の注意として、IISやApache等のWebサーバが起動していないことを確認してください。起動している場合は、停止もしくはアンインストールしておいてください。Trac Lightningをインストールするとマシンを再起動するので再起動後自動的に起動しないようにしておく必要があります。また、PythonやSubversionを既にインストールされている場合、これらのアプリケーションの環境が変更されるので注意してください。
分からない場合は、PythonやSubversionをコントロールパネルのプログラムの追加と削除からアンインストールしておくことをお勧めしておきます。
(プログラムの追加と削除に表示されていない場合はアンインストールする必要はありません)。
新しいTrac Lightningをバージョンアップしてインストールするには、まず、古いTrac Lightningをバックアップしておきます。
インストーラの実行の途中の「Apacheのhttpd.confを上書きする」のチェックボックスを外してインストールします。
インストールが完了したら、Trac Lightningのインストールディレクトの下のprojects\tracの下の各プロジェクトに対して、次のようにしてアップグレードを実行します。
> trac-admin.bat C:\TracLight\projects\trac\SampleProject upgrade
http://<ホスト名>/trac/にアクセスすると、利用可能なプロジェクト一覧が表示されます。各プロジェクトのSVNリポジトリは、
http://<ホスト名>/svn/<プロジェクト名>/でアクセスすることができます。デフォルトでは、SampleProjectプロジェクトが作成されています。
また、デフォルトのユーザアカウントとして、下記の3つが利用できます。
ユーザ名 | パスワード | 説明 |
---|---|---|
guest | guest | ゲストの開発者権限を持つアカウントです。チケットの操作など開発者のユーザ権限を持ちます。 |
admin | admin | 管理者アカウントです。TRAC_ADMIN権限があり、管理画面でTracの設定やユーザアカウントの作成等を行うことができます。 |
leader | leader | リーダ権限のアカウントです。ロードマップの編集などTracの機能機能をすべて利用できる権限を持ちます。 |
デフォルトのパスワードを変更するには、それぞれのユーザ名でTracにログインして、画面右上の「My Account」のリンクをクリックしてパスワードを変更します。
新しいアカウントを作成するには、adminでログインし、メニュの「Admin」から「Accounts/Users」を選択します。ユーザアカウントは全てのプロジェクトで共有されていますが、アクセス権は、各プロジェクト毎に設定することができます。必要に応じて権限の設定を行ってください。
TracとSubversionのアカウントは共通で、%TRAC_LIGHT_HOME%\projects\trac.htdigestファイルにhtdigest形式で格納されていますが、通常意識する必要はありません。
Subversion、Tracの各種コマンドを利用したい場合は、プログラムメニューの「Trac」→「コマンドプロンプト」を実行し、表示されたコマンドプロンプトからコマンドを実行します。
Python、Subversion、Apacheの各コマンドとカスタムスクリプトを利用することができます。
カスタムスクリプトの説明を下に示します。
プロジェクトを作成するコマンドです。引数にプロジェクト名を設定することで、SVNのリポジトリとTracのプロジェクトを作成します。
使用例を以下に示します。
> create-project.bat MyProject
tracのプロジェクトは、%TRAC_LIGHT_HOME%\projects\tracに、SVNのリポジトリは%TRAC_LIGHT_HOME%\projects\svnに作成されます。
Tracに表示されるタイトルを変更したい場合は、adminでTracにログインし、Adminメニューの「trac.ini/project」のnameの設定を変更します。
create-projectに下記のように引数をつけて実行すると、アジャイル開発向けのプロジェクトを作成することができます。
> create-project.bat /profile agile MyProject
trac-adminコマンドを実行するスクリプトです。利用方法はtrac-amdinと同じです。説明は省略します。
あとは、一般的なTracの記事を参照してください。
SSLを利用するためのサーバ証明書を作成します。実行すると証明書の情報を聞いてくるので、適当に入力します。Common Nameだけはアクセスされるホストのホスト名にして下さいhttps://<ホスト名>/でSSLでアクセス出きるようになります。Common Nameとホスト名が異なると、Subversionに正しくアクセスできないので注意してください。
証明書が作成できたら、http.confを次のように変更します。
#LoadModule ssl_module modules/mod_ssl.so
↓
LoadModule ssl_module modules/mod_ssl.so
設定が完了したら、Apacheを再起動します。プログラムメニューの「Trac」->「サービスのアンインストール」を選択後、「Trac」->「サービスのインストール」を選んでください。
コマンドプロンプトから起動している場合は、コマンドプロンプトを終了してもう一度立ち上げ直してください。
SVNリポジトリのアクセス権の設定は、%TRAC_LIGHT_HOME%\projects\svnauthzで行うことができます。SVNの機能により、ユーザグループ毎に各リポジトリ、ディレクトのアクセス権を細かく設定することができます。
プログラムメニューの「Trac」→「バックアップ」を選択すると、TracとSVNリポジトリのバックアップを行うことができます。バックアップしたbackupディレクトリは他のマシンの共有フォルダにコピーしたり、メディアに書き込んだりしてマシンの故障に備えましょう。
Trac Lightningをインストールしたサーバ上で下記のように実行すると、サンプルプロジェクトで作成したライブラリをMavenのリポジトリへインストールすることができます。
> svn co http://localhost/svn/SampleProject/LibraryProject/trunk
> cd trunk
> mvn deploy -Dtest=false
http://localhost/maven/でリポジトリへアップロードされたファイルを確認することができます。
サンプルWebProjectは、LibraryProjectで生成したライブラリをmavenリポジトリからダウンロードしてプロジェクトをビルドします。
サンプルWebProjectをビルドするには下記のようにします。
> svn co http://localhost/svn/SampleProject/WebProject/trunk
> cd trunk
> mvn package
サンプルWebProjectはTrac Lightningをインストールした別のマシンからもビルドすることができます。
別のマシンからビルドするには、Mavenのリポジトリの設定を書き換える必要があります。
プロジェクトルートにあるpom.xmlの下記の部分を書き換えればOKです。
<!-- localhost をこのサーバのホスト名に置換 -->
<url>http://localhost/maven/</url>
次のようにすると、mavenのリポートが作成されます。
> svn co http://localhost/svn/SampleProject/LibraryProject/trunk
> cd trunk
> mvn site-deploy
http://localhost/report/にアクセスすると、レポートを閲覧することができます。
ライセンス上必要な謝辞などを記述します。