phabricator 项目管理平台
前言:以前都用的gerrit,感觉也是挺好用的,结合jenkins可以自动verify,也可以通过jenkins进行自动部署.但是phabricator不一样,它是全套自带.在好用完善的同时,界面风格与用户体验方面也是足足甩了gerrit一条街.(其实感觉SVN对小团队要好一点,用git的developer老是几天才提交一次代码...)
目录:
- setup base
- install phabricator
- create project & repo
- setup code review
- extra explain
- auto lint
- auto unit test
- auto deploy
setup base
这里主要参考phabricator的官方文档.例如 installation_guide, install_rhel-derivs, configuration_guide
上次我们搭建了两台服务器,143开发服务器,配置了git,php,nginx.144数据库服务器,配置了mysql等.所以我就不重头搭建了,我安装的软件基本都是较新的,如果使用系统自带的yum源的话,可以直接yum install httpd git php php-cli php-mysql php-process php-devel php-gd php-pecl-apc php-pecl-json php-mbstring mysql-server完事.
install phabricator
我这里参照了那个官方给出的shell脚本,将没有完善的东西继续安装完毕.
#mkdir /phabricator
#cd phabricator
#git clone https://github.com/phacility/libphutil.git
#git clone https://github.com/phacility/arcanist.git
#git clone https://github.com/phacility/phabricator.git
#yum install php56w-cli php56w-mysql php56w-pdo php56w-process php56w-devel php56w-gd php56w-opcache php56w-mbstring
#php -m原始的安装是这样的yum install httpd git php php-cli php-mysql php-process php-devel php-gd php-pecl-apc php-pecl-json php-mbstring mysql-server 需要哪些扩展一定要添加上去,apc我们用opcache代替.
// 配置数据库
#cd /phabricator/phabricator
#./bin/storage upgrade
#./bin/config set mysql.host 192.168.1.144
#./bin/config set mysql.user root
#./bin/config set mysql.pass 123456这里就直接用root密码了,phabricator会创建1mol多的数据库,没错,是数据库.
#./bin/storage upgrade用不了多久,数据库就安装完成了.
SELECT count(*) FROM SCHEMATA WHERE SCHEMA_NAME LIKE 'phabricator%';
嗯,新建了57个数据库.
#cd /etc/nginx/conf.d
#vim
/*
server {
listen 8090;
charset utf-8;
server_name 192.168.1.143;
root /phabricator/phabricator/webroot;
location / {
index index.php;
rewrite ^/(.*)$ /index.php?__path__=/$1 last;
}
location = /favicon.ico {
try_files $uri =204;
}
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;
}
}
*/
#service nginx reload
#service php-fpm restart打开浏览器访问192.169.1.143:8090,注册管理员账号
yongliu
yongliu
1234!@#$
1234!@#$
yongliu@tjut.cc设置一下时区与系统时间
#yum install -y ntpdate
#mv /etc/localtime /etc/localtime.bak
#cp /usr/share/zoneinfo/Asia/Shanghai /etc/localtime
#ntpdate us.pool.ntp.org
#date根据web平台的提示,修复其他issue,这里只记录了部分,因为有点多.
#cd /phabricator/phabricator/
#./bin/config set phabricator.base-uri 'http://192.168.1.143:8090/'
#mkdir -p '/var/repo/'
#./bin/phd restart启用phd后台进程,我们这里使用root进行启动
#cd /phabricator/phabricator/
#./bin/phd help
#./bin/phd start配置ssh
#useradd -m -s "/bin/bash" sshpha
#whereis git-upload-pack
#vim /etc/sudoers
/*
sshpha ALL=(root) SETENV: NOPASSWD: /usr/bin/git-upload-pack, /usr/bin/git-receive-pack, /usr/bin/hg, /usr/bin/svnserve
*/
#vim /etc/shadow
/*
#sshpha:!!:16696:0:99999:7:::
sshpha:NP:16696:0:99999:7:::
*/
#./bin/config set phd.user root
#./bin/config set diffusion.ssh-user sshpha
#vim /etc/ssh/sshd_config
/*
#Port 22
Port 222
*/
#cp phabricator/resources/sshd/phabricator-ssh-hook.sh ssh/
#cp phabricator/resources/sshd/sshd_config.phabricator.example ssh/sshd_config
#vim ssh/sshd_config
/*
AuthorizedKeysCommand /phabricator/ssh/phabricator-ssh-hook.sh
AuthorizedKeysCommandUser sshpha
AllowUsers sshpha
# You may need to tweak these options, but mostly they just turn off everything
# dangerous.
Port 22
Protocol 2
PermitRootLogin no
AllowAgentForwarding no
AllowTcpForwarding no
PrintMotd no
PrintLastLog no
PasswordAuthentication yes
RSAAuthentication yes
PubkeyAuthentication yes
AuthorizedKeysFile %h/.ssh/authorized_keys
PidFile /var/run/sshd-phabricator.pid
*/
#vim ssh/phabricator-ssh-hook.sh
/*
#!/bin/sh
# NOTE: Replace this with the username that you expect users to connect with.
VCSUSER="sshpha"
# NOTE: Replace this with the path to your Phabricator directory.
ROOT="/phabricator/phabricator"
if [ "$1" != "$VCSUSER" ];
then
exit 1
fi
exec "$ROOT/bin/ssh-auth" $@
*/
#service sshd restart
#/usr/sbin/sshd -f /phabricator/ssh/sshd_config
/*error happend when openssh version is 5.3 not 6.2*/这里系统自带的openssh-server是5.3的,而phabricator需要的某些sshd配置项只有6.2才用.这里就走上了漫长的openssh升级之路.主要是参照了这篇文章upgrade openssh for centos6.5.
升级完毕,我们先杀死自己配置sshd然后重启.
#ps -ef | grep sshd
#kill 15 xxxpid
#/usr/sbin/sshd -f /phabricator/ssh/sshd_config刚才配置的sshd是需要通过publicKey登录的，所以我们切换成sshpha用户并生成其ssh-key,这里就不写相关的命令了.
然后通过脚本创建web平台登录的用户sshpha.
#./phabricator/bin/accountadmin
/*
创建sshpha用户
sshpha
1234!@#$
OLD VALUE NEW VALUE
Username sshpha
Real Name sshpha
Email sshpha@163.com
Password Updated
Bot N N
Admin N N
*/创建好用户后,登录web平台,将刚才生成的ssh-key粘贴到ssh public key配置中,按钮是设置那个.
最后通过ssh测试是否配置成功.
#ssh -T sshpha@192.168.1.143
/*
phabricator-ssh-exec: Welcome to Phabricator.
You are logged in as sshpha.
You haven't specified a command to run. This means you're requesting an interactive shell, but Phabricator does not provide an interactive shell over SSH.
Usually, you should run a command like `git clone` or `hg push` rather than connecting directly with SSH.
Supported commands are: conduit, git-receive-pack, git-upload-pack, hg, svnserve.
*/显示ssh配置成功.下面开始配置项目,并进行code review.
create project & repo
我们使用管理员账号yongliu登录web平台.
创建项目比较简单,点击左侧的Project即可显示创建按钮.一步一步跟着提示创建就可以了.
然后是创建repo,点击左侧的Diffusion,即可显示创建按钮.这里我们添加sshpha的push权限.
创建完毕,我们同步项目.
$cd /home/sshpha
$git clone ssh://sshpha@192.168.1.143/diffusion/TEST/server-test.git
$cd server-test
$vim aa.txt
/*
aaaaaaaaaaaaa
bbbbbbbbbbbbb
*/
$git add -A
$git config --global user.email "sshpha@163.com"
$git config --global user.name "sshpha"
$git commit -m "for test"
$git branch
$git push origin master我们到web平台查看一下,就会发现该repo的代码是更新了的.这里就有一个问题,没有code review!怎么行!所以最后我们将code review加上.
我们先取消sshpha用户的push权限,在Diffusion编辑repo就可以了. 然后我们push代码的话,就会发现没有push的权限了.
setup code review
这里的code review跟github还不太一样,github是fork别人的项目到自己的主页,我们这里的开发可不能随意创建工程或者说fork工程的.所以这里用的是Differential应用完成的.
首先使用diff生成diff文件.
$vim aa.txt
/*
ddddddddd
ggergeragea
gaergeragearg
ge34yr834
*/
$git diff > ../diff.outsshpha用户登录web平台,点击Differential创建一个diff,上传diff文件.然后生成Revisions,并指定yongliu为reviewer.上传完成后切换成yongliu登录.查看该Revisions,然后确认该Revisions后,该次sshpha的修改就自动合并带仓库中去了.
extra explain
可能有很多的概念性的东西理解的不是很清楚,我们慢慢梳理.
下面接着的是使用phabricator的Lint(代码质量分析),Unit test(单元测试)和Auto deploy(代码自动部署).