跳转到主要内容

Bitbucket

当你的工作流程需要仓库、分支、拉取请求或问题数据时,请使用 Bitbucket。它可以读取并更新你已连接工作区中的代码审查和跟踪工作。

配置

在配置此步骤之前,请通过登录流程在你的工作区的 Integrations 中连接 Bitbucket。如果没有可用的活动连接,该步骤会显示一条警告,并提供指向 Integrations 的链接,而不是账户选择器。

Arguments form

当你选择一个操作时,Arguments 部分会根据该操作的输入 schema 显示一个表单。引用现有记录的字段包含下拉选择器。 如果你更愿意手动编写完整的参数对象,请切换到 Raw JSON 选项卡。任一选项卡中的更改都会保持同步。

Common actions

诸如删除记录之类的破坏性操作在工作流操作选择器中不可用。

输出

此步骤会将 Bitbucket 响应存储为步骤输出。响应的结构取决于该操作。 在后续步骤中使用完整的输出引用:

示例

  1. 打开 Integrations,如果你还没有这样做,请先连接 Bitbucket。
  2. 将一个 Bitbucket 步骤添加到你的工作流中。
  3. 在 Authentication 中选择一个已连接账户。
  4. 在 Action 中选择 Get repository。
  5. 填写必填字段。对任何字段值,使用 Insert Variable 引用前面某一步的输出。
  6. 点击步骤标题栏中的 Run 来测试该操作,然后在 Output 中查看返回的载荷。

使用场景

从分支发起评审

  1. 列出分支
  2. 获取分支
  3. 创建拉取请求
  4. 批准拉取请求

跟踪一个新缺陷

  1. 列出问题
  2. 创建问题
  3. 更新问题

检查一次代码变更

  1. 列出提交
  2. 获取提交
  3. 获取提交差异
  4. 获取拉取请求

备注

  • 此步骤依赖于你工作区中已连接的 Bitbucket 集成。
  • 工作流操作选择器会显示一组经过筛选的操作。拥有 Bitbucket 工具的代理可以使用更多操作。
  • 登录界面可能会显示第三方授权品牌信息。

将 Bitbucket 用作代理工具

你也可以在 Agent Editor 中将 Bitbucket 添加为工具。打开该代理,点击 Add tool,然后选择 Bitbucket。在工具设置面板中,选择代理应使用的已连接账户。代理会在相关于对话时调用 Bitbucket 操作。 另请参阅:Integrations、Creating and Editing 和 Testing and Iteration