AWS CodeCommit 入门

创建 CodeCommit 存储库

1. 通过以下网址打开 CodeCommit 控制台：https://console.www.amazonaws.cn/codesuite/codecommit/home。

2. 可使用区域选择器选择要创建存储库的 AWS 区域。有关更多信息，请参阅 区域和 Git 连接终端节点。

3. 在存储库页面上，选择创建存储库。

4. 在创建存储库页面上的存储库名称中，输入存储库的名称（例如，MyDemoRepo）。

   注意

   存储库名称区分大小写，且不能超过 100 个字符。有关更多信息，请参阅限制。

5. （可选）在描述中，输入描述（例如，My demonstration repository）。这可以帮助您及其他用户了解存储库的用途。

6. （可选）选择Add tag (添加标签)，向您的存储库添加一个或多个存储库标签（自定义属性标签，可帮助您组织和管理您的 AWS 资源）。有关更多信息，请参阅 在 AWS CodeCommit 中标记存储库。

7. （可选）如果该存储库将包含 Java 代码，并且您希望 CodeGuru Reviewer 分析该 Java 代码，请选择 Enable Amazon CodeGuru Reviewer for Java (为 Java 启用 Amazon CodeGuru Reviewer)。CodeGuru Reviewer 将使用多个机器学习模型查找 Java 代码缺陷，并在拉取请求中自动提出改进和修复建议。有关更多信息，请参阅 Amazon CodeGuru Reviewer 用户指南。

8. 选择 Create。

向存储库添加文件

1. 在存储库的导航栏中，选择代码。

2. 选择 Add file (添加文件)，然后选择是创建文件还是从您的计算机上传文件。本教程向您展示了如何执行这两个操作。

3. 要添加文件，请执行以下操作：

   1. 在分支下拉列表中，选择要添加文件的分支。已为您自动选择默认分支。在此处所示的示例中，默认分支名为 master。如果要将文件添加到不同的分支，请选择不同的分支。

   2. 在 File name (文件名) 中，为文件输入名称。在代码编辑器中，输入文件的代码。

   3. 在作者姓名中，输入您希望显示给其他存储库用户的姓名。

   4. 在电子邮件地址中，输入电子邮件地址。

   5. （可选）在提交消息中，输入一条简短的消息。虽然这是可选的，但建议您添加提交消息以帮助您的团队成员了解您添加此文件的原因。如果您没有输入提交消息，将使用默认消息。

   6. 选择提交更改。

   要上传文件，请执行以下操作：

   • 如果正在上传文件，请选择要上传的文件。

     

   • 在作者姓名中，输入您希望显示给其他存储库用户的姓名。

   • 在电子邮件地址中，输入电子邮件地址。

   • （可选）在提交消息中，输入一条简短的消息。虽然这是可选的，但建议您添加提交消息以帮助您的团队成员了解您添加此文件的原因。如果您没有输入提交消息，将使用默认消息。

   • 选择提交更改。

浏览存储库

1. 从存储库中选择 MyDemoRepo。

2. 页面显示了存储库的默认分支中的内容。要查看其他分支或查看特定标签处的代码，请从列表中选择要查看的分支或标签。在以下屏幕截图中，视图设置为 master 分支。

   

3. 要查看存储库中某个文件的内容，请从列表中选择该文件。要更改所显示代码的颜色，请选择设置图标。

   

   有关更多信息，请参阅 浏览存储库中的文件。

4. 要浏览存储库的提交历史记录，请选择 Commits (提交)。控制台按时间倒序显示默认分支的提交历史记录。可以按作者、日期等查看提交详细信息。

   

5. 要按分支或 Git 标签查看提交历史记录，请从列表中选择要查看的分支或标签。

6. 要查看提交与其父项之间的差异，请选择缩写的提交 ID。您可以选择更改的显示方式，包括显示或隐藏空格更改，以及是以内联方式（统一视图）还是并排方式（拆分视图）查看更改。

   注意

   每当您更改用于查看代码和其他控制台设置的首选项时，都会将它们保存为浏览器 Cookie。有关更多信息，请参阅使用用户首选项。

   

7. 要查看对提交的所有评论，请选择提交，然后滚动显示更改以便通过内联方式查看更改。您还可以添加自己的评论并回复他人发表的评论。

   

   有关更多信息，请参阅评论提交。

8. 要查看任意两个提交说明符（包括标签、分支和提交 ID）之间的差异，请在导航窗格中选择 Commits (提交)，然后选择 Compare commits (比较提交)。

   

   有关更多信息，请参阅浏览存储库的提交历史记录和比较提交。

9. 在提交中，选择提交可视化工具选项卡。

   

   此时会显示提交图，图中每个提交点的旁边显示其主题行。主题行显示限制为 80 个字符。

10. 要查看有关提交的更多详细信息，请选择其缩写的提交 ID。要呈现特定提交的图表，请在图表中选择该点。有关更多信息，请参阅 查看存储库的提交历史记录图表 。

在拉取请求中进行创建和协作

1. 在导航窗格中，选择拉取请求。

2. 在拉取请求中，选择创建拉取请求。

   提示

   您也可以从分支和代码创建拉取请求。

   在 Create pull request 中，在 Source 中选择包含要审核的更改的分支。在 Destination (目标) 中，选择要在拉取请求关闭后将已审核的代码合并到的分支。选择 Compare。

3. 审核合并详细信息和更改，以确认拉取请求包含要审核的更改和提交。如果是这样，请在标题中输入此审核的标题。此标题显示在存储库的拉取请求列表中。在描述中，输入有关此审核的详细信息及对审核者有用的任何其他信息。选择 Create。

   

4. 拉取请求将显示在存储库的拉取请求列表中。您可以筛选视图，使其只显示打开的请求、关闭的请求、您创建的请求等。

   

5. 您可以向拉取请求添加审批规则，以确保该请求在合并之前满足某些条件。要向拉取请求添加审批规则，请从列表中选择拉取请求。在 Approvals (审批) 选项卡上，选择 Create approval rule (创建审批规则)。

6. 在 Rule name (规则名称) 中，为规则指定一个描述性名称。例如，如果您希望拉取请求在合并之前，必须由两人对其进行审批，那么可以将该规则命名为 Require two approvals before merge。在 Number of approvals needed (需要的审批数量) 中，输入所需的数量 2。默认值为 1。选择 Submit (提交)。要了解有关审批规则和审批池成员的更多信息，请参阅为拉取请求创建审批规则。

   

7. 如果已为存储库配置通知并选择向用户通知拉取请求事件，用户会收到有关新拉取请求的电子邮件。用户可以查看针对特定代码行、文件和拉取请求自身的更改和评论。他们还可以回复评论。如有必要，可以将更改推送到拉取请求分支，此操作会更新拉取请求。

   

8. 如果您对请求中所做的更改感到满意，请选择 Approve (批准)。即使该拉取请求未配置审批规则，您也可以选择批准拉取请求。这样可清楚地记录您已审核拉取请求并批准更改。如果您改变主意，还可以选择撤销批准。

   
   注意

   如果拉取请求由您创建，那么您无法批准该请求。

9. 当您对在拉取请求中审核并同意的所有代码更改感到满意后，执行以下操作之一：

   • 如果要关闭拉取请求而不合并分支，请选择 Close pull request (关闭拉取请求)。

   • 如果要合并分支并关闭拉取请求，请选择 Merge (合并)。您可以在代码的可用合并策略之间进行选择，这些策略取决于源和目标分支之间的差异，以及在合并完成后是否自动删除源分支。在进行选择后，请选择 Merge pull request (合并拉取请求) 以完成合并。

     

   • 如果分支中存在无法自动解决的合并冲突，您可以在 CodeCommit 控制台中解决，或者也可以使用本地 Git 客户端合并分支，然后推送合并。有关更多信息，请参阅 解决 AWS CodeCommit 存储库中的拉取请求的冲突。

   注意

   您始终可以在本地存储库中使用 git merge 命令并推送更改以手动合并分支，包括拉取请求分支。

删除 CodeCommit 存储库

1. 通过以下网址打开 CodeCommit 控制台：https://console.www.amazonaws.cn/codesuite/codecommit/home。

2. 在存储库中，选择要删除的存储库。如果您遵循了本主题中的命名约定，它将命名为 MyDemoRepo。

3. 在导航窗格中，选择 Settings。

4. 在 Settings 页面上的 Delete repository 中，选择 Delete repository。

5. 键入 delete，然后选择删除。存储库将被永久删除。