审核拉取请求 - Amazon CodeCatalyst

审核拉取请求

您可以使用 Amazon CodeCatalyst 控制台以协作方式审核并评论拉取请求中包含的更改。您可以向单个代码行中添加评论,说明源分支和目标分支之间的差异以及各个拉取请求修订之间的差异。您可以选择创建在拉取请求中更改代码时留下的评论的摘要,以帮助您快速了解其他用户留下的反馈。您还可以选择创建一个开发环境来处理代码。

注意
注意

由 Amazon Bedrock 提供支持:AWS 实施自动化滥用检测。由于为我编写描述创建内容摘要推荐任务使用 Amazon Q 创建功能或将功添加到项目以及将事务分配给 Amazon Q 功能与用于软件开发的 Amazon Q 开发者版代理程序的功能都是基于 Amazon Bedrock 构建的,因此,用户可以充分利用 Amazon Bedrock 中实施的控制措施来强制实施安全性并负责任地使用人工智能(AI)。

提示

您可以在个人资料中配置您将收到哪些拉取请求事件的相关电子邮件。有关更多信息,请参阅从 CodeCatalyst 发送 Slack 和电子邮件通知

拉取请求显示了拉取请求修订与创建拉取请求时作为目标分支最新块的提交之间的差异。这称作合并基础。有关 Git 中差异和合并基准的更多信息,请参阅 Git 文档中的 git-merge-base

提示

在控制台中工作时,特别是在您已打开拉取请求一段时间的情况下,请考虑刷新浏览器以确保在开始审核拉取请求之前,有最新的修订可供拉取请求使用。

在 CodeCatalyst 控制台中审核拉取请求
  1. 导航到您的项目。

  2. 通过执行下列操作之一来导航到拉取请求:

    • 如果项目页面上列出了拉取请求,请从列表中选择它。

    • 如果项目页面上未列出拉取请求,请选择查看全部。使用筛选条件和排序来查找拉取请求,然后从列表中选择它。

    • 在导航窗格中,选择代码,然后选择拉取请求

  3. 从列表中选择要审核的拉取请求。您可以通过在筛选条件栏中键入拉取请求的部分名称来筛选拉取请求列表。

  4. 概述中,您可以审核拉取请求的名称和标题。您可以创建和查看拉取请求本身留下的评论。您还可以查看拉取请求的详细信息,包括有关工作流运行、链接的事务、审阅者、拉取请求作者和可行的合并策略的信息。

    注意

    特定代码行上留下的评论会显示在更改中。

  5. (可选)要添加适用于整个拉取请求的评论,请展开针对拉取请求的评论,然后选择创建评论

  6. (可选)要查看对此拉取请求修订中的更改留下的所有评论的摘要,请选择创建评论摘要

    注意

    此功能要求为空间启用生成式人工智能功能,并且仅在美国西部(俄勒冈州)区域提供。有关更多信息,请参阅 Managing generative AI features

  7. 更改中,您可以查看目标分支与拉取请求的最新修订之间的差异。如果有多个修订,您可以在它们之间的差异中更改要比较的修订。有关修订的更多信息,请参阅修订

    提示

    您可以在文件已更改中快速查看拉取请求中发生更改的文件数,以及拉取请求中具有评论的文件。文件夹旁边显示的评论数表示该文件夹中文件的评论数。展开文件夹可查看文件夹中每个文件的评论数。

  8. 要更改差异的显示方式,请在统一拆分之间进行选择。

  9. 要向拉取请求中的行添加评论,请转到要评论的行。选择为该行显示的评论图标,输入评论,然后选择保存

  10. 要查看拉取请求中的各个修订之间的更改或其源分支和目标分支之间的更改,请从比较中的可用选项中进行选择。修订中各行的评论将保留在这些修订中。

  11. 如果您已将工作流配置为生成有关拉取请求触发器的代码覆盖率报告,则可以在相关的拉取请求中查看行和分支覆盖率结果。要隐藏代码覆盖率结果,请选择隐藏代码覆盖率。有关更多信息,请参阅代码覆盖率报告

  12. 如果要对拉取请求进行代码更改,则可以从拉取请求创建开发环境。选择创建开发环境。可选择为开发环境添加名称或编辑其配置,然后选择创建

  13. 报告中,您可以查看此拉取请求中的质量报告。如果有多个修订,您可以在它们之间的差异中更改要比较的修订。您可以按名称、状态、工作流、操作和类型筛选报告。

    注意

    必须配置工作流来生成报告,以使报告显示在拉取请求中。有关更多信息,请参阅在操作中配置质量报告

  14. 要查看特定报告,请从列表中选择该报告。有关更多信息,请参阅使用工作流进行测试

  15. 如果您被列为拉取请求的审阅者并想批准更改,请确保您正在查看最新修订,然后选择批准

    注意

    所有必需的审阅者都必须批准拉取请求,之后才能合并拉取请求。