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

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

ConnectAmazon 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 存储库Connect 存储库

如果您还没有本地存储库,请按照此过程中的步骤将 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

    对于使用 HTTPSgit-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目录的名称。有关该支持 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 设置您的 IAM 用户凭证等 CodeCommit 本地机器。此外,请确保您指定了正确的存储库名称。

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