Phabricator部署
概述
Phabricator是由facebook开发的一套集任务追踪、文档、代码库、文件存储等功能于一体的开源软件，功能较为完善，对于创业公司、小公司乃至大公司而言都是一个非常好用的管理工具，本篇文章便对phabricator的部署方法作一些介绍。
部署
Phabricator由php语言编写并通过常用的web server来提供服务，大多数流行的linux操作系统应该都是可以用于部署的，本篇使用的是Centos7。
PHP安装
软件包安装
Phabricator要求必须使用PHP5，推荐使用5.6版本，为此先将remi库加入到yum的repo中，这里直接从网上找了一个包下载安装，有些系统也可以直接通过yum安装。
wget http://rpms.famillecollet.com/enterprise/remi-release-7.rpm
rpm -Uvh remi-release-7.rpm
然后启用remi库中的php56子库，找到enable值并设置成1。
vim /etc/yum.repos.d/remi.repo
[remi-php56]
enabled=1
接下来就可以安装一系列依赖的php软件包了。
yum install php php-common php-mbstring php-iconv php-mysql php-curl php-pcntl php-gd php-apc php-xhprof pcre-devel php-pear php-fpm php-pecl-zendopcache python-pygments php-phpoffice-phpexcel
配置用户
由于一般git服务器都是通过git这个用户来提供服务的，所以这里我们也先创建一个git用户，系统默认会将同名的组git也创建好，并且将用户git加入到了组git中。
useradd git
接下来把启动php-fpm的用户和组也都设置成git。
vim /etc/php-fpm.d/www.conf
user = git
group = git
安装web服务器
这里选择了使用nginx来提供web服务，先安装nginx，然后按照phabricator安装文档上的说明修改配置文件。
yum install nginx
vim /etc/nginx/nginx.conf
user git git;
worker_processes 4;
error_log /var/log/nginx/error.log;
pid /run/nginx.pid;
include /usr/share/nginx/modules/*.conf;
events {
worker_connections 1024;
}
http {
log_format main '$remote_addr - $remote_user [$time_local] "$request" '
'$status $body_bytes_sent "$http_referer" '
'"$http_user_agent" "$http_x_forwarded_for"';
access_log /var/log/nginx/access.log main;
sendfile on;
tcp_nopush on;
tcp_nodelay on;
keepalive_timeout 65;
types_hash_max_size 2048;
include /etc/nginx/mime.types;
default_type application/octet-stream;
include /etc/nginx/conf.d/*.conf;
server {
server_name phabricator.aorise.org;
root /home/git/phabricator/webroot;
location / {
index index.php;
rewrite ^/(.*)$ /index.php?__path__=/$1 last;
}
location /index.php {
fastcgi_pass localhost:9000;
fastcgi_index index.php;
#required if PHP was built with --enable-force-cgi-redirect
fastcgi_param REDIRECT_STATUS 200;
#variables to make the $_SERVER populate in PHP
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
fastcgi_param QUERY_STRING $query_string;
fastcgi_param REQUEST_METHOD $request_method;
fastcgi_param CONTENT_TYPE $content_type;
fastcgi_param CONTENT_LENGTH $content_length;
fastcgi_param SCRIPT_NAME $fastcgi_script_name;
fastcgi_param GATEWAY_INTERFACE CGI/1.1;
fastcgi_param SERVER_SOFTWARE nginx/$nginx_version;
fastcgi_param REMOTE_ADDR $remote_addr;
}
}
}
Phabricator安装
代码获取
phabricator是github上的一个开源项目，所以需要先安装git。
yum install git
然后切换到我们刚才创建的git用户，在主目录下将phabricator的几个代码库都clone下来。
su git -
cd ~
git clone https://github.com/phacility/libphutil.git
git clone https://github.com/phacility/arcanist.git
git clone https://github.com/phacility/phabricator.git
数据库配置
Phabricator使用一个mysql数据库来存储元数据，可以选择一个公共的mysql服务，这里选择了本地部署。首先安装mysql并且启动，然后初始化。
yum install mariadb-server mariadb-client
systemctl enable mariadb
systemctl start mariadb
mysql_secure_installation
接下来配置phabricator使用本地的mysql，创建一个定制化的配置文件，注意配置文件后缀必须使用.conf.php
cd phabricator
mkdir conf/custom
vim conf/custom/mysql.conf.php
<?php
return array(
'mysql.host' => 'localhost',
'mysql.port' => '3306',
'mysql.user' => 'root',
'mysql.pass' => '',
);
将配置文件加入到phabricator的配置中，这里省略后缀。
echo custom/mysql > conf/local/ENVIRONMENT
最后让phabriator进行初始化。
./bin/storage upgrade
启动服务
现在phabricator已经配置好了，启动web服务器就可以使用了。
systemctl start nginx
systemctl start php-fpm
systemctl enable nginx
systemctl enable php-fpm
然后通过浏览器打开部署phabricator的服务器地址即可。刚进去的时候会有许多warning警告，一般都是配置不完美造成的，根据提示修改配置文件即可。
代码库配置
因为代码库的设置要更加繁琐和特别，所以phabriator不会自动安装好代码库，还需要一些人工的操作。
配置用户
官方文档推荐使用几个不同的用户来实现不同的功能，这里比较偷懒，直接用刚才创建的git用户来完成所有功能好了，先给予git用户所有的sudo权限。
vim /etc/sudoers
git ALL=(ALL) NOPASSWD: ALL
然后给git用户一个shell界面，将shadow文件中git用户的!!替换成NP。
vim /etc/shadow
git:NP:17136:0:99999:7:::
还要在/etc/passwd中确保git用户是有shell登录界面的。
vim /etc/passwd
git:x:1000:1000::/home/git:/bin/bash
配置phabricator
然后设置phabricator来使用这个用户，并且指定代码库的端口，因为22号端口已经被服务器的ssh服务使用了，所以这里使用2222号端口。
su git -
cd /home/git/phabricator
./bin/config set phd.user git
./bin/config set diffusion.ssh-user git
./bin/config set diffusion.ssh-port 2222
开启ssh服务
最后开启代码库的ssh服务，phabricator已经给出了样例文件，复制到一个常用的地方然后将文件中的用户和路径修改成实际的值就行了。
cp /home/git/phabricator/resources/sshd/phabricator-ssh-hook.sh /usr/libexec/phabricator-ssh-hook.sh
vim /usr/libexec/phabricator-ssh-hook.sh
VCSUSER="git"
ROOT="/home/git/phabricator"
cp /home/git/phabricator/resources/sshd/sshd_config.phabricator.example /etc/ssh/sshd_config.phabricator
vim /etc/ssh/sshd_config.phabricator
AuthorizedKeysCommandUser git
AllowUsers git
启动服务。
/sbin/sshd -f /etc/ssh/sshd_config.phabricator
其他
Phabricator的code review（代码评审）功能在另外一个单独的库arcanist中，并且是可以直接使用的，唯一要注意的是，需要给nginx的路径配置上足够的访问权限，不然会报错。
chmod +x /var/lib/nginx
chmod +x /var/lib/nginx/tmp
chmod +x /var/lib/nginx/tmp/client_body
参考资料
- 官方文档首页：https://secure.phabricator.com/book/phabricator/article/installation_guide
- 数据库配置：https://secure.phabricator.com/book/phabricator/article/advanced_configuration
- 基础配置：https://secure.phabricator.com/book/phabricator/article/configuration_guide
- 代码库配置：https://secure.phabricator.com/book/phabricator/article/diffusion_hosting
