关于Phabricator部署时候的疑难点

Phabricator的搭建

首先是关于Phabricator的搭建问题,由于我们这里对于Phabricator的目的只是CodeReview,于是我把Phabricator部署在了我们的打包机器上,我用的是Mac OSX。

关于Phabricator的基本安装使用方法可以查询这份基础的官方文档.

Phabricator是一款LAMP (Linux, Apache, MySQL, PHP) 应用,我们需要在服务器上部署上述的环境;推荐大家去看下面这篇文章,这是一篇详细安装Phabricator的教程,推荐使用XAMPP来安装上述的运行环境,这样对于小白来说会比较方便,XAMPP基本上提供了主流的操作系统版本,Windows、Linux、Solaris、Mac OS X都是支持;
基本按照上面的教程可以很顺利的安装上Phabricator;

还有就是安装的时候可能会出现端口号冲突的问题,因为我的服务器上原来装了Jekins,现在装了Phabricator,我把8080端口给了Jekins,80端口给了Phabricator。

Phabricator本身提供了付费服务,可以直接使用,缺点就是每年都要付费而且需要翻墙出去;所以自己部署是一个很好的选择;

基本上按照上面的教程可以顺利的完成安装;

启动Phabricator

按照上述的教程我们可以顺利打开Phabricator,注册完管理员账号以后,Phabricator会提示你很多的警告,基本上上面的警告很多都是需要解决的,但是一小部分可以忽略,并不影响我们的使用。

  • No Authentication Providers Configured
    You have not configured any authentication providers yet. You should add a provider (like username/password, LDAP, or GitHub OAuth) so users can register and log in. You can add and configure providers using the Auth Application.

你需要选择一个或者多个登录注册方式,Phabricator支持多种方式的登录注册,包括账号密码,LDAP,第三方账号授权登录等等;由于默认情况下没有Providers,所以你需要设置一种登录注册方式,我这里只选择了Username/Password方式,你可以根据自己的要求进行配置。

  • 没有配置phabricator.base-uri没有配置

需要通过bin/config set phabricator.base-uri <value>进行设置,也就是你当前服务器的地址。

  • Small MySQL "max_allowed_packet"
    On host "localhost", MySQL is configured with a small "max_allowed_packet" (1048576), which may cause some large writes to fail. The recommended minimum value for this setting is "33554432".

my.cnf文件中,修改max_allowed_packet字段,默认为1M,我们需要修改为32M。

  • MySQL May Run Slowly
    Database host "localhost" is configured with a very small innodb_buffer_pool_size (16 MB). This may cause poor database performance and lock exhaustion.
    There are no hard-and-fast rules to setting an appropriate value, but a reasonable starting point for a standard install is something like 40% of the total memory on the machine. For example, if you have 4GB of RAM on the machine you have installed Phabricator on, you might set this value to 1600M.

my.cnf文件中,修改max_allowed_packet字段,默认为16M,我们需要修改1600M;

  • MySQL STRICT_ALL_TABLES Mode Not Set;On database host "127.0.0.1", the global sql_mode is not set to STRICT_ALL_TABLES. It is strongly encouraged that you enable this mode when running Phabricator.

对于事务表,当启用STRICT_ALL_TABLES或STRICT_TRANS_TABLES模式时,如果语句中有非法或丢失值,则会出现错误。语句被放弃并滚动。

my.cnf文件中,添加sql_mode=STRICT_ALL_TABLES字段;

  • PHP Extension "APCu" Not Installed
    Installing the "APCu" PHP extension will improve performance. This extension is strongly recommended. Without it, Phabricator must rely on a very inefficient disk-based cache.

PHP版本也很烦,首先apc不支持PHP5.4级以下的版本,貌似只支持PHP7.0以上,但是Phabricator又不支持PHP7.0,所以搞得很烦,最后下载了一个XAMMP的7.1.2版本;

如果你使用了XAMMP,那么你必须保持PHP版本在7.0以上,然后使用sudo /Applications/XAMPP/xamppfiles/bin/pecl install apc
就可以了,安装完成以后在php.ini中添加extension=apcu.so就可以了。

  • Phabricator Daemons Are Not Running
    The Phabricator daemons are not running, so Phabricator will not be able to perform background processing (including sending email, rebuilding search indexes, importing commits, cleaning up old data, and running builds).

我们需要启动后台的phd服务,否则无法发送邮件,清理旧数据,构建搜索索引等等;

 ./bin/phd start

可能会报ERROR: The PHP extension 'pcntl' is not installed. You must install it to run daemons on this machine.

这个问题相当的麻烦,主要的流程可以Google xammp 安装pcntl插件;然后遇到的坑事,首先要保证PHP对应的版本与pcntl的版本一致,
其次是在php.ini中添加extension=pcntl.so的时候可能还是会报上面的这个错,原因就是对应的php.ini的文件不对,可以通过查看php -i的命令,查看Loaded Configuration File是否为nono,它可能找到的并不是XAMMP目录下的文件,因为环境变量中启动的php是在/etc这个目录下,所以要找到对应的正确关系。

  • Missing Repository Local Path
    The directory for local repositories (/var/repo/) does not exist, or is not readable by the webserver. Phabricator uses this directory to store information about repositories. If this directory does not exist, create it:

我们手动创建这个存放代码仓库的目录:mkdir -p '/var/repo/'
同时需要设置对应的config里面的key, ./bin/config set repository.default-local-path /var/repo/

Phabricator使用文档
  • 安装浏览器通知服务
    安装通知服务,需要安装Node.js模块,去官网安装下载就可以;接下来需要安装ws(npm install ws),等两者都安装结束以后,我们就需要运行如下命令:
bin/aphlict start

如果你没有安装pcntl,如果没有安装pcntl的话就会报错,安装pcntl的教程可以参考上面。

  • 安装Email的配置

配置mail:通过web访问phabricator并在页面上进行配置:
用administrator账号登录后,在administration栏选择Config进入
1)选择mail,设置:
metamta.default-address -- fucking@163.com // 注意:这里必须要用与smtp服务器对应的邮箱地址,不然邮件发不出去
metamta.domain -- phabricator.myproject.com //改不改无所谓,我用的是默认的
metamta.mail-adapter: set to "PhabricatorMailImplementationPHPMailerAdapter" //修要修改
metamta.send-immediately: Send Via Daemons //需要修改
2)选择PHPMailer,设置:
phpmailer.mailer: set to "smtp". //需要修改
phpmailer.smtp-host: smtp.163.com //填写你的163邮箱的smtp地址!
phpmailer.smtp-port: 25 //修要修改
phpmailer.smtp-user: fucking //你邮箱的用户名
phpmailer.smtp-password: fuck //你邮箱的密码
配置完毕后,可以在Administration-MetaMTA下进行发送邮件的测试,注意需要添加一个User组用户,无法直接向System Agent组用户发送邮件 (我没有检测因为没找到地方!)

同时需要配置metamta.default-address的地址就是你的邮箱地址;

  • 配置.arcconfig文件

首先需要安装Arcanist的源码拷贝到本地,

  1. somewhere git clone git://github.com/facebook/libphutil.git
  2. somewhere git clone git://github.com/facebook/arcanist.git

将arc的路径加入到系统路径中

export PATH=$PATH:/somewhere/arcanist/bin/

arc配置

配置arc的默认编辑器,我使用vim

arc set-config editor "vim"

配置默认的phabricator的uri,uri为团队的phabricator主页的url

arc set-config default http://phabricator.example.com

在项目的根目录下建.arcconfig配置文件,文件中至少要填入以下内容

{
  "project_id" : "your project name",
  "conduit_uri" : "your phabricator url"
}

为项目安装证书,用于phabricator的认证

arc install-certificate

找到your_phabricator_url/conduit/token/ 填入对应的token。

关于lint的配置

我们需要在.arcconfig文件中增加一个配置,load字段,下载OC代码需要对应的lint资源,https://github.com/vhbit/clang-format-linter

{
  "project_id" : "your project name",
  "conduit_uri" : "your phabricator url",
  "load" : ["/somewhere/clang-format-linter"]
}

同时需要在添加.arclint以及自定义配置的.clang-format文件;

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 206,126评论 6 481
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 88,254评论 2 382
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 152,445评论 0 341
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 55,185评论 1 278
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 64,178评论 5 371
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,970评论 1 284
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,276评论 3 399
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,927评论 0 259
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 43,400评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,883评论 2 323
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,997评论 1 333
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,646评论 4 322
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,213评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,204评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,423评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,423评论 2 352
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,722评论 2 345

推荐阅读更多精彩内容

  • 目录0x10 概述0x20 我的应用环境0x30 路线图0x40 安装0x41 LNMP环境的安装0x42 Pha...
    zhangweiheb阅读 60,410评论 36 62
  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,599评论 18 139
  • rljs by sennchi Timeline of History Part One The Cognitiv...
    sennchi阅读 7,292评论 0 10
  • 官网地址 点此前往 功能简介 支持 MacOS Windows Linux 老爷、用户等级、勋章等级标识同步B站原...
    荼蓼子阅读 49,234评论 13 16
  • 2018年2月19日,星期一,晴。 “明天我们也去看海鸥,好吗?”柳眉看到朋友圈里大家都在晒图,雪白的海鸥或游泳,...
    春山雨阅读 441评论 10 15