步骤 1：创建 CodeCommit 存储库步骤 2：创建本地存储库步骤 3：创建您的第一个提交步骤 4：推送您的第一个提交第 5 步：共享 CodeCommit 存储库并推送和拉取另一个提交步骤 6：创建并共享分支步骤 7：创建并共享标签步骤 8：设置访问权限步骤 9：清除

Git 入门和 AWS CodeCommit

如果你是 Git 的新手 CodeCommit，本教程可以帮助你学习一些简单的命令来开始使用。如果您已熟悉 Git，可以跳过本教程并转到入门 CodeCommit 。

在本教程中，您将创建一个表示存储库本地副本的 CodeCommit 存储库，我们称之为本地存储库。

创建本地存储库后，您将对其进行一些更改，然后将更改发送（推送）到 CodeCommit 存储库。

您还可以模拟一个团队环境，在该环境中，两个用户独立提交对本地存储库的更改，并将这些更改推送到 CodeCommit 存储库。然后，用户将更改从 CodeCommit 存储库拉到自己的本地存储库，以查看其他用户所做的更改。

您还可以创建分支和标签，并管理 CodeCommit 仓库中的某些访问权限。

完成本教程后，您应已完成有关 Git 和 CodeCommit 核心概念的充分练习，可以开始在自己的项目中使用它们了。

完成前提条件和设置，包括：

向 IAM 用户分配权限。
设置 CodeCommit 为使用 HTTPS、SSH 或连接到存储库git-remote-codecommit。有关这些选择的更多信息，请参阅正在设置 AWS CodeCommit。
AWS CLI 如果要使用命令行或终端执行所有操作（包括创建存储库），请配置。

步骤 1：创建 CodeCommit 存储库

在此步骤中，您将使用 CodeCommit 控制台创建存储库。

如果您已经有想要使用的 CodeCommit 存储库，则可以跳过此步骤。

注意

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

创建 CodeCommit 存储库

在 https://console.aws.amazon.com/codesuite/codemmit /home 打开 CodeCommit 控制台。
使用区域选择器选择要在 AWS 区域哪里创建存储库。有关更多信息，请参阅区域和 Git 连接端点。
在存储库页面上，选择创建存储库。
在创建存储库页面上的存储库名称中，输入存储库的名称（例如，MyDemoRepo）。

注意
存储库名称区分大小写，且不能超过 100 个字符。有关更多信息，请参阅限制。
（可选）在描述中，输入描述（例如，My demonstration repository）。这可以帮助您及其他用户了解存储库的用途。
（可选）选择 Add t ag，向存储库添加一个或多个存储库标签（可帮助您组织和管理 AWS 资源的自定义属性标签）。有关更多信息，请参阅在中标记存储库 AWS CodeCommit。
（可选）展开其他配置以指定是使用默认密钥 AWS 托管式密钥还是您自己的客户托管密钥来加密和解密此存储库中的数据。如果您选择使用自己的客户托管密钥，则必须确保该密钥在您创建存储库 AWS 区域的地方可用，并且该密钥处于活动状态。有关更多信息，请参阅 AWS Key Management Service 以及 AWS CodeCommit 存储库的加密。
（可选）如果此存储库将包含 Java 或 Python 代码，并且您想让 CodeGuru Reviewer 分析该代码，请选择 “为 Java 和 Python 启用 Ama zon CodeGuru Reviewer”。 CodeGuru Reviewer 使用多个机器学习模型来查找代码缺陷，并自动在拉取请求中提出改进和修复建议。有关更多信息，请参阅 Amazon CodeGuru Reviewer 用户指南。
选择创建。

注意

本教程的其余步骤使用MyDemoRepo CodeCommit 存储库的名称。如果您选择其他名称，请确保在本教程中通篇使用它。

有关创建存储库 (包括如何从终端或命令行创建存储库) 的更多信息，请参阅创建存储库。

步骤 2：创建本地存储库

在此步骤中，需要在本地计算机上设置一个本地存储库，以连接到您的存储库。为此，请在本地计算机上选择一个代表本地存储库的目录，您可以使用 Git 在该目录中克隆和初始化空 CodeCommit 仓库的副本。并指定用于为您的提交添加注释的 Git 用户名和电子邮件地址。

在 https://console.aws.amazon.com/codesuite/codemmit /home 打开 CodeCommit 控制台。
在区域选择器中，选择存储库的创建 AWS 区域位置。存储库特定于 AWS 区域。有关更多信息，请参阅区域和 Git 连接端点。
从列表中找到您要连接的存储库并选择此存储库。选择 Clone URL (克隆 URL)，然后选择克隆或连接到存储库时要使用的协议。此时将复制克隆 URL。
- 如果您使用的是 IAM 用户的 Git 凭证或 AWS CLI附带的凭证助手，请复制 HTTPS URL。
- 如果您在本地计算机上使用 git-remote-codecommit 命令，请复制 HTTPS (GRC) URL。
- 如果您使用的是 IAM 用户的 SSH 公有密钥/私有密钥对，请复制 SSH URL。
注意
如果您看到的是欢迎页面而不是存储库列表，则说明您登录的 AWS 区域位置中没有与您的 AWS 账户关联的存储库。要创建存储库，请参阅创建 AWS CodeCommit 存储库或按照Git 入门和 CodeCommit教程中的步骤进行操作。
（可选）我们建议您将本地 Git 客户端配置为使用 main 作为存储库默认分支的名称。本指南所有示例中的默认分支均使用此名称。它也与您在控制台中首次提交时 CodeCommit 使用的默认分支名称相同。运行以下命令为您的系统全局配置默认分支名称：
```
git config --global init.defaultBranch main
```
如果您更喜欢为所有存储库使用不同的默认分支名称，请将 main 替换为您的首选名称。本教程假定您的默认分支名称为 main。

如果您希望为不同的存储库使用不同的默认分支名称，则可以在本地 (--local) 设置此属性，而不是全局 (--global) 设置。
在终端或命令提示符处，使用 git clone 命令并提供您在步骤 3 中复制的克隆 URL 来克隆存储库。您的克隆 URL 具体取决于您使用的协议和配置。例如，如果您使用带有 Git 凭据的 HTTPS 来克隆MyDemoRepo位于美国东部（俄亥俄州）地区的仓库：
```
git clone https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo my-demo-repo
```
如果您将 HTTPS 与 git-remote-codecommit 结合使用：
```
git clone codecommit://MyDemoRepo my-demo-repo
```
如果您正在使用 SSH：
```
git clone ssh://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo my-demo-repo
```
注意
如果您在尝试克隆存储库时看到错误，则可能尚未完成本地计算机所需的设置。有关更多信息，请参阅正在设置 AWS CodeCommit。

步骤 3：创建您的第一个提交

在此步骤中，您将在本地存储库中创建第一个提交。为此，您需要在本地存储库中创建两个示例文件。使用 Git 暂存更改，然后将更改提交到您的本地存储库。

使用文本编辑器在您的目录中创建以下两个示例文本文件。将这两个文件命名为 cat.txt 和 dog.txt：


cat.txt
-------
The domestic cat (Felis catus or Felis silvestris catus) is a small, usually furry, domesticated, and carnivorous mammal.


dog.txt
-------
The domestic dog (Canis lupus familiaris) is a canid that is known as man's best friend.

运行git config以将占位符your-user-name表示的用户名和电子邮件地址your-email-address添加到您的本地存储库中。这样，就可以更轻松地标识您所做的提交：
```
git config --local user.name "your-user-name"
git config --local user.email your-email-address
```
如果您在创建本地存储库时没有全局设置默认分支名称，请运行以下命令，将默认分支名称设置为 main：
```
git config --local init.defaultBranch main
```
运行 git add 暂存更改：
```
git add cat.txt dog.txt
```
运行 git commit 提交更改：
```
git commit -m "Added cat.txt and dog.txt"
```
提示
要查看刚刚创建的提交的详细信息，请运行 git log。

步骤 4：推送您的第一个提交

在此步骤中，您将提交从本地存储库推送到存储 CodeCommit 库。

运行git push以通过 Git 在仓库中使用的默认远程名称 (origin)，从本地 CodeCommit 仓库的默认分支 (main) 推送你的提交：


git push -u origin main

提示

将文件推送到存储 CodeCommit 库后，您可以使用 CodeCommit 控制台查看内容。有关更多信息，请参阅浏览存储库中的文件。

第 5 步：共享 CodeCommit 存储库并推送和拉取另一个提交

在此步骤中，您将与其他团队成员共享有关 CodeCommit 仓库的信息。团队成员使用这些信息获取本地副本，对其进行一些更改，然后将修改后的本地副本推送到您的 CodeCommit 存储库。然后，您将更改从 CodeCommit 存储库提取到本地存储库。

在本教程中，您可以通过使用 Git 另外创建一个目录 (独立于您在步骤 2 中创建的目录) 来模拟其他用户。（该目录通常位于其他计算机上。）这个新目录是您的 CodeCommit 存储库的副本。您对现有目录或该新目录所做的任何更改都是独立进行的。识别这些目录的更改的唯一方法是从 CodeCommit 存储库中提取。

我们将现有目录称作本地存储库，将新目录称作共享存储库 (即使它们位于同一台本地计算机上)。

从新目录中，您将获得 CodeCommit 存储库的单独副本。然后，您可以添加一个新的示例文件，将更改提交到共享存储库，然后将该提交从共享存储库推送到您的 CodeCommit 存储库。

最后，将存储库中的更改拉取到本地存储库，然后浏览它以查看其他用户提交的更改。

切换到 /tmp 目录或 c:\temp 目录。
运行 git clone 在共享存储库中提取一份存储库副本：

对于 HTTPS：
```
git clone https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo shared-demo-repo
```
对于将 HTTPS 与 git-remote-codecommit 一起使用：
```
git clone codecommit://MyDemoRepo shared-demo-repo
```
对于 SSH：
```
git clone ssh://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo shared-demo-repo
```
注意
在 Windows 操作系统上使用 SSH 克隆存储库时，您可能需要将 SSH 密钥 ID 添加到连接字符串，如下所示：
```
git clone ssh://Your-SSH-Key-ID@git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo my-demo-repo
```
有关更多信息，请参阅适用于 Windows 上的 SSH 连接。
在此命令中，MyDemoRepo是您的 CodeCommit 存储库的名称。 shared-demo-repo是 Git 在目录或目录中创建的/tmpc:\temp目录的名称。Git 创建该目录后，会向 shared-demo-repo 目录中提取一份存储库副本。

切换到 shared-demo-repo 目录：


(For Linux, macOS, or Unix) cd /tmp/shared-demo-repo
(For Windows) cd c:\temp\shared-demo-repo

运行git config添加另一个由占位符表示的用户名和电子邮件地址，然后other-user-name。other-email-address这样，就可以更轻松地标识其他用户进行的提交：
```
git config --local user.name "other-user-name"
git config --local user.email other-email-address
```
使用文本编辑器在 shared-demo-repo 目录中创建以下示例文本文件。将该文件命名为 horse.txt：
```
horse.txt
-------
The horse (Equus ferus caballus) is one of two extant subspecies of Equus ferus.
```
运行 git add 将更改暂存到共享存储库：
```
git add horse.txt
```
运行 git commit 将更改提交到共享存储库：
```
git commit -m "Added horse.txt"
```
运行git push以通过 Git 在仓库中使用的默认远程名称 (origin)，从本地 CodeCommit 仓库的默认分支 (main) 推送你的初始提交：
```
git push -u origin main
```
切换到本地存储库，然后运行将共享存储库提交git pull到存储库的内容拉入本地存储库。 CodeCommit 然后运行 git log 查看从共享存储库发起的提交。

步骤 6：创建并共享分支

在此步骤中，你将在本地存储库中创建一个分支，进行一些更改，然后将该分支推送到您的 CodeCommit 存储库。然后，您将分支从存储库中拉到共享存储 CodeCommit 库。

分支允许您独立开发存储库内容的不同版本。例如，在不影响团队成员工作的情况下使用新的软件功能。当该功能稳定时，可以将分支合并到软件的更稳定的分支中。

使用 Git 创建分支，然后将其指向您的第一个提交。您可以使用 Git 将分支推送到 CodeCommit 仓库。然后，切换到您的共享存储库，使用 Git 将新分支拉取到共享本地存储库并查看该分支。

在本地存储库中运行 git checkout，指定该分支的名称（例如 MyNewBranch）和您在本地存储库中的第一个提交的 ID。

如果不知道提交 ID，可以运行 git log 获取它。确保提交使用的是您的用户名和电子邮件地址，而不是其他用户的用户名和电子邮件地址。这是为了模拟 CodeCommit 存储库的稳定版本，main而MyNewBranch分支用于一些新的、相对不稳定的功能：
```
git checkout -b MyNewBranch commit-ID
```
运行git push将新分支从本地存储库发送到 CodeCommit 存储库：
```
git push origin MyNewBranch
```
现在，将分支提取到共享存储库并检查结果：
1. 切换到共享存储库目录 (shared-demo-repo)。
2. 提取新分支 (git fetch origin)。
3. 确认已提取分支（git branch --all 显示存储库所有分支的列表）。
4. 切换到新分支 (git checkout MyNewBranch)。
5. 通过运行 git status 或 git branch 确认您已切换到 MyNewBranch 分支。输出将显示您所在的分支。在本示例中，输出应为 MyNewBranch。
6. 查看分支中的提交列表 (git log)。
以下是要调用的 Git 命令的列表：
```
git fetch origin
git branch --all
git checkout MyNewBranch
git branch or git status
git log
```
切换回 main 分支，查看其提交列表。Git 命令应如下所示：
```
git checkout main
git log
```
切换到本地存储库中的 main 分支。您可以运行 git status 或 git branch。输出将显示您所在的分支。在本示例中，输出应为 main。Git 命令应如下所示：
```
git checkout main
git branch or git status
```

步骤 7：创建并共享标签

在此步骤中，您将在本地存储库中创建两个标签，将这些标签与提交相关联，然后将标签推送到您的 CodeCommit 存储库。然后，您将更改从 CodeCommit 存储库拉到共享存储库。

标签用于给提交 (或分支，甚至是另一个标签) 起一个易于阅读的名称。例如，如果要将提交标记为 v2.1，则可如此操作。提交、分支或标签可以关联任意数量的标签，但一个标签只能关联一个提交、分支或标签。在本教程中，将一个提交标记为 release，将另一个提交标记为 beta。

您使用 Git 创建标签，将 release 标签指向您进行的第一个提交，并将 beta 标签指向其他用户进行的提交。然后使用 Git 将标签推送到 CodeCommit 仓库。接下来，切换到您的共享存储库，使用 Git 将标签拉取到共享本地存储库并查看标签。

在本地存储库中运行 git tag，指定新标签的名称（例如 release）和您在本地存储库中的第一个提交的 ID。

如果不知道提交 ID，可以运行 git log 获取它。确保提交使用的是您的用户名和电子邮件地址，而不是其他用户的用户名和电子邮件地址。这是为了模拟你的提交是 CodeCommit 存储库的稳定版本：
```
git tag release commit-ID
```
再次运行 git tag，将其他用户的提交与 beta 标签关联。这是模拟该提交用于某种新的、相对不稳定的功能的情况：
```
git tag beta commit-ID
```
运行git push --tags将标签发送到 CodeCommit 存储库。
现在，将标签提取到共享存储库并检查结果：
1. 切换到共享存储库目录 (shared-demo-repo)。
2. 提取新标签 (git fetch origin)。
3. 确认已提取标签（git tag 显示存储库的标签列表）。
4. 查看有关每个标签（git log release 和 git log beta）的信息。
以下是要调用的 Git 命令的列表：
```
git fetch origin
git tag
git log release
git log beta
```
也请尝试在本地存储库中执行该操作：
```
git log release
git log beta
```

步骤 8：设置访问权限

在此步骤中，您授予用户将共享存储库与 CodeCommit 存储库同步的权限。此为可选步骤。当用户使用 Git 凭证或 SSH 密钥对与 IAM 用户一起使用访问 CodeCommit 存储库时，有兴趣了解如何控制对 CodeCommit 仓库的访问权限的用户建议使用该工具。

注意

如果您使用的是联合访问、临时凭证或 Web 身份提供者验证（例如 IAM Identity Center），请为您的身份提供者设置用户、访问权限和权限，然后使用 git-remote-codecommit。有关更多信息，请参阅使用 HTTPS 连接 AWS CodeCommit 的设置步骤 git-remote-codecommit 和使用轮换凭证连接到 AWS CodeCommit 存储库。

为此，您可以使用 IAM 控制台创建一个用户，默认情况下，该用户无权将共享存储库与 CodeCommit 存储库同步。您可以运行 git pull 来验证这一点。如果新用户没有同步权限，则该命令不起作用。然后，返回到 IAM 控制台，应用允许该用户使用 git pull 的策略。随后，您可以再次运行 git pull 进行验证。

此步骤假定您具备在 Amazon Web Services 账户中创建 IAM 用户的权限。如果您不具备这些权限，则无法执行此步骤中的过程。请跳到步骤 9：清除并清理学习教程时所使用的资源。

登录 AWS Management Console 并打开 IAM 控制台，网址为https://console.aws.amazon.com/iam/。

请务必用您在设置中使用的用户名和密码登录。
在导航窗格中选择用户，然后选择创建新用户。
在第一个输入用户名称框中，输入示例用户名（例如，JaneDoe-CodeCommit）。选中为每个用户生成访问密钥框，然后选择创建。
选择显示用户安全凭证。记下访问密钥 ID 和秘密访问密钥，或选择 Download Credentials。
按照适用于使用 Git 凭证的 HTTPS 用户中的说明进行操作以生成并提供 IAM 用户的凭证。

如果需要使用 SSH，请按照SSH 和 Linux、macOS 或 Unix：为 Git 设置公钥和私钥以及 CodeCommit或第 3 步：为 Git 设置公钥和私钥以及 CodeCommit中的说明操作，设置用户及公钥和私钥。
运行 git pull。此时会出现下面的错误：

对于 HTTPS：

fatal: unable to access 'https://git-codecommit.us-east-2.amazonaws.com/v1/repos/repository-name/': The requested URL returned error: 403.

对于 SSH：

fatal: unable to access 'ssh://git-codecommit.us-east-2.amazonaws.com/v1/repos/repository-name/': The requested URL returned error: 403.

出现错误是因为新用户无权将共享存储库与 CodeCommit 存储库同步。
返回到 IAM 控制台。在导航窗格中选择 Policies，然后选择 Create Policy。（如果 Get Started 按钮出现，选择此按钮，然后选择 Create Policy。）
在 Create Your Own Policy 旁，选择 Select。
在策略名称框中，输入名称（例如 CodeCommitAccess-GettingStarted）。

在策略文档框中，输入以下内容，它允许 IAM 用户从与该 IAM 用户关联的任何存储库中拉取内容：


{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "codecommit:GitPull"
      ],
      "Resource": "*"
    }
  ]
}

提示

如果您希望该 IAM 用户能够将提交推送到与之关联的任何存储库，请改为输入：


{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "codecommit:GitPull",
        "codecommit:GitPush"
      ],
      "Resource": "*"
    }
  ]
}

有关您可以授予用户的其他 CodeCommit 操作和资源权限的信息，请参阅AWS CodeCommit的身份验证和访问控制。

在导航窗格中，选择 Users（用户）。
选择要附加策略的示例用户名（例如，JaneDoe-CodeCommit）。
选择 Permissions（权限）选项卡。
在 Managed Policies 中，选择 Attach Policy。
选择您刚刚创建的 CodeCommitAccess-GettingStarted 策略，然后选择 Attach Policy (附加策略)。
运行 git pull。这一次，命令应能起作用，并显示 Already up-to-date 消息。
如果您使用 HTTPS，请切换到您的原始 Git 凭证；或者，如果使用 git-remote-codecommit，请切换到您的常用配置文件。有关更多信息，请参阅适用于使用 Git 凭证的 HTTPS 用户的设置或使用 HTTPS 连接 AWS CodeCommit 的设置步骤 git-remote-codecommit中的说明。

如果使用的是 SSH，请切换到您的原始密钥。有关更多信息，请参阅 SSH 和 Linux、macOS 或 Unix：为 Git 设置公钥和私钥以及 CodeCommit或第 3 步：为 Git 设置公钥和私钥以及 CodeCommit。

本教程到此结束。

步骤 9：清除

在此步骤中，您将删除在本教程中使用的 CodeCommit 存储库，这样就不会继续向您收取存储空间费用。

您还可以移除本地存储库和本地计算机上的共享存储库，因为删除存储库后将不再需要它们。 CodeCommit

重要

删除该存储库后，您就无法再将其克隆到任何本地存储库或共享存储库，也无法再从任何本地存储库或共享存储库向其推送数据或从其拉取数据。并且无法撤消。

删除 CodeCommit 存储库（控制台）

在 https://console.aws.amazon.com/codesuite/codemmit /home 打开 CodeCommit 控制台。
在 Dashboard (控制面板) 页面的存储库列表中，选择 MyDemoRepo。
在导航窗格中，选择 Settings（设置）。
在 Settings 页面上的 Delete repository 中，选择 Delete repository。
在 Type the name of the repository to confirm deletion (键入存储库名称以确认删除) 旁边的框中，输入 MyDemoRepo，然后选择 Delete (删除)。

要删除 CodeCommit 存储库 (AWS CLI)

运行 delete-repository 命令：


aws codecommit delete-repository --repository-name MyDemoRepo

删除本地存储库和共享存储库

对于 Linux、macOS 或 Unix：


cd /tmp
rm -rf /tmp/my-demo-repo
rm -rf /tmp/shared-demo-repo

对于 Windows：


cd c:\temp
rd /s /q c:\temp\my-demo-repo
rd /s /q c:\temp\shared-demo-repo

Javascript 在您的浏览器中被禁用或不可用。

要使用 Amazon Web Services 文档，必须启用 Javascript。请参阅浏览器的帮助页面以了解相关说明。

文档惯例

入门 CodeCommit

产品和服务集成