连接到Amazon CodeCommit知识库 - Amazon CodeCommit
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

连接到Amazon CodeCommit知识库

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

注意

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

连接到 a 的先决条件CodeCommit知识库

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

  • 您必须为本地计算机配置连接 CodeCommit 所需的软件和设置。这包括安装和配置 Git。有关更多信息,请参阅 设置 入门 GitAmazon CodeCommit

  • 您必须拥有的克隆 URLCodeCommit要连接的存储库。有关更多信息,请参阅查看存储库详情

    如果你还没有创建CodeCommit存储库,请按照中的说明进行操作创建 存储库,复制的克隆 URLCodeCommit存储库,然后返回此页面。

    如果你有一个CodeCommit存储库但您不知道其名称,请按照中的说明进行操作查看存储库详情

  • 您必须在本地计算机上有一个位置才能存储本地副本CodeCommit您连接到的存储库。(此本地副本CodeCommit存储库被称为本地存储库。) 然后,您可以切换到该位置并运行 Git 命令。例如,你可以使用/tmp(适用于 Linux、macOS 或 Unix)或c:\temp(适用于 Windows),前提是您为测试目的制作临时克隆。这是这些示例中使用的目录路径。

    注意

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

连接到CodeCommit通过克隆存储库来创建存储库

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

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

    重要

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

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

    对于使用 Git 凭证的 HTTPS 或 Amazon CLI 随附的凭证辅助程序:

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

    对于 HTTPS 使用git-remote-codecommit,假设使用默认配置文件和Amazon Web Services 区域配置在Amazon CLI:

    git clone codecommit://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目录。有关更多信息Amazon Web Services 区域那种支持CodeCommit还有那些的 Git 连接Amazon Web Services 区域,请参阅地区和 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 设置您的 IAM 用户凭证以及CodeCommit在本地计算机上。此外,请确保您指定了正确的存储库名称。

在你成功地将本地存储库连接到你的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存储库。