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

连接 AWS CodeCommit 存储库

首次连接 CodeCommit 存储库时,您通常会将其内容克隆到本地计算机。您还可以直接从 CodeCommit 控制台将文件添加到存储库以及在存储库中编辑文件。或者,如果您已有本地存储库,则可将 CodeCommit 存储库添加为远程存储库。本主题提供了有关如何连接 CodeCommit 存储库的说明。如果您需要将现有存储库迁移到 CodeCommit,请参阅迁移到 CodeCommit

注意

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

连接 CodeCommit 存储库的前提条件

在克隆 CodeCommit 存储库或将本地存储库连接到 CodeCommit 存储库之前:

  • 您必须为本地计算机配置连接 CodeCommit 所需的软件和设置。有关更多信息,请参阅 设置

  • 您必须拥有要连接的 CodeCommit 存储库的克隆 URL。该 URL 包含存储库的名称及其 AWS 区域。有关更多信息,请参阅查看存储库详细信息

    如果您尚未创建 CodeCommit 存储库,请按照创建存储库中的说明操作,复制 CodeCommit 存储库的克隆 URL,然后返回到此页面。

    如果您有 CodeCommit 存储库,但您不知道其名称,请按照查看存储库详细信息中的说明操作。

  • 在本地计算机上,您必须有一个位置来存储要连接到的 CodeCommit 存储库的本地副本。(该 CodeCommit 存储库本地副本称作本地存储库。) 然后,您可以切换到该位置并运行 Git 命令。例如,如果您出于测试目的而进行临时克隆,可以使用 /tmp(对于 Linux, macOS, or Unix)或 c:\temp(对于 Windows)。这是这些示例中使用的目录路径。

    注意

    您可以使用所需的任意目录。如果您要克隆存储库以供长期使用,请考虑从不是用于临时文件的工作目录中创建克隆。如果使用 /tmpc:\temp 以外的目录,在按照以下说明操作时,请务必将示例中的目录替换成您自己指定的目录。

通过克隆存储库来连接 CodeCommit 存储库

如果您还没有本地存储库,请按照下面过程中的步骤将 CodeCommit 存储库克隆到您的本地计算机。

  1. 完成前提条件,包括设置

    重要

    如果您尚未完成设置,则无法连接或克隆存储库。

  2. /tmp 目录或 c:\temp 目录,使用 Git 来运行 clone 命令。以下示例说明如何在美国东部(俄亥俄州)区域中克隆名为 MyDemoRepo 的存储库:

    对于 HTTPS:

    git clone https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo my-demo-repo

    对于 SSH:

    git clone ssh://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo my-demo-repo

    在本示例中,git-codecommit.us-east-2.amazonaws.com 是存储库所在的美国东部(俄亥俄州)区域的 Git 连接点,MyDemoRepo 代表您的 CodeCommit 存储库的名称,my-demo-repo 代表 Git 将在 /tmp 目录或 c:\temp 目录中创建的目录的名称。有关支持 CodeCommit 的 AWS 区域和这些 AWS 区域的 Git 连接的更多信息,请参阅区域和 Git 连接终端节点

    注意

    当您在 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 连接问题排查

    Git 创建该目录后会将 CodeCommit 存储库的副本提取到新创建的目录中。

    如果 CodeCommit 存储库是新的或空的,您会看到一条消息,说明您正在克隆空存储库。这是预期行为。

    注意

    如果您收到 Git 找不到 CodeCommit 存储库或您无权连接 CodeCommit 存储库的错误,请确保您已完成前提条件,包括在本地计算机上向 IAM 用户分配权限和为 Git 及 CodeCommit 设置 IAM 用户凭证。此外,请确保您指定了正确的存储库名称。

将本地存储库成功连接到 CodeCommit 存储库后,您就可以开始在本地存储库中运行 Git 命令来创建提交、分支和标签并对 CodeCommit 存储库执行推送和提取操作了。

将本地存储库连接到 CodeCommit 存储库

如果您已有本地存储库并且想要将 CodeCommit 存储库添加为远程存储库,请完成以下步骤。如果您已有远程存储库并且想要将提交推送到 CodeCommit 及其他远程存储库,请按照将提交推送到两个存储库中的步骤操作。

  1. 完成前提条件

  2. 在命令提示符或终端中,切换到本地存储库目录,然后运行 git remote add 命令将 CodeCommit 存储库添加为本地存储库的远程存储库。

    例如,以下命令将别名为 origin 的远程存储库添加到 https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo:

    对于 HTTPS:

    git remote add origin https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo

    对于 SSH:

    git remote add origin ssh://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo

    该命令不返回任何内容。

  3. 要验证您是否已将 CodeCommit 存储库添加为本地存储库的远程存储库,请运行 git remote -v 命令,它应会产生类似以下内容的输出:

    对于 HTTPS:

    origin https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo (fetch) origin https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo (push)

    对于 SSH:

    origin ssh://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo (fetch) origin ssh://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo (push)

将本地存储库成功连接到 CodeCommit 存储库后,您就可以开始在本地存储库中运行 Git 命令来创建提交、分支和标签并对 CodeCommit 存储库执行推送和提取操作了。