Debian/Ubuntu架设nginx+bugzilla

题注

最近须要一个简单快速的bug追踪工具，考虑到系统环境以及学习成本，决定采用bugzilla。不试不知道，原来这里面还有这么多的坑须要一个个踩平~，遂随笔一下以备后用。

我采用的系统组成是debian+mysql+nginx+bugzilla，使用centos的亲可能须要注意nginx的安装方式和配置文件位置不同，须要灵活变通；至于使用apache的同窗，请参考其它文章设置转发部分。

1、安装nginx、perl-fpm、mysql

不一样于apache使用的cgi方式，nginx采用fcgi来调度php、perl等编程语言。因此咱们须要安装并配置perl的fpm。

安装

aptitude install nginx libfcgi-perl mysql-server

我原本想经过下载编译的方式安装fcgi(https://metacpan.org/pod/FCGI)不料安到一半发现发行版里居然有！因而乎瞬间采用更好的方案解决了。发行版里找不到这个包的同窗能够自行下载安装（nginx也是一个道理）

安装完后发现，这个lib没有启停脚本，因而上网上找了两个脚本安上去：

wget http://nginxlibrary.com/downloads/perl-fcgi/fastcgi-wrapper -O /usr/bin/fastcgi-wrapper.pl
wget http://nginxlibrary.com/downloads/perl-fcgi/perl-fcgi -O /etc/init.d/perl-fcgi
chmod +x /usr/bin/fastcgi-wrapper.pl
chmod +x /etc/init.d/perl-fcgi
update-rc.d perl-fcgi defaults
insserv perl-fcgi

执行完上述脚本后，咱们在/etc/init.d/里面安装了一个服务perl-fcgi，它将在开机后自动运行/usr/bin/fastcgi-wrapper.pl

配置

fastcgi-wrapper.pl调用libfcgi-perl并监听socket端口，nginx将经过该端口与之通讯。默认地址为127.0.0.1:9000。为了提高性能，我将其改成命名管道方式：

vim /usr/bin/fastcgi-wrapper.pl

找到原来的启动监听语句将其修改成：

$socket = FCGI::OpenSocket( "/tmp/perl-fcgi.sock", 10 );

保存后，启动perl-fcgi

service perl-fcgi start

若是启动失败，提示`account not available`，多是www-data用户被禁止登录，执行如下命令：

usermod -s /bin/sh www-data

 进入nginx的配置目录，建立配置文件：

cd /etc/nginx/sites-available
vim bugzilla

配置文件以下(将域名和端口替换成你的访问地址)：

server {
        listen          8008; # listening port
        server_name     bugzilla.example.com; # server name

        root            /var/www/bugzilla; # installation path

        location /skin/ {}
        location /js/ {}

        location / {
                include         fastcgi_params;
                fastcgi_pass    unix:/tmp/perl-fcgi.sock;
                fastcgi_index   index.cgi;
                fastcgi_param   SCRIPT_FILENAME $document_root$fastcgi_script_name;
        }
}

接下来，将配置文件连接到sites-enabled目录中，并启动应用（若是以前nginx已经启动，调用reload重载入配置文件）：

cd ../sites-enabled/
ln -s ../sites-available/bugzilla .
service nginx start

mysql的安装与配置在网上至关多，在此再也不赘述。

2、安装bugzilla

搞定了基础环境，接下来开始正式安装bugzilla

安装

从bugzilla.org下载并解压到/var/www

mkdir -p /var/www
cd /var/www
chown -R www-data .
wget http://ftp.mozilla.org/pub/mozilla.org/webtools/bugzilla-4.4.5.tar.gz
tar zxf bugzilla-4.4.5.tar.gz
mv bugzilla-4.4.5 bugzilla
cd bugzilla

配置

接下来须要对bugzilla进行配置。bugzilla依赖某些perl组件本机可能没有安装，而我在使用其自带的安装脚本时始终没法成功安装，网上搜索后找到一个解决方案是使用cpanm来安装。

下载并安装cpanm：

sudo curl -L http://cpanmin.us | perl - --sudo App::cpanminus

接下来咱们执行checksetup.pl来进行配置。配置过程当中checksetup.pl须要执行若干次以完成环境检查。第一次执行后，可能会提示有模块未安装，按照未安装的模块列表使用cpanm命令进行安装便可

perl checksetup.pl
cpanm YAML
cpanm DateTime
...

安装完成后，再次执行checksetup.pl，此时依赖模块应该都检查经过。若是有模块已安装但检查不到，能够尝试强制从新安装，如：

cpanm DateTime -f

模块检查经过后，checksetup.pl会提示mysql链接失败，咱们如今进入mysql配置用户与数据库：

CREATE database bugs default charset utf8 collate utf8_bin;
CREATE user bugs@localhost identified by 'bugs';
grant all on bugs.* to bugs@localhost;
flush privileges;

修改数据库配置：

vim localconfig

找到并修改如下项：

$webservergroup = 'www-data';

$db_pass = 'bugs';

注：若是使用远程数据库等，请自行进行配置用户名、密码等

至此，咱们完成了全部的配置。再次执行checkconfig.pl，会提示输入管理员邮箱和密码，并保存配置到数据库。

尝试打开你配置的访问地址（如：http://bugzilla.example.com:8008/)，若是能打开并排版显示正确，就代表能够访问了。