Redmineにはリポジトリとの連携が可能なので現場では良く使われています。
そこで勉強がてらに、BitnamiのRedmineのオールインワンパッケージとSVNクライアントソフトのTortoiseSVNで作成したリポジトリを使った、ApacheのBasic認証でのRedmine連携手順のメモを記載したいと思います。
目次
- 前提条件
- Redmineオールインワンパッケージのインストール
- TortoiseSVNのインストール
- リポジトリの作成
- Subversionの設定
- Redmineのプロジェクトに紐付け
- 参考文献
前提条件
- OS：Windows
- Redmineのバージョン：2.3.3-1
- TortoiseSVNのバージョン：1.8.8
Redmineオールインワンパッケージのインストール
以下のURLより手順にそってRedmineをインストールします。【Redmineのインストール手順（All in one windows）】
TortoiseSVNのインストール
以下のURLより手順にそってTortoiseSVNをインストールします。【TortoiseSVNのインストール手順】
リポジトリの作成
RedmineのSubversionでコマンドをうってもいいのですが、TortoiseSVNを使ってリポジトリを作った方が簡単なので、ここではTortoiseSVNを使ったリポジトリの作成の仕方を記載します。- 任意の場所に空のフォルダを作成し、フォルダの中で右クリックし「ここにリポジトリを作成」をクリックします。
- これでリポジトリの完成です。
Subversionの設定
Redmineのオールインワンパッケージを次へ次へでインストールするとSubversionとApacheが自動的にインストールされます。そのApacheのconfファイルにSubversionと連動する設定情報を記載します。
今回は、Subversionの設定情報は別ファイルに分ける方法をここで記載します。
{REDMINE_HOME}はRedmineのインストールされているフォルダなので適宜変更してください。
- デフォルトでSVNと連動するモジュールの設定は出来ているのですが、念のため確認しておきます。
Apacheフォルダ（{REDMINE_HOME}/apache2/conf）に保存されているhttpd.confを開き、以下のモジュールが記載されていることを確認します。
LoadModule dav_svn_module modules/mod_dav_svn.so LoadModule authz_svn_module modules/mod_authz_svn.so
ここで先頭に「＃」が記載されていたら、コメントアウトされている状態になっているので外してあげます。
これによりSubversionにHTTPで通信できるようになります。 -
今回は、Subversionの設定ファイルを別にしたいのでhttpd.confに以下を付け加えます。
Include "{REDMINE_HOME}/apache2/conf/extra/httpd-svn.conf" - 次に先ほどhttpd.confでIncludeした場所に「httpd-svn.conf」を作成します。
- 作成したらファイルを開き、以下の内容を記載します
# Subversion <Location /svn> DAV svn # enable view for repositories parent directories SVNPath "D:/test/svn" #SVNParentPath "D:/test" #SVNListParentPath On # read/write accesses force Basic auth AuthType Basic AuthName "Subversion repository" AuthUserFile {REDMINE_HOME}/apache2/conf/.htpasswd.svn Require valid-user </Location>- LocationでURLのパスを定義します。
- DAV svn でバックエンドとしてSubversionを使うようにします。
- SVNPathでリポジトリが保存されているフォルダを設定します。尚、複数のレポジトリを定義する場合は、SVNParentPathに親ディレクトリを指定します。
- AuthTypeでユーザ認証をBasic認証と定義します
- AuthNameでパスワード入力のダイアログで表示される文字列を定義します。
- AuthUserFileで認証に必要なユーザとパスワードが保存されている一覧の場所を定義します。
- Require valid-userで認証が通った全ユーザに対してのアクセスを許可します。
- 次にBasic認証で使うユーザとパスワードを上記「AuthUserFile」で定義した場所と名前で作成します。
G:\BitNami\redmine-2.3.3-1\apache2\bin>htpasswd -c svnpasswd user1 New password: ***** Re-type new password: ***** Adding password for user user1 G:\BitNami\redmine-2.3.3-1\apache2\bin>htpasswd svnpasswd user2 New password: ***** Re-type new password: ***** Adding password for user user2 G:\BitNami\redmine-2.3.3-1\apache2\bin>
-c オプションで新しくファイルを作るという意味になります。
その後ユーザを追加するには-cを取ったコマンドを入力すると追加されます。 - apacheを再起動します。
Redmineのプロジェクトに紐付け
RedmineのプロジェクトにRedmineメニューから先ほどApacheと紐付けたリポジトリを認識させます。- 紐付けたいプロジェクトにログインします。
- 「設定」タブから「リポジトリ」をクリックし、「新しいリポジトリ」をクリックします。
- 以下の情報を入力し、作成ボタンをクリックします。
- バージョン管理システム：Subversion
- メインリポジトリ：取りあえずチェック
- 識別子：「test」チケットやWikiからリポジトリを指定してリンクを行う際に使用します。
- URL：「http://localhost/svn」apacheで設定したLocationのURLを入力します。
- ログイン：Basic認証の設定で作成したユーザ名を入力します。
- パスワード：Basic認証の設定で作成したパスワードを入力します。
- 上手くいっていれば、「リポジトリ」をクリックするとリビジョン１が表示されます。
