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

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

连接 Amazon CodeCommit 存储库

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

注意

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

连接到 CodeCommit存储库的先决条件

在克隆存储 CodeCommit 库或将本地存储库连接到存储库之前,请执行以下操作: CodeCommit

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

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

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

    如果您有 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

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

    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 在目录或目录中创建的/tmpc:\temp目录的名称。有关该支持 CodeCommit 以及这些支持Amazon Web Services 区域的 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 和 CodeCommit 本地计算机设置您的 IAM 用户证书。此外,请确保您指定了正确的存储库名称。

成功将本地存储库连接到 CodeCommit 仓库后,您现在可以开始从本地存储库中运行 Git 命令来创建提交、分支和标签,然后向仓库推送和拉取存储库了。 CodeCommit

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

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

  1. 完成前提条件

  2. 在命令提示符或终端中,切换到本地 repo 目录并运行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