本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
开始使用 Amazon CodeCommit
本教程介绍了如何使用一些关键的 CodeCommit 功能。首先,请创建一个存储库并提交一些对它的更改。然后,浏览文件并查看更改。您还可以创建拉取请求,以便其他用户可以审核并注释代码的更改。
如果您希望将现有代码迁移到CodeCommit,请参阅迁移到 Amazon CodeCommit.
如果您不熟悉 Git,也可以考虑完成 Git 和 CodeCommit 入门。完成这些教程后,您应当已具备足够的实践知识,可以开始在自己的项目和团队环境中使用 CodeCommit。
CodeCommit 控制台在可折叠面板中包含了有用的信息,您可以从信息图标 (
) 或页面上的任何 Info (信息) 链接打开这些信息。您可以随时关闭此面板。
CodeCommit 控制台还提供了一种方法,可以快速搜索诸如存储库、构建项目、部署应用程序和管道等资源。选择转到资源或按下 /
键,然后键入资源的名称。任何匹配结果都会显示在列表中。搜索不区分大小写。您只能看到您有权查看的资源。有关更多信息,请参阅 在控制台中查看资源。
先决条件
在开始之前,必须完成先决条件和设置过程,包括:
-
向 IAM 用户分配权限。
-
在您用来完成本教程的本地计算机上为 HTTPS 或 SSH 连接设置凭证管理。
-
如果您想要使用命令行或终端完成所有操作,包括创建存储库,则还需要配置 Amazon CLI。
第 1 步:创建 CodeCommit 存储库
您可以使用CodeCommit控制台来创建CodeCommit存储库。如果您已有可用于本教程的存储库,可以跳过该步骤。
根据您的使用情况,您可能需要为创建或访问仓库付费。有关更多信息,请参阅 。定价
创建CodeCommit知识库
打开CodeCommit控制台https://console.aws.amazon.com/codesuite/codecommit/home
. -
使用区域选择器选择Amazon Web Services 区域在其中创建存储库。有关更多信息,请参阅 区域和 Git 连接端点。
-
在存储库页面上,选择创建存储库。
-
在 Create repository (创建存储库) 页面上的 Repository name (存储库名称)中,输入存储库的名称(例如,
MyDemoRepo
)。注意 存储库名称区分大小写,且不能超过 100 个字符。有关更多信息,请参阅限制。
-
(可选)在描述中,输入描述(例如,
My demonstration repository
)。这可以帮助您及其他用户了解存储库的用途。 -
(可选)选择Add tag (添加标签),向您的存储库添加一个或多个存储库标签(自定义属性标签,可帮助您组织和管理您的 Amazon 资源)。有关更多信息,请参阅 在中标记存储库Amazon CodeCommit。
(可选)选择启用亚马逊CodeGuruJava 和 Python 的审阅者这个存储库是否包含 Java 或 Python 代码,并且你想拥有CodeGuru审阅者对该代码进行分析。CodeGuruReviewer 使用多个机器学习模型来查找代码缺陷,并自动提出拉取请求的改进和修复建议。有关更多信息,请参阅 AmazonCodeGuru审阅者用户指南。
-
请选择创建。

如果存储库使用了 MyDemoRepo
以外的名称,请务必在剩余步骤中使用该名称。
当存储库打开后,您可以查看有关如何直接从 CodeCommit 控制台添加文件的信息。
第 2 步:向存储库中添加文件
可以通过以下方法向您的存储库添加文件:
-
在 CodeCommit 控制台中创建文件。如果您在控制台中为仓库创建第一个文件,则会为您创建一个名为的分支主要的. 此分支是您的存储库的默认分支。
-
使用 CodeCommit 控制台从您的本地计算机上传文件。如果您从控制台上传仓库的第一个文件,则会为您创建一个名为的分支主要的. 此分支是您的存储库的默认分支。
-
使用 Git 客户端将存储库克隆到您的本地计算机,然后添加文件并将文件提交和推送到 CodeCommit 存储库。作为来自 Git 的第一次提交的一部分为你创建了一个分支,它被设置为仓库的默认分支。分支的名称是 Git 客户端的默认选择。考虑将 Git 客户端配置为使用主要的作为初始分支的名称。
您可以随时创建分支并更改存储库的默认分支。有关更多信息,请参阅 处理Amazon CodeCommit存储库中的分支。
最简单的入门方法是打开 CodeCommit 控制台并添加文件。通过这样做,您还可以为名为的存储库创建默认分支。主要的. 有关如何添加文件和创建第一次提交到存储库的说明Amazon CLI,请参阅使用创建仓库的第一次提交Amazon CLI.
向存储库添加文件
-
在存储库的导航栏中,选择代码。
-
选择 Add file (添加文件),然后选择是创建文件还是从您的计算机上传文件。本教程向您展示了如何执行这两个操作。
-
要添加文件,请执行以下操作:
-
在分支下拉列表中,选择要添加文件的分支。已为您自动选择默认分支。在此处所示的示例中,默认分支名为
主要的
. 如果要将文件添加到不同的分支,请选择不同的分支。 -
在 File name (文件名) 中,为文件输入名称。在代码编辑器中,输入文件的代码。
-
在作者姓名中,输入您希望显示给其他存储库用户的姓名。
-
在电子邮件地址中,输入电子邮件地址。
-
(可选)在提交消息中,输入一条简短的消息。虽然这是可选的,但建议您添加提交消息以帮助您的团队成员了解您添加此文件的原因。如果您没有输入提交消息,将使用默认消息。
-
选择提交更改。
要上传文件,请执行以下操作:
-
如果正在上传文件,请选择要上传的文件。
-
在作者姓名中,输入您希望显示给其他存储库用户的姓名。
-
在电子邮件地址中,输入电子邮件地址。
-
(可选)在提交消息中,输入一条简短的消息。虽然这是可选的,但建议您添加提交消息以帮助您的团队成员了解您添加此文件的原因。如果您没有输入提交消息,将使用默认消息。
-
选择提交更改。
-
有关更多信息,请参阅 使用中的文件Amazon CodeCommit存储库。
要使用 Git 客户端克隆存储库,请在您的本地计算机上安装 Git,然后克隆 CodeCommit 存储库。向本地存储库中添加一些文件,并将它们推送到 CodeCommit 存储库。有关深入介绍,请尝试 Git 和 CodeCommit 入门。如果您熟悉 Git 但不确定如何对 CodeCommit 存储库执行此操作,则可查看创建提交、第 2 步:创建本地存储库或连接存储库中的示例和说明。
向 CodeCommit 存储库中添加一些文件后,您可以在控制台中查看它们。
第 3 步:浏览存储库的内容
您可以使用 CodeCommit 控制台查看存储库中的文件或快速读取文件的内容。这可以帮助您确定要签出的分支或者确定是否需要创建存储库的本地副本。
浏览存储库
-
从存储库,选择MyDemo存储库。
-
页面显示了存储库的默认分支中的内容。要查看其他分支或查看特定标签处的代码,请从列表中选择要查看的分支或标签。在以下屏幕截图中,视图设置为主要的。
-
要查看存储库中某个文件的内容,请从列表中选择该文件。要更改所显示代码的颜色,请选择设置图标。
有关更多信息,请参阅 浏览仓库中的文件。
-
要浏览存储库的提交历史记录,请选择 Commits (提交)。控制台按时间倒序显示默认分支的提交历史记录。可以按作者、日期等查看提交详细信息。
-
要查看提交与其父项之间的差异,请选择缩写的提交 ID。您可以选择更改的显示方式,包括显示或隐藏空格更改,以及是以内联方式(统一视图)还是并排方式(拆分视图)查看更改。
注意 每当您更改用于查看代码和其他控制台设置的首选项时,都会将它们保存为浏览器 Cookie。有关更多信息,请参阅 使用用户首选项。
-
要查看对提交的所有评论,请选择提交,然后滚动显示更改以便通过内联方式查看更改。您还可以添加自己的评论并回复他人发表的评论。
有关更多信息,请参阅 评论提交。
-
要查看任意两个提交说明符(包括标签、分支和提交 ID)之间的差异,请在导航窗格中选择 Commits (提交),然后选择 Compare commits (比较提交)。
有关更多信息,请参阅 浏览仓库的提交历史记录 和 比较提交。
-
在提交中,选择提交可视化工具选项卡。
此时会显示提交图,图中每个提交点的旁边显示其主题行。主题行显示限制为 80 个字符。
-
要查看有关提交的更多详细信息,请选择其缩写的提交 ID。要呈现特定提交的图表,请在图表中选择该点。有关更多信息,请参阅 查看仓库提交历史的图表 。
第 4 步:在拉取请求中进行创建和协作
当您与其他用户在存储库中一起工作时,您可以协作编写代码并审核更改。您可以创建拉取请求,以便其他用户可以在分支中审核并注释您的代码更改。您还可以为拉取请求创建一个或多个审批规则。例如,您可以创建一个审批规则,要求在拉取请求合并之前,至少由另外两名用户对其进行审批。拉取请求经审批后,您可以将这些更改合并到其目标分支中。如果您为存储库设置了通知,则存储库用户可以收到有关存储库事件的电子邮件(例如,针对拉取请求,或在有人对代码评论时)。有关更多信息,请参阅 为Amazon CodeCommit存储库中的事件配置通知。
在创建拉取请求之前,必须先创建一个分支,其中包含要查看的代码更改。有关更多信息,请参阅 创建分支。
在拉取请求中进行创建和协作
-
在导航窗格中,选择拉取请求。
-
在拉取请求中,选择创建拉取请求。
提示 您也可以从分支和代码创建拉取请求。
在 Create pull request 中,在 Source 中选择包含要审核的更改的分支。在 Destination (目标) 中,选择要在拉取请求关闭后将已审核的代码合并到的分支。选择 Compare。
-
审核合并详细信息和更改,以确认拉取请求包含要审核的更改和提交。如果是这样,请在标题中输入此审核的标题。此标题显示在存储库的拉取请求列表中。在描述中,输入有关此审核的详细信息及对审核者有用的任何其他信息。请选择创建。
-
拉取请求将显示在存储库的拉取请求列表中。您可以筛选视图,使其只显示打开的请求、关闭的请求、您创建的请求等。
-
您可以向拉取请求添加审批规则,以确保该请求在合并之前满足某些条件。要向拉取请求添加审批规则,请从列表中选择拉取请求。在 Approvals (审批) 选项卡上,选择 Create approval rule (创建审批规则)。
-
在 Rule name (规则名称) 中,为规则指定一个描述性名称。例如,如果您希望拉取请求在合并之前,必须由两人对其进行审批,那么可以将该规则命名为
Require two approvals before merge
。在 Number of approvals needed (需要的审批数量) 中,输入所需的数量2
。默认值为 1。选择 Submit (提交)。要了解有关审批规则和审批池成员的更多信息,请参阅为拉取请求创建审批规则。 -
如果已为存储库配置通知并选择向用户通知拉取请求事件,用户会收到有关新拉取请求的电子邮件。用户可以查看针对特定代码行、文件和拉取请求自身的更改和评论。他们还可以使用文本和表情符号回复评论。如有必要,可以将更改推送到拉取请求分支,此操作会更新拉取请求。
-
如果您对请求中所做的更改感到满意,请选择 Approve (批准)。即使该拉取请求未配置审批规则,您也可以选择批准拉取请求。这样可清楚地记录您已审核拉取请求并批准更改。如果您改变主意,还可以选择撤销批准。
注意 如果拉取请求由您创建,那么您无法批准该请求。
-
当您对在拉取请求中审核并同意的所有代码更改感到满意后,执行以下操作之一:
-
如果要关闭拉取请求而不合并分支,请选择 Close pull request (关闭拉取请求)。
-
如果要合并分支并关闭拉取请求,请选择 Merge (合并)。您可以在代码的可用合并策略之间进行选择,这些策略取决于源和目标分支之间的差异,以及在合并完成后是否自动删除源分支。在进行选择后,请选择 Merge pull request (合并拉取请求) 以完成合并。
-
如果分支中存在无法自动解决的合并冲突,您可以在 CodeCommit 控制台中解决,或者也可以使用本地 Git 客户端合并分支,然后推送合并。有关更多信息,请参阅 解决中的拉取请求的冲突Amazon CodeCommit知识库。
注意 您始终可以在本地存储库中使用 git merge 命令并推送更改以手动合并分支,包括拉取请求分支。
-
第 5 步:清除
如果您不再需要CodeCommit存储库中,您应删除CodeCommit在本练习中使用的存储库和其他资源,以免继续为存储空间付费。
此操作无法撤消。删除该存储库后,您不能再将其克隆到任何本地存储库或共享存储库。您也无法再从任何本地存储库或共享存储库向其推送数据或从其推送数据或执行任何 Git 操作。
如果您为存储库配置通知,则删除存储库还会删除 AmazonCloudWatch为存储库创建的事件规则。此时不会删除用作该规则目标的 Amazon SNS 主题。
如果您为存储库配置了触发器,删除存储库并不会删除您配置为这些触发器目标的 Amazon SNS 主题或 Lambda 函数。如果不需要这些资源,请务必将其删除。有关更多信息,请参阅 从存储库中删除触发器。
删除CodeCommit知识库
打开CodeCommit控制台https://console.aws.amazon.com/codesuite/codecommit/home
. -
在存储库中,选择要删除的存储库。如果您遵循了本主题中的命名约定,它将命名为MyDemo存储库.
-
在导航窗格中,选择 Settings (设置)。
-
在 Settings 页面上的 Delete repository 中,选择 Delete repository。
-
键入
delete
,然后选择删除。存储库将被永久删除。
第 6 步:后续步骤
现在您已经熟悉了 CodeCommit 及其部分功能,请考虑执行以下操作:
-
如果您刚开始使用 Git 和 CodeCommit,或需要查看 Git 与 CodeCommit 配合使用的示例,请继续学习 Git 和 CodeCommit 入门教程。
-
如果您需要与他人共同使用 CodeCommit 存储库,请参阅共享存储库。(如果您希望与其他 Amazon Web Services 账户中的用户共享您的存储库,请参阅使用角色配置对Amazon CodeCommit存储库的跨账户访问权限。)
-
如果需要将存储库迁移到 CodeCommit,请按照迁移到 CodeCommit 中的步骤操作。
-
如果需要将存储库添加到持续交付管道,请按照简单管道演练中的步骤操作。
-
如果需要了解有关与 CodeCommit 集成的产品和服务的更多信息,包括来自社区的示例,请参阅产品和服务集成。