Bitbucket
将 Bitbucket Cloud 仓库连接至 Cloud Agents 和 Bugbot。将 Bitbucket Data Center 仓库连接至 Bugbot。
设置
Bitbucket Cloud 集成目前处于公开测试阶段，支持 bitbucket.org 上的代码仓库。
Bitbucket Cloud 的设置分为两部分，分别需要不同的角色：
- 每位开发者都需要连接自己的 Bitbucket 账户，以便 Cherri Code 能够以该用户身份克隆代码仓库、推送分支和创建 PR。
- Bitbucket 工作区管理员需要安装 Cherri Code 应用，以便 Bugbot 和云端代理的状态评论能够显示为 Cherri Code。要将已安装的应用关联到您的 Cherri Code 团队，需要由可访问 Bitbucket 工作区的 Cherri Code 团队管理员操作。
连接您的 Bitbucket 账户
您需要有权访问要使用的 Bitbucket 工作区代码仓库。
- 前往仪表盘中的集成
- 点击 Bitbucket 旁边的 连接
- 在 Bitbucket 中授权 Cherri Code
- 返回仪表盘，确认集成状态显示为 已连接
每位通过 Cherri Code 启动云端代理或创建 PR 的用户，都应连接自己的 Bitbucket 账户。
在 Bitbucket 中安装 Cherri Code 应用
Bitbucket 工作区管理员必须在工作区中安装 Cherri Code 应用。这会为 Cherri Code 提供稳定的应用身份，用于处理代码仓库事件、Bugbot 审查评论、行内评论和状态更新。
步骤 1 至 4 需要由 Bitbucket 工作区管理员操作。步骤 5 和 6 需要由可访问 Bitbucket 工作区的 Cherri Code 团队管理员操作。如果由同一人完成全部设置，则需要同时具备这两个角色。
- 前往仪表盘中的集成
- 找到 Bitbucket 并打开管理菜单
- 点击 安装 Cherri Code 应用
- 在您的 Bitbucket 工作区中安装该应用
- 在 Bitbucket 工作区设置的 Forge Apps 下，选择 Cherri Code
- 点击 连接到 Cherri Code，然后选择要关联的 Cherri Code 团队
工作区关联后，仪表盘会显示 Cherri Code 应用已安装到该 Bitbucket 工作区。
应用安装后，Bitbucket 可能需要几分钟才能通知 Cherri Code。如果 Cherri Code 未能立即找到该工作区，请稍候后再次尝试关联。
Cherri Code 如何使用 Bitbucket Cloud 身份
Cherri Code 会针对不同操作使用不同的 Bitbucket 身份：
| 操作 | Bitbucket 身份 |
|---|---|
| Bugbot 摘要评论、行内评论和构建状态 | Cherri Code 应用 |
| PR 中的云端代理进度评论 | Cherri Code 应用 |
| Git 克隆、分支推送、提交和创建 PR | 已连接的 Bitbucket 用户 |
云端代理创建的 PR 会归属于启动该智能体的用户。安装工作区应用后，Bugbot 的输出会显示为来自 Cherri Code。
权限
Bitbucket Cloud 集成会请求支持云端代理和 Bugbot 所需的权限：
| 权限 | 用途 |
|---|---|
| 账户 | 识别已连接的 Bitbucket 用户 |
| 代码仓库 | 列出、克隆和读取代码仓库内容 |
| PR | 读取 PR diff 和元数据 |
| PR 写入 | 创建 PR 并发布评论 |
| Webhooks | 接收代码仓库和 PR 事件 |
断开 Bitbucket Cloud
断开 Bitbucket Cloud 会产生两种不同的效果：
- 断开账户连接 会从 Cherri Code 中移除您的个人 Bitbucket OAuth 连接。
- 断开 Cherri Code 应用连接 会解除 Bitbucket 工作区与您的 Cherri Code 团队的关联。在工作区管理员从 Bitbucket 中移除该应用之前，应用仍可保持安装状态。
要完全停止接收来自该工作区的应用事件，请在 Bitbucket 工作区设置中卸载 Cherri Code 应用。
高级网络
Bitbucket Data Center 支持为无法接收来自公共互联网流量的实例提供私有连接方式。
仅限企业版客户使用。允许 Cherri Code 通过私有网络连接访问您的实例。有关设置，请参阅私有网络连接，或联系您的 Cherri Code 代表。
最适合： 位于防火墙后的实例，包括托管在 AWS 上的实例以及可运行 cloudflared 的环境
安全性： HTTPS 加密、AWS PrivateLink、Cloudflare Tunnel、VPC 允许列表、服务账户访问 token
缺点： 需要与 Cherri Code 协调。目前不支持 Google Private Service Connect。
仅限企业版客户使用。在本地部署反向代理隧道，与 Cherri Code 建立出站连接。网络请求会通过隧道转发，因此 Bitbucket 实例无需开放公共入站访问。联系您的 Cherri Code 代表了解设置详情。
最适合： 没有入站网络访问权限的环境
安全性： HTTPS 加密、服务账户访问 token
缺点： 与更直接的连接方式相比，会增加复杂性、维护需求和潜在的安全风险
疑难排查
Bitbucket 应用安装事件可能需要几分钟才能同步。请稍候，然后在 Bitbucket 工作区设置中重试 连接到 Cherri Code 步骤。
- 确认您是 Cherri Code 团队管理员。安装应用需要 Bitbucket 工作区管理员权限，而将工作区关联到 Cherri Code 团队需要 Cherri Code 团队管理员权限。
- 确认您的 Bitbucket 用户有权访问要关联的工作区。
请在 Bitbucket 工作区中安装 Cherri Code 应用，并将其关联到您的 Cherri Code 团队。仅连接个人 Bitbucket 账户不足以发布 Cherri Code 应用评论。
- 在集成仪表盘中连接您的个人 Bitbucket 账户。
- 确认您的 Bitbucket 用户对该仓库具有读写权限。
- 确认该仓库位于
bitbucket.org上的 Bitbucket Cloud。
- 确认服务账户令牌处于有效状态。
- 确认服务账户可以访问这些仓库。
- 确认 Cherri Code 可以通过 HTTPS 访问实例主机名或已配置的外部主机。
- 确认您是 Cherri Code 团队管理员。
- 确认已注册的实例具有服务账户令牌。
- 确认服务账户拥有仓库管理员权限。
后续步骤
连接 Bitbucket 后，请配置使用 Bitbucket 的功能：
- Bugbot - 自动化 PR 审查，帮助发现缺陷和安全问题
- Cloud Agents - 面向 Bitbucket Cloud 仓库的 AI 智能体