Connect 到AWS CodeCommitrepository - AWS CodeCommit

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

Connect 到AWS CodeCommitrepository

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

注意

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

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

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

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

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

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

    如果您有 CodeCommit 存储库,但您不知道其名称,请按照查看存储库细信息.

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

    注意

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

通过克隆存储库来 Connect CodeCommit 存储库

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

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

    重要

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

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

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

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

    对于 HTTPS 使用git-remote-codecommit,假设默认配置文件和 AWS 区域 中配置的AWS 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目录。有关的更多信息 AWS 区域 ,支持 CodeCommit 以及这些 AWS 区域 ,请参阅区域和 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 存储库执行推送和提取操作了。

将本地仓库 Connect 到 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 存储库执行推送和提取操作了。