phabricator code review组件arcanist安装和使用

phabricator arcanist安装

一. 安装arcanist

1. 源码安装, 下载地址https://github.com/phacility/arcanist

   ln -s /xxx/arcanist/bin/arc /usr/local/bin/arc
   

   ubuntu系统可以使用apt-get install arcanist安装

2. 在项目根目录下创建.arcconfig文件, 并且编辑以下内容, uri为phabricator网址

   {
   	"phabricator.uri": "http://www.phabricator.com"
   }
   

3. 执行以下命令, 安装证书, 终端会有提示, 根据提示框找到对应的token

   arc install-certificate
   

二. phabricator实践

以下实践为develop分支必须经过code review流程, commit message包含@pass-review则跳过code review

1. 配置Herald(在phabricator搜索框中可以直接搜索到此组件)
   
2. 客户端尝试push到需要code review的分支, 出现小恐龙就表示成功啦

三. arcanist 常用命令

4. arc help // 查看详细帮助
5. arc diff //提交diff
6. arc land // 提交代码
7. arc list //查看有哪些revision和其状态

四. 使用注意事项

1. arc diff 必须是远端存在的分支, 否则不生效
2. arc land 可以强制push到远端
3. arc diff 必须都为要提交的内容, 不要diff的临时修改, 创建本地临时分支, 或者先git stash
4. 若存在没有accepted的diff, 执行arc diff命令会继续修改此diff, 也可以添加–create --update参数选择新增还是更新diff