用途:为当前分支的改动创建 YugabyteDB Phorge 评审(diff),适用于用户希望发布改动以供评审时。
主要能力:提交未提交改动;运行 ./build-support/lint.sh 检查;收集 issue 引用(GitHub issue 号或 JIRA 键)、组件与标题,可按需自动创建 GitHub issue 或 JIRA 工单;按 [<issue>] <Component>: <Title> 格式构造标题;确定订阅者(DB 代码加 ybase,YBA/平台代码加 yugaware,跨两者则都加);用 arc diff --create 创建 diff;发布 trigger jenkins 评论触发 CI;最后输出 diff URL、标题、订阅者及评论确认。
使用方式:需先安装并配置 arc(Arcanist)指向 YugabyteDB Phorge。工作流为:git status 检查并提交改动;运行 lint,有错误须先修复;逐步询问 issue 引用、组件、标题;确认订阅者;通过 --message-file 传入标题与正文(不修改本地提交标题),典型命令为 arc diff --create --message-file <path> --reviewers <reviewers> --cc <subscribers> <base>;随后用 arc 发布 trigger jenkins 评论,例如 echo "trigger jenkins" | arc call-conduit differential.createcomment -- '{"revision_id": "<id>", "message": "trigger jenkins"}'。
限制与注意:Phorge 视为公开,diff 标题、摘要、测试计划、评论、提交信息、代码、测试、fixtures、golden 输出与文件名均不得包含客户标识、PII、未匿名化的客户 schema 或查询、密钥凭证、未公开内部信息;测试 IP/主机名须用文档范围(如 192.0.2.0/24、2001:db8::/32、example.com)。客户报告仅从内部来源阅读,不复述或链接,只落地合成复现。不得使用 Phorge MCP 服务器创建 diff,只用 arc CLI。具体价格、平台支持等信息暂未提供。