本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
连接 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)。这是这些示例中使用的目录路径。注意
您可以使用所需的任意目录。如果您要克隆存储库以供长期使用,请考虑从不是用于临时文件的工作目录中创建克隆。如果使用
/tmp
或c:\temp
以外的目录,在按照以下说明操作时,请务必将示例中的目录替换成您自己指定的目录。
通过克隆 CodeCommit 存储库来连接存储库
如果您还没有本地存储库,请按照此过程中的步骤将 CodeCommit 存储库克隆到本地计算机。
-
完成前提条件,包括设置 。
重要
如果您尚未完成设置,则无法连接或克隆存储库。
-
从
/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 在目录或目录中创建的/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 和 CodeCommit 本地计算机设置您的 IAM 用户证书。此外,请确保您指定了正确的存储库名称。
成功将本地存储库连接到 CodeCommit 仓库后,您现在可以开始从本地存储库中运行 Git 命令来创建提交、分支和标签,然后向仓库推送和拉取存储库了。 CodeCommit
将本地存储库连接到存储库 CodeCommit
如果您已有本地存储库并且想要将 CodeCommit 存储库添加为远程存储库,请完成以下步骤。如果您已经有一个远程存储库,并且想要将提交推送到 CodeCommit 另一个远程存储库,请按照中的步骤操作将提交推送到两个存储库。
-
完成前提条件。
-
在命令提示符或终端中,切换到本地 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
该命令不返回任何内容。
-
要验证您是否已将 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