连接 AWS CodeCommit 存储库 - AWS CodeCommit
连接 CodeCommit 存储库的前提条件通过克隆存储库来连接 CodeCommit 存储库将本地存储库连接到 CodeCommit 存储库

AWS CodeCommit 现已不再向新客户提供。AWS CodeCommit 的现有客户可以继续正常使用该服务。了解更多

连接 AWS CodeCommit 存储库

首次连接 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）。这是这些示例中使用的目录路径。

    注意

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

通过克隆存储库来连接 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

    对于使用 git-remote-codecommit 的 HTTPS，假设在 AWS CLI 中配置了默认配置文件和 AWS 区域：

    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 目录中创建的目录的名称。有关支持 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 存储库执行推送和拉取操作了。