处理问题和拉取请求

本页介绍了如何在 Secure Source Manager 网页界面中使用问题和拉取请求。

如需通过网页界面访问 Secure Source Manager 实例，请将以下网址复制到浏览器地址栏中。

INSTANCE_ID-PROJECT_NUMBER.LOCATION.sourcemanager.dev

请替换以下内容：

• 将 INSTANCE_ID 替换为实例名称。
• 将 PROJECT_NUMBER 替换为实例的 Google Cloud项目编号。如需了解如何标识项目，请参阅标识项目。
• 将 LOCATION 替换为实例的区域。

所需的角色

如需获得处理问题和拉取请求所需的权限，请让您的管理员为您授予以下 IAM 角色：

• Secure Source Manager 实例上的 Secure Source Manager Instance Accessor (roles/securesourcemanager.instanceAccessor)
• 针对代码库的 Secure Source Manager Repo Writer (roles/securesourcemanager.repoWriter)

如需详细了解如何授予角色，请参阅管理对项目、文件夹和组织的访问权限。

您也可以通过自定义角色或其他预定义角色来获取所需的权限。

如需了解如何授予 Secure Source Manager 角色，请参阅使用 IAM 进行访问权限控制和向用户授予实例访问权限。

查看拉取请求

您可以查看自己有权访问的所有拉取请求，也可以查看特定代码库的拉取请求。

空代码库没有 Pull requests 标签页。将代码推送到代码库后，您就可以查看拉取请求标签页。

如需查看分配给您的拉取请求或问题，请前往 Secure Source Manager 的问题或拉取请求标签页，然后点击分配给我。

如需查看代码库的拉取请求，请执行以下操作：

1. 在 Secure Source Manager 网页界面中，选择您的代码库。
2. 在代码库页面中，点击 Pull requests 标签页。
3. 您可以使用受让人、类型或排序的下拉菜单过滤或排序拉取请求。

如需查看所有拉取请求，请执行以下操作：

1. 在 Secure Source Manager 网页界面中，点击 Pull request 标签页。

   注意： 您必须拥有代码库的 Repo Reader 角色 (roles/securesourcemanager.repoReader)，才能查看该代码库的拉取请求。

2. 您可以使用受让人、类型或排序下拉菜单过滤或排序拉取请求。

创建拉取请求

1. 在 Secure Source Manager 网页界面中，选择要为其创建拉取请求的代码库。
2. 在代码库页面中，点击 Pull requests 标签页。
3. 点击 New pull request。
4. 在合并到菜单中，选择要将拉取请求合并到的分支。
5. 在从以下位置拉取菜单中，选择要从中拉取的分支。
6. 点击 New pull request。
7. 为拉取请求添加标题和说明，并附上任何相关文件。

8. 点击创建拉取请求。

   系统会将您转到拉取请求页面，您可以在其中添加审核者、标签、里程碑和受让人。

修改拉取请求详细信息

您可以为拉取请求添加审核者、标签、里程碑、指派对象和截止日期。

注意： 在此版本中，审核者或受让人不会收到电子邮件通知。

如需添加审核者、标签、里程碑、受让人，请执行以下操作：

在拉取请求页面中，点击要修改的详细信息旁边的 齿轮图标。

系统会自动保存修改。

如需更新截止日期，请执行以下操作：

1. 点击截止日期部分中的日历图标，然后选择一个日期。
2. 点击 加号图标以保存截止日期。

查看拉取请求

审核者可以添加评论、请求更改和批准拉取请求。

如需查看分配给您的拉取请求，请执行以下操作：

1. 在 Secure Source Manager 网页界面中，点击 Pull request 标签页。
2. 点击分配给我的。

3. 点击要查看的拉取请求。

   系统随即会打开对话页面。您可以查看拉取请求作者或其他审核者留下的任何评论。

4. 如需查看和评论已更改的文件，请点击已更改的文件标签页。 您可以点击空白、拆分视图/统一视图和差异选项下拉菜单，更改空白显示、视图和差异选项的行为。

5. 如需发表评论，请点击要评论的行旁边的加号图标。

6. 点击开始检查。

7. 如需添加其他注释，请点击要注释的行中的加号图标，然后点击添加注释。

   评论支持使用 Markdown 设置样式。

8. 如需发送评论、批准拉取请求或请求更改，请点击查看。

9. 您可以留下评论来总结所做的更改，也可以将评论空间留空，然后从以下选项中进行选择：

   • 批准：批准更改。
   • 评论：发送评论，但不批准拉取请求。

   • 请求更改：请求对拉取请求进行更改。

     注意： 如果您要评论自己的拉取请求，则无法批准或请求更改自己的拉取请求。

合并拉取请求

1. 在代码库页面中，点击 Pull requests 标签页。
2. 选择要合并的拉取请求。
3. 如果没有冲突，请点击 合并拉取请求。

查看问题

1. 在 Secure Source Manager 网页界面中，选择您的代码库。
2. 在代码库页面中，点击问题标签页。
3. 您可以使用受让人、类型或排序菜单过滤或排序问题。

创建问题

1. 在 Secure Source Manager 网页界面中，选择您的代码库。
2. 在代码库页面中，点击问题标签页。
3. 点击新问题。
4. 输入问题标题和说明，然后点击创建问题。

5. 在问题详情页面上，您可以分配标签、里程碑、受让人，并指定分支或标记。

   注意： 此版本中没有电子邮件通知。

使用 Mermaid 添加图表

Secure Source Manager 支持在 Markdown 文件（例如 README.md）、拉取请求说明、问题和注释中呈现 Mermaid 图表。

如需添加图表，请使用 mermaid 围栏式代码块：

```mermaid
graph TD
    A[Write Markdown] --> B(Click Preview Tab)
    B --> C{Does it render?}
    C -- Yes --> D[Success]
    C -- No --> E[Check Syntax]
```

点击 Markdown 编辑器中的预览标签页，验证图表是否会呈现，然后再保存。

支持的图表类型

Secure Source Manager 支持以下 Mermaid 图表类型：

• 流程图：graph 或 flowchart（支持 TD、TB、LR、BT、RL）
• 序列图：sequenceDiagram
• 类图：classDiagram
• 实体关系图：erDiagram
• 状态图：stateDiagram 或 stateDiagram-v2
• XY 图表：xychart-beta 或 xychart

渲染行为和限制

• 静态渲染：图表以静态图片的形式呈现。出于安全考虑，系统会停用互动功能（例如 click 回调和提示）和外部脚本。
• 主题自适应：图表会自动适应浅色主题和深色主题。
• 无障碍功能：渲染的图表包含填充了图表源代码的替代文本，供屏幕阅读器使用。
• 不支持的图表类型：不支持的图表类型会显示错误消息，并且不会呈现。这些图表包括甘特图、思维导图、饼图、Gitgraph 图、用户旅程图、需求图、C4 图、时间轴图、桑基图和框图。对于不受支持的图表类型，请将图表在本地渲染为图片（PNG 或 SVG），然后使用标准 Markdown 图片语法嵌入该图片。

后续步骤

• 将 Git 源代码管理与 Secure Source Manager 搭配使用。