Debian Linux 架設 Trac + Virtual Host

Trac + SVN + Virtual host 設定一起搞定, 先寫比較清楚的版本, 之後再來改寫簡易版.

首先 Subversion + HTTP(apache2) 存取, 請見: Debian Linux 架設 Subversion(SVN)

假設現在已經可以由 http://DOMAIN_NAME/svn/PROJECT_NAME/ 做 ci/co 等動作, 且 svn 目錄建在 /home/svn/repository.

安裝 trac: apt-get install trac libapache2-mod-python(有一堆相關的會自動幫你裝上), 預設會裝: trac python python-central python-clearsilver python-minimal python-pysqlite2 python-subversion python-support python2.4 python2.4-minimal 等 package.
mkdir -p /home/trac/PROJECT_NAME
trac 初始化設定, 安裝於 /home/trac: trac-admin /home/trac/PROJECT_NAME initenv, 會問
- Project Name => PROJECT_NAME
- Path to repository => /home/svn/repository/PROJECT_NAME
- 其它都 enter 按過即可.

於是就會產生:

設定 /home/trac/PROJECT_NAME/conf/trac.ini 語系:

修改權限並測試看看之前設定是否都正確:

chown www-data:www-data -R /home/trac/PROJECT_NAME
sudo -u www-data tracd --port 8000 /home/trac/PROJECT_NAME # 執行啟動應該就可以用 http://DOMAIN_NAME:8000/ 存取(如果這個不能存取, 有可能是設定設錯了(注意 repository path 設定), 此處一定要先可以存取, 再做整合 apache 的動作)

設定 apache, 讓 http://DOMAIN_NAME/trac/PROJECT_NAME 可以直接存取.

直接存取, 不設 Virtual Host: vim /etc/apache2/conf.d/PROJECT_NAME.conf

SetHandler mod_python PythonHandler trac.web.modpython_frontend PythonOption TracEnv "/home/trac/PROJECT_NAME" PythonOption TracUriRoot "/trac/PROJECT_NAME" <LocationMatch "/trac/[^/]+/login"> AuthType Basic AuthName "Trac" AuthUserFile /etc/apache2/dav_svn.passwd Require valid-user </LocationMatch> # 另一種寫法 #<Location "/trac/login"> # AuthType Basic # AuthName "Trac" # # 跟 svn account 同一個檔即可. # AuthUserFile /etc/apache2/dav_svn.passwd # Require valid-user #</Location>
這樣子 /etc/init.d/apache2 restart 應該就可以 http://DOMAIN_NAME/trac 連到了.

於 VirtualHost 情況下設定檔如下: vim /etc/apache2/sites-enbaled/PROJECT_NAME.conf

<VirtualHost *>     ServerAdmin webmaster@localhost     DocumentRoot /home/trac     ServerName VIRTUAL_HOST_NAME     ErrorLog /var/log/apache2/trac-error.log     CustomLog /var/log/apache2/trac-access.log combined

    SetHandler mod_python
    PythonHandler trac.web.modpython_frontend
    PythonOption TracEnv "/home/trac/PROJECT_NAME"
    PythonOption TracUriRoot "/trac/PROJECT_NAME" # 注意: 此處是 URI
    <LocationMatch "/trac/[^/]+/login">
      AuthType Basic
      AuthName "Trac"
      # 跟 svn account 同一個檔即可.
      AuthUserFile /etc/apache2/dav_svn.passwd
      Require valid-user
    </LocationMatch>
</VirtualHost>
正規方法應該是先寫在 /etc/apache2/sites-available/PROJECT_NAME.conf
再 ln -s /etc/apache2/sites-available/PROJECT_NAME.conf /etc/apache2/sites-enabled/PROJECT_NAME.conf 會比較好.
(如果 Virtual host 設在 conf.d 裡面, 就直接寫這個檔案即可 /etc/apache2/conf.d/PROJECT_NAME.conf)
這樣子 /etc/init.d/apache2 restart 應該就可以 http://VIRTUAL_HOST_NAME/trac/PROJECT_NAME 連到了.(主要是要一台機器控管多個 Trac)

往後如果 trac 有升級(apt 升級), 都執行 trac-admin /home/trac/PROJECT_NAME upgrade 來升級即可.

附註: (其它功能設定)

Trac 有任何修改都寄信出來:

Trac 安全權限設定:

trac-admin /home/trac/PROJECT_NAME permission
trac-admin /home/trac/PROJECT_NAME permission list # 看有哪些權限能開
trac-admin /home/trac/PROJECT_NAME permission remove anonymous '*' # 這樣子預設沒登入就不能進入 Trac
trac-admin /home/trac/PROJECT_NAME permission add USERNAME TRAC_ADMIN
trac-admin /home/trac/PROJECT_NAME permission list # 可以看到 USERNAME 設為 TRAC_ADMIN 的訊息
chown -R www-data:www-data /home/trac/PROJECT_NAME

參考文件:

Tsung: 對新奇的事物都很有興趣, 喜歡簡單的東西, 過簡單的生活.