AWS CodeCommit
用户指南 (API 版本 2015-04-13)

AWS CodeCommit 入门教程

如果您刚开始使用 CodeCommit,本教程可帮助您了解如何使用其功能。在本教程中,您将在 CodeCommit 中创建一个存储库。在提交对 CodeCommit 存储库所做的一些更改后,您可以浏览文件和查看更改。您还可以为其他人创建拉取请求以便查看和评论对代码所做的更改。

CodeCommit 控制台在可从页面上的信息图标或任何 Info (信息) 链接打开的可折叠面板中包含有帮助的信息。( )。您可以随时关闭此面板。


            在控制台中查看其他指导

CodeCommit 控制台还提供了一种方法,可以快速搜索诸如存储库、构建项目、部署应用程序和管道等资源。选择转到资源或按下 / 键,然后键入资源的名称。任何匹配结果都会显示在列表中。搜索不区分大小写。您只能看到您有权查看的资源。有关更多信息,请参阅 在控制台中查看资源

如果您不熟悉 Git,除了本教程以外,我们还建议您完成Git 与 CodeCommit 教程。完成本教程后,您应已完成充分的练习,可以开始在自己的项目和团队环境中使用 CodeCommit 了。

重要

在开始之前,您必须完成前提条件和设置,包括:

  • 向 IAM 用户分配权限。

  • 在您用来完成本教程的本地计算机上为 HTTPS 或 SSH 连接设置凭证管理。

  • 如果您想要使用命令行或终端完成所有操作,包括创建存储库,则还需要配置 AWS CLI。

步骤 1:创建 CodeCommit 存储库

您可以使用 CodeCommit 控制台创建 CodeCommit 存储库。如果您已有可用于本教程的存储库,可以跳过该步骤。

注意

根据您的使用情况,您可能需要为创建或访问存储库付费。有关更多信息,请参阅 CodeCommit 产品信息页面上的定价

创建 CodeCommit 存储库

  1. 通过以下网址打开 CodeCommit 控制台:https://console.aws.amazon.com/codesuite/codecommit/home

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

  3. 存储库页面上,选择创建存储库

  4. 创建存储库页面上的存储库名称中,输入存储库的名称(例如,MyDemoRepo)。

    注意

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

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

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

  7. 选择 Create


              从控制台创建存储库

注意

如果存储库使用了 MyDemoRepo 以外的名称,请务必在本教程的剩余步骤中使用自己指定的名称。

当存储库打开后,您可以查看有关如何直接从 CodeCommit 控制台添加文件的信息。

步骤 2:向您的存储库添加文件

可以通过以下方法向您的存储库添加文件:

  • 在 CodeCommit 控制台中创建文件。

  • 使用 CodeCommit 控制台从您的本地计算机上传文件。

  • 使用 Git 客户端将存储库克隆到您的本地计算机,然后添加文件并将文件提交和推送到 CodeCommit 存储库。

最简单的开始使用方法是从 CodeCommit 控制台添加一个文件。

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

  2. 选择添加文件,然后选择创建文件或者从您的计算机上传文件。

  3. 执行以下操作:

    • 如果要将文件添加到其他分支,请从分支的下拉列表中选择要将文件添加到其中的分支。已为您自动选择默认分支。在此处所示的示例中,默认分支名为 master

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

    • 电子邮件地址中,输入电子邮件地址。

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

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

    • 如果您要创建文件,请在文件名称中输入文件的名称,然后在代码编辑器中输入要添加的代码。

    
                        在 CodeCommit 控制台中上传文件的视图
  4. 选择提交更改

有关更多信息,请参阅使用 AWS CodeCommit 存储库中的文件

要使用 Git 客户端克隆存储库,请在您的本地计算机上安装 Git,然后克隆 CodeCommit 存储库。向本地存储库中添加一些文件,并将它们推送到 CodeCommit 存储库。有关深入介绍,请尝试 Git 与 CodeCommit 教程。如果您熟悉 Git 但不确定如何对 CodeCommit 存储库执行此操作,则可查看创建提交步骤 2:创建本地存储库连接存储库中的示例和说明。

向 CodeCommit 存储库中添加一些文件后,您可以在控制台中查看它们。

步骤 3:浏览存储库的内容

您可以使用 CodeCommit 控制台查看存储库中的文件或快速读取文件的内容。这可以帮助您确定要签出的分支或者确定是否需要创建存储库的本地副本。

  1. 存储库中选择 MyDemoRepo。

  2. 存储库的内容显示在您的存储库的默认分支中。要将视图更改为另一个分支,或查看特定标签处的代码,请选择视图选择器按钮,然后从列表中选择要查看的分支或标签。此处的视图设置为 master 分支。

    
                        浏览存储库的内容
  3. 要查看存储库中某个文件的内容,请从列表中选择该文件。选择齿轮图标以更改显示的代码的颜色显示选项。

    
                        查看文件的内容

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

您还可以浏览存储库的提交历史记录。这可以帮助您确定存储库中所做的更改,包括是谁在何时进行了这些更改。

  1. 在存储库的导航窗格中,选择 Commits。系统按反向时间顺序显示存储库默认分支中的提交的历史记录。

    
                        控制台中的提交历史记录视图
  2. 分支或按标签查看提交历史记录,并按作者、日期等获取有关提交的详细信息。

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

    注意

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

    
                        在统一视图中显示的更改,空格更改可见
  4. 要查看对提交的所有评论,请选择提交,然后滚动显示更改以便通过内联方式查看更改。您还可以添加自己的评论并回复他人发表的评论。

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

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

    
                        将提交与拆分视图中的分支的提示相比较

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

  6. 提交中,选择提交可视化工具选项卡。

    
                        控制台中的存储库图形视图

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

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

步骤 4:在拉取请求中进行创建和协作

当您与其他存储库用户合作时,您可能希望协作处理代码并查看更改。您可以创建一个拉取请求,这样其他用户可在分支中查看和评论您的代码更改,然后您再将这些更改合并到其他分支中。如果您为存储库设置了通知,则存储库用户可以收到有关存储库事件的电子邮件(例如,针对拉取请求,或在有人对代码评论时)。有关更多信息,请参阅 在 AWS CodeCommit 存储库中配置事件通知

重要

在创建拉取请求之前,必须先创建一个分支,其中包含要查看的代码更改。有关更多信息,请参阅创建分支

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

  2. 拉取请求中,选择创建拉取请求

    提示

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

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

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

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

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

    
                        查看拉取请求中的活动
  6. 当您对在拉取请求中审核并同意的所有代码更改感到满意后,执行以下操作之一:

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

      
                                在 CodeCommit 控制台中显示合并的可用合并策略的拉取请求。
    • 如果要关闭拉取请求而不合并分支,请选择 Close pull request (关闭拉取请求)

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

    注意

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

有关更多信息,请参阅 使用拉取请求

步骤 5:后续步骤

现在您已经熟悉了 CodeCommit 及其部分功能,请考虑执行以下操作:

步骤 6:清除

如果您不再需要 CodeCommit 存储库,则应删除本教程中使用的 CodeCommit 存储库和其他资源,这样您就不再需要为存储空间付费。

重要

删除该存储库后,您不能再将其克隆到任何本地存储库或共享存储库。您也无法再从任何本地存储库或共享存储库向其推送数据、从其拉取数据或执行任何 Git 操作。此操作无法撤消。

如果已为存储库配置通知,则删除存储库还会删除为该存储库配置的 Amazon CloudWatch Events 规则。此时不会删除用作该规则目标的 Amazon SNS 主题。

如果为存储库配置了触发器,删除存储库不会删除您配置为这些触发器目标的 Amazon SNS 主题或 Lambda 函数。如果不需要这些资源,请务必将其删除。有关更多信息,请参阅从存储库中删除触发器

删除 CodeCommit 存储库

  1. 通过以下网址打开 CodeCommit 控制台:https://console.aws.amazon.com/codesuite/codecommit/home

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

  3. 在导航窗格中,选择 Settings

  4. Settings 页面上的 Delete repository 中,选择 Delete repository

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